ClientContext

Letzte Aktualisierung: 2023-12-19
HINWEIS

ClientContext wurde durch ContextHub abgelöst. Weitere Informationen finden Sie in der entsprechenden Konfigurations- und Entwicklerdokumentation.

ClientContext ist ein Mechanismus, der Ihnen bestimmte Informationen zur aktuellen Seite und zum aktuellen Besucher liefert. Um ClientContext zu öffnen, drücken Sie die Tastenkombination Strg+Alt+C (Windows) oder Ctrl+Wahl+C (Mac):

Beispiel für das ClientContext-Fenster

In der Veröffentlichungs- und Autorenumgebung werden Informationen zu Folgendem angezeigt:

  • der oder dem Besuchenden (abhängig von Ihrer Instanz werden bestimmte Informationen angefordert oder abgeleitet)
  • Seiten-Tags und Häufigkeit, mit der die oder der aktuelle Besuchende auf diese Tags zugegriffen hat (wird angezeigt, wenn Sie den Mauszeiger über ein bestimmtes Tag bewegen)
  • Seiteninformationen
  • Informationen zur technischen Umgebung, z. B. IP-Adresse, Browser und Bildschirmauflösung
  • allen Segmenten, die aktuell aufgelöst werden

Über die (nur in der Autorenumgebung verfügbaren) Symbole können Sie ClientContext-Details konfigurieren:

ClientContext-Fenster mit den Symbolen zum Bearbeiten, Laden und Zurücksetzen

Verfügbare ClientContext-Komponenten

ClientContext kann die folgenden Eigenschaften anzeigen (abhängig von der mit „Bearbeiten“ getroffenen Auswahl):

Surfer-Informationen: Zeigt die folgenden Client-seitigen Informationen an:

  • die IP-Adresse
  • Schlüsselwörter als Suchmaschinenreferenz
  • die verwendeten Browser
  • das verwendete Betriebssystem
  • die Auflösung des Bildschirms
  • die X-Position der Maus
  • die Y-Position der Maus

Aktivitäts-Stream Hier erhalten Sie Informationen zur sozialen Aktivität des Benutzers auf verschiedenen Plattformen, z. B. den AEM, Blogs, Bewertungen usw.

Kampagne: Ermöglicht es Autoren, ein bestimmtes Erlebnis für eine Kampagne zu simulieren. Diese Komponente setzt die normale Kampagnenauflösung und Erlebnisauswahl außer Kraft, um verschiedene Permutationen testen zu können.

Die Kampagnenauflösung basiert normalerweise auf der Prioritätseigenschaft der Kampagne. Das Erlebnis wird im Regelfall auf Grundlage der Segmentierung ausgewählt.

Warenkorb Zeigt Informationen zum Warenkorb an, einschließlich Produkteinträgen (Titel, Menge, PreisFormatiert usw.), aufgelösten Promotions (Titel, Nachricht usw.) und Gutscheinen (Code, Beschreibung usw.).

Der Warenkorbsitzungs-Store benachrichtigt mittels ClientContextCartServlet zudem den Server über aufgelöste Promotion-Änderungen (basierend auf Segmentierungsänderungen).

Generischer Store: Eine generische Komponente, die den Inhalt eines Stores angezeigt. Es handelt sich hierbei um eine untergeordnete Version der Komponente „Generische Store-Eigenschaften“.

Der generische Store muss mit einem JS-Renderer konfiguriert werden, der die Daten benutzerdefiniert anzeigt.

Generische Store-Eigenschaften: Eine generische Komponente, die den Inhalt eines Stores angezeigt. Es handelt sich um eine übergeordnete Version der Komponente „Generischer Store“.

Die Komponente „Generische Store-Eigenschaften“ beinhaltet einen Standard-Renderer, der die konfigurierten Eigenschaften (mit einer Miniaturansicht) auflistet.

Geolocation: Zeigt den Breiten- und Längengrad des Kundenstandorts an. Über die HTML5-Geolocation-API wird der aktuelle Standort vom Browser abgefragt. Dabei wird eine Popup-Meldung angezeigt, über die der Besucher gebeten wird, seine Standortdaten freizugeben.

Bei Anzeige in ContextCloud nutzt die Komponente eine Google-API, um eine Karte als Miniaturansicht darzustellen. Die Komponente unterliegt den Nutzungsbeschränkungen der Google-API.

HINWEIS

