DokumentationExperience PlatformSjälvstudiekurs om webb-SDK

Konfigurera Adobe Analytics med Adobe Experience Platform Web SDK

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

Skapat för:

  • Nybörjare
  • Mellanliggande
  • Utvecklare

Lär dig konfigurera Adobe Analytics med Adobe 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.

Web SDK till Adobe Analytics-diagram

Utbildningsmål

När lektionen är klar kan du:

  • Konfigurera ett datastream för att aktivera Adobe Analytics
  • Ta reda på vilka XDM-standardfält som automatiskt mappas till analysvariabler
  • Ange analysvariabler i dataobjektet
  • Skicka data till en annan rapportserie genom att åsidosätta datastream
  • Validera Adobe Analytics-variabler med Felsökning och Assurance

Förutsättningar

För att slutföra lektionen måste du först:

  • Bekanta dig med och få tillgång till Adobe Analytics.

  • Ha 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.

  • Slutför de tidigare lektionerna i avsnitten Inledande konfiguration och Tagginställningar i den här självstudien.

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 till vilken Adobe Analytics-rapport säger att dina data ska skickas.

  1. Gå till Datainsamling gränssnitt

  2. Välj Datastreams

  3. Markera tidigare skapade Luma Web SDK: Development Environment datastream

    Välj dataströmmen för Luma Web SDK

  4. Välj Add Service
    Lägg till en tjänst i datastream

  5. Välj Adobe Analytics som Service

  6. Ange Report Suite ID av din utvecklingsrapportsserie

  7. Välj Save

    DataStream Save analytics

    note tip
    TIP
    Lägg till fler rapportsviter genom att välja Add Report Suite motsvarar taggning i flera programsviter.
WARNING
I den här självstudiekursen konfigurerar du bara Adobe Analytics rapportsvit för din utvecklingsmiljö. När du skapar datastreams för din egen webbplats bör du skapa ytterligare datastreams och rapportsviter för dina staging- och produktionsmiljöer.

Ange analysvariabler

Det finns flera sätt att ställa in Analytics-variabler i en Web SDK-implementering:

  1. Automatisk mappning av XDM-fält till analysvariabler (automatiskt).
  2. Ange fält i dialogrutan data objekt (rekommenderas).
  3. Mappa XDM-fält till Analytics-variabler i Analytics-bearbetningsregler (rekommenderas inte längre).
  4. Mappa till Analytics-variabler direkt i XDM-schemat (rekommenderas inte längre).

Från maj 2024 behöver du inte längre skapa ett XDM-schema för att implementera Adobe Analytics med Platform Web SDK. The data -objekt (och data.variable dataelement som du skapade i Skapa dataelement lektion) kan användas för att ställa in alla anpassade Analytics-variabler. Att ställa in dessa variabler i dataobjektet kommer att kännas bekant för befintliga analyskunder, är mer effektivt än att använda gränssnittet för bearbetningsregler och förhindrar att onödiga data tar upp utrymme i kundprofiler i realtid (viktigt om du har Real-time Customer Data Platform eller Journey Optimizer).

Automatiskt mappade fält

Många XDM-fält mappas automatiskt till analysvariabler. Den senaste listan över mappningar finns på Variabelmappning för analyser i Adobe Experience Edge.

Detta inträffar om även om du inte har definierat ett anpassat schema. Experience Platform Web SDK samlar automatiskt in vissa data och skickar dem till Platform Edge Network som XDM-fält. Web SDK läser till exempel den aktuella sidans URL och skickar den som XDM-fält web.webPageDetails.URL. Det här fältet vidarebefordras till Adobe Analytics och fyller automatiskt i sidans URL-rapporter i Adobe Analytics.

Om du implementerar Web SDK för Adobe Analytics med ett XDM-schema, som du har gjort i den här självstudiekursen, har du några av de XDM-fält som du har anpassat automatiskt mappa till Analytics-variabler, vilket beskrivs i följande tabell:

XDM till Analytics - automappade variabler
Adobe Analytics-variabel
identitymap.ecid.[0].id
mitten
web.webPageDetails.name
s.pageName
web.webPageDetails.server
s.server
web.webPageDetails.siteSection
s.channel
commerce.productViews.value
prodView
commerce.productListViews.value
scView
commerce.checkouts.value
scCheckout
commerce.purchases.value
köp
commerce.order.currencyCode
s.currencyCode
commerce.order.purchaseID
s.purchaseID
productListItems[].SKU
s.products=;product name;;;; (primär - se anmärkning nedan)
productListItems[].name
s.products=;product name;;;; (fallback - se anm. nedan)
productListItems[].quantity
s.products=;;produktkvantitet;
productListItems[].priceTotal
s.product=;;;produktpris;

