Erstellen von Datenelementen

CAUTION
Wir gehen davon aus, dass am Dienstag, dem 23. April 2024, wichtige Änderungen an diesem Tutorial veröffentlicht werden. Danach ändern sich viele Übungen und Sie müssen das Tutorial möglicherweise von Anfang an neu starten, um alle Lektionen abzuschließen.

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.

NOTE
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".
IMPORTANT
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. digitalData-Datenschicht

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:

  1. Zuordnen von Website-Variablen zu Datenelementen und
  2. Zuordnen dieser Datenelemente zu einem XDM-Objekt

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:

  • Ereigniszusammenführungs-ID
  • Identitätszuordnung
  • XDM-Objekt

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.

Lernziele

Am Ende dieser Lektion können Sie:

  • Erstellen von Datenelementen zum Erfassen von Inhalten und ID-Daten für die Benutzeranmeldung
  • Erstellen eines Identitätszuordnungs-Datenelements
  • Zuordnen von Datenelementen zu einem XDM-Objektdatenelement

Voraussetzungen

Sie wissen, was eine Datenschicht ist, und kennen die Demosite "Luma" und wissen, wie Datenelemente in Tags referenziert werden. Sie müssen die folgenden vorherigen Schritte im Tutorial ausgeführt haben

IMPORTANT
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.

Erstellen von Datenelementen zum Erfassen der Datenschicht

Bevor Sie mit der Erstellung des XDM-Objekts beginnen, erstellen Sie den folgenden Satz von Datenelementen, die dem Demosite "Luma" Datenschicht:

  1. Navigieren Sie zu Datenelemente und wählen Datenelement hinzufügen (oder Neues Datenelement erstellen wenn in der Tag-Eigenschaft keine Datenelemente vorhanden sind)

    Datenelement erstellen

  2. Benennen Sie das Datenelement page.pageInfo.pageName.

  3. Verwenden Sie die JavaScript-Variable Datenelementtyp auf einen Wert in der Datenschicht von Luma verweisen: digitalData.page.pageInfo.pageName

  4. Markieren Sie die Kästchen für Kleinbuchstaben erzwingen Wert und Text bereinigen zur Standardisierung der Groß-/Kleinschreibung und Entfernung von Fremdbereichen

  5. Urlaub None als Speicherdauer Einstellung, da dieser Wert auf jeder Seite unterschiedlich ist

  6. Wählen Sie Speichern aus

    Datenelement Seitenname

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)

CAUTION
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.

Identitätszuordnungs-Datenelement erstellen

Als Nächstes können Sie das Datenelement "Identity Map"erstellen:

  1. Navigieren Sie zu Datenelemente und wählen Datenelement hinzufügen

  2. Name das Datenelement identityMap.loginID

  3. Als Erweiterung auswählen Adobe Experience Platform Web SDK

  4. Als Datenelementtyp auswählen Identity map

  5. Dadurch wird ein Bildschirmbereich rechts neben dem Datenerfassungsoberfläche für die Konfiguration der Identität:

    Datenerfassungsoberfläche

  6. Als Namespace, wählen Sie die Luma CRM Id Namespace, den Sie zuvor in der Identitäten konfigurieren Lektion.

    note note
    NOTE
    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.
  7. 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.

  8. Als Authentifizierter Status auswählen Authentifiziert

  9. Auswählen Primär

  10. Wählen Sie Speichern aus

    Datenerfassungsoberfläche

TIP
Adobe empfiehlt, Identitäten zu senden, die eine Person repräsentieren, z. B. Luma CRM Idals primary Identität.
Wenn die Identitätszuordnung die Personenkennung enthält (z. B. Luma CRM Id), wird die Personen-ID zur primary Identität. Andernfalls ECID wird primary Identität.

Zuordnen von Datenelementen zu XDM-Objekten

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 durch Zuordnung zu einzelnen Feldern. 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:

  1. Wählen Sie im linken Navigationsbereich die Option Datenelemente

  2. Auswählen Datenelement hinzufügen

  3. Name das Datenelement xdm.content

  4. Als Erweiterung select Adobe Experience Platform Web SDK

  5. Als Datenelementtyp select XDM object

  6. 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

  7. Als Schema, wählen Sie Luma Web Event Data schema:

    XDM-Objekt

    note note
    NOTE
    Die Sandbox entspricht der Experience Platform-Sandbox, in der Sie das Schema erstellt haben. In Ihrer Experience Platform-Instanz können mehrere Sandboxes verfügbar sein. Wählen Sie daher die richtige Sandbox aus. Arbeiten Sie immer zuerst in der Entwicklung, dann in der Produktion.
  8. Scrollen Sie nach unten, bis Sie zum web Objekt

  9. Auswahl zum Öffnen

    Webobjekt

  10. 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%

    XDM-Objekt

  11. Suchen Sie als Nächstes die identityMap -Objekt im Schema und wählen Sie es aus

  12. Zuordnung zu identityMap.loginID Datenelement

  13. Wählen Sie Speichern aus

    Datenerfassungsoberfläche

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.

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 oder Vorschläge zu künftigen Inhalten teilen möchten, teilen Sie diese hier mit. Experience League Community-Diskussionsbeitrag
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4