Dokumentation Experience Platform Web SDK-Tutorial

Streamen von Daten an Experience Platform mit dem Web SDK

Last update: Sat Jun 01 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. A 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 zu Experience Platform oder Journey Optimizer Benutzeroberfläche
Bestätigen, dass Sie sich in der Entwicklungs-Sandbox befinden, die Sie für dieses Tutorial verwenden
Öffnen Datenverwaltung > Datensätze über die linke Navigation
Auswählen Datensatz erstellen
Wählen Sie die Datensatz aus Schema erstellen option
Wählen Sie die Luma Web Event Data Schema, das im frühere Lektion und wählen Sie Nächste
Stellen Sie eine Name und optional Beschreibung für den Datensatz. Verwenden Sie für diese Übung Luma Web Event Data, wählen Sie Beenden

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

Konfigurieren des Datenspeichers

Jetzt können Sie Ihre datastream zum Senden von Daten an Adobe Experience Platform. Der Datastream ist die Verknüpfung zwischen Ihrer Tag-Eigenschaft, dem Platform-Edge Network und dem Experience Platform-Datensatz.

Öffnen Sie die Datenerfassung Benutzeroberfläche
Auswählen Datenspeicher über die linke Navigation
Öffnen Sie den von Ihnen im Abschnitt Konfigurieren eines Datenspeichers Lektion, Luma Web SDK
Auswählen Dienst hinzufügen
Auswählen Adobe Experience Platform als Dienst
Auswählen Luma Web Event Data als Ereignis-Datensatz
Wählen Sie Speichern aus.

Beim Generieren des Traffics auf Demosite "Luma" Ihrer Tag-Eigenschaft zugeordnet sind, füllen die Daten den Datensatz in Experience Platform aus!

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 eines Datensatzes anzeigen
Validieren mit Query Service

Experience Platform Debugger

Diese Schritte entsprechen mehr oder weniger den Schritten in der Debugger-Lektion. 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 die Experience Platform Debugger Erweiterungssymbol
Konfigurieren des Debuggers für die Zuordnung der Tag-Eigenschaft zu Ihre Entwicklungsumgebung, wie im Abschnitt Validieren mit Debugger Lektion
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 die Luma Web Event Data Datensatz und bereit für die Validierung des Datensatzes in der Vorschau.

Vorschau des Datensatzes anzeigen

Um zu bestätigen, dass die Daten im Data Lake von Platform gelandet sind, können Sie schnell mithilfe der Datensatz-Vorschau Funktion. 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.

Im Experience Platform Benutzeroberfläche, wählen Sie Datenverwaltung > Datensätze im linken Navigationsbereich, um die Datensätze Dashboard.

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 Luma Web Event Data Datensatz, um seine Datensatzaktivität angezeigt.

Der Aktivitätsbildschirm enthält ein Diagramm, das die Rate der konsumierten Nachrichten sowie eine Liste erfolgreicher und fehlgeschlagener Batches visualisiert.
Aus dem Datensatzaktivität Bildschirm, auswählen Datensatz-Vorschau in der oberen rechten Ecke des Bildschirms eine Vorschau von bis zu 100 Datenzeilen anzeigen. 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

Im Experience Platform Benutzeroberfläche, wählen Sie Datenverwaltung > Abfragen im linken Navigationsbereich, um die Abfragen angezeigt.
Auswählen Abfrage erstellen
Führen Sie zunächst eine Abfrage aus, um alle Namen der Tabellen im Data Lake anzuzeigen. Eingabe SHOW TABLES Klicken Sie im Abfrageeditor auf das Wiedergabesymbol, um die Abfrage auszuführen.
Beachten Sie in den Ergebnissen, wie der Name der Tabelle ungefähr luma_web_event_data
Abfragen Sie nun die Tabelle mit einer einfachen Abfrage, 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 durchsuchen 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 von Ihnen erstellten Datensatz, Luma Web Event Data
Wählen Sie die Profil-Umschalter zum Aktivieren
Bestätigen, dass Sie Aktivieren den Datensatz

So aktivieren Sie das Schema:

Öffnen Sie das von Ihnen erstellte Schema, Luma Web Event Data
Wählen Sie die Profil-Umschalter zum Aktivieren

Auswählen 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.

Auswählen Aktivieren
Auswählen Speichern Speichern des aktualisierten Schemas

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-Anforderung, um sicherzustellen, dass Daten mit dem lumaCRMId.

Im Experience Platform Benutzeroberfläche, wählen Sie Kunde > Profile im linken Navigationsbereich
Als Identitäts-Namespace use lumaCRMId
Kopieren und Einfügen des Werts des lumaCRMId den Aufruf übergeben, den Sie im Experience Platform Debugger überprüft haben, in diesem Fall 112ca06ed53d3db37e4cea49cc45b71e.
Wenn im Profil ein gültiger Wert für lumaCRMId, wird in der Konsole eine Profil-ID eingetragen:

So zeigen Sie die vollständige Kundenprofil Wählen Sie für jede ID die Profil-ID im Hauptfenster.

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, beispielsweise 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
Auswählen Individuelles Profil als Basisklasse
Benennen Sie das Schema. Luma Loyalty Schema
Fügen Sie die Treuedetails Feldergruppe
Fügen Sie die Demografische Details Feldergruppe
Wählen Sie die Person ID und markieren Sie es als Identität und Primäre Identität mithilfe der Luma CRM Id Identitäts-Namespace.
Aktivieren des Schemas 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 Sie einen neuen Datensatz aus der Luma Loyalty Schema
Benennen Sie den Datensatz. Luma Loyalty Dataset
Datensatz aktivieren für Profil
Beispieldatei herunterladen luma-loyalty-forWeb.json
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:

Navigieren Sie in der Experience Platform- oder Journey Optimizer-Benutzeroberfläche zu Kunde > Zielgruppen in der linken Navigation
Auswählen Erstellen einer Zielgruppe
Auswählen Regel erstellen
Auswählen Erstellen
Auswählen Attribute
Suchen Sie die Treue > Ebene und ziehen Sie es auf das Attribute Abschnitt
Definieren Sie die Zielgruppe als Benutzer, deren tier is gold
Benennen der Zielgruppe Luma Loyalty Rewards – Gold Status
Auswählen Edge als Auswertungsmethode
Auswählen Speichern

Da es sich um eine sehr einfache Zielgruppe handelt, können wir die Edge-Auswertungsmethode verwenden. Edge-Zielgruppen werden am Edge-Rand 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 möchten oder Vorschläge zu künftigen Inhalten haben, teilen Sie diese bitte mit. Experience League Community-Diskussionsbeitrag

recommendation-more-help

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