In AEM 6.1 verfügt der Geolocation-Store nicht länger über die Reverse Geocoding-Funktion. Deshalb ruft der Geolocation-Store nicht mehr Details zum aktuellen Standort ab, etwa Ortsnamen oder Länder-Codes. Segmente, die diese Store-Daten verwenden, funktionieren nicht ordnungsgemäß. Der Geolocation-Store enthält nur den Breiten- und Längengrad eines Standorts.

JSONP-Store: Eine Komponente, die Inhalt anzeigt, der abhängig von Ihrer Installation ist.

Der JSON-Standard ist eine JSON-Ergänzung, mit der dieselbe ursprüngliche Richtlinie umgangen werden kann (sodass eine Web-Anwendung mit Servern in einer anderen Domain kommunizieren kann). Er besteht darin, das JSON-Objekt in einen Funktionsaufruf zu verpacken, damit es als <script> von der anderen Domäne aus (was eine zulässige Ausnahme von derselben Ursprungsrichtlinie ist).

Der JSONP-Store ist zwar wie jeder andere Store, er lädt allerdings Informationen aus einer anderen Domain, ohne dass für diese Informationen ein Proxy in der aktuellen Domain benötigt wird. Siehe hierzu das Beispiel unter Speichern von Daten in ClientContext über JSON.

HINWEIS

Der JSONP-Store speichert die Informationen nicht im Cookie zwischen, ruft aber die Daten bei jedem Seitenladevorgang ab.

Profildaten: Zeigt im Benutzerprofil erfasste Informationen an, Zum Beispiel Geschlecht, Alter, E-Mail-Adresse usw.

Aufgelöste Segmente: Gibt an, welche Segmente aktuell aufgelöst werden (häufig von anderen in ClientContext angezeigten Informationen abhängig). Dies ist beim Konfigurieren von Kampagnen von Interesse.

Beispiel: die Frage, ob sich die Maus aktuell im linken oder rechten Fensterbereich befindet. Dieses Segment dient in erster Linie für Tests, da Änderungen sofort zu sehen sind.

Soziales Diagramm: Zeigt das soziale Diagramm von Freunden und Followern des Benutzers an.

HINWEIS

Diese Option ist derzeit als Demofunktion verfügbar und auf vorkonfigurierte Datensätze im Profilknoten der Demobenutzenden angewiesen. Ein Beispiel finden Sie unter:

/home/users/geometrixx/aparker@geometrixx.info/profile => Eigenschaft „Freunde“

Tag-Cloud: Zeigt die auf der aktuellen Seite gesetzten und beim Navigieren auf der Site gesammelten Tags an. Wenn Sie mit der Maus auf ein Tag zeigen, sehen Sie, wie oft der aktuelle Benutzer auf Seiten mit diesem bestimmten Tag zugegriffen hat.

HINWEIS

Auf DAM-Assets gesetzte Tags, die auf besuchten Seiten angezeigt werden, werden nicht gezählt.

Technografie-Store: Diese Komponente hängt von Ihrer Installation ab.

ViewedProducts: Verfolgt die vom Einkäufer angesehenen Produkte. Es kann das zuletzt angesehene Produkt oder das zuletzt angesehene Produkt, das sich nicht bereits im Warenkorb befindet, abgerufen werden.

Dieser Sitzungs-Store verfügt über keine standardmäßige ClientContext-Komponente.

Weitere Informationen finden Sie unter ClientContext im Detail.

HINWEIS

Die Seitendaten sind keine Standardkomponenten in ClientContext mehr. Sie können sie ggf. hinzufügen, indem Sie ClientContext bearbeiten, die Komponente Generische Store-Eigenschaften hinzufügen und dann eine entsprechende Konfiguration durchführen, um den Store als pagedata zu definieren.

Ändern des ClientContext-Profils

Mit ClientContext können Sie Details interaktiv verändern:

  • Wenn Sie das in ClientContext verwendete Profil ändern, können Sie sehen, wie sich die Erlebnisse von verschiedenen Benutzenden beim Aufruf der aktuellen Seite unterscheiden.
  • Abgesehen vom Ändern des Benutzerprofils können Sie auch bestimmte Profildetails ändern, um nachzuvollziehen, wie sich das Seitenerlebnis unter verschiedenen Bedingungen verändert.

Laden eines neues Benutzerprofils

Sie können ein Profil wie folgt ändern:

