ClientContext

Hinweis

ClientContext wurde durch ContextHub abgelöst. For more details, see the related [configuration]ch-configuring.md) and developer documenatation.

Der Client-Kontext ist ein Mechanismus, mit dem Sie bestimmte Informationen über die aktuelle Seite und den aktuellen Besucher erhalten. It can be opened using Ctrl-Alt-c (windows) or control-option-c (Mac):

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

  • dem Besucher; abhängig von Ihrer Instanz werden bestimmte Informationen angefordert oder abgeleitet;
  • Seiten-Tags und Häufigkeit, mit der der aktuelle Besucher auf diese Tags zugegriffen hat (wird beim Zeigen mit der Maus auf ein bestimmtes Tag angezeigt);
  • 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:

Verfügbare ClientContext-Komponenten

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

Surfer-Informationen Zeigt die folgenden clientseitigen Informationen an:

  • die IP-Adresse
  • Suchbegriffe , die für Suchmaschinenverweise verwendet werden
  • der verwendete Browser
  • das Betriebssystem , das verwendet wird
  • die Bildschirmauflösung
  • X-Position der Maus
  • die Y -Position der Maus

Aktivität Stream : Hier erhalten Sie Informationen zur sozialen Aktivität des Benutzers auf verschiedenen Plattformen. zum Beispiel die AEM Foren, Blogs, Ratings 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 Auflösung der Kampagne basiert normalerweise auf der Eigenschaft priority der Kampagne. Das Erlebnis wird im Regelfall auf Grundlage der Segmentierung ausgewählt.

Warenkorb zeigt Informationen zum Warenkorb einschließlich Produkteinträgen (Titel, Menge, PreisFormatiert usw.), gelöste Promotions (Titel, Nachricht usw.) und Gutscheine (Code, Beschreibung usw.).

Der Warenkorbsitzungsstore benachrichtigt mit dem ClientContextCartServlet zudem den Server über aufgelöste Promotionsänderungen (basierend auf Segmentierungsänderungen).

Generischer Store ist eine allgemeine Komponente, die den Inhalt eines Speichers anzeigt. Es handelt sich 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 ist eine allgemeine Komponente, die den Inhalt eines Stores anzeigt. Es handelt sich um eine übergeordnete Version der Komponente „Generischer Store“.

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

Geografischer Standort zeigt den Breiten- und Längengrad des Clients 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 der Kontext-Cloud nutzt die Komponente eine Google-API, um eine Karte als Miniatur darzustellen. Die Komponente unterliegt den Nutzungsbeschränkungen der Google-API.

Hinweis

In AEM 6.1 bietet der Geolocation-Store nicht länger die Reverse Geocoding-Funktion. Deshalb ruf der Geolocation-Store nicht mehr Details zum aktuellen Standort ab, etwa Ortsnamen oder Ländercodes. Segmente, die diesen Store verwenden, funktionieren nicht ordnungsgemäß. Der Geolocation-Store enthält nur den Breiten- und Längengrad eines Standorts.

JSONP Store Eine Komponente, die Inhalte anzeigt, die von Ihrer Installation abhängig sind.

Der JSON-Standard ist eine JSON-Ergänzung, mit der dieselbe ursprüngliche Richtlinie umgangen werden kann (sodass eine Web-App mit Servern in einer anderen Domäne kommunizieren kann). It consists in wrapping the JSON object in a function call in order to be able load it as a <script> from the other domain (which is an allowed exception to the same origin policy).

Der JSONP-Store ist zwar wie jeder andere Store, er lädt allerdings Informationen aus einer anderen Domäne, ohne dass für diese Informationen ein Proxy in der aktuellen Domäne 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.

Profil Data zeigt Informationen, die im Profil des Benutzers erfasst wurden. z. B. Geschlecht, Alter, E-Mail-Adresse usw.

