Einrichten der Ereignisweiterleitung mit Platform Web SDK-Daten
Erfahren Sie, wie Sie die Ereignisweiterleitung mit Daten von Adobe Experience Platform Web SDK verwenden.
Die Ereignisweiterleitung ist ein neuer Eigenschaftstyp, der in der Datenerfassung verfügbar ist. Die Ereignisweiterleitung bietet Ihnen die Möglichkeit, Daten direkt über das Adobe Experience Platform-Edge Network anstelle des herkömmlichen Client-seitigen Adobe-Browsers an Drittanbieter zu senden, bei denen es sich nicht um Anbieter handelt. Erfahren Sie mehr über die Vorteile der Ereignisweiterleitung in der Übersicht über die Ereignisweiterleitung.
Um die Ereignisweiterleitung in Adobe Experience Platform zu verwenden, müssen Daten zuerst mithilfe einer oder mehrerer der folgenden drei Optionen an das Adobe Experience Platform-Edge Network gesendet werden:
Nach Abschluss der vorherigen Lektionen in diesem Tutorial sollten Sie Daten mithilfe der Web-SDK an Platform Edge Network senden. Sobald sich die Daten in Platform Edge Network befinden, können Sie die Ereignisweiterleitung aktivieren und eine Ereignisweiterleitungseigenschaft verwenden, um Daten an Nicht-Adobe-Lösungen zu senden.
Lernziele
Am Ende dieser Lektion haben Sie folgende Möglichkeiten:
- Erstellen einer Ereignisweiterleitungs-Eigenschaft
- Verknüpfen einer Ereignisweiterleitungseigenschaft mit einem Platform Web SDK-Datenstrom
- Machen Sie sich mit den Unterschieden zwischen Datenelementen und Regeln für Tag-Eigenschaften und Datenelementen und Regeln für die Ereignisweiterleitung vertraut
- Erstellen eines Datenelements für die Ereignisweiterleitung
- Konfigurieren einer Ereignisweiterleitungsregel
- Überprüfen, ob eine Ereignisweiterleitungseigenschaft Daten erfolgreich sendet
Voraussetzungen
-
Eine Softwarelizenz, die die Ereignisweiterleitung enthält. Die Ereignisweiterleitung ist eine gebührenpflichtige Funktion der Datenerfassung. Weitere Informationen erhalten Sie von Ihrem Adobe Account Team.
-
Die Ereignisweiterleitung ist in Ihrer Experience Cloud-Organisation aktiviert.
-
Benutzerberechtigung für die Ereignisweiterleitung. (In Admin Consoleunter dem Adobe Experience Platform Launch-Produkt Berechtigungselemente fürPlattformen > Edge alle Eigenschaftsrechte). Nach der Gewährung im linken Navigationsbereich Datenerfassungsoberfläche „Ereignisweiterleitung“ angezeigt werden:
-
Adobe Experience Platform Web oder Mobile SDK ist so konfiguriert, dass Daten an Edge Network gesendet werden. Sie müssen die folgenden Lektionen dieses Tutorials abgeschlossen haben:
Erstellen einer Ereignisweiterleitungs-Eigenschaft
Erstellen Sie zunächst eine Ereignisweiterleitungs-Eigenschaft:
-
Öffnen Sie die Datenerfassungsschnittstelle
-
Wählen Sie linken Navigationsbereich Ereignisweiterleitung“ aus
-
Wählen Sie Neue Eigenschaft aus.
-
Benennen Sie die Eigenschaft. In diesem Fall
Server-Side - Web SDK Course -
Wählen Sie Speichern aus.
Konfigurieren des Datenstroms
Damit die Ereignisweiterleitung die Daten verwenden kann, die Sie an das Platform-Edge Network senden, müssen Sie die neu erstellte Ereignisweiterleitungseigenschaft mit demselben Datenstrom verknüpfen, der zum Senden von Daten an Adobe-Lösungen verwendet wird.
So konfigurieren Sie Target im Datenstrom:
-
Zur Datenerfassung wechseln
-
Wählen Sie in der linken Navigation Datenströme
-
Wählen Sie den zuvor erstellten
Luma Web SDK: Development Environmentaus
-
Wählen Sie Service hinzufügen
-
Wählen Sie Ereignisweiterleitung als Service
-
Wählen Sie Dropdown- „Eigenschafts-ID“ den Namen aus, den Sie Ihrer Ereignisweiterleitungs-Eigenschaft gegeben haben, in diesem Fall
Server-Side - Web SDK Course -
Wählen Sie Dropdown- „Umgebungs-ID“ die Tag-Umgebung aus, mit der Sie die Ereignisweiterleitungsumgebung verknüpfen, in diesem Fall
Developmentnote tip TIP Um Daten an eine Ereignisweiterleitungsumgebung außerhalb der Adobe-Organisation zu senden, wählen Sie IDs manuell eingeben und fügen Sie eine ID ein. Die ID wird bereitgestellt, wenn Sie eine Ereignisweiterleitungseigenschaft erstellen. -
Wählen Sie Speichern aus.
Wiederholen Sie diese Schritte für Staging- und Produktions-Datenströme, wenn Sie bereit sind, Ihre Änderungen über den Publishing-Ablauf weiterzuleiten.
Weiterleiten von Daten vom Platform-Edge Network an eine Nicht-Adobe-Lösung
In dieser Übung erfahren Sie, wie Sie ein Datenelement für die Ereignisweiterleitung einrichten, eine Regel für die Ereignisweiterleitung konfigurieren und mit dem Tool eines Drittanbieters namens „Webhooksite“.
Erstellen eines Datenelements für die Ereignisweiterleitung
Das XDM-Objekt, das Sie zuvor mit der Tag-Erweiterung „Platform Web SDK" konfiguriert haben, wird zur Datenquelle für Datenelemente in einer Ereignisweiterleitungseigenschaft. Sie verwenden dieselben Daten, die Sie bereits in der Tag-Eigenschaft als Datenquelle für die Ereignisweiterleitung konfiguriert haben.
arc.event Präfix enthalten:arcsteht für Adobe Response Context.- Beispiel:
arc.event.xdm.web.webPageDetails.URL
In dieser Übung leiten Sie die Höhe des Browser-Viewports und die Experience Cloud-ID vom XDM-Objekt an einen Webhook weiter. Der XDM-Feldpfad wird durch das XDM-Schema bestimmt, das während der Lektion Konfigurieren eines XDM-Schemas erstellt wurde.
/ee-Anfragen filtern, den Beacon Payload öffnen und eine Drilldown-Liste für die gesuchte Variable durchführen. Klicken Sie dann mit der rechten Maustaste und wählen Sie „Eigenschaftspfad kopieren“. Im Folgenden finden Sie ein Beispiel für die Höhe des Browser-Ansichtsfensters:
-
Navigieren Sie zur Eigenschaft Ereignisweiterleitung, die Sie kürzlich erstellt haben
-
Wählen Sie in der linken Navigation Datenelemente
-
Wählen Sie Neues Datenelement erstellen aus
-
Name das Datenelement
environment.browserDetails.viewportHeight -
Lassen unter ""
CORE -
Wählen unter „Datenelementtyp die Option
Path -
Geben Sie den XDM-Objektpfad ein, der die Browser-Viewport-
arc.event.xdm.environment.browserDetails.viewportHeightenthält -
Wählen Sie Speichern
-
Ein weiteres Datenelement erstellen
-
Name sie
ecid -
Lassen unter ""
CORE -
Wählen unter „Datenelementtyp die Option
Path -
Geben Sie den XDM-Objektpfad ein, der die Experience Cloud-ID
arc.event.xdm.identityMap.ECID.0.identhält -
Wählen Sie Speichern
note caution CAUTION Stellen Sie sicher, dass Sie das arc.event.Präfix in den Pfad einschließen. Achten Sie außerdem darauf, die exakte Groß-/Kleinschreibung als XDM-Objektfeldname zu verwenden. Der ECID-Namespace muss in Großbuchstaben angegeben werden.note tip TIP Wenn Sie mit Ihrer eigenen Website arbeiten, können Sie den XDM-Objektpfad mit Ihren Webbrowser-Netzwerkwerkzeugen finden, nach /eefiltern, den Beacon Payload öffnen und zur gesuchten Variablen aufschlüsseln. Klicken Sie dann mit der rechten Maustaste und wählen Sie „Eigenschaftspfad kopieren“. Im Folgenden finden Sie ein Beispiel für die Höhe des Browser-Ansichtsfensters:
Installieren der Adobe Cloud Connector-Erweiterung
Um Daten an Standorte von Drittanbietern zu senden, installieren Sie zunächst die Erweiterung Adobe Cloud Connector.
-
Wählen Erweiterungen im linken Navigationsbereich aus.
-
Wählen Sie die Katalog aus
-
Suchen Sie nach dem Adobe Cloud Connector und wählen Sie Installieren
Es ist keine Erweiterungskonfiguration erforderlich. Mit dieser Erweiterung können Sie jetzt Daten an eine Nicht-Adobe-Lösung weiterleiten!
Erstellen einer Regel für die Ereignisweiterleitung
Es gibt einige Hauptunterschiede zwischen dem Konfigurieren von Regeln in einer Tag-Eigenschaft und einer Regel in einer Ereignisweiterleitungs-Eigenschaft:
-
Ereignisse und Bedingungen:
- Tags: Alle Regeln werden durch ein Ereignis ausgelöst, das in der Regel angegeben werden muss, z. B.
Library Loaded - Page Top. Bedingungen sind optional. - Ereignisweiterleitung: Es wird davon ausgegangen, dass jedes an das Platform-Edge Network gesendete Ereignis ein Trigger zur Datenweiterleitung ist. Daher gibt es keine Ereignisse die in den Regeln für die Ereignisweiterleitung ausgewählt werden müssen. Um zu verwalten, welcher Trigger eine Ereignisweiterleitungsregel ist, müssen Sie Bedingungen konfigurieren.
- Tags: Alle Regeln werden durch ein Ereignis ausgelöst, das in der Regel angegeben werden muss, z. B.
-
Datenelement-Tokenisierung:
-
Tags: Datenelementnamen werden am Anfang und am Ende des Datenelementnamens mit einem
%versehen, wenn sie in einer Regel verwendet werden. Beispiel:%viewportHeight%. -
Ereignisweiterleitung: Namen von Datenelementen werden mit
{{am Anfang und}}am Ende des Datenelementnamens versehen, wenn sie in einer Regel verwendet werden. Beispiel:{{viewportHeight}}.
-
-
Sequenz von:
- Der Abschnitt Aktionen einer Ereignisweiterleitungsregel wird immer nacheinander ausgeführt. Stellen Sie beim Speichern einer Regel sicher, dass die Reihenfolge der Aktionen korrekt ist. Diese Ausführungsreihenfolge kann im Gegensatz zu Tags nicht asynchron ausgeführt werden.
Um eine Regel für die Weiterleitung von Daten an Ihren Webhook zu konfigurieren, müssen Sie zunächst Ihren persönlichen Webhook abrufen:
-
Navigieren Sie zu Webhook.site
-
Suchen Sie Ihre eindeutige URL und verwenden Sie diese als URL-Anfrage in Ihrer Ereignisweiterleitungsregel
-
Wählen Sie In Zwischenablage kopieren
-
Lassen Sie dieses Fenster geöffnet, da Sie die Ereignisweiterleitungsdaten in Echtzeit überprüfen können, die von Webhook erfasst werden
-
Gehen Sie linken Navigationsbereich zurück Datenerfassung > Ereignisweiterleitung > Regeln.
-
Wählen Sie Neue Regel erstellen
-
Benennen Sie ihn
all events - ad cloud connector - webhook -
Aktion hinzufügen
-
Wählen unter "" den Adobe-Cloud-Connector aus
-
Wählen unter „Aktionstyp die Option Abrufaufruf ausführen
-
Fügen Sie Ihre Webhook-URL in das Feld URL ein
-
Unter [Abfrageparameter] fügen Sie beide zuvor erstellten Datenelemente hinzu.
-
Auf der Schlüssel Spaltentyp in
viewPortHeight. Geben Sie in Spalte Wert“ das{{environment.browserDetails.viewportHeight}}Datenelement ein, indem Sie es eingeben oder aus dem Datenelement-Auswahlsymbol auswählen -
Wählen Sie + Weitere hinzufügen aus um einen weiteren Abfrageparameter hinzuzufügen
-
Auf der Schlüssel Spaltentyp in
ecid. Geben Sie in der Spalte Wert das{{ecid}}Datenelement ein -
Wählen Änderungen beibehalten
-
Ihre Regel sollte wie folgt aussehen
-
Wählen Sie Speichern
Bibliothek erstellen
Erstellen Sie eine Bibliothek und erstellen Sie alle Änderungen an Ihrer Entwicklungsumgebung für die Ereignisweiterleitung wie gewohnt in einer Tag-Eigenschaft.
Validieren der Ereignisweiterleitungsregel
Jetzt können Sie Ihre Ereignisweiterleitungseigenschaft mit dem Platform Debugger und Webhook.site überprüfen:
-
Führen Sie die Schritte aus um die TagBibliothek auf der Luma Demo-Site auf die Tag-Eigenschaft von Web SDK zu wechseln, der Sie Ihre Ereignisweiterleitungs-Eigenschaft im Datenstrom zugeordnet haben.
-
Bevor Sie die Seite neu laden, öffnen Sie im Experience Platform-Debugger Protokolle im linken Navigationsbereich
-
Wählen Sie die Registerkarte Edge und dann Verbinden aus, um die Platform-Edge Network-Anfragen anzuzeigen
-
Seite neu laden
-
Es werden zusätzliche Anfragen angezeigt, die Ihnen Einblick in die Server-seitigen Anfragen geben, die vom Platform-Edge Network an den WebHook gesendet werden
-
Die Anforderung, auf die die Validierung konzentriert werden soll, ist diejenige, die die vollständig aufgebaute URL anzeigt, die vom Edge-Netzwerk gesendet wird
-
Beachten Sie die Abfragezeichenfolgenparameter viewPortHeight und ecid
-
Sie entsprechen den im XDM-Objekt angezeigten Daten
-
Überprüfen Sie abschließend die Datenübereinstimmungen in Webhook.site und indem Sie Ihr geöffnetes Webhook-Fenster anzeigen
Herzlichen Glückwunsch! Sie haben die Ereignisweiterleitung konfiguriert!