Dokumentation Experience Platform Web SDK-Tutorial

Erstellen von Datenelementen

Last update: Sat Jun 01 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:
Tags

Erstellt für:

Einsteiger
Fortgeschrittener
Entwickler

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

Lernziele

Am Ende dieser Lektion können Sie:

Verstehen verschiedener 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 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.

Datenschichtansätze

Es gibt mehrere Möglichkeiten, Daten aus Ihrer Datenschicht mithilfe der Tagfunktion von Adobe Experience Platform XDM zuzuordnen. Im Folgenden finden Sie einige Vor- und Nachteile von drei verschiedenen Ansätzen. Bei Bedarf können Ansätze kombiniert werden:

Implementieren von XDM in der Datenschicht
Zuordnung zu XDM in Tags
Zuordnung zu XDM im Datastream

NOTE

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

Implementieren von XDM in der Datenschicht

Bei diesem Ansatz wird das vollständig definierte XDM-Objekt als Struktur für Ihre Datenschicht verwendet. Anschließend ordnen Sie die gesamte Datenschicht einem XDM-Objektdatenelement in Tags zu. Wenn Ihre Implementierung keinen Tag-Manager verwendet, ist dieser Ansatz möglicherweise optimal, da Sie Daten von Ihrer Anwendung direkt mit dem XDM sendEvent, Befehl. Wenn Sie Tags verwenden, können Sie ein benutzerdefiniertes Code-Datenelement erstellen, das die gesamte Datenschicht als Pass-Through-JSON-Objekt an das XDM erfasst. Anschließend ordnen Sie die Pass-Through-JSON dem XDM-Objektfeld in der Aktion "Ereignis senden"zu.

Im Folgenden finden Sie ein Beispiel dafür, wie die Datenschicht mit dem Adobe Client-Datenschichtformat aussehen würde:

XDM im Beispiel einer Datenschicht

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, die auf Datenschichtvariablen in XDM beschränkt sind
Die Bereitstellung kann schneller erfolgen, wenn Ihr Webentwicklungsteam auch Eigentümer des Tagging-digitalen Verhaltens ist

Nachteile

