Erstellen von Datenelementen
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:
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](./media_13a7791139dfbcb543c2b0369d2d52c3cca4c6836.png?width=750&format=png&optimize=medium)
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
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:
code language-json |
---|
|
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
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.
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 zudigitalData.page.pageInfo.server
-
page.pageInfo.hierarchie1
zugeordnet zudigitalData.page.pageInfo.hierarchie1
-
user.profile.attributes.username
zugeordnet zudigitalData.user.0.profile.0.attributes.username
-
user.profile.attributes.loggedIn
zugeordnet zudigitalData.user.0.profile.0.attributes.loggedIn
-
product.productInfo.sku
zugeordnet zudigitalData.product.0.productInfo.sku
-
product.productInfo.title
zugeordnet zudigitalData.product.0.productInfo.title
-
cart.orderId
zugeordnet zudigitalData.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 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;
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:
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
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.