Wenn Sie fertig sind, können Sie das Profil zurücksetzen.

Laden eines neuen Besucherprofils mit dem Symbol „Profil laden“

  1. Klicken Sie auf das Symbol „Profil laden“:

    Das ClientContext-Symbol „Profil laden“

  2. Dadurch wird das Dialogfeld geöffnet. Hier können Sie das zu ladende Profil auswählen:

    Das Dialogfeld „Profil-Lader“ mit der Dropdown-Liste zur Profilauswahl

  3. Klicken Sie auf OK, um das Profil zu laden.

Laden neuer Benutzerprofile mit dem Auswahlregler

Sie können ein Profil auch mit dem Auswahlregler auswählen:

  1. Doppelklicken Sie auf das Symbol für den aktuellen Benutzer. Der Selektor wird geöffnet. Navigieren Sie mit den Pfeilen und sehen Sie sich die verfügbaren Profile an:

    Die Benutzerauswahl

  2. Klicken Sie auf das zu ladende Profil. Wenn die Details geladen wurden, klicken Sie auf eine Stelle außerhalb der Auswahl, um diese zu schließen.

Zurücksetzen des Profils auf den aktuellen Benutzer

  1. Setzen Sie das Profil in ClientContext mit dem Symbol „Zurücksetzen“ auf den aktuellen Benutzer zurück:

    Das Symbol „Zurücksetzen“

Ändern der Browser-Plattform

  1. Doppelklicken Sie auf das Symbol, das die Browser-Plattform darstellt. Der Selektor wird geöffnet. Navigieren Sie mit den Pfeilen zu den verfügbaren Plattformen/Browsern und sehen Sie sie an:

    Browser-Plattformauswahl

  2. Klicken Sie auf den zu ladenden Plattform-Browser. Wenn die Details geladen wurden, klicken Sie auf eine Stelle außerhalb der Auswahl, um diese zu schließen.

Ändern der Geolocation

  1. Doppelklicken Sie auf das Geolocation-Symbol. Eine erweiterte Zuordnung wird geöffnet. Hier können Sie die Markierung an eine neue Position ziehen:

    Standortdetails

  2. Klicken Sie auf eine Stelle außerhalb der Karte, um sie zu schließen.

Ändern der Tag-Auswahl

  1. Doppelklicken Sie auf den Abschnitt Tag Cloud des ClientContext. Das Dialogfeld wird geöffnet. Hier können Sie Tags auswählen:

    Tag-Cloud-Dialogfeld

  2. Klicken Sie auf „OK“, um Ihre Auswahl in ClientContext zu laden.

Bearbeiten von ClientContext

Mittels ClientContext-Bearbeitung können die Werte bestimmter Eigenschaften festgelegt (oder zurückgesetzt), neue Eigenschaften hinzugefügt oder nicht mehr benötigte Eigenschaften entfernt werden.

Bearbeiten von Eigenschaftsdetails

Mittels ClientContext-Bearbeitung können die Werte bestimmter Eigenschaften festgelegt (zurückgesetzt) werden. So können Sie bestimmte Szenarien testen. (Dies ist besonders nützlich bei Segmentierungen und Kampagnen.)

Bearbeiten von ClientContext

Hinzufügen von Eigenschaftskomponenten

Nachdem Sie die ClientContext-Designseite können Sie auch Hinzufügen eine vollständig neue Eigenschaft mit den verfügbaren Komponenten (die Komponenten werden sowohl im Sidekick als auch aus dem Neue Komponente einfügen Dialogfeld, das nach einem Doppelklick auf die Komponenten oder Assets hierher ziehen -Feld):

Hinzufügen einer Eigenschaft zum ClientContext-Fenster

Entfernen von Eigenschaftskomponenten

Nach dem Öffnen der ClientContext-Design-Seite haben Sie außerdem die Möglichkeit, nicht mehr benötigte Eigenschaften zu entfernen, auch standardmäßig vorhandene Eigenschaften. Wurden diese entfernt, können Sie sie mit Zurücksetzen aktivieren.

Speichern von Daten in ClientContext über JSONP

Folgen Sie diesem Beispiel, um die Kontextspeicher-Komponente „JSONP-Store“ zum Hinzufügen externer Daten zu ClientContext zu verwenden. Erstellen Sie dann ein Segment basierend auf den Informationen aus diesen Daten. Im Beispiel wird der JSONP-Dienst von WIPmania.com verwendet. Der Dienst gibt Geolocation-Informationen anhand der IP-Adresse des Webclients zurück.

