Konfigurera Adobe Analytics med Platform Web SDK
Lär dig konfigurera Adobe Analytics med Experience Platform Web SDK, skapa taggregler för att skicka data till Adobe Analytics och validera att Analytics hämtar in data som förväntat.
Adobe Analytics är en branschledande applikation som ger er möjlighet att förstå era kunder som människor och styra verksamheten med kundanalys.
Utbildningsmål
När lektionen är klar kan du:
- Konfigurera ett XDM-schema för Adobe Analytics och förstå skillnaden mellan automatiskt mappade och manuellt mappade XDM-variabler för Analytics
- Konfigurera ett datastream för att aktivera Adobe Analytics
- Mappa enskilda eller hela arraydataelement till XDM-objektet
- Hämta sidvyer i Adobe Analytics med XDM-objektet
- Samla in e-handelsdata med XDM-objektet för Adobe Analytics produktsträng
- Validera Adobe Analytics-variabler anges med XDM-objektet med Experience Platform Debugger
- Använd Adobe Analytics bearbetningsregler för att ange anpassade variabler
- Validera data hämtas av Adobe Analytics med Real-Time Reports
Förutsättningar
Du känner till taggar, Adobe Analytics och Luma demo site inloggnings- och shoppingfunktioner.
Du behöver minst ett test-/dev-rapportpaket-ID. Om du inte har någon test-/dev-rapportsserie som du kan använda för den här självstudiekursen, skapa en.
Du måste ha slutfört alla steg från de föregående avsnitten i självstudien:
XDM-scheman och analysvariabler
Grattis! Du har redan konfigurerat ett schema som är kompatibelt med Adobe Analytics i Konfigurera ett schema lektion!
Implementeringsplattformens Web SDK ska vara så produktagnostiska som möjligt. För Adobe Analytics sker inte mappning av eVars, props och händelser när du skapar ett schema, och inte heller under taggrelicenskonfigurationen som den har gjorts traditionellt. I stället blir varje nyckelvärdepar i XDM en kontextdatavariabel som mappas till en Analytics-variabel på ett av två sätt:
- Automatiskt mappade variabler med reserverade XDM-fält
- Manuellt mappade variabler med analysbearbetningsregler
Mer information om vilka XDM-variabler som automatiskt mappas till Adobe Analytics finns i Variabler mappas automatiskt i Analytics. Alla variabler som inte är automatiskt mappade måste mappas manuellt.
Schemat som skapats i Konfigurera ett schema lektionen innehåller några automatiskt mappade till analysvariabler, som beskrivs i följande tabell:
identitymap.ecid.[0].id
web.webPageDetails.pageViews.value
web.webPageDetails.name
web.webPageDetails.server
web.webPageDetails.siteSection
commerce.productViews.value
commerce.productListViews.value
commerce.checkouts.value
commerce.purchases.value
commerce.order.currencyCode
commerce.order.purchaseID
productListItems[].SKU
productListItems[].name
productListItems[].quantity
productListItems[].priceTotal
productListItems
-objekt.18 augusti 2022
productListItems[].SKU
prioriterar mappning till produktnamnet i variabeln s.products.Värdet som anges till
productListItems[].name
mappas endast till produktnamnet om productListItems[].SKU
finns inte. Annars är den omappad och tillgänglig i kontextdata.Ange inte en tom sträng eller null till
productListItems[].SKU
. Detta har den oönskade effekten av att mappa till produktnamnet i variabeln s.products.Konfigurera datastream
Platform Web SDK skickar data från din webbplats till Platform Edge Network. Din datastream talar sedan om för Platform Edge Network var dessa data ska vidarebefordras, i det här fallet, vilken av dina Adobe Analytics rapporteringsprogram.
-
Gå till Datainsamling gränssnitt
-
Välj Datastreams
-
Markera tidigare skapade
Luma Web SDK
datastream -
Välj Add Service
-
Välj Adobe Analytics som Service
-
Ange Report Suite ID av din utvecklingsrapportsserie
-
Välj Save
note tip TIP Lägg till fler rapportsviter genom att välja Add Report Suite motsvarar taggning i flera programsviter.
Skapa ytterligare dataelement
Hämta sedan in ytterligare data från Luma-datalagret och skicka dem till Platform Edge Network. Även om lektionen fokuserar på vanliga Adobe Analytics-krav kan alla insamlade data enkelt skickas till andra destinationer baserat på din datastream-konfiguration. Om du t.ex. har avslutat Adobe Experience Platform-lektionen skickas även de ytterligare data du får i lektionen till Platform.
Skapa dataelement för e-handel
Under lektionen Skapa dataelement kan du skapade JavaScript-dataelement som fångade innehåll och identitetsinformation. Nu ska du skapa ytterligare dataelement för att hämta in e-handelsdata. På grund av Luma demo site använder olika datalagerstrukturer för produktinformationssidor och produkter i kundvagnen, måste du skapa dataelement för varje scenario. Du måste skapa vissa anpassade kodelement för att kunna hämta det du behöver från Luma-datalagret, som kanske inte behövs när du implementerar på din egen webbplats. I så fall måste du slingra dig igenom en mängd olika varukorgsartiklar för att få information om varje produkt. Använd följande kodfragment:
-
Öppna taggegenskapen som du använder för självstudiekursen
-
Gå till Data Elements
-
Välj Add Data Element
-
Ge den ett namn
product.productInfo.sku
-
Använd Custom Code Data Element Type
-
Lämna kryssrutor för Force lowercase value och Clean text avmarkerad
-
Lämna
None
som Storage Duration inställning eftersom det här värdet är olika på alla sidor -
Välj Open Editor
-
Kopiera och klistra in följande kod
code language-javascript var cart = digitalData.product; var cartItem; cart.forEach(function(item){ cartItem = item.productInfo.sku; }); return cartItem;
-
Välj Save för att spara den anpassade koden
-
Välj Save spara dataelementet
Följ de här stegen för att skapa ytterligare dataelement:
-
product.productInfo.title
code language-javascript var cart = digitalData.product; var cartItem; cart.forEach(function(item){ cartItem = item.productInfo.title; }); return cartItem;
-
cart.productInfo
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, "name":item.title, "quantity":qty, "priceTotal":price }); }); return cartItem;
När du har lagt till dessa dataelement och skapat de tidigare elementen i Skapa dataelement lektion bör du ha följande dataelement:
cart.orderId
cart.productInfo
identityMap.loginID
page.pageInfo.hierarchie1
page.pageInfo.pageName
page.pageInfo.server
product.productInfo.sku
product.productInfo.title
user.profile.attributes.loggedIn
user.profile.attributes.username
xdm.content
- identityMap för att hämta det autentiserade ID:t enligt Skapa dataelement för identitetskarta träna i Skapa dataelement lektion.
- web objekt för att hämta innehåll enligt content XDM-objekt träna i Skapa dataelement lektion på alla dataelement ovan.
Öka sidvyer
I lektionen Skapa dataelement har skapat xdm.content
dataelement för att hämta in innehållsdimensioner. Eftersom du nu skickar data till Adobe Analytics måste du även mappa ett extra XDM-fält för att ange att en fyr ska bearbetas som en Analytics-sidvy.
-
Öppna
xdm.content
dataelement -
Bläddra nedåt och välj att öppna tills
web.webPageDetails
-
Välj för att öppna pageViews object
-
Ange value till
1
-
Välj Spara
s.t()
sidvisningsfyr för Analytics med AppMeasurement.js
. För en länk klickar du på beacon och anger webInteraction.linkClicks.value
till 1
Ange produktsträngen
Innan du mappar till produktsträngen är det viktigt att förstå att det finns två huvudobjekt i XDM-schemat som används för att hämta e-handelsdata som har särskilda relationer med Adobe Analytics:
- The
commerce
objekt ställer in Analytics-händelser somprodView
,scView
ochpurchase
- The
productListItems
objekt ställer in Analytics-dimensioner somproductID
.
Se Samla in data om handel och produkter för mer information.
Det är också viktigt att du förstår att du kan provide individual attributes till enskilda XDM-fält eller provide an entire array till ett XDM-objekt.
Mappa enskilda attribut till ett XDM-objekt
Du kan mappa till enskilda variabler för att samla in data på sidan med produktinformation på Luma Demo-webbplatsen:
-
Skapa en XDM object Data Element Type namngiven
xdm.commerce.prodView
-
Välj samma plattformssandlåda och XDM-schema som användes i tidigare lektioner
-
Öppna commerce object
-
Öppna productViews objekt och ange value till
1
note tip TIP Det här steget motsvarar inställningen prodView
händelse i Analytics -
Bläddra nedåt till och markera
productListItems
array -
Välj Provide individual items
-
Välj Add Item
note caution CAUTION The productListItems
är enarray
datatyp så att data förväntas komma in som en samling element. På grund av Luma-demonstrationswebbplatsens datalagerstruktur och eftersom det bara är möjligt att visa en produkt i taget på Luma-webbplatsen, kommer du att lägga till objekt individuellt. När du implementerar på din egen webbplats, beroende på din datalagerstruktur, kanske du kan tillhandahålla en hel array. -
Markera för att öppna Item 1
-
Mappa följande XDM-variabler till dataelement
productListItems.item1.SKU
till%product.productInfo.sku%
productListItems.item1.name
till%product.productInfo.title%
note important IMPORTANT Innan du sparar det här XDM-objektet måste du även ange globala variabler och sidvisningsökare:
-
Välj Save
Mappa en hel array till ett XDM-objekt
Som tidigare nämnts använder Luma Demo-webbplatsen en annan datalagerstruktur för produkter i kundvagnen. Elementet med anpassade koddata cart.productInfo
dataelement som du skapade tidigare slingor genom digitalData.cart.cartEntries
datalagerobjekt och översätter det till det obligatoriska XDM-objektschemat som krävs. Det nya formatet måste matcha exakt schemat som definieras av productListItems
XDM-schemats objekt.
Se jämförelsen nedan av Luma-webbplatsens datalager (vänster) till det översatta dataelementet (höger) för att illustrera:
Jämför dataelementet med productListItems
struktur (tips, det ska matcha).
price
och qty
formateras om till tal i dataelementet. Dessa formatkrav är viktiga för dataintegriteten i plattformar och fastställs under konfigurera scheman steg. I exemplet quantity använder Integer datatyp.Nu tillbaka till mappningen av XDM-objektet till en hel array. Skapa ett XDM-objektdataelement för att hämta produkter på kundvagnssidan:
-
Skapa en XDM object Data Element Type namngiven
xdm.commerce.cartView
-
Välj samma plattformssandlåda och XDM-schema som du använder för den här självstudien
-
Öppna commerce object
-
Öppna productListViews objekt och ange
value
till1
note tip TIP Det här steget motsvarar inställningen scView
händelse i Analytics -
Bläddra nedåt till och markera productListItems array
-
Välj Provide entire array
-
Mappa till
cart.productInfo
dataelementnote important IMPORTANT Innan du sparar det här XDM-objektet måste du även ange globala variabler och sidvisningsökare:
-
Välj Save
Skapa en till XDM object Data Element Type för utcheckning har anropats xdm.commerce.checkout
. Den här gången anger du commerce.checkouts.value till 1
, karta productListItems till cart.productInfo
som du just gjorde, och lägg till de"globala" variablerna och sidvisningsräknaren.
scCheckout
händelse i AnalyticsDet finns ytterligare steg för att hämta purchase
händelse:
-
Skapa en till XDM object Data Element Type för inköp anropade
xdm.commerce.purchase
-
Öppna commerce object
-
Öppna order object
-
Karta purchaseID till
cart.orderId
dataelement -
Ange currencyCode till hårdkodat värde
USD
note tip TIP Det här motsvarar inställningen s.purcahseID
ochs.currencyCode
variabler i Analytics -
Välj för att öppna
purchases
objekt och angevalue
till1
note tip TIP Det här motsvarar inställningen purchase
händelse i Analyticsnote important IMPORTANT Innan du sparar det här XDM-objektet måste du även ange globala variabler och sidvisningsökare:
-
Välj Save
I slutet av dessa steg bör du skapa följande fem XDM-objektdataelement:
xdm.commerce.cartView
xdm.commerce.checkout
xdm.commerce.prodView
xdm.commerce.purchase
xdm.content
Skapa ytterligare regler för Platform Web SDK
När du har skapat flera XDM-objektdataelement kan du ange beacons med hjälp av regler. I den här övningen skapar du individuella regler per e-handelshändelse och användningsvillkor så att reglerna aktiveras på rätt sidor. Låt oss börja med en produktvyhändelse.
-
Välj Rules och sedan Add Rule
-
Ge den ett namn
product view - library load - AA
-
Under Events, markera Library Loaded (Page Top)
-
Under Conditions, välj Add
-
Lämna Logic Type as Regular
-
Lämna Extensions as Core
-
Välj Condition Type as Path Without Query String
-
Till höger aktiverar du Regex växla
-
Under path equals set
/products/
. För demonstrationswebbplatsen Luma säkerställer den att regeln endast aktiveras på produktsidor -
Välj Keep Changes
-
Under Actions välj Add
-
Välj Adobe Experience Platform Web SDK extension
-
Välj Action Type as Send event
-
The Type fältet har en nedrullningsbar lista med värden att välja mellan. Välj
commerce.productViews
note tip TIP Det värde som markeras här påverkar inte hur data mappas till Analytics, men vi rekommenderar att variabeln tillämpas noggrant eftersom den används i Adobe Experience Platform segmentbygggränssnitt. Det valda värdet är tillgängligt att använda i c.a.x.eventtype
sammanhangsdatavariabel nedströms. -
Under XDM Data väljer du
xdm.commerce.prodView
XDM-objektdataelement -
Välj Keep Changes
-
Regeln ska se ut ungefär som nedan. Välj Save
Upprepa samma sak för alla andra e-handelshändelser med följande parametrar:
Regelnamn: kundvagnsvy - biblioteksinläsning - AA
- Event Type: Bibliotek inläst (sidan ovanpå)
- Condition: /content/luma/us/en/user/cart.html
- Ange ett värde under Web SDK - skicka åtgärd: commerce.productListViews
- XDM-data för Web SDK - skicka åtgärd:
%xdm.commerce.cartView%
Regelnamn: utcheckning - biblioteksinläsning - AA
- Event Type: Bibliotek inläst (sidan ovanpå)
- Condition /content/luma/us/en/user/checkout.html
- Typ för Web SDK - skicka åtgärd: commerce.checkouts
- XDM-data för Web SDK - skicka åtgärd:
%xdm.commerce.checkout%
Regelnamn: purchase - library load - AA
- Event Type: Bibliotek inläst (sidan ovanpå)
- Condition /content/luma/us/en/user/checkout/order/thank-you.html
- Typ för Web SDK - skicka åtgärd: commerce.purchase
- XDM-data för Web SDK - skicka åtgärd:
%xdm.commerce.purchase%
När du är klar bör du se följande regler som skapats.
Bygg en utvecklingsmiljö
Lägg till nya dataelement och regler i Luma Web SDK Tutorial
och bygga om utvecklingsmiljön.
Validera Adobe Analytics for Platform Web SDK
I Felsökning lektionen lärde du dig att inspektera XDM-objektbeacon på klientsidan med plattformsfelsökaren och webbläsarutvecklarkonsolen, som liknar hur du felsöker en AppMeasurement.js
Implementering av analyser. För att validera att Analytics hämtar in data på rätt sätt via Platform Web SDK måste du gå två steg längre:
- Validera hur data bearbetas av XDM-objektet på Platform Edge Network med hjälp av funktionen Edge Trace i Experience Platform-felsökaren
- Validera hur data behandlas av Analytics med bearbetningsregler och realtidsrapporter.
Använd kantkalkering
Lär dig hur du validerar att Adobe Analytics spelar in ECID, sidvisningar, produktsträngen och e-handelshändelser med Edge Trace-funktionen i felsökaren för Experience Platform.
Experience Cloud ID-validering
-
Gå till Luma demo site och använd Experience Platform Debugger för att växla taggegenskapen på webbplatsen till din egen utvecklingsegenskap
note warning WARNING Kontrollera att du är inloggad på Luma-webbplatsen innan du fortsätter. Om du inte är inloggad tillåter Luma-webbplatsen inte utcheckning. -
På Luma väljer du inloggningsknappen längst upp till höger och använder inloggningsuppgifter u: test@adobe.com p: test autentisera
-
Du omdirigeras automatiskt till Didi Sport Watch produktsida vid inläsning av nästa sida
-
-
Om du vill aktivera Edge Trace går du till Felsökning för Experience Platform, i den vänstra navigeringen väljer du Logs väljer du Edge och markera Connect
-
Den kommer att vara tom tills vidare
-
Uppdatera Didi Sport Watch produktsida och kontrollera Experience Platform Debugger igen bör du se data som kommit fram. Raden börjar med Analytics Automatic Mapping RSIDs är Adobe Analytics fyr
-
Markera för att öppna båda
mappedQueryParams
listruta och den andra listrutan för att visa Analytics-variablernote tip TIP Den andra listrutan motsvarar det ID för analysrapportsserie som du skickar data till. Det ska matcha din egen rapportsserie, inte den i skärmbilden. -
Bläddra nedåt för att hitta
c.a.x.identitymap.ecid.[0].id
. Det är en kontextdatavariabel som hämtar ECID -
Fortsätt rulla nedåt tills du ser Analytics
mid
variabel. Båda ID:n överensstämmer med enhetens Experience Cloud ID.note note NOTE Eftersom du är inloggad bör du ägna en stund åt att validera det autentiserade ID:t 112ca06ed53d3db37e4cea49cc45b71e
för användaren test@adobe.com tas också med ic.a.x.identitymap.lumacrmid.[0].id
Vyer av innehållssidor
Du använder samma fyr för att validera att innehållssidvisningar hämtas av Analytics.
-
Leta efter
c.a.x.web.webpagedetails.pageviews.value=1
. Det säger atts.t()
sidvisningsfyren skickas till Analytics -
Bläddra nedåt för att se
gn
variabel. Det är den dynamiska syntaxen i Analytics förs.pageName
variabel. Det hämtar sidnamnet från datalagret.
Produktsträng och e-handelshändelser
Eftersom du redan är på en produktsida fortsätter den här övningen att använda samma Edge Trace för att validera att produktdata hämtas av Analytics. Både produktsträngen och e-handelshändelserna mappas automatiskt XDM-variabler till Analytics. Så länge du har mappat till rätt productListItem
XDM-variabeln while konfigurera ett XDM-schema för Adobe Analyticstar Platform Edge Network hand om att mappa data till rätt analysvariabler.
-
Verifiera först att
Product String
är inställt -
Leta efter
c.a.x.productlistitems.[0].sku
. Variabeln hämtar det dataelementvärde som du har mappat tillproductListItems.item1.sku
tidigare i den här lektionen -
Bläddra nedåt för att se
pl
variabel. Det är den dynamiska syntaxen för produktsträngvariabeln Analytics -
Båda värdena matchar produktnamnet som finns i datalagret
Edge Trace behandlar commerce
händelser något annorlunda än productList
dimensioner. Du ser inte att en kontextdatavariabel är mappad på samma sätt som du ser produktnamnet mappat till c.a.x.productlistitem.[0].name
ovan. I stället visar Edge Trace den slutliga automatiska händelsemappningen i Analytics event
variabel. Platform Edge Network mappar det så länge du mappar till rätt XDM commerce
variabel while konfigurera schema för Adobe Analytics; i detta fall commerce.productViews.value=1
.
-
Gå tillbaka till Experience Platform Debugger-fönstret och rulla nedåt till
event
variabel, är inställd påprodView
Validera resten av e-handelshändelserna och produktsträngarna är inställda för Analytics.
-
Lägg till Didi Sport Watch till kundvagn
-
Gå till Kundsida, kontrollera Edge Trace för
events: "scView"
och produktsträngen -
Fortsätt till kassan, kontrollera Edge Trace för
events: "scCheckout"
och produktsträngen -
Fyll ut bara Förnamn och Efternamn fält i leveransformuläret och välj Fortsätt. På nästa sida väljer du Montera beställning
-
På bekräftelsesidan kan du kontrollera Edge Trace för
- Inköpshändelse som ställs in
events: "purchase"
- Valutakodvariabeln anges
cc: "USD"
- Inköps-ID anges
pi
- Produktsträng
pl
ange produktnamn, kvantitet och pris
- Inköpshändelse som ställs in
Bearbetningsregler och realtidsrapporter
Nu när du har validerat Analytics-fyrar med Edge Trace kan du även validera data som bearbetas av Analytics med hjälp av Real-Time-rapporterna. Innan du kontrollerar realtidsrapporterna måste du konfigurera bearbetningsregler för Analytics props
efter behov.
Bearbetningsregler för anpassade analysmappningar
I den här övningen mappar du en XDM-variabel till ett utkast så att du kan visa den i realtidsrapporter. Följ de här stegen för alla anpassade mappningar du måste göra för alla eVar
, prop
, event
, eller variabel som är tillgänglig via bearbetningsregler.
-
Gå till Analytics-gränssnittet Admin > Admin Tools > Report Suites
-
Välj den rapport för utveckling/test som du använder för självstudiekursen > Edit Settings > General > Processing Rules
-
Skapa en regel till Overwrite value of
Product Name (prop1)
tilla.x.productlistitems.0.name
. Kom ihåg att lägga till anteckningen till varför du skapar regeln och ge den ett namn. Välj Savenote important IMPORTANT Första gången du mappar till en bearbetningsregel visas inte kontextdatavariablerna från XDM-objektet. Om du vill åtgärda det väljer du ett värde, Spara och återgå till att redigera. Alla XDM-variabler ska nu visas. -
Gå till Edit Settings > Real-Time. Konfigurera alla tre med följande parametrar som visas nedan så att du kan validera visningar av innehållssidor, produktvyer och köp
-
Upprepa valideringsstegen och du bör se att realtidsrapporter fyller i data i enlighet med detta.
Sidvisningar
Produktvisningar
Inköp
-
I arbetsytans användargränssnitt skapar du en tabell som visar hela e-handelsflödet för den produkt du har köpt
Mer information om hur du mappar XDM-fält till analysvariabler finns i videon Mappa Web SDK-variabler till Adobe Analytics.
Grattis! Det här är slutet av lektionen och nu är du redo att implementera Adobe Analytics med Platform Web SDK för din egen webbplats.