Dokumentation Experience Platform Web SDK-Tutorial

Datenelemente erstellen

Last update: Tue Dec 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:

Erstellt für:

Einsteiger
Fortgeschrittener
Entwickler

Erfahren Sie, wie Sie Datenelemente in Tags für Inhalts-, Commerce- und Identitätsdaten auf der Demo-Site von Luma erstellen. Füllen Sie dann Felder in Ihrem XDM-Schema mit dem Datenelementtyp Variable der Adobe Experience Platform Web SDK-Erweiterung aus.

Lernziele

Am Ende dieser Lektion können Sie:

Verstehen der verschiedenen Ansätze zum Zuordnen einer Datenschicht zu XDM
Erstellen von Datenelementen zur Datenerfassung
Zuordnen von Datenelementen zu einem XDM-Objekt

Voraussetzungen

Sie wissen, was eine Datenschicht ist, und haben die vorherigen Lektionen im Tutorial abgeschlossen:

IMPORTANT

Die Daten für diese Lektion stammen aus der digitalData Datenschicht auf der Luma-Site. Um die Datenschicht anzuzeigen, öffnen Sie die Entwicklerkonsole und geben Sie ein, digitalData die vollständige verfügbare Datenschicht anzuzeigen.

Ansätze für Datenschichten

Es gibt mehrere Möglichkeiten, Daten aus Ihrer Datenschicht mithilfe der Tags-Funktion von Adobe Experience Platform XDM zuzuordnen. Im Folgenden finden Sie einige Vor- und Nachteile von drei verschiedenen Ansätzen. Es ist möglich, Ansätze zu kombinieren, falls gewünscht:

Implementieren von XDM in der Datenschicht
Zuordnen zu XDM in Tags
Zu XDM im Datenstrom zuordnen

NOTE

Die Beispiele in diesem Tutorial folgen dem Ansatz Zu XDM in Tags zuordnen .

Implementieren von XDM in der Datenschicht

Dieser Ansatz beinhaltet die Verwendung des vollständig definierten XDM-Objekts als Struktur für Ihre Datenschicht. Anschließend ordnen Sie die gesamte Datenschicht einem XDM-Objekt-Datenelement in Tags zu. Wenn Ihre Implementierung keinen Tag-Manager verwendet, kann dieser Ansatz ideal sein, da Sie mit dem Befehl „XDM sendEvent Daten direkt aus Ihrer Anwendung an XDM senden. Wenn Sie Tags verwenden, können Sie ein benutzerdefiniertes Code-Datenelement erstellen, das die gesamte Datenschicht als Passthrough-JSON-Objekt an das XDM erfasst. Anschließend ordnen Sie die Passthrough-JSON dem XDM-Objektfeld in der Aktion „Ereignis senden“ zu.

Im Folgenden finden Sie ein Beispiel dafür, wie die Datenschicht bei Verwendung des Adobe-Client-Datenschichtformats aussehen würde:

XDM in Data Layer-Beispiel

code language-json

code language-json
`window.adobeDataLayer.push({ "eventType": "web.webPageDetails.pageViews", "web":{ "webInteraction":{ "linkClicks":{ "id":"", "value":"" }, "URL":"", "name":"", "region":"", "type":"" }, "webPageDetails":{ "pageViews":{ "id":"", "value":"1" }, "URL":"https://luma.enablementadobe.com/", "isErrorPage":"", "isHomePage":"", "name":"luma:home", "server":"enablementadobe.com", "siteSection":"home", "viewName":"" }, "webReferrer":{ "URL":"", "type":"" } } });`

window.adobeDataLayer.push({
"eventType": "web.webPageDetails.pageViews",
"web":{
         "webInteraction":{
            "linkClicks":{
               "id":"",
               "value":""
            },
            "URL":"",
            "name":"",
            "region":"",
            "type":""
         },
         "webPageDetails":{
            "pageViews":{
               "id":"",
               "value":"1"
            },
            "URL":"https://luma.enablementadobe.com/",
            "isErrorPage":"",
            "isHomePage":"",
            "name":"luma:home",
            "server":"enablementadobe.com",
            "siteSection":"home",
            "viewName":""
         },
         "webReferrer":{
            "URL":"",
            "type":""
         }
      }
});

Vorteile

Beseitigt zusätzliche Schritte, um Datenschichtvariablen XDM zuzuordnen
Die Bereitstellung kann schneller erfolgen, wenn Ihrem Web-Entwicklungs-Team auch das Tagging digitalen Verhaltens gehört

Nachteile

