Migrera från Adobe Analytics-taggtillägget till Web SDK-taggtillägget

Den här implementeringsvägen innefattar en metod för metodmigrering för att gå från taggtillägget Adobe Analytics till taggtillägget Web SDK. Andra implementeringsvägar beskrivs på separata sidor:

  • 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 tar du bort Adobe Analytics datainsamlingsbibliotek (AppMeasurement.js) manuellt och ersätter det med Web SDK JavaScript-biblioteket (alloy.js).
  • Web SDK-taggtillägg: En ny Web SDK-installation där 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.
  • JavaScript-bibliotek för Web SDK: En ny SDK-installation med JavaScript-biblioteket för Web SDK (alloy.js). Hantera implementeringen själv i stället för att använda tagggränssnittet. Det kräver fältgruppen Adobe Analytics ExperienceEvent, som innehåller typiska analysvariabler som ska inkluderas i XDM-schemat.

Fördelar och nackdelar med implementeringsvägen

Att använda den här migreringsmetoden 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
  • Inga kodändringar på din plats: Eftersom implementeringen redan har installerade taggar kan alla migreringsuppdateringar göras i tagggränssnittet.
  • Använder din befintliga implementering: Den här metoden kräver ingen ny implementering. Även om det kräver nya regelåtgärder kan du återanvända befintliga dataelement och regelvillkor med minimala ändringar.
  • Kräver inget schema: För den här migreringsfasen till Web SDK behövs inget XDM-schema. I stället kan du fylla i objektet data, som skickar data direkt till Adobe Analytics. När migreringen till Web SDK är klar kan du skapa ett schema för din organisation och använda datastream-mappning för att fylla i tillämpliga XDM-fält. Om det krävs ett schema i det här skedet av migreringsprocessen måste din organisation använda ett Adobe Analytics XDM-schema. Om du använder det här schemat blir det svårare för din organisation att använda ditt eget schema i framtiden.
  • Implementeringens tekniska skuld: Eftersom den här metoden använder en modifierad form av din befintliga implementering, kan det vara svårare att spåra implementeringslogik och utföra ändringar vid behov. Anpassad kod kan vara särskilt svår att felsöka.
  • Kräver mappning för att skicka data till plattformen: När din organisation är redo att använda Customer Journey Analytics måste du skicka data till en datauppsättning i Adobe Experience Platform. Den här åtgärden kräver att alla fält i objektet data är en post i datastream-mappningsverktyget som tilldelar det till ett XDM-schemafält. Mappning behöver bara göras en gång för det här arbetsflödet, och implementeringen behöver inte ändras. Det är dock ett extra steg som inte krävs när du skickar data i ett XDM-objekt.

Adobe rekommenderar att du följer den här implementeringsvägen i följande scenarier:

  • Du har en befintlig implementering med hjälp av taggtillägget Adobe Analytics. Om du har en implementering med AppMeasurement följer du Migrera från AppMeasurement till Web SDK i stället.
  • Du tänker använda Customer Journey Analytics i framtiden, men vill inte ersätta din Analytics-implementering med en Web SDK-implementering från grunden. Att ersätta implementeringen från grunden i Web SDK kräver mest arbete, men erbjuder även den mest livskraftiga långsiktiga implementeringsarkitekturen. Om din organisation vill använda en ren Web SDK-implementering läser du Importera data via Adobe Experience Platform Web SDK i användarhandboken för Customer Journey Analytics.

Steg som krävs för att migrera till Web SDK

Följande steg innehåller konkreta mål att arbeta mot. Klicka på varje steg om du vill ha detaljerade anvisningar om hur du slutför det.

1. Skapa och konfigurera en datastream

Skapa ett datastream i Adobe Experience Platform Data Collection. När du skickar data till den här dataströmmen vidarebefordrar den data till Adobe Analytics. I framtiden vidarebefordrar samma datastream data till Customer Journey Analytics.

  1. Navigera till experience.adobe.com och logga in med dina autentiseringsuppgifter.
  2. Använd hemsidan eller produktväljaren i det övre högra hörnet för att navigera till Data Collection.
  3. Välj Datastreams i den vänstra navigeringen.
  4. Välj New Datastream.
  5. Ange önskat namn och välj sedan Save.
  6. Välj Add Service när dataströmmen har skapats.
  7. Välj Adobe Analytics på den nedrullningsbara menyn för tjänster.
  8. Ange samma rapportsviter-ID som den webbplats du för närvarande skickar analysdata till. Klicka på Save.

Lägg till Adobe Analytics-tjänst

Din datastream är nu redo att ta emot och skicka data till Adobe Analytics.

2. Lägg till Web SDK-tillägget i taggegenskapen

I det här avsnittet förbereds taggen för den mesta migreringen som görs i nästa steg.

  1. Klicka på ikonen för hamburgaren i det övre vänstra hörnet i Adobe Experience Platform-gränssnittet och välj sedan Tags.

  2. Välj önskad taggegenskap.

  3. Välj Extensions i den vänstra navigeringen för taggegenskapen.

  4. Välj Catalog i den övre delen om du vill se en lista över alla tillgängliga tillägg.

  5. Sök efter och välj tillägget Adobe Experience Platform Web SDK och klicka sedan på Install till höger.

    Katalog

  6. Konfigurationsinställningarna för tillägget visas. Leta reda på avsnittet Datastreams och markera datastream som du skapade i föregående steg.

    Val av dataström

  7. Välj Save.

Din taggegenskap har nu Web SDK installerat.

3. Skapa ett dataobjektdataelement

