Dokumentation Experience Platform Web SDK-Tutorial

Streamen von Daten an Experience Platform mit dem Web SDK

Last update: Tue Jul 16 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-Applikationen wie Adobe Real-time Customer Data Platform, Adobe Customer Journey Analytics und Adobe Journey Optimizer. Diese Anwendungen sind so konzipiert, dass sie das Platform Web SDK als optimale Methode zur Webdatenerfassung verwenden.

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 Platform Edge Network gesendet werden, kann die Datastream-Konfiguration sie an Experience Platform weiterleiten.

Lernziele

Am Ende dieser Lektion können Sie:

Datensatz in Adobe Experience Platform erstellen
Konfigurieren des Datenspeichers zum Senden von Web SDK-Daten an Adobe Experience Platform
Streaming-Webdaten für Echtzeit-Kundenprofil aktivieren
Überprüfen, ob die Daten sowohl im Platform-Datensatz als auch im Echtzeit-Kundenprofil gelandet sind
Aufnehmen von Beispieldaten zum Treueprogramm in Platform
Einfache Platform-Audience erstellen

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
Schließen Sie die früheren Lektionen in den Abschnitten Erstkonfiguration und Tags-Konfiguration dieses Tutorials ab.

NOTE

Wenn Sie keine Platform-Anwendungen haben, können Sie diese Lektion überspringen oder lesen.

Erstellen eines Datensatzes

Alle Daten, die erfolgreich in Adobe Experience Platform aufgenommen wurden, werden im Data Lake als Datensätze persistiert. Ein Datensatz ist ein Speicher- und Verwaltungskonstrukt für eine Datenerfassung, 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:

Navigieren Sie zur Benutzeroberfläche Experience Platform oder Journey Optimizer .
Bestätigen, dass Sie sich in der Entwicklungs-Sandbox befinden, die Sie für dieses Tutorial verwenden
Öffnen Sie Datenverwaltung > Datensätze im linken Navigationsbereich.
Wählen Sie Datensatz erstellen aus
Wählen Sie die Option Datensatz aus Schema erstellen aus
Wählen Sie das Schema Luma Web Event Data aus, das in der früheren Lektion erstellt wurde, und wählen Sie dann Weiter aus
Geben Sie einen Namen und optional eine Beschreibung für den Datensatz an. Verwenden Sie für diese Übung Luma Web Event Data und wählen Sie dann Beenden aus.

Ein Datensatz ist jetzt so konfiguriert, dass Daten aus Ihrer Platform Web SDK-Implementierung erfasst werden.

Konfigurieren des Datenspeichers

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

Öffnen Sie die Oberfläche Datenerfassung .
Wählen Sie Datastreams aus der linken Navigation aus
Öffnen Sie den von Ihnen in der Lektion Datensatz konfigurieren erstellten Datensatz, Luma Web SDK .
Wählen Sie Dienst hinzufügen aus
Wählen Sie Adobe Experience Platform als Dienst aus.
Wählen Sie Luma Web Event Data als Ereignisdatensatz aus.
Wählen Sie Speichern aus.

Wenn Sie Traffic auf der Ihrer Tag-Eigenschaft zugeordneten Luma Demo Site generieren, wird der Datensatz mit den Daten in Experience Platform gefüllt!

Datensatz validieren

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

Validieren mit Experience Platform Debugger
Validieren mit Vorschau des Datensatzes anzeigen
Validieren mit Query Service

Experience Platform Debugger

Diese Schritte entsprechen mehr oder weniger den Schritten in der Lektion Debugger. Da Daten jedoch erst nach der Aktivierung im Datastream an Platform gesendet werden, müssen Sie weitere Beispieldaten generieren:

Öffnen Sie die Demosite "Luma" und wählen Sie das Symbol für die Erweiterung Experience Platform Debugger aus.
Konfigurieren Sie den Debugger, um die Tag-Eigenschaft Ihrer Entwicklungsumgebung zuzuordnen, wie in der Lektion Mit Debugger überprüfen beschrieben.
Melden Sie auf der Site „Luma“ sich mit den folgenden Anmeldeinformationen an: test@adobe.com/test
Kehren Sie zur Startseite „Luma“ zurück.
Wählen Sie im vom Debugger angezeigten Platform Web SDK-Netzwerk-Beacon die Zeile "Ereignisse"aus, um Details in einem Popup-Fenster zu erweitern.
Suchen Sie im Popup nach der "identityMap". Hier sollten Sie lumaCrmId mit drei Schlüsseln von authenticatedState, id und primary sehen.

Jetzt sollten Daten in den Datensatz Luma Web Event Data gefüllt werden und zur Validierung des Datensatzes für die Vorschau bereit sein.

Vorschau des Datensatzes anzeigen

Um sicherzustellen, dass die Daten im Data Lake von Platform gelandet sind, können Sie schnell die Funktion Datensatz-Vorschau verwenden. Web SDK-Daten werden in Mikro-Batches an den Data Lake gesendet 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 Benutzeroberfläche Experience Platform im linken Navigationsbereich die Option Datenverwaltung > 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 im Bildschirm Datensatzaktivität die Option Datensatz-Vorschau in der oberen rechten Ecke des Bildschirms 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.

Abfragen der Daten