Vollständige Abhängigkeit vom Entwicklungsteam und vom Entwicklungszyklus zur Aktualisierung der an XDM gesendeten Daten
Eingeschränkte Flexibilität, da XDM die genaue Payload von der Datenschicht erhält
Integrierte Tags-Funktionen wie Scraping, Persistenz und Funktionen für schnelle Bereitstellungen können nicht verwendet werden.
Die Verwendung der Datenschicht für Pixel von Drittanbietern ist schwieriger (Sie sollten diese Pixel jedoch möglicherweise in die Ereignisweiterleitung“!
Keine Möglichkeit, die Daten zwischen der Datenschicht und XDM umzuwandeln

Zuordnen der Datenschicht in Tags

Dieser Ansatz beinhaltet die Zuordnung einzelner Datenschichtvariablen ODER Datenschichtobjekte zu Datenelementen in Tags und schließlich zu XDM. Dies ist der herkömmliche Implementierungsansatz unter Verwendung eines Tag-Management-Systems.

Vorteile

Der flexibelste Ansatz, da Sie einzelne Variablen steuern und Daten transformieren können, bevor sie an XDM gesendet werden
Kann Adobe-Tags-Trigger und Scraping-Funktionen verwenden, um Daten an XDM zu übergeben
Kann Datenelemente Client-seitig Pixel von Drittanbietern zuordnen

Nachteile

benötigt Zeit, um die Datenschicht als Datenelemente zu rekonstruieren

TIP

Google-Datenschicht

Wenn Ihr Unternehmen bereits Google Analytics verwendet und das herkömmliche Google-Datenschichtobjekt auf Ihrer Website hat, können Sie die Google-Datenschichterweiterung in Tags verwenden. So können Sie Adobe-Technologie schneller bereitstellen, ohne den Support von Ihrem IT-Team anfordern zu müssen. Wenn Sie die Google-Datenschicht XDM zuordnen, gehen Sie wie oben beschrieben vor.

Zu XDM im Datenstrom zuordnen

Dieser Ansatz verwendet Funktionen, die in die Datenstromkonfiguration integriert sind ( für die Datenerfassung),die Zuordnung von Datenschichtvariablen zu XDM in Tags übersprungen.

Vorteile

Flexibel, da Sie einzelne Variablen XDM zuordnen können
Möglichkeit „Berechnung neuer Werte oder Umwandlung von Datentypen aus einer Datenschicht, bevor sie an XDM gesendet wird
Nutzen Sie eine ZuordnungsBenutzeroberfläche, um Felder in Ihren Quelldaten mithilfe einer Point-and-Click-Benutzeroberfläche XDM zuzuordnen

Nachteile

Datenschichtvariablen können nicht als Datenelemente für Client-seitige Pixel von Drittanbietern verwendet werden, sie können jedoch bei der Ereignisweiterleitung verwendet werden
Die Scraping-Funktion der Tags-Funktion von Adobe Experience Platform kann nicht verwendet werden
Die Wartung ist komplexer, wenn die Zuordnung der Datenschicht sowohl in Tags als auch im Datenstrom erfolgt

IMPORTANT

Wie bereits erwähnt, folgen die Beispiele in diesem Tutorial dem Ansatz Zu XDM in Tags zuordnen .

Erstellen von Datenelementen zur Erfassung der Datenschicht

Bevor Sie das XDM-Objekt erstellen, erstellen Sie den folgenden Satz von Datenelementen für die Datenschicht Demo-Site von Luma:

Wechseln 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 den JavaScript Variablen Datenelementtyp, auf einen Wert in der Datenschicht von Luma zu verweisen: digitalData.page.pageInfo.pageName
Markieren Sie die Kästchen für Kleinbuchstaben erzwingen und Text bereinigen, um die Groß-/Kleinschreibung zu standardisieren und überflüssige Leerzeichen zu entfernen
Belassen Sie None als Einstellung Speicherdauer, da dieser Wert auf jeder Seite anders ist
Wählen Sie Speichern

Erstellen Sie diese zusätzlichen Datenelemente, indem Sie die gleichen Schritte ausführen:

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
product.productInfo.sku zugeordnet zu digitalData.product.0.productInfo.sku
product.productInfo.title zugeordnet zu digitalData.product.0.productInfo.title
cart.orderId zugeordnet zu digitalData.cart.orderId

product.category Verwendung des benutzerspezifischer Code Datenelementtyps) folgenden benutzerdefinierten Code, um die Website-URL für die Kategorie der obersten Ebene zu analysieren:

code language-javascript
`var cat = location.pathname.split(/[/.]+/); if (cat[5] == 'products') { return (cat[6]); } else if (cat[5] != 'html') { return (cat[5]); }`

