Dokumentation Experience Platform Web SDK-Tutorial

Streamen von Daten auf Experience Platform mit Web SDK

Last update: Tue Dec 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:

Erstellt für:

Einsteiger
Fortgeschrittener
Entwickler

Erfahren Sie, wie Sie Webdaten mit Platform Web SDK an Adobe Experience Platform streamen.

Experience Platform ist das Rückgrat aller neuen Experience Cloud-Anwendungen wie Adobe Real-time Customer Data Platform, Adobe Customer Journey Analytics und Adobe Journey Optimizer. Diese Programme sind für die Verwendung von Platform Web SDK als optimale Methode zur Web-Datenerfassung konzipiert.

Web-SDK und Adobe Experience Platform-Diagramm

Experience Platform verwendet dasselbe XDM-Schema, das Sie zuvor erstellt haben, um Ereignisdaten von der Luma-Website zu erfassen. Wenn diese Daten an das Platform-Edge Network gesendet werden, kann die Datenstromkonfiguration sie an Experience Platform weiterleiten.

Lernziele

Am Ende dieser Lektion können Sie:

Erstellen eines Datensatzes in Adobe Experience Platform
Konfigurieren des Datenstroms zum Senden von Web SDK-Daten an Adobe Experience Platform
Streaming-Webdaten für Echtzeit-Kundenprofil aktivieren
Überprüfen Sie, ob die Daten sowohl im Platform-Datensatz als auch im Echtzeit-Kundenprofil gespeichert sind
Nehmen Sie Beispieldaten von Treueprogrammen in Platform auf
Erstellen einer einfachen Platform-Zielgruppe

Voraussetzungen

Um diese Lektion abzuschließen, müssen Sie zunächst:

Zugriff auf eine Adobe Experience Platform-Anwendung wie Real-time Customer Data Platform, Journey Optimizer oder Customer Journey Analytics
Die vorherigen Lektionen in den Abschnitten Erstkonfiguration und Tags-Konfiguration dieses Tutorials absolvieren.

NOTE

Wenn Sie über keine Platform-Programme verfügen, können Sie diese Lektion überspringen oder mitlesen.

Erstellen eines Datensatzes

Alle Daten, die erfolgreich in Adobe Experience Platform aufgenommen werden, bleiben als Datensätze im Data Lake erhalten. Ein Datensatz ist ein Konstrukt zur Speicherung und Verwaltung von Daten, normalerweise eine Tabelle, die ein Schema (Spalten) und Felder (Zeilen) enthält. Datensätze enthalten auch Metadaten, die verschiedene Aspekte der in ihnen gespeicherten Daten beschreiben.

Richten wir einen Datensatz für Ihre Luma-Web-Ereignisdaten ein:

Zur Experience Platform- oder Journey Optimizer-Benutzeroberfläche
Bestätigen Sie, dass Sie sich in der Entwicklungs-Sandbox befinden, die Sie für dieses Tutorial verwenden
Öffnen Sie Daten-Management > Datensätze über die linke Navigation
Wählen Sie Datensatz erstellen
Wählen Sie die Datensatz aus Schema erstellen aus
Wählen Sie das in der Lektion erstellte Luma Web Event Data Schemaund klicken Sie dann auf Weiter
Geben Sie einen Namen und optional Beschreibung für den Datensatz an. Verwenden Sie für diese Übung Luma Web Event Data und wählen Sie dann Beenden

Ein Datensatz ist jetzt so konfiguriert, dass er mit der Erfassung von Daten aus Ihrer Platform Web SDK-Implementierung beginnt.

Konfigurieren des Datenstroms

Jetzt können Sie Ihren Datenstrom) so konfigurieren dass Daten an Adobe Experience Platform gesendet . Der Datenstrom ist die Verknüpfung zwischen Ihrer Tag-Eigenschaft, dem Platform-Edge Network und dem Experience Platform-Datensatz.

Öffnen Sie die Datenerfassung.
Wählen Datenströme in der linken Navigationsleiste aus
Öffnen Sie den Datenstrom, den Sie in der Lektion Konfigurieren eines Datenstroms erstellt haben Luma Web SDK
Wählen Sie Service hinzufügen
Wählen Sie Adobe Experience Platform als Service
Wählen Sie Luma Web Event Data als Ereignisdatensatz
Wählen Sie Speichern aus.

Wenn Sie Traffic auf der Demo-Site von Luma generieren, der Ihrer Tag-Eigenschaft zugeordnet ist, befüllen die Daten den Datensatz in Experience Platform!

Validieren des Datensatzes

Dieser Schritt ist wichtig, um sicherzustellen, dass die Daten im Datensatz gelandet sind. Es gibt zwei Aspekte beim Validieren von Daten, die an den Datensatz gesendet werden.

