DocumentatieExperience PlatformTutorial voor Web SDK

Gegevenselementen maken

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Beginner
  • tussenpersoon
  • Ontwikkelaar

Leer hoe te om gegevenselementen in markeringen voor inhoud, handel, en identiteitsgegevens over de de demoplaats van de Lumatot stand te brengen. Vul vervolgens velden in uw XDM-schema met het gegevenstype Variabele voor gegevenselement in de extensie van Adobe Experience Platform Web SDK.

Leerdoelstellingen

Aan het einde van deze les kunt u het volgende doen:

  • Begrijp verschillende benaderingen om een gegevenslaag aan XDM in kaart te brengen
  • Gegevenselementen maken om gegevens vast te leggen
  • Gegevenselementen toewijzen aan een XDM-object

Vereisten

U hebt inzicht in wat een gegevenslaag is en de vorige lessen in het leerprogramma voltooid:

IMPORTANT
De gegevens voor deze les komen uit de digitalData gegevenslaag op de plaats van de Luma. Als u de gegevenslaag wilt weergeven, opent u de ontwikkelaarsconsole en typt u in digitalData om de volledige beschikbare gegevenslaag weer te geven. digitalData gegevenslaag

Datalaagbenaderingen

Er zijn meerdere manieren om gegevens van uw gegevenslaag toe te wijzen aan XDM gebruikend de markeringsfunctionaliteit van Adobe Experience Platform. Hieronder volgen een paar voor- en nadelen van drie verschillende benaderingen. Indien gewenst kunnen benaderingen worden gecombineerd:

  1. XDM in de gegevenslaag implementeren
  2. Toewijzen aan XDM in tags
  3. Toewijzen aan XDM in de gegevensstroom
NOTE
De voorbeelden in deze zelfstudie volgen de Tagbenadering Kaart aan XDM.

XDM in de gegevenslaag implementeren

Deze benadering impliceert het gebruiken van het volledig bepaalde voorwerp XDM als structuur voor uw gegevenslaag. Vervolgens wijst u de volledige gegevenslaag toe aan een XDM-objectelement in tags. Als uw implementatie geen markeringsmanager gebruikt, kan deze benadering ideaal zijn omdat u gegevens naar XDM direct van uw toepassing kunt verzenden gebruikend het XDM sendEvent bevel. Als u wel tags gebruikt, kunt u een aangepast code-gegevenselement maken waarmee de gehele gegevenslaag als een pass-through JSON-object wordt vastgelegd op de XDM. Vervolgens wijst u de pass-through JSON toe aan het XDM-objectveld in de Send Event-handeling.

Hieronder is een voorbeeld van hoe de gegevenslaag als het gebruiken van het formaat van de Laag van de Gegevens van de Cliënt van de Adobe zou kijken:

XDM in het voorbeeld Gegevenslaag
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":""
         }
      }
});

Pros

  • Elimineert extra stappen die aan de variabelen van de gegevenslaag opnieuw aan XDM worden toegewezen
  • Mogelijk is de implementatie sneller als uw webontwikkelingsteam ook eigenaar is van taggen met digitaal gedrag

Cons

  • Volledige afhankelijkheid van ontwikkelingsteam en ontwikkelingscyclus voor het bijwerken van welke gegevens naar XDM gaan
  • Beperkte flexibiliteit omdat XDM de exacte lading van de gegevenslaag ontvangt
  • Kan ingebouwde tagfuncties, zoals plakken, persistentie, functies voor snelle implementatie niet gebruiken
  • Harder om de gegevenslaag voor derdepixel te gebruiken (maar u zou deze pixel aan gebeurtenis kunnen willen bewegen door:sturen!
  • Kan de gegevens niet transformeren tussen de gegevenslaag en XDM

Gegevenslaag toewijzen in tags

Deze benadering omvat het in kaart brengen van individuele gegevenslaagvariabelen OF gegevenslaagvoorwerpen aan gegevenselementen in markeringen en uiteindelijk aan XDM. Dit is de traditionele benadering van implementatie gebruikend een systeem van het markeringsbeheer.

Pros

  • De meest flexibele benadering zoals u individuele variabelen kunt controleren en gegevens omzetten alvorens het XDM krijgt
  • Kan Adobe-tagtriggers en -schrappingsfunctionaliteit gebruiken om gegevens door te geven aan XDM
  • Gegevenselementen kunnen worden toegewezen aan client-side pixels van derden

Cons

  • Er is tijd nodig om de gegevenslaag te reconstrueren als gegevenselementen
TIP
Google-gegevenslaag
Als uw organisatie reeds Googles Analytics gebruikt en het traditionele Google dataLayer voorwerp op uw website heeft, kunt u de uitbreiding van de Laag van Gegevens van Googlein markeringen gebruiken. Hierdoor kunt u sneller Adobe technologie implementeren zonder dat u ondersteuning van uw IT-team nodig hebt. Als u de Google-gegevenslaag toewijst aan XDM, worden dezelfde stappen uitgevoerd als hierboven.

Toewijzen aan XDM in de gegevensstroom

Deze benadering gebruikt functionaliteit die in de configuratie van de gegevensstroom wordt ingebouwd Prep van Gegevens voor de Inzameling van Gegevensen slaat de variabelen van de kaartgegevenslaag aan XDM in markeringen over.

Pros

  • Flexibel omdat u individuele variabelen aan XDM kunt in kaart brengen
  • Capaciteit om nieuwe waardenof transformatie gegevenstypesvan een gegevenslaag gegevens uit te werken alvorens het naar XDM gaat
  • Hefboomwerking a Afbeelding UIaan kaartgebieden in uw brongegevens aan XDM met een punt-en-klik UI

Cons

  • Kan gegevenslaagvariabelen niet als gegevenselementen voor cliënt-kant derdepixel gebruiken, maar kan hen gebruiken met gebeurtenis het door:sturen
  • Kan de plakfunctie van de tagfunctie van Adobe Experience Platform niet gebruiken
  • De complexiteit van onderhoud neemt toe als de gegevenslaag zowel in tags als in gegevensstroom wordt toegewezen
IMPORTANT
Zoals eerder vermeld, volgen de voorbeelden in deze zelfstudie de optie Toewijzen aan XDM in de tagaanpak.

Gegevenselementen maken om de gegevenslaag vast te leggen

Alvorens u het voorwerp XDM creeert, creeer de volgende reeks gegevenselementen voor de 🔗 gegevenslaag 1} van de Luminagedemo :

  1. Ga naar Data Elements en selecteer Add Data Element (of Create New Data Element als de eigenschap tag geen bestaande gegevenselementen bevat)

    creeer het Element van Gegevens

  2. Naam van het gegevenselement page.pageInfo.pageName

  3. Gebruik JavaScript Variable Data Element type om naar een waarde in de gegevenslaag van Luma te wijzen: digitalData.page.pageInfo.pageName

  4. Schakel de selectievakjes voor Force lowercase value en Clean text in om het hoofdlettergebruik te standaardiseren en overbodige spaties te verwijderen

  5. Laat None staan als de instelling Storage Duration omdat deze waarde op elke pagina anders is

  6. Selecteren Save

    het Element van Gegevens van de Naam van de Pagina