Wählen Sie in der Benutzeroberfläche Experience Platform im linken Navigationsbereich die Option Datenverwaltung > Abfragen aus, um den Bildschirm Abfragen zu öffnen.
Wählen Sie Abfrage erstellen aus
Führen Sie zunächst eine Abfrage aus, um alle Namen der Tabellen im Data Lake anzuzeigen. Geben Sie SHOW TABLES in den Abfrageeditor ein und klicken Sie auf das Wiedergabesymbol, um die Abfrage auszuführen.
Beachten Sie in den Ergebnissen, wie der Name der Tabelle ungefähr luma_web_event_data ist.
Jetzt die Tabelle mit einer einfachen Abfrage abfragen, die auf Ihre Tabelle verweist (beachten Sie, dass die Abfrage standardmäßig auf 100 Ergebnisse begrenzt ist): SELECT * FROM "luma_web_event_data"
Nach einigen Augenblicken sollten Sie Beispieldatensätze Ihrer Web-Daten sehen.

ERROR

Wenn die Fehlermeldung "Tabelle nicht bereitgestellt"angezeigt wird, überprüfen Sie den Namen Ihrer Tabelle. Es könnte auch sein, dass die Mikrostapel von Daten noch nicht im Data Lake gelandet ist. Versuchen Sie es in 10-15 Minuten erneut.

INFO

Weitere Informationen zum Abfragedienst von Adobe Experience Platform finden Sie unter Daten untersuchen im Abschnitt "Platform-Tutorials".

Datensatz und Schema für Echtzeit-Kundenprofil aktivieren

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 vom Web SDK ist eine von vielen Datenquellen, die in Platform fließen. 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:

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

CAUTION

Wenn Sie mit Ihrer eigenen Website und Ihren eigenen Daten arbeiten, empfehlen wir eine zuverlässigere Validierung der Daten, bevor Sie sie für das Echtzeit-Kundenprofil aktivieren.

So aktivieren Sie den Datensatz:

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

Aktivieren des Schemas:

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

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

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

note important

IMPORTANT

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

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

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

IMPORTANT

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

Wir empfehlen, beim Arbeiten mit Ihren eigenen Daten die folgenden Schritte auszuführen:

Erfassen Sie zunächst einige Daten in Ihren Datensätzen.
Beheben Sie alle Probleme, die während des Datenerfassungsprozesses auftreten (z. B. bei der Datenvalidierung oder bei der Zuordnung).
Datensätze und Schemata für Profile aktivieren
Erfassen Sie die Daten bei Bedarf neu.

Profil überprüfen

Sie können in der Benutzeroberfläche von Platform (oder Journey Optimizer) 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 ausgefüllt, sodass es keine Verzögerung gibt, wie es bei der Validierung von Daten im Datensatz der Fall war.

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

Wählen Sie in der Benutzeroberfläche Experience Platform im linken Navigationsbereich Kunde > Profile aus.
Verwenden Sie als Identitäts-Namespace lumaCRMId
Kopieren Sie den Wert von lumaCRMId, der im Aufruf übergeben wird, den Sie im Experience Platform Debugger überprüft haben, in diesem Fall 112ca06ed53d3db37e4cea49cc45b71e.
Wenn im Profil ein gültiger Wert für lumaCRMId vorhanden ist, wird in der Konsole eine Profil-ID eingetragen:

Um das vollständige Kundenprofil für jede ID anzuzeigen, wählen Sie die 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 Identitäten sehen, die mit dem lumaCRMId verknüpft sind, z. B. die ECID.

Kundenprofil

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

Erstellen eines Loyalitätsschemas und Erfassen 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 erfasst werden, können sie durch andere Datenquellen angereichert werden, die Sie in Platform erfasst haben. Wenn sich ein Benutzer beispielsweise bei der Site "Luma"anmeldet, wird ein Identitätsdiagramm in 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 weiteren Datensatz in Adobe Experience Platform mit Beispielloyalitätsdaten, 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 aus.
Nennen Sie das Schema Luma Loyalty Schema
Hinzufügen der Feldergruppe Treuedetails
Hinzufügen der Feldergruppe Demografische Details
Wählen Sie das Feld Person ID aus und markieren Sie es mit dem Namespace Luma CRM Id Identität als Identität und Primäre Identität.
Aktivieren Sie das Schema für Profil. Wenn Sie den Profil -Umschalter nicht finden, klicken Sie oben links auf den Schemanamen.
Schema speichern

So erstellen Sie den Datensatz und erfassen die Beispieldaten:

Erstellen eines neuen Datensatzes aus dem Luma Loyalty Schema
Benennen Sie den Datensatz Luma Loyalty Dataset .
Datensatz für Profil aktivieren
Laden Sie die Beispieldatei luma-loyalty-forWeb.json herunter.
Ziehen Sie die Datei per Drag-and-Drop in Ihren Datensatz
Überprüfen Sie, ob die Daten erfolgreich erfasst wurden.

Erstellen einer Zielgruppe

Zielgruppen gruppieren Profile um allgemeine Eigenschaften. Erstellen Sie eine schnelle Zielgruppe, die Sie in Ihrer Web-Kampagne verwenden können:

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

Da es sich um eine sehr einfache Zielgruppe handelt, können wir die Edge-Auswertungsmethode verwenden. Edge-Zielgruppen werden am Rande ausgewertet. In der gleichen Anfrage des Web SDK an Platform Edge Network können wir die Zielgruppendefinition auswerten und sofort bestätigen, ob sich der Benutzer qualifiziert.

Weiter:

NOTE

Vielen Dank, dass Sie Ihre Zeit investiert haben, um mehr über das Adobe Experience Platform Web SDK zu erfahren. Wenn Sie Fragen haben, ein allgemeines Feedback teilen oder Anregungen zu künftigen Inhalten haben möchten, teilen Sie diese bitte in diesem Experience League Community-Diskussionsbeitrag mit.

recommendation-more-help

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