Erstellen von Datenelementen

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.

HINWEIS

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

WICHTIG

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” Datenschicht und wissen, wie Datenelemente in Tags referenziert werden. Sie müssen die folgenden vorherigen Schritte im Tutorial ausgeführt haben

WICHTIG

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 Sie 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 , um auf einen Wert in der Datenschicht von Luma zu verweisen: digitalData.page.pageInfo.pageName

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

  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)

VORSICHT

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

    HINWEIS

    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. Wählen Sie Speichern aus

    Datenerfassungsoberfläche

WARNUNG

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.

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, 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:

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

  2. Wählen Sie Datenelement hinzufügen aus

  3. ​Benennen Sie 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

    HINWEIS

    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.

  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:

HINWEIS

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

Auf dieser Seite