De enskilda avsnitten i Analytics-produktsträngen anges via olika XDM-variabler under productListItems -objekt.

NOTE
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.

Ange variabler i dataobjektet

Men evar, props och händelser då? Ange variabler i data är det rekommenderade sättet att ställa in dessa Analytics-variabler med Web SDK. Om du ställer in variabler i dataobjektet kan även alla automatiskt mappade variabler skrivas över.

För det första, vad är data objekt? I alla Web SDK-händelser kan du skicka två objekt med anpassade data, xdm -objektet och data -objekt. Båda skickas till Platform Edge Network, men bara till xdm -objektet skickas till datauppsättningen Experience Platform. Egenskaper i data kan mappas på Edge till xdm fält som använder funktionen Dataprep för datainsamling, men som annars inte skickas till Experience Platform. Detta gör det till ett idealiskt sätt att skicka data till program som Analytics, som inte är inbyggt i Experience Platform.

Här är de två objekten i ett generiskt Web SDK-anrop:

data- och xdm-objekt

Adobe Analytics har konfigurerats för att söka efter egenskaper i data.__adobe.analytics och använda dem för analysvariabler.

Nu ska vi se hur det här fungerar. Låt oss sätta igång eVar1 och prop1 med vårt sidnamn och se hur XDM-mappat värde kan skrivas över

  1. Öppna märkordsregeln all pages - library loaded - set global variables - 1
  2. Lägg till en ny Action
  3. Välj Adobe Experience Platform Web SDK extension
  4. Välj Action Type as Update variable
  5. Välj data.variable som Data element
  6. Välj analytics object
  7. Ange eVar1 som page.pageInfo.pageName dataelement
  8. Ange prop1 för att kopiera värdet för eVar1
  9. Testa hur XDM-mappade värden skrivs över i Additional property anger att sidnamnet ska vara ett statiskt värde test
  10. Spara regeln

Nu måste vi inkludera dataobjektet i vår sändningshändelseregel.

  1. Öppna märkordsregeln all pages - library loaded - send event - 50
  2. Öppna Send Event åtgärd
  3. Välj data.variable som Data
  4. Välj Keep Changes
  5. Välj Save

Skicka data till en annan rapportserie

Du kanske vill ändra vilka data i Adobe Analytics rapportserie som skickas till när besökarna finns på vissa sidor. Detta kräver en konfiguration i både datastream och en regel.

Konfigurera datastream för åsidosättning av en rapportserie

Så här konfigurerar du åsidosättningsinställningen för Adobe Analytics-rapportsviten i datastream:

  1. Öppna ditt datastream

  2. Redigera Adobe Analytics genom att öppna mer och sedan välja Edit

    Skriv över datastream

  3. Välj Advanced Options att öppna Report Suite Overrides

  4. Markera de rapportsviter som du vill åsidosätta. I detta fall Web SDK Course Dev och Web SDK Course Stg

  5. Välj Save

    Skriv över datastream

Konfigurera en regel för åsidosättning av en rapportserie

Låt oss skapa en regel för att skicka ytterligare ett sidvisningsanrop till en annan rapportserie. Använd åsidosättningsfunktionen för datastream för att ändra rapportsviten för en sida med hjälp av Send Event Åtgärd.

  1. Skapa en ny regel, kalla den homepage - library loaded - AA report suite override - 51

  2. Markera plustecknet under Event lägga till en ny utlösare

  3. Under Extension, markera Core

  4. Under Event Type, markera Library Loaded (Page Top)

  5. Markera för att öppna Advanced Options, skriva in 51. Detta garanterar att regeln körs efter all pages - library loaded - send event - 50 som ställer in baslinje-XDM med Update variable åtgärdstyp.

  6. Välj Keep Changes

    Åsidosättning av analysrapportsSuite

  7. Under Conditions, välj Add

  8. Lämna Logic Type as Regular

  9. Lämna Extensions as Core

  10. Välj Condition Type as Path Without Query String

  11. Till höger, lämna Regex växla inaktiverad

  12. Under path equals set /content/luma/us/en.html. För demonstrationswebbplatsen Luma säkerställer den att regeln endast aktiveras på startsidan

  13. Välj Keep Changes

    Villkor för åsidosättning av analysrapportsserie

  14. Under Actions välj Add

  15. Som Extension, markera Adobe Experience Platform Web SDK

  16. Som Action Type, markera Send Event

  17. Som XDM data väljer du xdm.variable.content dataelement som du skapade i Skapa dataelement lektion

  18. Som Data väljer du data.variable dataelement som du skapade i Skapa dataelement lektion

    Åsidosättning av analysdataström

  19. Bläddra nedåt till Datastream Configurations Overrides section

  20. Lämna Development har valts.

    note tip
    TIP
    Den här fliken avgör i vilken taggmiljö åsidosättningen sker. I det här exemplet anger du bara utvecklingsmiljön, men när du distribuerar den till produktionen måste du också göra det i Production miljö.

  21. Välj Sandbox som du använder för självstudiekursen

  22. Välj Datastream, i detta fall Luma Web SDK: Development Environment

  23. Under Report suites väljer du den rapportwebbplats som du vill åsidosätta. I detta fall tmd-websdk-course-stg.

  24. Välj Keep Changes

  25. Och Save din regel

    Åsidosättning av analysdataström