Gelöste Segmente Zeigt an, welche Segmente zurzeit aufgelöst werden (häufig abhängig von anderen im Kundenkontext angezeigten Informationen). Dies ist beim Konfigurieren von Kampagnen von Interesse.

Beispiel: die Frage, ob sich die Maus aktuell im linken oder rechten Fensterbereich befindet. Dieses Segment wird hauptsächlich zum Testen verwendet, da Änderungen sofort angezeigt werden können.

Social Graph zeigt das soziale Diagramm der Freunde und Anhänger des Benutzers.

Hinweis

Dieses Feature ist derzeit als Demofunktion verfügbar und auf vorkonfigurierte Datensätze im Profilknoten unserer Demobenutzer angewiesen. Beispiel:

/home/users/geometrixx/aparker@geometrixx.info/profile => friends-Eigenschaft

Tag Cloud zeigt Tags, die auf der aktuellen Seite festgelegt wurden, sowie Tags, die beim Surfen auf der Site gesammelt wurden. 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.

Technographics Store Diese Komponente ist von Ihrer Installation abhängig.

Angezeigte Produkte Hält die Produkte, die der Käufer angesehen hat, im Auge. Es kann das zuletzt angesehene Produkt oder das zuletzt angesehene Produkt, das sich nicht bereits im Warenkorb befindet, abgerufen werden.

Dieser Sitzungsstore 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 verschiedener Benutzer beim Anzeigen 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 neuer Benutzerprofile

Sie können ein Profil wie folgt ändern:

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

Laden neuer Besucherprofile mit dem Symbol „Profil laden“

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

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

  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. Daraufhin wird die Auswahl geöffnet. Navigieren Sie mit den Pfeilen und sehen Sie sich die verfügbaren Profile an:

  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:

Ändern der Browserplattform

  1. Doppelklicken Sie auf das Symbol für die Browserplattform. Daraufhin wird die Auswahl geöffnet. Navigieren Sie mit den Pfeilen und sehen Sie sich die verfügbaren Plattformen/Browser an:

  2. Klicken Sie auf den zu ladenden Plattformbrowser. 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. Daraufhin wird eine erweiterte Karte geöffnet. Hier können Sie die Markierung an einen neuen Standort ziehen:

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

Ändern der Tag-Auswahl

  1. Doppelklicken Sie auf den ClientContext-Abschnitt „Tag-Cloud“. Daraufhin wird das zugehörige Dialogfeld geöffnet. Hier können Sie Tags auswählen:

  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 (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. This allows you to test specific scenarios (particularly useful for segmentation and campaigns).

Hinzufügen von Eigenschaftskomponenten

After you have opened the ClientContext design page, you can also Add a completely new property using the available components (the components are listed on both the sidekick or from the Insert New Component dialog that is opened after a double-click on the Drag components or assets here box):

Entfernen von Eigenschaftskomponenten

Nach dem Öffnen der ClientContext-Designseite 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 reaktivieren.

Speichern von Daten in ClientContext über JSON

Folgen Sie diesem Beispiel, um die Context-Store-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-Service von WIPmania.com verwendet. Der Service 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 Seiten.)

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. Um den Client-Kontext zu öffnen, drücken Sie Strg-Alt-c (Fenster) oder Strg-Option-c (Mac).

  3. Klicken Sie oben im ClientContext-Bereich auf das Bearbeitungssymbol, um ClientContext-Designer zu öffnen.

  4. Ziehen Sie die Komponente „JSONP-Store“ auf 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-Service auf und führt alle Eigenschaften auf, die die zurückgegebenen Daten enthalten. Die Eigenschaften in der Liste entsprechen den in ClientContext verfügbaren Eigenschaften.

  7. Klicken Sie auf OK.

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

Erstellen von Segmenten

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

  1. Open the Tools console in your web browser (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: mysegments
    • Titel: My Segments
  3. Wählen Sie den Ordner „My Segments“ 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.

  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