Maak deze aanvullende gegevenselementen door dezelfde stappen uit te voeren:

  • page.pageInfo.server toegewezen aan
    digitalData.page.pageInfo.server

  • page.pageInfo.hierarchie1 toegewezen aan
    digitalData.page.pageInfo.hierarchie1

  • user.profile.attributes.username toegewezen aan
    digitalData.user.0.profile.0.attributes.username

  • user.profile.attributes.loggedIn toegewezen aan
    digitalData.user.0.profile.0.attributes.loggedIn

  • product.productInfo.sku toegewezen aan digitalData.product.0.productInfo.sku

  • product.productInfo.title toegewezen aan digitalData.product.0.productInfo.title

  • cart.orderId toegewezen aan digitalData.cart.orderId

  • product.category door de URL van de site te parseren voor de categorie op hoofdniveau met de Custom Code Data Element type en de volgende aangepaste code:

    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 gebruiken van de volgende douanecode:

    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 gebruiken van de volgende douanecode:

    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;
CAUTION
Het JavaScript variable type van gegevenselement behandelt serieverwijzingen als punten in plaats van haakjes, zodat zal het van verwijzingen voorzien van het element van gebruikersnaamelementen zoals digitalData.user[0].profile[0].attributes.username niet werken.

Variabele-gegevenselementen maken voor XDM- en gegevensobjecten

De gegevenselementen u enkel creeerde zullen worden gebruikt om een voorwerp XDM (voor de toepassingen van het Platform) en een gegevensvoorwerp (voor Analytics, Doel, en Audience Manager) te bouwen. Deze objecten hebben hun eigen speciale gegevenselementen, Variable gegevenselementen, die u heel gemakkelijk kunt maken.

Om het Variabele gegevenselement voor XDM tot stand te brengen, koppelt u het aan het schema u in creeerde vormt een schemales:

  1. Selecteren Add Data element

  2. Geef uw gegevenselement een naam xdm.variable.content. Het wordt aanbevolen om de gegevenselementen die specifiek zijn voor XDM, vooraf in te delen met "xdm" om de eigenschap tag beter te organiseren

  3. Selecteer Adobe Experience Platform Web SDK als Extension

  4. Selecteer Variable als Data Element Type

  5. Selecteer XDM als de property

  6. Selecteer de Sandbox waarin u het schema hebt gemaakt

  7. Selecteer in dit geval de juiste Schema Luma Web Event Data .

  8. Selecteren Save

    Variabel gegevenselement voor XDM

Maak vervolgens het gegevenselement Variabele voor het gegevensobject:

  1. Selecteren Add Data element

  2. Geef uw gegevenselement een naam data.variable. Het wordt aanbevolen om de gegevenselementen die specifiek zijn voor het gegevensobject, vooraf in te stellen op 'data' om de eigenschap tag beter te organiseren

  3. Selecteer Adobe Experience Platform Web SDK als Extension

  4. Selecteer Variable als Data Element Type

  5. Selecteer data als de property

  6. Selecteer de oplossingen voor Experiencen Cloud die u wilt implementeren als onderdeel van deze zelfstudie

  7. Selecteren Save

    Variabel gegevenselement voor gegevensvoorwerp

Aan het einde van deze stappen moeten de volgende gegevenselementen worden gemaakt:

Core Extension Data Elements
Platform Web SDK Extension Data Elements
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 een toekomstige creeer markeringsregelsles, leert u hoe de Variable gegevenselementen u toestaan om veelvoudige regels in markeringen te stapelen gebruikend Update Variable Action type.

Met deze gegevenselementen op zijn plaats, bent u bereid om gegevens naar de Edge Network van het Platform met een markeringsregel te beginnen te verzenden. Maar eerst, leer over het verzamelen van identiteiten met Web SDK.

Volgende:

NOTE
Bedankt dat u tijd hebt geïnvesteerd in het leren over de SDK van Adobe Experience Platform Web. Als u vragen hebt, algemene terugkoppelen wilt delen, of suggesties over toekomstige inhoud hebben, gelieve hen op deze Communautaire besprekingspost van de Experience League te delen
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4