DokumentationExperience PlatformSjälvstudiekurs om webb-SDK

Konfigurera Adobe Analytics med Adobe Experience Platform Web SDK

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

Skapat för:

  • Nybörjare
  • Mellanliggande
  • Utvecklare

Lär dig hur du konfigurerar Adobe Analytics med Adobe Experience Platform Web SDK, skapar taggregler för att skicka data till Adobe Analytics och validerar att Analytics hämtar data som förväntat.

Adobe Analytics är ett branschledande program som gör att du kan förstå dina kunder som människor och styra din verksamhet 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örhandskrav

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 skapar du 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 gränssnittet Datainsamling

  2. Välj Datastreams i den vänstra navigeringen

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

    Välj Luma Web SDK-datastream

  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 för utvecklingsrapportsviten

  7. Välj Save

    Datastream sparar analys

    note tip
    TIP
    Om du lägger till fler rapportsviter genom att välja Add Report Suite motsvarar det taggning av flera sviter.
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 objektet data (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. Objektet data (och dataelementet data.variable som du skapade i lektionen Skapa dataelement) 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 i Variabelmappning 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ältet 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 ställs in via olika XDM-variabler under objektet productListItems.

NOTE
Från och med den 18 augusti 2022 prioriterar productListItems[].SKU mappning till produktnamnet i variabeln s.products.
Värdet productListItems[].name mappas bara till produktnamnet om productListItems[].SKU inte finns. 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å? Vi rekommenderar att du anger variabler i objektet data för 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 objektet data? I alla Web SDK-händelser kan du skicka två objekt med anpassade data, xdm-objektet och data-objektet. Båda skickas till Platform Edge Network, men bara xdm-objektet skickas till datauppsättningen Experience Platform. Egenskaper i data-objektet kan mappas på Edge till xdm-fält med hjälp av dataprep för datainsamling, men skickas annars inte 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 objektet data.__adobe.analytics och använda dem för Analytics-variabler.

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

  1. Öppna taggregeln all pages - library loaded - set global variables - 1
  2. Lägg till en ny Action
  3. Välj tillägget Adobe Experience Platform Web SDK
  4. Välj Action Type som Update variable
  5. Välj data.variable som Data element
  6. Markera objektet analytics
  7. Ange eVar1 som page.pageInfo.pageName-dataelement
  8. Ange prop1 för kopiering av värdet för eVar1
  9. Om du vill testa att XDM-mappade värden skrivs över anger du sidnamnet som ett statiskt värde test i avsnittet Additional property.
  10. Spara regeln

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

  1. Öppna taggregeln all pages - library loaded - send event - 50
  2. Öppna åtgärden Send Event
  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 konfigurationen för Adobe Analytics genom att öppna menyn mer och sedan välja Edit

    Skriv över datastream

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

  4. Markera de rapportsviter som du vill åsidosätta. I det här fallet 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 åtgärden Send Event.

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

  2. Välj plustecknet under Event för att lägga till en ny utlösare

  3. Under Extension väljer du Core

  4. Under Event Type väljer du Library Loaded (Page Top)

  5. Välj att öppna Advanced Options, skriv in 51. Detta garanterar att regeln körs efter all pages - library loaded - send event - 50 som anger baslinje-XDM med åtgärdstypen Update variable.

  6. Välj Keep Changes

    Åsidosättning av analysrapportsviten

  7. Under Conditions väljer du att Add

  8. Lämna Logic Type som Regular

  9. Lämna Extensions som Core

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

  11. Till höger lämnar du växlingsknappen Regex inaktiverad

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

  13. Välj Keep Changes

    Åsidosättningsvillkor för analysrapportsserie

  14. Under Actions väljer du Add

  15. Som Extension väljer du Adobe Experience Platform Web SDK

  16. Som Action Type väljer du Send Event

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

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

    Åsidosättning av analysdatastam

  19. Bläddra ned till avsnittet Datastream Configurations Overrides

  20. Låt fliken Development vara markerad.

    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ön.

  21. Välj Sandbox som du använder som självstudiekurs

  22. Välj Datastream, i det här fallet Luma Web SDK: Development Environment

  23. Under Report suites väljer du den rapportwebbplats som du vill åsidosätta. I det här fallet tmd-websdk-course-stg.

  24. Välj Keep Changes

  25. Och Save din regel

    Åsidosättning av analysdatastam

Bygg en utvecklingsmiljö

Lägg till dina uppdaterade regler i Luma Web SDK Tutorial-taggbiblioteket och återskapa 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ängar och e-handelshändelser med Edge Trace-funktionen i felsökningsprogrammet för Experience Platform.

I lektionen Felsökning 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 -analysimplementering. 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 Experience Platform Debugger Edge Trace-funktionen
  2. Validera hur data bearbetas fullt ut av Analytics med Adobe Experience Platform Assurance

Experience Cloud ID-validering

  1. Gå till demowebbplatsen för luma

  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 i 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 i Experience Platform, väljer Logs i den vänstra navigeringen, sedan fliken Edge och väljer Connect

    Anslut Edge Trace

  5. Den kommer att vara tom tills vidare

    Ansluten Edge Trace

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

  7. Välj att öppna både listrutan mappedQueryParams och den andra listrutan för att visa Analytics-variabler

    Analysfyr för Edge Trace

    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 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 variabeln mid i Analytics. Båda ID:n överensstämmer med enhetens Experience Cloud ID.

  10. På Lumas webbplats

    Analytics ECID

    note note
    NOTE
    Eftersom du är inloggad kan du ägna en stund åt att validera att det autentiserade ID:t 112ca06ed53d3db37e4cea49cc45b71e för användaren test@adobe.com också har hämtats i c.a.x.identitymap.lumacrmid.[0].id

Åsidosättningsvalidering av rapportsviten

Ovanför du konfigurerade en datastream-åsidosättning för Luma-startsidan. 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 analysrapportsviten

  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

    Åsidosätt anropsvalidering för analysrapportsviten

Validering av vyer av innehållssidor

Gå till en produktsida som produktsidan Didi Sport Watch. 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 variabeln gn. Det är den dynamiska syntaxen för Analytics för variabeln s.pageName. Det hämtar sidnamnet från datalagret.

    Analysproduktsträng

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-variabel när du konfigurerar ett XDM-schema för Adobe Analytics, hanterar Platform Edge Network mappningen av 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 mappade 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 variabeln pl. Det är den dynamiska syntaxen för produktsträngvariabeln Analytics

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

    Analysproduktsträng

    Edge Trace hanterar commerce händelser något annorlunda än productList dimensioner. Du ser ingen kontextdatavariabel som har mappats på samma sätt som du ser produktnamnet som har mappats till c.a.x.productlistitem.[0].name ovan. I stället visar Edge Trace den slutliga automatiska händelsemappningen i variabeln event för analysen. Platform Edge Network mappar den därefter så länge du mappar till rätt XDM commerce-variabel medan schemat för Adobe Analytics konfigureras, i det här fallet commerce.productViews.value=1.

  5. Gå tillbaka till felsökningsfönstret i Experience Platform, rulla ned till variabeln events, det är inställt på prodView

  6. Observera också att c.a.x.eventType är inställt på commerce.productViews eftersom du är på en produktsida.

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

    Analysproduktvy

Verifiera resten av e-handelshändelser och produktsträngar har angetts för Analytics

  1. Lägg till Didi Sport Watch i kundvagnen

  2. Gå till kundvagnssidan och kontrollera Edge Trace efter

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

    Vyn Analyskundvagn

  3. Gå till kassan, kontrollera Edge Trace för

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

    Analyskassa

  4. Fyll bara i fälten Förnamn och Efternamn i leveransformuläret och välj Fortsätt. På nästa sida väljer du Placera ordning

  5. På bekräftelsesidan finns Edge Trace

    • eventType inställd på commerce.purchases
    • Inköpshändelse ställs in events: "purchase"
    • Valutakodvariabeln ställs in cc: "USD"
    • Inköps-ID anges i pi
    • Produktsträng pl som anger produktnamn, kvantitet och pris

    Analysköp

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 lektionen Assurance finns det flera sätt att initiera en Assurance-session. Eftersom du redan har Adobe Experience Platform Debugger öppet 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 via Adobe Experience Platform Data Collection

I “Web SDK Tutorial 3” Assurance-sessionen anger du “hitdebugger” i sökfältet för händelser för att filtrera resultaten till Adobe Analytics Post Bearbetade data.
Assurance Adobe Analytics Post Bearbetade 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 bör vara com.adobe.analytics.hitdebugger
Adobe Analytics-validering med Assurance

Bläddra sedan nedåt till mcvisId för att verifiera att ECID:t har hämtats korrekt
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 till pageName för att verifiera att Page Name har hämtats korrekt
Validering av sidnamn med Assurance

Produktsträng och validering av e-handelshändelser

Efter samma valideringsanvändningsfall som användes vid valideringen med Experience Platform Debugger ovan, fortsätter du att använda samma fyr för att validera Ecommerce Events och Product String.

  1. Leta efter nyttolast där events innehåller prodView
    Produktsträngsvalidering med Assurance
  2. Bläddra ned till product-string för att validera Product String.
    • Observera Product SKU och Merchandizing eVar1.
  3. Bläddra nedåt och validera att prop1, som du konfigurerade med bearbetningsreglerna i föregående avsnitt, innehåller Product SKU
    Produktsträng med verifiering av variabler vid förmedling 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. Leta efter nyttolast där events innehåller purchase
    Produktsträngsvalidering med Assurance
  4. När du validerar purchase-händelsen bör du tänka på att Product String ska innehålla Product SKU, Product Quantity och Product Total Price.
  5. Dessutom, för purchase-valideringen, måste purchase-id och/eller purchaseId anges

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 dem i det här Experience League-diskussionsinlägget
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4