Einrichten einer Ereignisweiterleitungs-Eigenschaft

Erfahren Sie, wie Sie die Ereignisweiterleitungs-Eigenschaft mit 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 ohne Adobe und nicht an den herkömmlichen Client-seitigen Browser senden. Weitere Informationen zu den Vorteilen der Ereignisweiterleitung finden Sie im Abschnitt Ü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:

• Adobe Experience Platform Web SDK
• Adobe Experience Platform Mobile SDK

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

    • Berechtigungen konfigurieren
    • Konfigurieren eines XDM-Schemas
    • Identitäts-Namespace konfigurieren
    • Konfigurieren eines Datenstroms

  • Tag-Konfiguration

    • Installieren der Web SDK-Erweiterung
    • Erstellen von Datenelementen
    • Tag-Regel erstellen
    • Überprüfen mit dem Adobe Experience Platform-Debugger

Erstellen einer Ereignisweiterleitungs-Eigenschaft

Erstellen Sie zunächst eine Ereignisweiterleitungs-Eigenschaft:

1. Öffnen Sie die Datenerfassungsoberfläche

2. Auswählen Ereignisweiterleitung über die linke Navigation

3. Wählen Sie Neue Eigenschaft aus.
   

4. Benennen Sie die Eigenschaft. In diesem Fall Server-Side - Web SDK Course

5. 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:

1. Navigieren Sie zu Datenerfassung Benutzeroberfläche

2. Wählen Sie im linken Navigationsbereich die Option Datenspeicher

3. Wählen Sie die zuvor erstellte Luma Web SDK datastream

   

4. Wählen Sie Service hinzufügen aus
   

5. Auswählen Ereignisweiterleitung als Diensleistung

6. 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

7. Unter dem Umgebungs-ID Dropdown-Liste die Tag-Umgebung auswählen, mit der Sie die Ereignisweiterleitungsumgebung verknüpfen, in diesem Fall Development

   TIPP

   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 Ereignisweiterleitungs-Eigenschaft erstellen.

8. 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.

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.

1. Navigieren Sie zu Ereignisweiterleitung -Eigenschaft, die Sie kürzlich erstellt haben

2. Wählen Sie im linken Navigationsbereich die Option Datenelemente

3. Auswählen Neues Datenelement erstellen

   

4. ​​Benennen Sie das Datenelement . environment.browserDetails.viewportHeight

5. under Erweiterung, verlassen CORE

6. under Datenelementtyp auswählen Path

7. Geben Sie den XDM-Objektpfad ein, der die Höhe des Browser-Viewports enthält. arc.event.xdm.environment.browserDetails.viewportHeight

8. Wählen Sie Speichern aus

   

9. Erstellen eines weiteren Datenelements

10. ​​Benennen Sie sie ecid

11. under Erweiterung, verlassen CORE

12. under Datenelementtyp auswählen Path

13. Geben Sie den XDM-Objektpfad ein, der die Experience Cloud-ID enthält arc.event.xdm.identityMap.ECID.0.id

14. Wählen Sie Speichern aus

    

    VORSICHT

    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.

    TIPP

    Wenn Sie mit Ihrer eigenen Website arbeiten, können Sie den XDM-Objektpfad mit Ihren Webbrowser-Netzwerkwerkzeugen finden und nach /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:
    

Installieren der Adobe Cloud Connector-Erweiterung

Um Daten an Drittanbieterstandorte zu senden, installieren Sie zunächst die Adobe Cloud Connector -Erweiterung.

1. Auswählen Erweiterungen im linken Navigationsbereich

2. Wählen Sie die Katalog tab

3. 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, z. B. Library Loaded - Page Top. Bedingungen sind optional.
  • Ereignisweiterleitung: Es wird davon ausgegangen, dass jedes Ereignis, das an Platform Edge Network gesendet wird, ein Trigger zur Weiterleitung 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.

• 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 sequentiell 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:

1. Navigieren Sie zu webhook.site

2. Suchen Ihre eindeutige URL verwenden, werden Sie dies als URL-Anfrage in Ihrer Ereignisweiterleitungsregel verwenden.

3. Auswählen In Zwischenablage kopieren

4. Lassen Sie dieses Fenster geöffnet, da Sie die Ereignisweiterleitungsdaten in Echtzeit überprüfen können, die von Webhook erfasst werden

   

5. Zurück Datenerfassung > Ereignisweiterleitung > Regeln über die linke Navigation

6. Wählen Sie Neue Regel erstellen aus

   

7. Benennen Sie sie all events - ad cloud connector - webhook

8. Hinzufügen einer Aktion

9. under Erweiterung auswählen Adobe Cloud Connector

10. under Aktionstyp auswählen Abrufen eines Aufrufs

11. Fügen Sie Ihre Webhook-URL in die URL field

    

12. under [Abfrageparameter], fügen Sie beide zuvor erstellten Datenelemente hinzu.

13. 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

14. Auswählen + Hinzufügen weiterer Hinzufügen eines weiteren Abfrageparameters

15. Im Schlüssel Spaltentyp in ecid. Geben Sie in der Spalte Wert die {{ecid}} Datenelement

16. Wählen Sie Änderungen beibehalten aus

    

17. Ihre Regel sollte wie unten aussehen

18. 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:

1. 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.

2. Bevor Sie die Seite neu laden, öffnen Sie im Experience Platform Debugger Protokolle über die linke Navigation

3. Wählen Sie die Edge Registerkarte und wählen Sie Verbinden Anzeigen der Anforderungen des Platform Edge Network

   

4. Seite neu laden

5. Es werden zusätzliche Anfragen angezeigt, die Ihnen einen Einblick in die serverseitigen Anforderungen geben, die vom Platform Edge Network an WebHook gesendet werden.

6. Die Anfrage, die Validierung auf zu konzentrieren, zeigt die vollständig erstellte URL, die vom Edge-Netzwerk gesendet wird.

   

7. Beachten Sie die Abfragezeichenfolgenparameter viewPortHeight und ecid .

   

8. Sie stimmen mit den im XDM-Objekt angezeigten Daten überein.

   

9. Ü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!

Weiter:

Ressourcen für Business.Adobe.com