21.3 Benutzerdefinierten Webhook erstellen und konfigurieren

21.3.1 Benutzerdefinierten Webhook erstellen

Gehen Sie zu https://webhook.site/. Sie sehen etwas wie das:

Demo

Sie sehen Ihre eindeutige URL, die wie folgt aussieht: https://webhook.site/f02f2c22-44f9-40d8-8188-dc60fd03e3ec.

Diese Website hat jetzt diesen Webhook für Sie erstellt und Sie können diesen Webhook in Ihrem Adobe Experience Platform Data Collection Server property konfigurieren, um die Weiterleitung von Ereignissen zu testen.

21.3.2 Eigenschaft des Adobe Experience Platform-Datenerfassungsservers aktualisieren: Erstellen eines Datenelements

Gehen Sie zu https://experience.adobe.com/#/data-collection/.

Adobe Experience Platform Data Collection SSF

Klicken Sie im linken Menü auf Server. Daraufhin wird eine Übersicht über alle verfügbaren Adobe Experience Platform-Datenerfassungsservereigenschaften angezeigt. Suchen und klicken Sie, um die Eigenschaft zu öffnen, die Sie in Übung 21.1 erstellt haben.

Adobe Experience Platform Data Collection SSF

Gehen Sie im linken Menü zu Datenelemente. Klicken Sie auf Neues Datenelement erstellen.

Adobe Experience Platform Data Collection SSF

Anschließend wird ein neues Datenelement angezeigt, das konfiguriert werden soll.

Adobe Experience Platform Data Collection SSF

Wählen Sie Folgendes aus:

  • Geben Sie als Name XDM-Ereignis ein.
  • Wählen Sie als Erweiterung Core aus.
  • Wählen Sie als Datenelementtyp Pfad aus.
  • Geben Sie als Pfad arc.event.xdm ein. Durch Eingabe dieses Pfads filtern Sie den Abschnitt XDM aus der Ereignis-Payload heraus, die von der Website oder App an die Adobe Edge gesendet wird.

Das wirst du jetzt haben. Klicken Sie auf Speichern.

Adobe Experience Platform Data Collection SSF

HINWEIS

Im obigen Pfad wird ein Verweis auf arc erstellt. ​arcsteht für Adobe Resource Context und ​arcalways für das höchste verfügbare Objekt, das im serverseitigen Kontext verfügbar ist. Anreicherungen und Umwandlungen können dem arc -Objekt hinzugefügt werden, das die Funktionen des Adobe Experience Platform-Datenerfassungsservers verwendet.

Im obigen Pfad wird auf event verwiesen. ​events steht für ein eindeutiges Ereignis und Adobe Experience Platform Data Collection Server wertet jedes Ereignis immer einzeln aus. Manchmal wird in der Payload, die vom Web SDK Client Side gesendet wird, ein Verweis auf events angezeigt, aber in Adobe Experience Platform Data Collection Server wird jedes Ereignis einzeln ausgewertet.

21.3.3 Adobe Experience Platform-Datenerfassungsservereigenschaft aktualisieren: Erstellen einer Regel

Gehen Sie im linken Menü zu Regeln. Klicken Sie auf Neue Regel erstellen.

Adobe Experience Platform Data Collection SSF

Danach wird eine neue Regel zum Konfigurieren angezeigt.

Adobe Experience Platform Data Collection SSF

Geben Sie Name ein: Alle Seiten.

Für diese Übung müssen Sie keine Bedingung konfigurieren. Stattdessen richten Sie eine Aktion ein. Klicken Sie auf die Schaltfläche + Hinzufügen unter Aktionen.

Adobe Experience Platform Data Collection SSF

Dann wirst du das sehen.

Adobe Experience Platform Data Collection SSF

Wählen Sie Folgendes aus:

  • Wählen Sie die Extension aus: Adobe Cloud Connector.
  • Wählen Sie den Aktionstyp aus: Rufen Sie den Abruf ab.

Dies sollte Ihnen Name geben: Adobe Cloud Connector - Rufen Sie den Abruf ab. Sie sollten jetzt Folgendes sehen:

Adobe Experience Platform Data Collection SSF

Konfigurieren Sie als Nächstes Folgendes:

  • Ändern Sie die Anforderungsmethode von GET in POST
  • Geben Sie die URL des benutzerdefinierten Webhooks ein, den Sie in einem der vorherigen Schritte auf der Website https://webhook.site/ erstellt haben, die wie folgt aussieht: https://webhook.site/f02f2c22-44f9-40d8-8188-dc60fd03e3ec

Du solltest das jetzt haben. Navigieren Sie als Nächstes zu Body.

Adobe Experience Platform Data Collection SSF

Dann wirst du das sehen. Klicken Sie auf das Symbol Datenelement , wie unten angegeben.

Adobe Experience Platform Data Collection SSF

Wählen Sie im Popup das Datenelement XDM Event aus, das Sie im vorherigen Schritt erstellt haben. Klicken Sie auf Auswählen.

Adobe Experience Platform Data Collection SSF