cart.productInfo mit dem folgenden benutzerdefinierten Code:

code language-javascript
`var cart = digitalData.cart.cartEntries; var cartItem = []; cart.forEach(function(item, index, array){ cartItem.push({ "SKU": item.sku }); }); return cartItem;`

cart.productInfo.purchase mit dem folgenden benutzerdefinierten Code:

code language-javascript

code language-javascript
`var cart = digitalData.cart.cartEntries; var cartItem = []; cart.forEach(function(item, index, array){ var qty = parseInt(item.qty); var price = parseInt(item.price); cartItem.push({ "SKU": item.sku, "quantity": qty, "priceTotal": price }); }); return cartItem;`

var cart = digitalData.cart.cartEntries;
var cartItem = [];
cart.forEach(function(item, index, array){
var qty = parseInt(item.qty);
var price = parseInt(item.price);
cartItem.push({
"SKU": item.sku,
"quantity": qty,
"priceTotal": price
});
});
return cartItem;

CAUTION

Der Datenelementtyp JavaScript behandelt Array-Verweise als Punkte anstatt als Klammern, sodass das Verweisen auf das Datenelement Benutzername als digitalData.user[0].profile[0].attributes.usernamenicht funktioniert.

Erstellen variabler Datenelemente für XDM und Datenobjekte

Die soeben erstellten Datenelemente werden zum Erstellen eines XDM-Objekts (für Platform-Programme) und eines Datenobjekts (für Analytics, Target und Audience Manager) verwendet. Diese Objekte haben ihre eigenen speziellen Datenelemente namens Variable Datenelemente, die sehr einfach zu erstellen sind.

Um das Datenelement „Variable“ für XDM zu erstellen, binden Sie es an das Schema, das Sie in der Lektion Konfigurieren eines Schemas“ erstellt:

Wählen Sie Datenelement hinzufügen
Benennen Sie Ihr Datenelement xdm.variable.content. Es wird empfohlen, den XDM-spezifischen Datenelementen „xdm“ voranzustellen, um Ihre Tag-Eigenschaft besser zu organisieren
Wählen Sie Adobe Experience Platform Web SDK als Erweiterung
Wählen Sie Variable als Datenelementtyp
Wählen Sie XDM als Eigenschaft
Wählen Sie die Sandbox, in der Sie das Schema erstellt haben
Wählen Sie das entsprechende Schema aus, in diesem Fall Luma Web Event Data
Wählen Sie Speichern

Erstellen Sie anschließend das Datenelement Variable für Ihr Datenobjekt:

Wählen Sie Datenelement hinzufügen
Benennen Sie Ihr Datenelement data.variable. Es wird empfohlen, den für das Datenobjekt spezifischen Datenelementen das Präfix „data“ voranzustellen, um Ihre Tag-Eigenschaft besser zu organisieren
Wählen Sie Adobe Experience Platform Web SDK als Erweiterung
Wählen Sie Variable als Datenelementtyp
Wählen Sie data als property
Wählen Sie die Experience Cloud-Lösungen aus, die Sie im Rahmen dieses Tutorials implementieren möchten
Wählen Sie Speichern

Am Ende dieser Schritte sollten die folgenden Datenelemente erstellt sein:

Datenelemente der Haupterweiterung

Datenelemente der Platform Web SDK-Erweiterung

cart.orderId

data.variable

cart.productInfo

xdm.variable.content

cart.productInfo.purchase

page.pageInfo.hierarchie1

page.pageInfo.pageName

page.pageInfo.server

product.category

product.productInfo.sku

product.productInfo.title

user.profile.attributes.loggedIn

user.profile.attributes.username

TIP

In einer zukünftigen Lektion Erstellen von TagRegeln) erfahren Sie, wie Sie mit den Variable-Datenelementen mehrere Regeln in Tags mithilfe des Aktionstyps „Variable aktualisieren“ können.

Wenn diese Datenelemente vorhanden sind, können Sie mit einer Tag-Regel beginnen, Daten an das Platform-Edge Network zu senden. Erfahren Sie jedoch zuerst mehr über das Erfassen von Identitäten mit Web SDK.

Weiter:

NOTE

Vielen Dank, dass Sie sich Zeit genommen haben, um mehr über Adobe Experience Platform Web SDK zu erfahren. Wenn Sie Fragen haben, allgemeines Feedback geben möchten oder Vorschläge für zukünftige Inhalte haben, teilen Sie diese bitte auf diesem Experience League-Community-Diskussionsbeitrag

recommendation-more-help

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