Uppdatera ditt datainsamlingsbibliotek för Audience Manager från taggtillägget Audience Manager till taggtillägget Web SDK

Målgrupp

Den här sidan är avsedd för Audience Manager-kunder som använder Audience Manager-taggtillägget för att hämta webbsamlingsdata till Audience Manager. Kunder som använder AppMeasurement JavaScript-biblioteket kan läsa guiden om hur du uppdaterar ditt datainsamlingsbibliotek för Audience Manager från AppMeasurement JavaScript-biblioteket till Web SDK JavaScript-biblioteket.

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över du inget XDM-schema. I stället kan du fylla i objektet data, som skickar data direkt till Adobe Audience Manager. 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 Audience Manager 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 Real-Time CDP 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 när du har en befintlig implementering med Adobe Audience Manager-taggtillägget.

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

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

1. Skapa och konfigurera en datastream

Följ instruktionerna nedan för att skapa ett datastam i Adobe Experience Platform Data Collection. När du skickar data till den här dataströmmen vidarebefordrar den data till Audience Manager. I framtiden skickar samma dataström data till Real-Time CDP.

  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 Audience Manager på den nedrullningsbara menyn för tjänster.

  8. Kontrollera att alternativet Enable XDM Flattened Fields inte är markerat.

    Lägg till Audience Manager-tjänst

Din datastream är nu redo att ta emot och skicka data till Audience Manager.

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. Markera hamburger-ikonen 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 välj sedan Install till höger.

    Katalog

  6. Konfigurationsinställningarna för tillägget visas. Leta reda på avsnittet Datastreams, markera den sandlåda som du använder och den 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 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 vara som de är.
  4. Välj följande inställningar till höger:

    • Egenskapens alternativknapp: Data
    • Solution: Adobe Audience Manager
  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 Audience Manager-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 Audience Manager-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 Audience Manager - Set Variables

  4. Observera alla Audience Manager-variabler 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. Kontrollera att dataobjektet som du skapade i steg 3 är markerat i listrutan till höger i fältet Data element.

  7. Ställ in Audience Manager nyckelvärdepar på samma värden som de konfigurerades i tillägget Audience Manager.

  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 taggtillägget Audience Manager för att ange värden.

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

  1. Välj en regel som skickar en Web SDK-händelse.

  2. Välj åtgärdstypen Send Event.

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

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

    • Type: Använd Web Webpagedetails Page Views.
    • Data: Markera dataobjektet som du skapade i steg 3.
  5. Välj Keep Changes.

  6. Upprepa dessa steg för varje åtgärdskonfiguration som använder Audience Manager för att skicka en händelse.

5. Publicera 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 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 Audience Manager-tillägget

När taggimplementeringen är helt migrerad till Web SDK kan du inaktivera Audience Manager-tillägget.

  1. Välj Extensions i den vänstra navigeringen i tagggränssnittet.
  2. Leta reda på och välj tillägget Audience Manager. Välj Disable till höger.
  3. Följ samma publiceringsarbetsflöde ovan för att publicera borttagningen av tillägget Audience Manager.
  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 är er Audience Manager-implementering helt migrerad till Web SDK och är beredd att gå över till Real-Time CDP i framtiden.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695