Validieren mit dem Experience Platform-Debugger
Validieren mit Vorschau des Datensatzes
Validieren mit Query Service

Experience Platform Debugger

Diese Schritte sind mehr oder weniger die gleichen wie in der Debugger-Lektion. Da Daten jedoch erst dann an Platform gesendet werden, nachdem Sie sie im Datenstrom aktiviert haben, müssen Sie weitere Beispieldaten generieren:

Öffnen Sie die Demo-Site von Luma und wählen Sie das Erweiterungssymbol Experience Platform Debugger aus
Konfigurieren Sie den Debugger, um die Tag-Eigenschaft Entwicklungsumgebung zuzuordnen wie in der Lektion Mit Debugger validieren beschrieben
Melden Sie auf der Site „Luma“ sich mit den folgenden Anmeldedaten an: test@adobe.com/test
Kehren Sie zur Startseite „Luma“ zurück.
Wählen Sie in den vom Debugger angezeigten Beacons des Platform Web SDK-Netzwerks die Zeile „Ereignisse“ aus, um die Details in einem Popup zu erweitern
Suchen Sie im Popup-Fenster nach „identityMap“. Hier sollte lumaCrmId mit drei Schlüsseln, AuthentifiedState, ID und primary, angezeigt werden

Jetzt sollten die Daten im Luma Web Event Data Datensatz ausgefüllt und für die Validierung des „Datensatzvorschau“ bereit sein.

Vorschau des Datensatzes

Um zu bestätigen, dass die Daten im Data Lake von Platform gelandet sind, besteht eine schnelle Option darin, die Funktion Datensatz in der Vorschau anzeigen zu verwenden. Web SDK-Daten werden in Mikro-Batches mit dem Data Lake verknüpft und in der Platform-Oberfläche regelmäßig aktualisiert. Es kann 10-15 Minuten dauern, bis die von Ihnen generierten Daten angezeigt werden.

Wählen Sie in der 🔗 Experience Platform im linken Navigationsbereich die Option Daten-Management > Datensätze aus, um das Dashboard Datensätze zu öffnen.

Das Dashboard listet alle verfügbaren Datensätze für Ihre Organisation auf. Zu jedem aufgelisteten Datensatz werden Details angezeigt, einschließlich seines Namens, des Schemas, dem der Datensatz entspricht, und des Status des letzten Erfassungslaufs.
Wählen Sie Ihren Luma Web Event Data Datensatz aus, um den Bildschirm Datensatzaktivität zu öffnen.

Der Aktivitätsbildschirm enthält ein Diagramm, das die Rate der konsumierten Nachrichten sowie eine Liste erfolgreicher und fehlgeschlagener Batches visualisiert.
Wählen Sie Bildschirm Datensatzaktivität rechts oben Bildschirm die Option Vorschau des Datensatzes aus, um eine Vorschau von bis zu 100 Datenzeilen anzuzeigen. Wenn der Datensatz leer ist, wird der Vorschau-Link deaktiviert.

Im Vorschaufenster wird rechts für den Datensatz die hierarchische Ansicht des Schemas angezeigt.

Daten abfragen

Wählen Sie in der 🔗 Experience Platform im linken Navigationsbereich die Option Daten-Management > Abfragen) aus, um den Bildschirm Abfragen zu öffnen.
Wählen Sie Abfrage erstellen
Führen Sie zunächst eine Abfrage aus, um alle Namen der Tabellen im Data Lake anzuzeigen. Geben Sie SHOW TABLES im Abfrage-Editor ein und klicken Sie auf das Wiedergabesymbol, um die Abfrage auszuführen.
Beachten Sie in den Ergebnissen, dass der Tabellenname in etwa luma_web_event_data lautet
Fragen Sie nun die Tabelle mit einer einfachen Abfrage ab, die auf Ihre Tabelle verweist (beachten Sie, dass die Abfrage standardmäßig auf 100 Ergebnisse beschränkt ist): SELECT * FROM "luma_web_event_data"
Nach einigen Augenblicken sollten Sie Beispieldatensätze Ihrer Web-Daten sehen.

ERROR

Wenn der Fehler „Tabelle nicht bereitgestellt“ angezeigt wird, überprüfen Sie den Namen Ihrer Tabelle. Es könnte auch sein, dass der Mikro-Batch von Daten noch nicht im Data Lake gelandet ist. Versuchen Sie es in 10-15 Minuten erneut.

INFO

Weitere Informationen zum Abfrage-Service von Adobe Experience Platform finden Sie unter Erkunden von Daten im Abschnitt Platform-Tutorials .

Aktivieren von Datensatz und Schema für das Echtzeit-Kundenprofil

