Erfahren Sie, wie Sie die wichtigsten Datenelemente erstellen, die zum Erfassen von Daten mit dem Experience Platform Web SDK erforderlich sind. Erfassen Sie sowohl Inhalts- als auch Identitätsdaten auf der Demosite "Luma". Erfahren Sie, wie Sie das zuvor erstellte XDM-Schema zur Datenerfassung mit dem Platform Web SDK mithilfe eines neuen Datenelementtyps namens XDM Object verwenden.
Zu Demonstrationszwecken bauen die Übungen in dieser Lektion auf dem Beispiel auf, das während der Schema konfigurieren Schritt; Erstellen von Beispiel-XDM-Objekten, die angesehene Inhalte und Identitäten von Benutzern auf der Demosite "Luma".
Die Daten für diese Lektion stammen aus dem digitalData
Datenschicht auf der Site "Luma". Um die Datenschicht anzuzeigen, öffnen Sie Ihre Entwicklerkonsole und geben Sie in digitalData
um die vollständige verfügbare Datenschicht anzuzeigen.
Unabhängig vom Platform Web SDK müssen Sie weiterhin Datenelemente in Ihrer Tag-Eigenschaft erstellen, die Datenerfassungsvariablen Ihrer Website wie einer Datenschicht, einem HTML-Attribut oder anderen zugeordnet sind. Nachdem Sie diese Datenelemente erstellt haben, müssen Sie sie dem XDM-Schema zuordnen, das Sie während der Schemas konfigurieren Lektion. Zu diesem Zweck stellt die Platform Web SDK-Erweiterung einen neuen Datenelementtyp namens XDM-Objekt bereit. Daher besteht das Erstellen von Datenelementen aus zwei Aktionen:
Bei Schritt 1 ordnen Sie Ihre Datenschicht Datenelementen weiterhin auf die aktuelle Weise zu, indem Sie einen der Datenelementtypen der Core-Tag-Erweiterung verwenden. Für Schritt 2 erstellt die Platform Web SDK-Erweiterung eine Reihe neuer Datenelementtypen, die zuvor nicht verfügbar waren:
Diese Lektion konzentriert sich auf Datenelementtypen von XDM-Objekten und Identitätszuordnungen. Sie erstellen XDM-Objekte, um die Aktivität und den Authentifizierungsstatus von Luma-Besuchern zu erfassen.
Am Ende dieser Lektion können Sie:
Sie wissen, was eine Datenschicht ist, und kennen die Demosite “Luma” Datenschicht und wissen, wie Datenelemente in Tags referenziert werden. Sie müssen die folgenden vorherigen Schritte im Tutorial ausgeführt haben
Die Experience Cloud ID-Diensterweiterung ist bei der Implementierung des Adobe Experience Platform Web SDK nicht erforderlich, da die ID-Dienst-Funktion in das Platform Web SDK integriert ist.
Bevor Sie mit der Erstellung des XDM-Objekts beginnen, erstellen Sie den folgenden Satz von Datenelementen, die dem Demosite “Luma” Datenschicht:
Navigieren Sie zu Datenelemente und wählen Sie Datenelement hinzufügen (oder Neues Datenelement erstellen wenn in der Tag-Eigenschaft keine Datenelemente vorhanden sind)
Benennen Sie das Datenelement page.pageInfo.pageName
.
Verwenden Sie die JavaScript-Variable Datenelementtyp , um auf einen Wert in der Datenschicht von Luma zu verweisen: digitalData.page.pageInfo.pageName
Markieren Sie die Kästchen für Wert in Kleinbuchstaben erzwingen und Text bereinigen, um die Groß-/Kleinschreibung zu standardisieren und unnötige Leerzeichen zu entfernen
Urlaub None
als Speicherdauer Einstellung, da dieser Wert auf jeder Seite unterschiedlich ist
Wählen Sie Speichern aus
Führen Sie dieselben Schritte aus, um diese vier zusätzlichen Datenelemente zu erstellen:
page.pageInfo.server
zugeordnet zu
digitalData.page.pageInfo.server
page.pageInfo.hierarchie1
zugeordnet zu
digitalData.page.pageInfo.hierarchie1
user.profile.attributes.username
zugeordnet zu
digitalData.user.0.profile.0.attributes.username
user.profile.attributes.loggedIn
zugeordnet zu
digitalData.user.0.profile.0.attributes.loggedIn
cart.orderId
zugeordnet zu digitalData.cart.orderId
(Sie verwenden dies während der Einrichten von Analytics Lektion)
Die JavaScript-Variable Datenelementtyp behandelt Array-Referenzen als Punkte anstelle von Klammern. Referenzieren Sie daher das Datenelement "Benutzername"als digitalData.user[0].profile[0].attributes.username
funktioniert nicht.
Als Nächstes können Sie das Datenelement "Identity Map"erstellen:
Navigieren Sie zu Datenelemente und wählen Sie Datenelement hinzufügen
Name das Datenelement identityMap.loginID
Als Erweiterung auswählen Adobe Experience Platform Web SDK
Als Datenelementtyp auswählen Identity map
Dadurch wird ein Bildschirmbereich rechts neben dem Datenerfassungsoberfläche für die Konfiguration der Identität:
Als Namespace, wählen Sie die Luma CRM Id
Namespace, den Sie zuvor in der Identitäten konfigurieren Lektion.
Wenn Sie Ihre Luma CRM Id
-Namespace verwenden, überprüfen Sie, ob Sie ihn auch in Ihrer standardmäßigen Produktions-Sandbox erstellt haben. Derzeit werden im Dropdown-Menü Namespace nur Namespaces angezeigt, die in der standardmäßigen Produktions-Sandbox erstellt wurden.
Nach dem Namespace ausgewählt ist, muss eine ID festgelegt werden. Wählen Sie die user.profile.attributes.username
-Datenelement, das zuvor in dieser Lektion erstellt wurde und eine ID erfasst, wenn Benutzer bei der Site "Luma"angemeldet sind.
Als Authentifizierter Status auswählen Authentifiziert
Wählen Sie Speichern aus
Die primäre Identität ist in allen an Adobe Experience Platform gesendeten Datensätzen erforderlich. Standardmäßig wird die Experience Cloud-ID (ECID) als primäre Identität des Platform Web SDK verwendet. Sie möchten nie etwas wie das Luma CRM ID
als primäre Identität mit dem Web SDK verwenden, da sie erst existiert, nachdem sich der Benutzer authentifiziert hat, und daher nicht in allen Datensätzen verfügbar wäre.
Alle von Ihnen erstellten Datenelemente müssen einem XDM-Objekt zugeordnet sein. Dieses Objekt sollte mit dem XDM-Schema übereinstimmen, das Sie während der Schema konfigurieren Lektion.
Es gibt verschiedene Möglichkeiten, Datenelemente XDM-Objektfeldern zuzuordnen. Sie können einzelne Datenelemente einzelnen XDM-Feldern zuordnen oder Datenelemente ganzen XDM-Objekten zuordnen, sofern Ihr Datenelement mit dem exakten Schlüssel-Wert-Paar-Schema im XDM-Objekt übereinstimmt. In dieser Lektion erfassen Sie Inhaltsdaten, indem Sie sie einzelnen Feldern zuordnen. Sie werden lernen, Zuordnen eines Datenelements zu einem ganzen XDM-Objekt im Einrichten von Analytics Lektion.
Erstellen Sie ein XDM-Objekt zum Erfassen von Inhaltsdaten:
Wählen Sie im linken Navigationsbereich die Option Datenelemente
Wählen Sie Datenelement hinzufügen aus
Benennen Sie das Datenelement . xdm.content
Als Erweiterung select Adobe Experience Platform Web SDK
Als Datenelementtyp select XDM object
Plattform auswählen Sandbox in dem Sie das XDM-Schema während der Konfigurieren eines XDM-Schemas Lektion in diesem Beispiel DEVELOPMENT Mobile and Web SDK Courses
Als Schema, wählen Sie Luma Web Event Data
schema:
Die Sandbox entspricht der Experience Platformen-Sandbox, in der Sie das Schema erstellt haben. In Ihrer Experience Platform-Instanz können mehrere Sandboxes verfügbar sein. Stellen Sie daher sicher, dass Sie die richtige Sandbox auswählen. Arbeiten Sie immer zuerst in der Entwicklung, dann in der Produktion.
Scrollen Sie nach unten, bis Sie zum web
Objekt
Auswahl zum Öffnen
Ordnen Sie die folgenden Web-XDM-Variablen Datenelementen zu
web.webPageDetials.name
in %page.pageInfo.pageName%
web.webPageDetials.server
in %page.pageInfo.server%
web.webPageDetials.siteSection
in %page.pageInfo.hierarchie1%
Suchen Sie als Nächstes die identityMap
-Objekt im Schema und wählen Sie es aus
Zuordnung zu identityMap.loginID
Datenelement
Wählen Sie Speichern aus
Am Ende dieser Schritte sollten die folgenden Datenelemente erstellt werden:
Datenelemente der CORE-Erweiterung | Platform Web SDK-Datenelemente |
---|---|
cart.orderId |
identityMap.loginID |
page.pageInfo.hierarchie1 |
xdm.content |
page.pageInfo.pageName |
|
page.pageInfo.server |
|
user.profile.attributes.loggedIn |
|
user.profile.attributes.username |
Wenn diese Datenelemente vorhanden sind, können Sie mit dem Senden von Daten an Platform Edge Network über das XDM-Objekt beginnen, indem Sie eine Regel in Tags erstellen.
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. Diskussionsbeitrag der Experience League