Vollständige Abhängigkeit vom Entwicklungsteam und vom Entwicklungszyklus für die Aktualisierung der Daten an XDM
Eingeschränkte Flexibilität, da XDM die exakte Payload von der Datenschicht erhält
Es können keine integrierten Tags-Funktionen wie Scraping, Persistenz, Funktionen für schnelle Bereitstellungen verwendet werden
Die Verwendung der Datenschicht für Pixel von Drittanbietern ist schwieriger (Sie sollten diese Pixel jedoch verschieben in Ereignisweiterleitung!
Keine Transformation der Daten zwischen der Datenschicht und XDM

Zuordnen der Datenschicht in Tags

Dieser Ansatz umfasst die Zuordnung einzelner Datenschichtvariablen ODER Datenschichtobjekte zu Datenelementen in Tags und schließlich zu XDM. Dies ist der traditionelle Ansatz für die Implementierung mithilfe eines Tag-Management-Systems.

Vorteile

Der flexibelste Ansatz, da Sie einzelne Variablen steuern und Daten transformieren können, bevor sie in XDM gelangen
Kann Adobe-Tags-Trigger und Scraping-Funktionen verwenden, um Daten an XDM zu übergeben
Kann Datenelemente Client-seitigen Drittanbieterpixel zuordnen

Nachteile

Zeit zum Rekonstruieren der Datenschicht als Datenelemente

TIP

Google-Datenschicht

Wenn Ihr Unternehmen bereits Google Analytics verwendet und auf Ihrer Website über das herkömmliche Google dataLayer -Objekt verfügt, können Sie die Google Data Layer-Erweiterung in Tags. Dadurch können Sie Adobe-Technologie schneller bereitstellen, ohne Unterstützung von Ihrem IT-Team anfordern zu müssen. Die Zuordnung der Google-Datenschicht zu XDM würde dieselben Schritte wie oben ausführen.

Zuordnung zu XDM im Datastream

Bei diesem Ansatz werden Funktionen verwendet, die in die Datastream-Konfiguration integriert sind: Datenvorbereitung für die Datenerfassung und überspringt die Zuordnung von Datenschichtvariablen zu XDM in Tags.

Vorteile

Flexibel, da Sie einzelne Variablen XDM zuordnen können
Fähigkeit Neue Werte berechnen oder Datentypen transformieren aus einer Datenschicht, bevor sie an XDM gesendet wird
Nutzen Sie eine Zuordnungs-Benutzeroberfläche , um Felder in Ihren Quelldaten mit einer Point-and-Click-Benutzeroberfläche XDM zuzuordnen.

Nachteile

Datenschichtvariablen können nicht als Datenelemente für clientseitige Drittanbieterpixel verwendet werden, können aber mit der Ereignisweiterleitung verwendet werden
Die Scraping-Funktion der Tags-Funktion von Adobe Experience Platform kann nicht verwendet werden
Die Wartungskomplexität erhöht sich bei der Zuordnung der Datenschicht sowohl in Tags als auch im Datenspeicher.

IMPORTANT

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

Erstellen von Datenelementen zum Erfassen der Datenschicht

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

Navigieren Sie zu Datenelemente und wählen 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 auf einen Wert in der Datenschicht von Luma verweisen: digitalData.page.pageInfo.pageName
Markieren Sie die Kästchen für Kleinbuchstaben erzwingen Wert und Text bereinigen zur Standardisierung der Groß-/Kleinschreibung und Entfernung von Fremdbereichen
Urlaub None als Speicherdauer Einstellung, da dieser Wert auf jeder Seite unterschiedlich ist
Auswählen Speichern

Erstellen Sie diese zusätzlichen Datenelemente wie folgt:

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 mithilfe der Benutzerspezifischer Code Datenelementtyp und den folgenden benutzerspezifischen Code, um die Site-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 unter Verwendung des folgenden benutzerspezifischen Codes:

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 unter Verwendung des folgenden benutzerspezifischen Codes:

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

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.

Erstellen von Variablendatenelementen für XDM- und Datenobjekte

Die soeben erstellten Datenelemente werden zum Erstellen eines XDM-Objekts (für Platform-Anwendungen) und eines Datenobjekts (für Analytics, Target und Audience Manager) verwendet. Diese Objekte verfügen über eigene spezielle Datenelemente, die Variable Datenelemente, die sehr einfach zu erstellen sind.

Um das Datenelement "Variable"für XDM zu erstellen, verknüpfen Sie es mit dem Schema, das Sie im Schema konfigurieren Lektion:

Auswählen Datenelement hinzufügen
Ihr Datenelement benennen xdm.variable.content. Es wird empfohlen, das XDM-spezifische Datenelement mit "xdm"zu versehen, um Ihre Tag-Eigenschaft besser zu organisieren
Wählen Sie die Adobe Experience Platform Web SDK als Erweiterung
Wählen Sie die Variable als Datenelementtyp
Auswählen XDM als property
Wählen Sie die Sandbox in dem Sie das Schema erstellt haben
Wählen Sie die entsprechende Schema in diesem Fall Luma Web Event Data
Auswählen Speichern

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

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

Am Ende dieser Schritte sollten die folgenden Datenelemente erstellt werden:

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 Zukunft Erstellen von Tag-Regeln Lektion: Sie lernen, wie die Variable Datenelemente ermöglichen es Ihnen, mehrere Regeln in Tags mithilfe der Aktionstyp der Variablen aktualisieren.

Wenn diese Datenelemente vorhanden sind, können Sie mit dem Senden von Daten an Platform Edge Network mit einer Tagregel beginnen. Erfahren Sie zunächst, wie Sie Identitäten mit dem Web SDK erfassen.

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