Dann wirst du das sehen. Klicken Sie auf Änderungen beibehalten.

Adobe Experience Platform Data Collection SSF

Dann wirst du das sehen. Klicken Sie auf Speichern.

Adobe Experience Platform Data Collection SSF

Sie haben Ihre erste Regel jetzt in einer Adobe Experience Platform-Datenerfassungsservereigenschaft konfiguriert. Gehen Sie zu Veröffentlichungsfluss , um Ihre Änderungen zu veröffentlichen.
Öffnen Sie Ihre Entwicklungsbibliothek v1, indem Sie wie angegeben auf Bearbeiten klicken.

Adobe Experience Platform Data Collection SSF

Klicken Sie auf die Schaltfläche Alle geänderten Ressourcen hinzufügen, nach der Ihre Regel und Ihr Datenelement in dieser Bibliothek angezeigt werden. Klicken Sie anschließend auf Speichern und für die Entwicklung erstellen. Ihre Änderungen werden jetzt bereitgestellt.

Adobe Experience Platform Data Collection SSF

Nach einigen Minuten werden Sie feststellen, dass die Implementierung abgeschlossen ist und getestet werden kann.

Adobe Experience Platform Data Collection SSF

21.3.4 Testen der Konfiguration

Öffnen Sie ein neues, sauberes Inkognito-Browser-Fenster und gehen Sie zu https://public.aepdemo.net.

Dann wirst du das sehen.

Einrichten der Adobe Experience Platform-Datenerfassung

Geben Sie Ihre Konfigurations-ID ein und klicken Sie auf Konfiguration laden. Ihre Konfiguration wird dann geladen.

Einrichten der Adobe Experience Platform-Datenerfassung

Scrollen Sie nach unten und klicken Sie auf Konfiguration speichern.

Einrichten der Adobe Experience Platform-Datenerfassung

Sie werden dann zur Admin-Homepage weitergeleitet. Gehen Sie zu Wählen Sie LDAP. Wählen Sie Ihren LDAP aus und klicken Sie auf Save.

Einrichten der Adobe Experience Platform-Datenerfassung

Sie werden dann zur Admin-Homepage weitergeleitet. Gehen Sie zu Wählen Sie Marke und wählen Sie die Marke Luma aus. Klicken Sie auf Speichern.

Einrichten der Adobe Experience Platform-Datenerfassung

Sie werden dann zur Admin-Homepage weitergeleitet. Klicken Sie auf das Logo Luma.

Einrichten der Adobe Experience Platform-Datenerfassung

Dann sehen Sie die Startseite von Luma.

Einrichten der Adobe Experience Platform-Datenerfassung

Wenn Sie die Entwickleransicht des Browsers öffnen, können Sie Netzwerkanforderungen wie unten angegeben überprüfen. Wenn Sie den Filter interact verwenden, werden die Netzwerkanforderungen angezeigt, die vom Adobe Experience Platform-Datenerfassungsclient an die Adobe Edge gesendet werden.

Einrichten der Adobe Experience Platform-Datenerfassung

Wenn Sie die Rohdaten-Payload auswählen, gehen Sie zu https://jsonformatter.org/json-pretty-print und fügen Sie die Payload ein. Klicken Sie auf Make Pretty. Anschließend werden die JSON-Nutzlast, das events -Objekt und das xdm -Objekt angezeigt. In einem der vorherigen Schritte, als Sie das Datenelement definiert haben, haben Sie die Referenz arc.event.xdm verwendet, was dazu führt, dass Sie das xdm-Objekt dieser Payload analysieren.

Einrichten der Adobe Experience Platform-Datenerfassung

Wechseln Sie Ihre Ansicht zur Website https://webhook.site/ , die Sie in einem der vorherigen Schritte verwendet haben. Sie sollten jetzt eine ähnliche Ansicht wie diese haben, wobei Netzwerkanforderungen im linken Menü angezeigt werden. Sie sehen die xdm-Payload, die aus der oben gezeigten Netzwerkanforderung herausgefiltert wurde.

Einrichten der Adobe Experience Platform-Datenerfassung

Scrollen Sie in der Payload ein wenig nach unten, um den Seitennamen zu finden, der in diesem Fall Luma Home ist.

Einrichten der Adobe Experience Platform-Datenerfassung

Wenn Sie jetzt über die Website navigieren, werden in Echtzeit zusätzliche Netzwerkanforderungen auf diesem benutzerdefinierten Webhook verfügbar sein.

Einrichten der Adobe Experience Platform-Datenerfassung

Sie haben jetzt die serverseitige Weiterleitung von Web SDK-/XDM-Payloads an einen externen benutzerdefinierten Webhook konfiguriert. In den nächsten Übungen konfigurieren Sie einen ähnlichen Ansatz, und Sie senden dieselben Daten an Google- und Microsoft Azure-Umgebungen.

Nächster Schritt: 21.4 Google Cloud-Funktion erstellen und konfigurieren

Zurück zu Modul 21

Zu allen Modulen zurückkehren

Auf dieser Seite