Für Kunden von Real-time Customer Data Platform und Journey Optimizer besteht der nächste Schritt darin, den Datensatz und das Schema für das Echtzeit-Kundenprofil zu aktivieren. Das Daten-Streaming aus Web SDK ist eine von vielen Datenquellen, die in Platform fließen, und Sie möchten Ihre Web-Daten mit anderen Datenquellen verbinden, um 360-Grad-Kundenprofile zu erstellen. Weitere Informationen zum Echtzeit-Kundenprofil finden Sie in diesem kurzen Video:

video poster

https://video.tv.adobe.com/v/31581?learn=on&captions=ger

CAUTION

Bei der Arbeit mit Ihrer eigenen Website und Ihren eigenen Daten empfehlen wir eine robustere Validierung von Daten, bevor sie für das Echtzeit-Kundenprofil aktiviert werden.

So aktivieren Sie den Datensatz:

Öffnen Sie den von Ihnen erstellten Datensatz Luma Web Event Data
Wählen Sie den Umschalter Profil aus, um ihn zu aktivieren
Bestätigen Sie, dass Sie Datensatz möchten

So aktivieren Sie das Schema:

Öffnen Sie das von Ihnen erstellte Schema Luma Web Event Data
Wählen Sie den Umschalter Profil aus, um ihn zu aktivieren

Wählen Sie Daten für dieses Schema enthalten eine primäre Identität im identityMap -Feld.

note important
IMPORTANT
Für jeden Datensatz, der an das Echtzeit-Kundenprofil gesendet wird, sind Primäre Identitäten erforderlich. Normalerweise werden Identitätsfelder innerhalb des Schemas beschriftet. Bei Verwendung von Identitätszuordnungen sind die Identitätsfelder jedoch nicht innerhalb des Schemas sichtbar. In diesem Dialogfeld bestätigen Sie, dass Sie eine primäre Identität im Sinn haben und diese beim Senden Ihrer Daten in einer Identitätszuordnung angeben. Wie Sie wissen, verwendet Web SDK eine Identitätszuordnung mit der Experience Cloud-ID (ECID) als standardmäßige primäre Identität und eine authentifizierte ID als primäre Identität, sofern verfügbar.

note important

IMPORTANT

Für jeden Datensatz, der an das Echtzeit-Kundenprofil gesendet wird, sind Primäre Identitäten erforderlich. Normalerweise werden Identitätsfelder innerhalb des Schemas beschriftet. Bei Verwendung von Identitätszuordnungen sind die Identitätsfelder jedoch nicht innerhalb des Schemas sichtbar. In diesem Dialogfeld bestätigen Sie, dass Sie eine primäre Identität im Sinn haben und diese beim Senden Ihrer Daten in einer Identitätszuordnung angeben. Wie Sie wissen, verwendet Web SDK eine Identitätszuordnung mit der Experience Cloud-ID (ECID) als standardmäßige primäre Identität und eine authentifizierte ID als primäre Identität, sofern verfügbar.

Wählen Sie Aktivieren aus
Wählen Sie Speichern, um das aktualisierte Schema zu speichern

Jetzt ist das Schema auch für das Profil aktiviert.

IMPORTANT

Nachdem ein Schema für das Profil aktiviert wurde, kann es nicht mehr deaktiviert oder gelöscht werden, ohne dass die gesamte Sandbox zurückgesetzt oder gelöscht wird. Außerdem können nach diesem Punkt keine Felder mehr aus dem Schema entfernt werden.

Bei der Arbeit mit Ihren eigenen Daten empfehlen wir, die Dinge in der folgenden Reihenfolge zu erledigen:

Nehmen Sie zunächst einige Daten in Ihre Datensätze auf.
Beheben Sie alle Probleme, die während der Datenaufnahme auftreten (z. B. Probleme bei der Datenvalidierung oder -zuordnung).
Aktivieren von Datensätzen und Schemata für Profile
Nehmen Sie die Daten bei Bedarf erneut auf

Überprüfen eines Profils

Sie können in der Platform-Benutzeroberfläche (oder der Journey Optimizer-Benutzeroberfläche) nach einem Kundenprofil suchen, um zu bestätigen, dass die Daten im Echtzeit-Kundenprofil gelandet sind. Wie der Name schon sagt, werden Profile in Echtzeit gefüllt, sodass es keine Verzögerung gibt, wie sie bei der Validierung von Daten im Datensatz aufgetreten ist.

Zunächst müssen Sie mehr Beispieldaten generieren. Wiederholen Sie die Schritte oben in dieser Lektion, um sich bei der Luma-Website anzumelden, wenn sie Ihrer Tag-Eigenschaft zugeordnet ist. Inspect stellt die Anforderung von Platform Web SDK bereit, um sicherzustellen, dass Daten mit dem lumaCRMId gesendet werden.

