Einrichten einer Ereignisweiterleitungs-Eigenschaft
Erfahren Sie, wie Sie die Ereignisweiterleitungs-Eigenschaft mithilfe von Experience Platform Web SDK-Daten verwenden.
Die Ereignisweiterleitung ist ein neuer Eigenschaftstyp, der in der Datenerfassung verfügbar ist. Mit der Ereignisweiterleitung können Sie Daten direkt vom Adobe Experience Platform Edge Network an Drittanbieter senden, die keine Adobe sind, und nicht an den herkömmlichen Client-seitigen Browser. Erfahren Sie mehr über die Vorteile der Ereignisweiterleitung im Übersicht über die Ereignisweiterleitung.
Um die Ereignisweiterleitung in Adobe Experience Platform zu verwenden, müssen Daten zunächst mit einer oder mehreren der folgenden drei Optionen an Adobe Experience Platform Edge Network gesendet werden:
Nach Abschluss der vorherigen Lektionen in diesem Tutorial sollten Sie mithilfe des Web SDK Daten an Platform Edge Network senden. Sobald sich die Daten im 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 können Sie:
- Erstellen einer Ereignisweiterleitungs-Eigenschaft
- Verknüpfen einer Ereignisweiterleitungs-Eigenschaft mit einem Platform Web SDK-Datenspeicher
- Machen Sie sich mit den Unterschieden zwischen den Datenelementen und Regeln der Tag-Eigenschaft und den Datenelementen und Regeln der Ereignisweiterleitung vertraut.
- Erstellen eines Datenelements für die Ereignisweiterleitung
- Ereignisweiterleitungsregel konfigurieren
- Ü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 wurde in Ihrer Experience Cloud-Organisation aktiviert.
-
Benutzerberechtigung für die Ereignisweiterleitung. (in Admin Console, unter dem Adobe Experience Platform Launch-Produkt, Berechtigungselemente fürPlattformen > Edge und alle Eigenschaftsrechte). Nach der Erteilung sollte Ereignisweiterleitung im linken Navigationsbereich der Datenerfassungsoberfläche:
-
Adobe Experience Platform Web oder Mobile SDK konfiguriert, um Daten an Edge Network zu senden. Sie müssen die folgenden Lektionen dieses Tutorials abgeschlossen haben:
-
Erstkonfiguration
-
Tag-Konfiguration
-
Erstellen einer Ereignisweiterleitungs-Eigenschaft
Erstellen Sie zunächst eine Ereignisweiterleitungs-Eigenschaft:
-
Öffnen Sie die Datenerfassungsoberfläche
-
Auswählen Ereignisweiterleitung über die linke Navigation
-
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 Datenspeichers
Damit die Ereignisweiterleitung die an das Edge-Netzwerk gesendeten Daten verwenden kann, müssen Sie die neu erstellte Ereignisweiterleitungs-Eigenschaft mit demselben Datastream verknüpfen, der zum Senden von Daten an Adobe-Lösungen verwendet wird.
So konfigurieren Sie Target im Datastream:
-
Navigieren Sie zu Datenerfassung Benutzeroberfläche
-
Wählen Sie im linken Navigationsbereich die Option Datenspeicher
-
Wählen Sie die zuvor erstellte
Luma Web SDKdatastream
-
Wählen Sie Service hinzufügen aus
-
Auswählen Ereignisweiterleitung als Dienst
-
Unter dem Eigenschafts-ID Dropdown-Liste den Namen auswählen, den Sie Ihrer Ereignisweiterleitungs-Eigenschaft gegeben haben, in diesem Fall
Server-Side - Web SDK Course -
Unter dem Umgebungs-ID Dropdown-Liste die Tag-Umgebung auswählen, mit der Sie die Ereignisweiterleitungsumgebung verknüpfen, in diesem Fall
Developmentnote tip TIP Um Daten an eine Ereignisweiterleitungsumgebung außerhalb der Adobe-Org zu senden, wählen Sie IDs manuell eingeben und fügen Sie eine ID ein. Die ID wird bereitgestellt, wenn Sie eine Ereignisweiterleitungs-Eigenschaft erstellen. -
Wählen Sie Speichern aus.
Wiederholen Sie diese Schritte für Staging- und Produktionsdatenspeicher, wenn Sie bereit sind, Ihre Änderungen durch den Veröffentlichungsfluss zu fördern.
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 Ereignisweiterleitungsregel konfigurieren und mit einem Tool des dritten Teils, dem so genannten webhook.site.
Erstellen eines Datenelements für die Ereignisweiterleitung
Das XDM-Objekt, das Sie zuvor mit der Platform Web SDK-Tag-Erweiterung konfiguriert haben, wird zur Datenquelle für Datenelemente in einer Ereignisweiterleitungs-Eigenschaft. Sie verwenden dieselben Daten, die Sie bereits in der Tag-Eigenschaft konfiguriert haben, als Datenquelle für die Ereignisweiterleitung.
arc.event prefix: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 Pfad des XDM-Felds wird durch das XDM-Schema bestimmt, das während der Konfigurieren eines XDM-Schemas Lektion.
/ee Anforderungen, Beacon öffnen Nutzlast und bohren bis zur gesuchten Variablen. 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 Viewports:
-
Navigieren Sie zu Ereignisweiterleitung -Eigenschaft, die Sie kürzlich erstellt haben
-
Wählen Sie im linken Navigationsbereich die Option Datenelemente
-
Auswählen Neues Datenelement erstellen
-
Name das Datenelement
environment.browserDetails.viewportHeight -
under Erweiterung, verlassen
CORE -
under Datenelementtyp auswählen
Path -
Geben Sie den XDM-Objektpfad ein, der die Höhe des Browser-Viewports enthält.
arc.event.xdm.environment.browserDetails.viewportHeight -
Wählen Sie Speichern aus
-
Erstellen eines weiteren Datenelements
-
Name it
ecid -
under Erweiterung, verlassen
CORE -
under Datenelementtyp auswählen
Path -
Geben Sie den XDM-Objektpfad ein, der die Experience Cloud-ID enthält
arc.event.xdm.identityMap.ECID.0.id -
Wählen Sie Speichern aus
note caution CAUTION Stellen Sie sicher, dass Sie die arc.event.-Präfix im Pfad. Achten Sie außerdem darauf, den genauen Fall als XDM-Objektfeldname zu befolgen. Der ECID-Namespace muss in Großbuchstaben sein.note tip TIP Wenn Sie mit Ihrer eigenen Website arbeiten, können Sie den XDM-Objektpfad mit Ihren Webbrowser-Netzwerkwerkzeugen finden und nach /eeAnforderungen, Beacon öffnen Nutzlast und bohren bis zur gesuchten Variablen. 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 Viewports:
Installieren der Adobe Cloud Connector-Erweiterung
Um Daten an Drittanbieterstandorte zu senden, installieren Sie zunächst die Adobe Cloud Connector -Erweiterung.
-
Auswählen Erweiterungen im linken Navigationsbereich
-
Wählen Sie die Katalog tab
-
Suchen Sie nach Adobe Cloud Connector auswählen Installieren
Es ist keine Erweiterungskonfiguration erforderlich. Mit dieser Erweiterung können Sie jetzt Daten an eine Nicht-Adobe-Lösung weiterleiten!
Erstellen einer Ereignisweiterleitungsregel
Es gibt einige Hauptunterschiede zwischen dem Konfigurieren von Regeln in einer Tag-Eigenschaft und einer Regel in einer Ereignisweiterleitungs-Eigenschaft:
-
Veranstaltungen & Bedingungen:
- Tags: Alle Regeln werden durch ein Ereignis ausgelöst, das in der Regel angegeben werden muss, beispielsweise
Library Loaded - Page Top. Bedingungen sind optional. - Ereignisweiterleitung: Es wird davon ausgegangen, dass jedes Ereignis, das an Platform Edge Network gesendet wird, ein Trigger zum Weiterleiten von Daten ist. Daher gibt es keine Veranstaltungen muss in Ereignisweiterleitungsregeln ausgewählt werden. Um zu verwalten, welche Ereignisse Trigger einer Ereignisweiterleitungsregel sind, müssen Sie Bedingungen konfigurieren.
- Tags: Alle Regeln werden durch ein Ereignis ausgelöst, das in der Regel angegeben werden muss, beispielsweise
-
Tokenisierung von Datenelementen:
-
Tags: Datenelementnamen werden mit einem -Token versehen.
%am Anfang und am Ende des Datenelementnamens, wenn dieser in einer Regel verwendet wird. Beispiel:%viewportHeight%. -
Ereignisweiterleitung: Datenelementnamen werden mit einem -Token versehen.
{{am Anfang und}}am Ende des Datenelementnamens, wenn dieser in einer Regel verwendet wird. Beispiel:{{viewportHeight}}.
-
-
Sequenz von Regelaktionen:
- Der Abschnitt Aktionen einer Ereignisweiterleitungsregel wird immer nacheinander ausgeführt. Stellen Sie also 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 zum Weiterleiten von Daten an Ihren Webhook zu konfigurieren, müssen Sie zunächst Ihren persönlichen Webhook abrufen:
-
Navigieren Sie zu webhook.site
-
Suchen Ihre eindeutige URL verwenden, werden Sie dies als URL-Anfrage in Ihrer Ereignisweiterleitungsregel verwenden.
-
Auswählen In Zwischenablage kopieren
-
Lassen Sie dieses Fenster geöffnet, da Sie die Ereignisweiterleitungsdaten in Echtzeit überprüfen können, die von Webhook erfasst werden
-
Zurück Datenerfassung > Ereignisweiterleitung > Regeln über die linke Navigation
-
Auswählen Neue Regel erstellen
-
Benennen Sie ihn
all events - ad cloud connector - webhook -
Hinzufügen einer Aktion
-
under Erweiterung auswählen Adobe Cloud Connector
-
under Aktionstyp auswählen Abrufen eines Aufrufs
-
Fügen Sie Ihre Webhook-URL in die URL field
-
under [Abfrageparameter], fügen Sie beide zuvor erstellten Datenelemente hinzu.
-
Im Schlüssel Spaltentyp in
viewPortHeight. Im Wert die Spalte{{environment.browserDetails.viewportHeight}}Datenelement durch Eingabe in oder Auswahl über das Symbol für die Datenelementauswahl -
Auswählen + Hinzufügen weiterer Hinzufügen eines weiteren Abfrageparameters
-
Im Schlüssel Spaltentyp in
ecid. Geben Sie in der Spalte Wert die{{ecid}}Datenelement -
Auswählen Änderungen beibehalten
-
Ihre Regel sollte wie unten aussehen
-
Wählen Sie Speichern aus
Erstellen und Erstellen der Bibliothek
Erstellen Sie eine Bibliothek und erstellen Sie alle Änderungen an Ihrer Entwicklungsumgebung für die Ereignisweiterleitung, wie Sie es normalerweise in einer Tag-Eigenschaft tun würden.
Validieren der Ereignisweiterleitungsregel
Jetzt können Sie Ihre Eigenschaft für die Ereignisweiterleitung mit dem Platform Debugger und Webhook.site validieren:
-
Führen Sie die Schritte aus, um Tag-Bibliothek wechseln auf Demosite "Luma" zur Web SDK-Tag-Eigenschaft, der Sie Ihre Eigenschaft für die Ereignisweiterleitung im Datastream zugeordnet haben.
-
Bevor Sie die Seite neu laden, öffnen Sie auf dem Experience Platform Debugger Protokolle über die linke Navigation
-
Wählen Sie die Edge Registerkarte und wählen Sie Verbinden Anzeigen der Anforderungen des Platform Edge Network
-
Seite neu laden
-
Es werden zusätzliche Anfragen angezeigt, die Ihnen einen Einblick in die serverseitigen Anforderungen geben, die vom Platform Edge Network an WebHook gesendet werden.
-
Die Anfrage, die Validierung auf zu konzentrieren, zeigt die vollständig erstellte URL, die vom Edge-Netzwerk gesendet wird.
-
Beachten Sie die Abfragezeichenfolgenparameter viewPortHeight und ecid .
-
Sie stimmen mit den im XDM-Objekt angezeigten Daten überein.
-
Überprüfen Sie abschließend die Datenübereinstimmungen in webhook.site sowie durch Ansicht des geöffneten Webhook-Fensters
Herzlichen Glückwunsch! Sie haben die Ereignisweiterleitung konfiguriert!