In diesem Beispiel wird die Beispiel-Website Geometrixx Outdoors verwendet, um auf ClientContext zuzugreifen und das erstellte Segment zu testen. Sie können eine andere Website verwenden, sofern für die Seite ClientContext aktiviert ist. (Siehe Hinzufügen von ClientContext zu einer Seite.)

Hinzufügen der Komponente „JSONP-Store“

Fügen Sie die Komponente „JSONP-Store“ zu ClientContext hinzu und nutzen Sie diese zum Abrufen und Speichern von Geolocation-Informationen zum Webclient.

  1. Öffnen Sie die englische Homepage der Geometrixx Outdoors-Site in der AEM-Autoreninstanz. (https://localhost:4502/content/geometrixx-outdoors/en.html).

  2. Drücken Sie zum Öffnen von ClientContext die Tastenkombination Strg+Alt+C (Windows) oder Ctrl+Wahl+C (Mac).

  3. Klicken Sie auf das Bearbeitungssymbol oben in Client Context, um Client Context-Designer zu öffnen.

    Link-Symbol

  4. Ziehen Sie die Komponente „JSONP-Store“ in ClientContext.

    Ziehen und Ablegen der Komponente „JSONP-Store“ in ClientContext

  5. Doppelklicken Sie auf die Komponente, um das Bearbeitungsdialogfeld zu öffnen.

  6. Geben Sie in das Feld „JSONP-Service-URL“ die folgende URL ein und klicken Sie dann auf „Store abrufen“:

    https://api.wipmania.com/jsonp?callback=${callback}

    Die Komponente ruft den JSONP-Dienst auf und listet alle Eigenschaften auf, die die zurückgegebenen Daten enthalten. Die Eigenschaften in der Liste entsprechen den in ClientContext verfügbaren Eigenschaften.

    Die Eigenschaften des JSONP-Dienstes

  7. Klicken Sie auf OK.

  8. Kehren Sie zur Geometrixx Outdoors-Startseite zurück und aktualisieren Sie diese. ClientContext umfasst nun die Informationen aus der Komponente „JSONP-Store“.

    Beispiel der mit Daten aufgefüllten JSONP-Komponente

Erstellen von Segmenten

Verwenden Sie die Daten aus dem Sitzungs-Store, den Sie mit der Komponente „JSONP-Store“ erstellt haben. Das Segment verwendet den Breitengrad aus dem Sitzungs-Store und das aktuelle Datum, um zu bestimmen, ob am Kundenstandort Winter herrscht.

  1. Öffnen Sie die Tools-Konsole in Ihrem Webbrowser (https://localhost:4502/miscadmin#/etc).

  2. Klicken Sie in der Ordnerstruktur auf den Ordner „Tools/Segmentation“ und dann auf „Neu“ > „Neuer Ordner“. Geben Sie die folgenden Eigenschaftswerte an und klicken Sie dann auf „Erstellen“:

    • Name: meinesegmente
    • Titel: Meine Segmente
  3. Wählen Sie den Ordner „Meine Segmente“ aus und klicken Sie auf „Neu“ > „Neue Seite“:

    1. Geben Sie „Winter“ als Titel ein.
    2. Wählen Sie die Vorlage „Segment“ aus.
    3. Klicken Sie auf „Erstellen“.
  4. Klicken Sie mit der rechten Maustaste auf das Segment „Winter“ und dann auf „Öffnen“.

  5. Ziehen Sie „Generische Store-Eigenschaft“ in den standardmäßigen UND-Container.

    Hinzufügen einer Komponente zum Segmenteditor

  6. Doppelklicken Sie auf die Komponente, um das Bearbeitungsdialogfeld zu öffnen. Geben Sie die folgenden Eigenschaftswerte an und klicken Sie dann auf „OK“:

    • Store: wipmania
    • Eigenschaftsname: Breite
    • Operator: ist größer als
    • Eigenschaftswert: 30
  7. Ziehen die Komponente „Skript“ in denselben UND-Container und öffnen Sie das zugehörige Bearbeitungsdialogfeld. Fügen Sie das folgende Skript hinzu und klicken Sie dann auf „OK“:

    3 < new Date().getMonth() < 12

Auf dieser Seite