Wählen Sie in der 🔗 Experience Platform im linken Navigationsbereich Kunde > Profile aus
Verwenden Sie lumaCRMId als Identity Namespace
Kopieren Sie den Wert der lumaCRMId, die in dem von Ihnen im Experience Platform-Debugger überprüften Aufruf übergeben wurde, und fügen Sie ihn ein, in diesem Fall 112ca06ed53d3db37e4cea49cc45b71e.
Wenn im Profil ein gültiger Wert für lumaCRMId vorhanden ist, wird in der Konsole eine Profil-ID ausgefüllt:

Um das vollständige Kundenprofil für jede ID anzuzeigen, wählen Sie Profil-ID im Hauptfenster aus.

note note
NOTE
Beachten Sie, dass Sie den Hyperlink der Profil-ID auswählen können. Wenn Sie die Zeile auswählen, wird ein rechtes Menü geöffnet, in dem Sie den Profil-ID-Hyperlink auswählen können

Hier können Sie alle mit der lumaCRMId verknüpften Identitäten sehen, z. B. die ECID.

Kundenprofil

Sie haben jetzt Platform Web SDK für Experience Platform (und Real-Time CDP! Und Journey Optimizer! Und Customer Journey Analytics!).

Erstellen eines Treueschemas und Aufnehmen von Beispieldaten

Der Abschluss dieser Übung wird für Kunden von Real-time Customer Data Platform und Journey Optimizer erwartet.

Wenn Web SDK-Daten in Adobe Experience Platform aufgenommen werden, können sie durch andere Datenquellen angereichert werden, die Sie in Platform aufgenommen haben. Wenn sich ein Benutzer beispielsweise bei der Luma-Site anmeldet, wird ein Identitätsdiagramm als Experience Platform erstellt und alle anderen profilaktivierten Datensätze können möglicherweise zusammengeführt werden, um Echtzeit-Kundenprofile zu erstellen. Um dies in Aktion zu sehen, erstellen Sie schnell einen anderen Datensatz in Adobe Experience Platform mit einigen Beispiel-Treuedaten, damit Sie Echtzeit-Kundenprofile mit Real-time Customer Data Platform und Journey Optimizer verwenden können. Da Sie bereits ähnliche Übungen durchgeführt haben, werden die Anweisungen kurz sein.

Erstellen Sie das Treueschema:

Erstellen eines neuen Schemas
Wählen Sie Individuelles Profil als Basisklasse
Benennen des Luma Loyalty Schema
Fügen Sie die Treuedetails hinzu
Fügen Sie die Demografische Details hinzu
Wählen Sie das Feld Person ID aus und markieren Sie es als Identität und Primäre mithilfe des Luma CRM IdIdentity-Namespace.
Aktivieren Sie das Schema für Profil. Wenn Sie den Umschalter Profil nicht finden können, klicken Sie oben links auf den Schemanamen.
Schema speichern

So erstellen Sie den Datensatz und nehmen die Beispieldaten auf:

Erstellen eines neuen Datensatzes aus dem Luma Loyalty Schema
Benennen des Datensatzes Luma Loyalty Dataset
Aktivieren des Datensatzes für Profil
Laden Sie die Beispieldatei luma-loyalty-forWeb.json)
Ziehen Sie die Datei per Drag-and-Drop in den Datensatz
Bestätigen, dass die Daten erfolgreich aufgenommen wurden

Erstellen einer Zielgruppe

Zielgruppen gruppieren Profile anhand gemeinsamer Eigenschaften. Erstellen Sie eine schnelle Audience, die Sie in Ihrer Web-Kampagne verwenden können:

Navigieren Sie auf der Experience Platform- oder Journey Optimizer Benutzeroberfläche im linken Navigationsbereich zu Kunde > Zielgruppen .
Wählen Sie Zielgruppe erstellen
Wählen Sie Regel erstellen
Wählen Sie Erstellen
Wählen Sie Attribute
Suchen Sie das Feld Treue > Ebene und ziehen Sie es in den Abschnitt Attribute
Zielgruppe als Benutzer definieren, deren tier gold ist
Benennen der Luma Loyalty Rewards – Gold Status
Wählen Sie Edge als Auswertungsmethode
Wählen Sie Speichern

Da es sich um eine sehr einfache Zielgruppe handelt, können wir die Edge-Auswertungsmethode verwenden. Edge-Zielgruppen werden am Edge ausgewertet. Daher können wir mit derselben Anfrage, die das Web SDK-to-Platform-Edge Network stellt, die Zielgruppendefinition auswerten und sofort bestätigen, ob der Benutzer sich qualifiziert.

Weiter:

NOTE

Vielen Dank, dass Sie sich Zeit genommen haben, um mehr über Adobe Experience Platform Web SDK zu erfahren. Wenn Sie Fragen haben, allgemeines Feedback geben möchten oder Vorschläge für zukünftige Inhalte haben, teilen Sie diese bitte auf diesem Experience League-Community-Diskussionsbeitrag

recommendation-more-help

8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4