Bygg en utvecklingsmiljö

Lägg till dina uppdaterade regler i Luma Web SDK Tutorial och bygga om utvecklingsmiljön.

Grattis! Nästa steg är att validera din Adobe Analytics-implementering via Experience Platform Web SDK.

Validera Adobe Analytics med felsökning

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.

I Felsökning i lektionen lärde du dig att inspektera XDM-begäran på klientsidan med plattformsfelsökaren och webbläsarutvecklarkonsolen, som liknar hur du felsöker en AppMeasurement.js Implementering av analyser. Du har också lärt dig att validera begäranden på serversidan för Platform Edge Network som skickas till Adobe-program och hur du visar en fullt bearbetad nyttolast med hjälp av Assurance.

För att validera att Analytics hämtar in data korrekt via Experience Platform Web SDK måste du gå två steg längre:

  1. Validera hur data bearbetas av XDM-objektet på Platform Edge Network med hjälp av funktionen Edge Trace i Experience Platform Debugger
  2. Validera hur data bearbetas fullt ut av Analytics med Adobe Experience Platform Assurance

Experience Cloud ID-validering

  1. Gå till Luma demo site

  2. Välj inloggningsknappen högst upp till höger och använd inloggningsuppgifterna u: test@adobe.com p: test to authenticate

  3. Öppna felsökaren för Experience Platform och växla taggegenskapen på webbplatsen till din egen utvecklingsegenskap

  4. 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

    Koppla kantkalkering

  5. Den kommer att vara tom tills vidare

    Ansluten kantkalkering

  6. Uppdatera Luma-sidan och kontrollera felsökaren i Experience Platform igen. Du bör se data som skickats. Raden börjar med Analytics Automatic Mapping är Adobe Analytics fyr

  7. Markera för att öppna båda mappedQueryParams listruta och den andra listrutan för att visa Analytics-variabler

    Kantkalkering för analysfyr

    note 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.

  8. Bläddra nedåt för att hitta c.a.x.identitymap.ecid.[0].id. Det är en kontextdatavariabel som hämtar ECID

  9. Fortsätt rulla nedåt tills du ser Analytics mid variabel. Båda ID:n överensstämmer med enhetens Experience Cloud ID.

  10. På Lumas webbplats

    Analytics ECID

    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 i c.a.x.identitymap.lumacrmid.[0].id

Åsidosättningsvalidering av rapportsviten

Ovanför du konfigurerade en åsidosättning av datastream för Lumas hemsida. Validera konfigurationen

  1. Leta efter en rad med Datastream config after override was applied. Här hittar du den primära rapportsviten och de extra rapportsviterna som har konfigurerats för åsidosättningar av rapportsviten.

    Verifiering av åsidosättningslista för Analytics-rapportsviten

  2. Bläddra nedåt till raden som börjar med Analytics Automatic Mapping och verifiera att reportSuiteIds visar rapportsviten som du angav i dina åsidosättningskonfigurationer

    Analytics Report Suite Override Call Validation

Validering av vyer av innehållssidor

Gå till en produktsida som Didi Sport Watch produktsida. Verifiera att innehållssidvisningar hämtas av Analytics.

  1. Leta efter c.a.x.web.webpagedetails.pageviews.value=1.

  2. Bläddra nedåt för att se gn variabel. Det är den dynamiska syntaxen i Analytics för s.pageName variabel. Det hämtar sidnamnet från datalagret.

    Produktsträng för Analytics

Produktsträng och validering av 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

  1. Leta efter c.a.x.productlistitems.[0].sku. Variabeln hämtar det dataelementvärde som du har mappat till productListItems.item1.sku tidigare i den här lektionen

  2. Sök även efter c.a.x.productlistitems.[0]._experience.analytics.customdimensions.evars.evar1. Variabeln hämtar det dataelementvärde som du har mappat till productListItems.item1._experience.analytics.customdimensions.evars.evar1

  3. Bläddra nedåt för att se pl variabel. Det är den dynamiska syntaxen för produktsträngvariabeln Analytics

  4. Observera att produktnamnet från datalagret mappas både till c.a.x.productlistitems.[0].sku och product -parametern i produktsträngen. Dessutom mappas produkttiteln från datalagret till merchandising evar1 i produktsträngen.

    Produktsträng för Analytics

    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 den 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.

  5. Gå tillbaka till Experience Platform Debugger-fönstret och rulla nedåt till events variabel, är inställd på prodView

  6. Obs! c.a.x.eventType är inställd på commerce.productViews eftersom du är på en produktsida.

    note tip
    TIP
    The ecommerce - pdp library loaded - AA (order 20) regeln skriver över värdet för eventType anges av all pages global content variables - library loaded - AA (order 1) styckelinje efter att den har ställts in att utlösas senare i sekvensen

    Analytics - produktvy

