DokumentationAnalyticsImplementeringshandbok

Skicka data till Adobe Analytics med Web SDK JavaScript-biblioteket

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Användare
  • Administratör

Den här implementeringssökvägen innebär en ny Web SDK-installation med Web SDK JavaScript-biblioteket. Andra implementeringsvägar beskrivs på separata sidor:

  • SDK-taggtillägg för webben: En ny SDK-installation med taggtillägget Web SDK. Liknar Web SDK JavaScript Library-metoden (den här sidan), förutom att du hanterar implementeringen med hjälp av taggar i Adobe Experience Platform Data Collection. Det kräver fältgruppen Adobe Analytics ExperienceEvent, som innehåller typiska analysvariabler som ska inkluderas i XDM-schemat.
  • Analystillägg för Web SDK-tillägg: Gå från Adobe Analytics-taggtillägg till Web SDK-taggtillägg på ett smidigt och metodiskt sätt. På så sätt slipper du använda XDM tills din organisation är redo att använda Adobe Experience Platform-tjänster, till exempel Customer Journey Analytics. Använd objektet data i stället för objektet xdm för att skicka data till Adobe.
  • AppMeasurement till Web SDK JavaScript-bibliotek: Ett smidigt och metodiskt sätt att migrera till Web SDK, förutom att taggar inte används. I stället kan du ta bort Adobe Analytics datainsamlingsbibliotek (AppMeasurement.js) manuellt och ersätta det med Web SDK JavaScript-biblioteket (alloy.js).

Fördelar och nackdelar med implementeringsvägen

Att använda Web SDK JavaScript-biblioteket för att skicka data till Adobe Analytics har både fördelar och nackdelar. Väg noga in varje alternativ för att avgöra vilken metod som är bäst för er organisation.

Fördelar
Nackdelar
  • Direkt metod: Den här implementeringsvägen är enklare än strategier som flyttar befintliga Adobe Analytics-implementeringar. Om du inte har någon Adobe Analytics-implementering att tänka på fyller du i de tillämpliga Web SDK XDM-fälten.
  • Fördefinierat schema: Om din organisation inte behöver ditt eget schema kan du helt enkelt använda det schema som är riktat mot Adobe Analytics. Det här konceptet gäller även när du går mot Customer Journey Analytics; konceptet med props och eVars gäller inte Customer Journey Analytics, men du kan fortsätta använda props och eVars som enkla anpassade dimensioner.
  • Implementeringsändringar kräver åtgärd från utvecklaren: Om du vill ändra implementeringen av din Web SDK måste du arbeta med utvecklingsteamet för att redigera koden på din webbplats. Den metod som använder Web SDK-taggtillägget undviker den här nackdelen.
  • Låst till att använda ett specifikt schema: När din organisation flyttas till Customer Journey Analytics måste du välja att fortsätta använda Adobe Analytics-schemat eller migrera till din egen organisations schema (som skulle vara en separat datauppsättning). Om din organisation vill undvika både Adobe Analytics-schemat och migrering till en separat datauppsättning när den flyttar till Customer Journey Analytics rekommenderar Adobe en av följande två metoder:
    • Använd objektet data: Med objektet data kan du skicka data till Adobe Analytics utan att följa ett XDM-schema. När din organisations schema har skapats kan du använda datastream-mappning för att mappa data objektfält till XDM. Både Analytics-tillägget för Web SDK-tillägget och -AppMeasurementet för Web SDK JavaScript-biblioteket använder det här data-objektet.
    • Hoppa över Adobe Analytics helt: Om du implementerar Web SDK kan du skicka dessa data till en datauppsättning i Adobe Experience Platform för användning i Customer Journey Analytics. Du kan använda vilket schema som helst. Adobe Analytics är inte involverat alls i det här arbetsflödet och därför krävs inte fältgruppen Adobe Analytics ExperienceEvent. Den här metoden medför minst teknisk skuld, men lämnar också Adobe Analytics helt utanför bilden.
IMPORTANT
Den här implementeringsmetoden kräver att du använder ett schema som konfigurerats för Adobe Analytics. Om din organisation planerar att använda ditt eget schema med Customer Journey Analytics i framtiden kan Adobe Analytics-schemat skapa förvirring för dataadministratörer och arkitekter. Det finns flera alternativ för att minska detta hinder:
  • Du kan använda Adobe Analytics-schemat i CJA. Observera att CJA inte har något koncept för props eller eVars. De behandlas som andra schemafält. Observera också att användningen av Adobe Analytics-schemat i CJA kan göra det svårare att använda andra plattformstjänster, som Adobe Journey Optimizer och Real-time Customer Data Platform.
  • Du kan använda dataobjektet, ungefär som ett migreringsarbetsflöde. Observera att användningen av dataobjektet kräver att du mappar varje dataobjektfält till ett XDM-schemafält.
  • Du kan hoppa över Adobe Analytics-implementeringen helt och skicka data till Adobe Experience Platform med ditt eget schema. Den här metoden är idealisk på lång sikt och gör att din organisation kan börja använda Customer Journey Analytics.

Steg som krävs för att implementera JavaScript-biblioteket för Web SDK

Översikt över implementeringsuppgifterna på hög nivå:

Så här implementerar du Adobe Analytics med hjälp av Web SDK-arbetsflöde, vilket beskrivs i det här avsnittet.

Uppgift
Mer information
1
Se till att du har definierat en rapportserie.
Report Suite Manager
2
Konfigurera scheman. För att standardisera datainsamlingen för användning i olika program som utnyttjar Adobe Experience Platform har Adobe skapat den öppna och offentligt dokumenterade standarden Experience Data Model (XDM).
Översikt över schemaanvändargränssnittet
3
Skapa ett datalager för att hantera spårningen av data på webbplatsen.
Skapa ett datalager
4
Installera den fördefinierade fristående versionen. Du kan referera till biblioteket (alloy.js) på CDN direkt på sidan eller hämta och lagra det på din egen infrastruktur. Du kan också använda NPM-paketet.
Installera den fördefinierade fristående versionen och Använda NPM-paketet
5
Konfigurera en datastream. En datastream representerar konfigurationen på serversidan när Adobe Experience Platform Web SDK implementeras.
Konfigurera ett datastream
6
Lägg till en Adobe Analytics-tjänst i ditt datastream. Tjänsten styr om och hur data skickas till Adobe Analytics och till vilka rapporteringsprogram.
Lägg till Adobe Analytics-tjänst i ett datastream
7
Konfigurera Web SDK. Kontrollera att biblioteket som du installerade i steg 4 är korrekt konfigurerat med dataStream ID (tidigare kanttskonfigurations-ID (datastreamId)), organisations-ID (orgId) och andra tillgängliga alternativ. Kontrollera att variablerna mappas korrekt.
Konfigurera Web SDK
XDM-objektvariabelmappning
8
Kör kommandon och/eller spåra händelser. När baskoden har implementerats på webbsidan kan du börja köra kommandon och spåra händelser med SDK.
Skicka händelser
9
Utöka och validera implementeringen innan du skickar ut den till produktion.
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690