Dataobjektets dataelement tillhandahåller ett intuitivt ramverk för att konfigurera en nyttolast som Web SDK använder för att skicka till en datastam. De flesta regler som du uppdaterar i följande steg interagerar med det här dataelementet.

  1. Välj Data Elements i den vänstra navigeringen i tagggränssnittet.

  2. Välj Add Data Element

  3. Ge dataelementet följande inställningar:

    • Name: Allt du vill, till exempel "Datalager" eller "Dataobjekt"
    • Extension: Adobe Experience Platform Web SDK
    • Data Element Type: Variable
    • Kryssrutor kan behållas som de är
  4. Välj följande inställningar till höger:

    • Egenskapens alternativknapp: Data
    • Lösning: Adobe Analytics
  5. Välj Save.

Skapa dataelement

Din taggegenskap har nu allt som behövs för att uppdatera varje regel.

4. Uppdatera regler för att använda Web SDK-tillägget i stället för Analytics-tillägget

Det här steget innehåller det mesta som krävs för att migrera till Web SDK och kräver kunskap om hur implementeringen fungerar. Nedan visas ett exempel på hur du redigerar en typisk taggregel. Uppdatera alla taggregler i implementeringen för att ersätta alla referenser till Adobe Analytics-tillägget med Web SDK-tillägget.

  1. Välj Rules i den vänstra navigeringen i tagggränssnittet.

  2. Markera en regel som du vill redigera.

  3. Välj åtgärden Adobe Analytics - Set Variables

  4. Observera alla analysvariabler som anges i den här regeln. Inkludera båda variablerna som angetts i listrutorna och variablerna som angetts i anpassad kod.

  5. Ändra Action Configuration till följande inställningar:

    • Extension: Adobe Experience Platform Web SDK
    • Action type: Uppdatera variabel
  6. Se till att dataobjektet är markerat i listrutan till höger.

  7. Ställ in Analytics-variablerna på samma värden som de konfigurerades i Analytics-tillägget.

    • Variabler som anges i tagggränssnittet kan direkt översättas till samma värden.
    • Strängvariabler som angetts i anpassad kod kräver minimala justeringar. Använd data.__adobe.analytics i stället för att använda objektet s. s.eVar1 skulle till exempel översätta till data.__adobe.analytics.eVar1.
    • Konfigurationsvariabler för analyser och metodanrop i anpassad kod kan kräva modifierad implementeringslogik. Se respektive variabel för att avgöra hur motsvarande värde ska uppnås med Web SDK.
  8. När all regellogik har replikerats med Web SDK-tillägget väljer du Keep Changes.

  9. Upprepa dessa steg för varje åtgärdskonfiguration som använder tillägget Adobe Analytics för att ange värden. I det här steget ingår både variabler som angetts med tagggränssnittet och variabler som ställts in med anpassad kod. Anpassade kodblock kan inte referera till objektet s någonstans.

Stegen ovan gäller bara regler som anger värden. Följande steg ersätter alla åtgärder som använder Action Configuration Send Beacon.

  1. Välj en regel som skickar en fyr.

  2. Välj åtgärden Adobe Analytics - Send Beacon.

  3. Observera det aktuella värdet för alternativknappen Tracking till höger (s.t() eller s.tl()).

  4. Ändra Action Configuration till följande inställningar:

    • Extension: Adobe Experience Platform Web SDK
    • Action type: Send event
  5. Till höger ändrar du åtgärdsinställningarna till följande:

    • Type: Använd Web Webpagedetails Page Views för s.t(). Använd Web Webinteraction Link Clicks för s.tl(). Om du använder s.tl() måste du även inkludera följande fält i dataobjektet. Dessa fält listas under Additional properties när åtgärdskonfigurationen Update variable utförs:

  6. Välj Keep Changes.

  7. Upprepa dessa steg för varje åtgärdskonfiguration som använder Adobe Analytics för att skicka en signal.

5. Publish uppdaterade regler

Publicering av uppdaterade regler följer samma arbetsflöde som andra ändringar av taggkonfigurationen.

  1. Välj Publishing Flow i den vänstra navigeringen i tagggränssnittet.
  2. Välj Add Library.
  3. Ge den här taggen ett namn, till exempel"Uppgradera till Web SDK".
  4. Välj Add All Changed Resources.
  5. Välj Save.
  6. Publiceringsarbetsflödet visar en orange punkt som anger att den håller på att byggas. När punkten blir grön är dina ändringar tillgängliga i utvecklingsmiljön.
  7. Testa ändringarna i utvecklingsmiljön för att säkerställa att alla regler aktiveras korrekt och att dataobjektet fylls med förväntade värden.
  8. När det är klart skickar du biblioteket för godkännande, bygg till staging, och sedan godkänner och publicerar det i produktion.

Publiceringsflöde

6. Inaktivera analystillägget

När taggimplementeringen är klar på Web SDK kan du inaktivera Adobe Analytics-tillägget.

  1. Välj Extensions i den vänstra navigeringen i tagggränssnittet.
  2. Leta reda på och välj tillägget Adobe Analytics. Välj Disable till höger.
  3. Följ samma publiceringsarbetsflöde ovan för att publicera borttagningen av tillägget Adobe Analytics.
  4. När tillägget har inaktiverats i produktionen kan du avinstallera det helt. Välj tillägget, välj menyn med tre punkter till höger och välj sedan Uninstall.
  5. Följ samma publiceringsarbetsflöde ovan för att publicera dessa ändringar i produktionen.

I nuläget finns er Analytics-implementering helt och hållet i Web SDK och är väl förberedd att gå över till Customer Journey Analytics i framtiden.

recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690