Validera resten av e-handelshändelser och produktsträngar för Analytics

  1. Lägg till Didi Sport Watch till kundvagn

  2. Gå till Kundsida, kontrollera Edge Trace för

    • eventType ange till commerce.productListViews
    • events: "scView"och
    • produktsträngen är inställd

    Vy för analyskundvagn

  3. Fortsätt till kassan, kontrollera Edge Trace för

    • eventType ange till commerce.checkouts
    • events: "scCheckout"och
    • produktsträngen är inställd

    Utcheckning av analyser

  4. 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

  5. På bekräftelsesidan kan du kontrollera Edge Trace för

    • eventType ange till commerce.purchases
    • 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

    Köp av analyser

Validera Adobe Analytics med Assurance

Adobe Experience Platform Assurance hjälper er att inspektera, bevisa, simulera och validera hur ni samlar in data eller levererar upplevelser via er webbplats och mobilapplikation.

I den föregående övningen validerade du att Adobe Analytics spelar in ECID, sidvisningar, produktsträngen och e-handelshändelser med Edge Trace-funktionen i felsökaren för Experience Platform. Sedan validerar du dessa händelser med Adobe Experience Platform Assurance, ett alternativt gränssnitt för att få tillgång till samma data i Edge Trace.

Som du lärde dig i Säkerhet kan du starta en Assurance-session på flera olika sätt. Eftersom du redan har Adobe Experience Platform Debugger öppen med en Edge Trace-session som initierats från den senaste övningen rekommenderar vi att du får åtkomst till Assurance via Felsökning:
Säkerhet genom Adobe Experience Platform Data Collection

I “Web SDK Tutorial 3” Anmäl session “hitdebugger” i sökfältet Händelser för att filtrera resultaten till data som bearbetats i Adobe Analytics Post.
Adobe-analys för Assurance-efterbearbetade data

Experience Cloud ID-validering

Om du vill validera att Adobe Analytics hämtar ECID-numret markerar du en fyr och öppnar nyttolasten. Leverantören för denna fyr ska vara com.adobe.analytics.hitdebugger
Adobe Analytics validation with Assurance

Bläddra sedan nedåt till mcvisId för att validera att ECID-numret är korrekt inhämtat
Experience Cloud ID-validering med Assurance

Validering av vyer av innehållssidor

Använd samma fyr för att kontrollera att vyerna för innehållssidor är mappade till rätt Adobe Analytics-variabel.
Bläddra nedåt till pageName för att validera att Page Name är korrekt infångad
Validering av sidnamn med Assurance

Produktsträng och validering av e-handelshändelser

Om du följer samma valideringsexempel som används vid validering med Experience Platform Debugger ovan, fortsätter du att använda samma fyr för att validera Ecommerce Events och Product String.

  1. Sök efter nyttolast där events innehåller prodView
    Produktsträngsvalidering med Assurance
  2. Bläddra nedåt till product-string för att validera Product String.
    • Anteckna Product SKU och Merchandizing eVar1.
  3. Bläddra nedåt och validera att prop1som du konfigurerade med bearbetningsreglerna i föregående avsnitt innehåller Product SKU
    Produktsträng med verifiering av variabler för marknadsföring med Assurance

Fortsätt att validera implementeringen genom att granska kundvagnen, kassan och köphändelserna.

  1. Sök efter nyttolast där events innehåller scView och validera produktsträngen.
    Produktsträngsvalidering med Assurance
  2. Sök efter nyttolast där events innehåller scCheckout och validera produktsträngen.
    Produktsträngsvalidering med Assurance
  3. Sök efter nyttolast där events innehåller purchase
    Produktsträngsvalidering med Assurance
  4. Vid validering av purchase händelsen observera att Product String ska innehålla Product SKU, Product Quantity och Product Total Price.
  5. Dessutom purchase validera att purchase-id och/eller purchaseId är inställda

Grattis! Du lyckades! 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.

Nästa:

NOTE
Tack för att du lade ned din tid på att lära dig om Adobe Experience Platform Web SDK. Om du har frågor, vill dela allmän feedback eller har förslag på framtida innehåll kan du dela med dig av dem om detta Experience League diskussionsinlägg
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4