Uppdatera datainsamlingsbiblioteket för Audience Manager från AppMeasurement till Web SDK
Målgrupp intended-audience
Den här sidan är till för Audience Manager- och Adobe Analytics-kunder som använder JavaScript-biblioteket AppMeasurement för att skicka webbdata till Audience Manager.
I tabellen nedan finns anvisningar om hur du migrerar till Web SDK, beroende på vilken datainsamlingsmetod du använder.
Migreringsöversikt overview
Migrering från AppMeasurement till Web SDK är i första hand en Adobe Analytics-migrering. För Audience Manager-kunder omfattar migreringen även Audience Manager. Båda måste migreras tillsammans. Om du huvudsakligen arbetar med Audience Manager måste du se till att Analytics-teamet deltar i migreringen.
Om du använder AppMeasurement för Audience Manager datainsamling använder du för närvarande Server-side Forwarding (SSF)-metoden för att skicka Analytics-data till Audience Manager. I den här konfigurationen vidarebefordras begäran om insamling av analysdata till Audience Manager, som även hanterar Audience Manager svar på sidan.
Detta har varit standardmetoden i många år och är sannolikt din nuvarande konfiguration. Om ditt AppMeasurement-bibliotek innehåller modulen AudienceManagement och dina datainsamlingsanrop innehåller sökvägen /10/ i begäran (/b/ss/examplereportsuite/10/) är den här handboken till dig.
Dataflöden mellan SSF och SDK på webben data-flows
För instruktionerna nedan är det viktigt att förstå dataflödesskillnaderna mellan Analytics och Audience Manager när man går över till Web SDK (och Edge Network).
Med vidarebefordran på serversidan samlar den regionala datainsamlingsnoden för Analytics in data, omvandlar dem till en signal som accepteras av Audience Manager, skickar den till Audience Manager och returnerar Audience Manager svar till sidan. Modulen AudienceManagement i biblioteket AppMeasurement hanterar sedan svaret (t.ex. att cookies släpps, URL-mål skickas). Den här processen kallas för vidarebefordran på serversidan eftersom Analytics vidarebefordrar data till Audience Manager med hjälp av Adobe-servrar.
Med Web SDK skickar Edge Network data till Analytics och Audience Manager i olika åtgärder. Web SDK är ett enda bibliotek som skickar data till alla lösningar, och Edge Network omvandlar lösningsbaserade datapunkter till lösningsspecifika format.
I det nya dataflödet skickas alla data till en datastream från Edge Network, som du kan konfigurera att skicka data till Adobe-lösningar efter behov. Om du aktiverar Audience Manager-tjänsten på datastream för Audience Manager omvandlas XDM- och Analytics-data till signaler som accepteras av Audience Manager. Edge Network returnerar också Audience Manager svar på sidan, där Web SDK hanterar svaret, som exempelvis AppMeasurement och AudienceManagement -modulen.
Överföring av taggar jämfört med andra taggar tags-vs-non-tags
Oavsett om du använder taggar med tillägget AppMeasurement, biblioteket AppMeasurement i ett annat tagghanteringssystem eller placerar AppMeasurement direkt på sidan är stegen för att migrera Audience Manager till Web SDK desamma. Eftersom Audience Manager-migreringen är beroende av Analytics-migreringen bestäms stegen för att migrera från AppMeasurement till Web SDK under Analytics-migreringen.
Den informationen beskrivs i Analytics-dokumentationen för Tags- eller JavaScript-baserade implementeringar.
XDM och data.__adobe.-noderna xdm-data-nodes
En av huvudfunktionerna i Web SDK är att skicka data till Real-Time Customer Data Platform (RTCDP). För att uppnå detta och fortfarande samla in data för andra Experience Cloud-lösningar utan en fullständig omimplementering, delas lösningsspecifika data upp i serveranropet för datainsamling. Det här anropet använder ett standardiserat JSON-schema som kallas Experience Data Model (XDM)
Lösningsmedvetna element, som information om webbläsaren och enheten, skickas till Edge Network i en förbestämd XDM-struktur. Edge Network omvandlar dessa data till lösningsspecifika format. Data som är specifika för Target, Analytics och Audience Manager lagras dock i en dedikerad data.__adobe-nod i XDM-nyttolasten.
Exempel:
- Analysvariabeln
s.eVar1representeras i XDM-nyttolasten somdata.__adobe.analytics.evar1. - En Target-parameter som är relaterad till kundlojalitetsstatusen lagras som
data.__adobe.target.loyaltyStatus.
Data i noden __adobe skickas till respektive lösningar (som Analytics och Audience Manager) utan att skickas till Experience Platform, även om Experience Platform-tjänsten är aktiverad på dataströmmen. Det innebär att du kan behålla dina nuvarande konfigurationer för Analytics och Audience Manager samtidigt som du har flexibilitet att mappa nödvändiga dataelement till XDM-schemaelement för användning i realtid i Experience Platform med Dataprep för datainsamling.
Strängen Analytics s.products, som används för att rapportera kundvagnens innehåll under utcheckningen, kan till exempel fortfarande skickas till Analytics och Audience Manager i det ursprungliga formatet. Samtidigt kan du använda elementen i den här strängen för att skapa mer intuitiva XDM-kundvagnsscheman för Experience Platform.
Eftersom de flesta Audience Manager-implementeringar förlitar sig på analysdata som vidarebefordrats till Audience Manager, är många av dina Audience Manager-uttryck troligen baserade på Analytics-variabler (c_evar#, c_prop# och c_events). För att undvika att återskapa trait-uttryck med XDM-format under migreringen är Edge Network som standard konfigurerat att omvandla alla Analytics-variabler som finns i noden data.__adobe.analytics till Audience Manager-signaler. En liknande transformeringsprocess sker i arbetsflödet för vidarebefordran på serversidan.
Edge Network kan utföra den här omvandlingen eftersom ett enda datainsamlingsanrop från sidan skickas till ett enda datastream som matar flera Adobe-lösningar. Därför kommer de flesta migreringar från AppMeasurement till Web SDK för både Analytics och Audience Manager främst att använda noden data.__adobe.analytics.
Edge Network omvandlar enhets- och webbläsardata från XDM-nyttolasten och pakethuvuden till Audience Manager-signaler. Detta gör att du kan fortsätta använda h_ och d_ plattformstangenter i Audience Manager-uttryck för egenskaper.
Noden data.__adobe.audiencemanager data-note
Noden data.__adobe.audiencemanager används för Audience Manager-implementeringar som inte är beroende av Analytics. Det lagrar anpassade nyckelpar/värdepar från Audience Manager som tidigare skickats via DIL-biblioteket, vilket beskrivs i migreringsguiden för taggtillägg.
Även om noden data.__adobe.audiencemanager inte behövs för den migrering som beskrivs i den här guiden, tillåter det nya dataflödet som beskrivs här att data skickas till Audience Manager utan att registreras i Analytics.
Om du behöver skicka ett anpassat nyckel/värde-par till Audience Manager utan att inkludera det i Analytics, kan du använda noden data.__adobe.audiencemanager. Alla datauppsättningar i den här noden läggs till i Audience Manager-transformerade Analytics-data i datainsamlingsserveranropet.
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.
- Använder din befintliga implementering: Även om den här metoden kräver vissa implementeringsändringar krävs ingen helt ny implementering från början. Du kan använda ditt befintliga datalager och kod med minimala ändringar av implementeringslogiken.
- 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 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 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.
- Implementering av teknisk 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 i framtiden vid behov.
- 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 följande implementeringsväg i följande scenarier:
- Du har en befintlig implementering som använder Adobe Analytics AppMeasurement JavaScript-biblioteket. Om du har en implementering med taggtillägget Audience Manager följer du Migrera från taggtillägget Audience Manager till taggtillägget Web SDK i stället.
- Du avser att använda Real-Time CDP i framtiden, men vill inte ersätta din Audience Manager-implementering med en Web SDK-implementering från grunden. Alternativet att ersätta implementeringen från grunden med Web SDK kräver mest arbete, eftersom du måste återskapa alla dina Audience Manager-egenskaper för att kunna söka efter XDM-formaterade data. Men det är också den mest lönsamma långsiktiga implementeringsarkitekturen. Om din organisation vill använda en ren implementering av Web SDK läser du dokumentationen för Web SDK i stället för att använda den här guiden.
Steg som krävs för att migrera till SDK för webben
Följ stegen nedan för att migrera din datainsamlingsintegrering till Web SDK.
Lägg till Audience Manager-tjänsten i den datastream som du använder i den Analytics-migrering som nämns i steg 1.
-
Navigera till experience.adobe.com och logga in med dina autentiseringsuppgifter.
-
Använd hemsidan eller produktväljaren i det övre högra hörnet för att navigera till Data Collection.
-
Välj Datastreams i den vänstra navigeringen.
-
Välj den datastream som du skapade som en del av din Analytics-migrering i steg 1.
-
Välj Add Service.
-
Välj Audience Manager på den nedrullningsbara menyn för tjänster.
-
Kontrollera alternativen Cookie Destinations Enabled och URL Destinations Enabled. Med dessa alternativ kan Edge Network returnera dessa måltyper från Audience Manager till sidan.
-
Kontrollera att Enable XDM Flattened Fields är inaktiverad. Med det här alternativet inaktiveras den automatiska omvandlingen av Analytics-variabler till Audience Manager-signaler. Det här alternativet är utformat för att behålla bakåtkompatibilitet för användare som migrerade till Web SDK innan Edge Network automatiskt omvandlade Analytics-data till Audience Manager-signaler.
note note NOTE Om du migrerar till Web SDK med alternativet Enabled XDM Flattened Fields aktiverat måste alla data som behövs i Audience Manager formaterade som XDM och alla Audience Manager-egenskaper som använder props, eVars eller händelser uppdateras för att i stället söka efter XDM-formaterade data. Adobe rekommenderar att du lämnar det här alternativet inaktiverat. 
-
Välj Save om du vill spara dataströmskonfigurationen.
Din datastream är nu redo att ta emot och skicka data till Audience Manager. Observera dataStream ID, eftersom detta ID krävs när du konfigurerar Web SDK i koden.
-
Navigera till experience.adobe.com och logga in med dina autentiseringsuppgifter.
-
Använd hemsidan eller produktväljaren i det övre högra hörnet för att navigera till Data Collection.
-
Välj Datastreams i den vänstra navigeringen.
-
Välj den datastream som du skapade som en del av din Analytics-migrering i steg 1.
-
Välj Edit i det övre högra hörnet på konfigurationssidan för datastream.
-
Expandera listrutan Advanced Options och aktivera funktionen Third Party ID Sync om den inte redan är aktiverad. Det här alternativet anger för Edge Network att returnera Partner ID Syncs för Audience Manager och Experience Platform datapartner.
-
I de flesta fall kan du lämna fältet Third Party ID Sync Container ID tomt. Standardvärdet är
0. Om du däremot föredrar att se till att rätt behållar-ID används följer du de här stegen:- Öppna ett webbläsarfönster i inkodat eller privat läge och navigera till en sida som är en del av migreringen.
- Använd webbläsarens utvecklarverktyg för att filtrera efter nätverksanropet till
dpm.demdex.net/id. Det här samtalet utlöses endast på första sidan av ett första besök, och därför behövs en inkognito eller en privat webbläsare. - Visa nyttolasten för begäran. Om parametern
d_nsidinte är noll kopierar du den till fältet Third Party ID Sync Container ID.
-
Välj Save.
Din datastream kan nu både skicka data till Audience Manager och skicka Audience Manager svar till Web SDK.
De flesta Audience Manager-implementeringar använder profilkopplingsregler i personaliseringsscenarier mellan olika enheter och för att styra vilka segment besökarna kan kvalificera sig för beroende på autentiseringsstatus (inloggad eller utloggad). Regler för profilsammanslagning kräver att en kundägd identifierare (CRM-ID, kontonummer osv.) skickas till Audience Manager vid varje datainsamlingsanrop efter autentiseringen. Tidigare användes funktionen setCustomerIDs i Visitor ID-tjänsten (visitor.js) för att lägga till kund-ID:n i varje anrop till Analytics-datainsamling, som sedan vidarebefordrades till Audience Manager.
Med Web SDK måste dessa identiteter skickas till Edge Network med en speciell XDM-konstruktion som kallas IdentityMap.
Att skicka identiteter korrekt i en identitetskarta kräver förståelse för identitetsnamnutrymmen och att du noga undersöker vilka identiteter som ska skickas, särskilt när du skickar data till en Experience Platform-sandlåda. I den här artikeln beskrivs dessa överväganden och instruktioner.
När du har fastställt vilka identiteter som ska skickas och när, följer du guiderna för hur du använder Identity map Identity map dataelementet i Taggar eller ställer in det manuellt så som beskrivs i översikten över identitetsdata för att anpassa dig till din distributionsstrategi för Web SDK.
aam_uuid från första partEtt standardtillvägagångssätt i många år var att placera Audience Manager UUID (värdet i en demodex-cookie från tredje part) i en cookie från första part som vanligtvis heter aam_uuid.
Om du vill ange cookie-filen måste du ange ett cookie-namn i fältet Name i avsnittet Unique User ID Cookie i taggtillägget Analytics eller i fältet uuidCookie när du konfigurerar audienceManagementModule. Även om cookien är konfigurerad i koden användes den sällan eftersom Audience Manager UUID-värdet är en enhetsspecifik, domänövergripande identifierare som används av annonsplattformar och inte ger något värde som förstapartidentifierare.
Om implementeringen kräver att den här aam_uuid-cookien fortsätter att anges efter migreringen till Web SDK kan du hämta Audience Manager UUID på två sätt.
-
Varje svar från Edge Network interact-slutpunkten innehåller en nyttolast med
idnoder. Nodenidi namnområdesnyttolastenCOREinnehåller Audience Manager UUID. -
Använd kommandot getIdentity för Web SDK för att hämta det. Använd namnutrymmet
COREenligt beskrivningen i dokumentationen och hämta värdet från fältetidentity.COREi svaret.
Oavsett vilken metod som används för att hämta Audience Manager UUID är det upp till ditt utvecklingsteam att analysera svaret, hämta UUID och ange cookien. Det finns inget automatiskt sätt att ställa in denna cookie via Web SDK.
Konfigurera vidarebefordran på serversidan och Audience Analytics i gränssnittet för Analytics Report Suite Manager configure-ssf-analytics
Om du känner till funktionen Vidarebefordran på serversidan i Analytics kan du undra: Ska jag inaktivera inställningen för vidarebefordran på serversidan i gränssnittet i Analytics Report Suite Manager för att förhindra att Analytics-data skickas till Audience Manager två gånger?".
Svaret är nej, du bör inte inaktivera den här inställningen av följande skäl:
-
När Audience Manager-tjänsten är aktiverad på en datastream, lägger Edge Network till variabeln
cm.ssfi alla datainsamlingsbegäranden som skickas till Analytics. Detta förhindrar även att analysdata skickas till Audience Manager. Eventuella Assurance-loggar som används för att validera Analytics-migreringen visar variabelncm.ssf=1när Audience Manager-tjänsten är aktiverad på datastream. Mer information finns på sidan Analytics and GDPR compliance page focused on server-side forward. -
Den här inställningen aktiverar även dataflödet för Audience Analytics-integreringen. Som beskrivs i Audience Analytics-översikten krävs vidarebefordran på serversidan för den här integreringen eftersom Audience Manager-svaret på analysdatainsamlingsservern läggs till i Analytics-träffen innan bearbetningen. En liknande process sker i Edge Network. När vidarebefordran på serversidan är aktiverat lägger Edge Network till de segment som behövs från Audience Manager svar till data som skickas till Analytics.
Sammanfattningsvis är det viktigt att den här inställningen är aktiverad så att Audience Analytics fortsätter att fungera med en Web SDK-implementering och att inga data räknas dubbelt i Audience Manager.
Validera migreringen validation
När alla Adobe-lösningar nu hanteras av ett enda Web SDK-anrop kan valideringsstegen ändras beroende på vilka lösningar Web SDK har.
Om Adobe Target eller Adobe Journey Optimizer (inklusive Decisioning) är en del av lösningsstacken som hanteras av implementeringen, kommer du att ha flera nätverksanrop till Edge Network på sidan. Vissa av dessa är avsedda för att hämta personaliseringar och erbjudanden medan andra är avsedda för datainsamling och rapportering.
Oberoende av implementering gäller de allmänna principerna nedan för att validera att data flödar korrekt till och från Audience Manager via Web SDK.
-
Det första nätverksanropet för en förstasidesbesökare är till domänen
adobedc.demdex.netoch slutpunkten/interact. Du kan se nätverksanrop från Web SDK genom att öppna utvecklarfliken i webbläsaren, klicka på fliken Nätverk och sedan filtrera efter/interact.
Det finns andra typer av Web SDK-anrop, men barainteractanrop skickar data till och hämtar en svarsnyttolast från Edge Network.
-
Svaret på det första nätverksanropet har flera nyttolaster. En av dessa nyttolastnoder innehåller flera undernoder av typen
url. Dessaurl-noder är synkroniseringar av tredje parts-ID som historiskt har utlösts av tjänsten Visitor ID. Det ska finnas enurl-nod för varje synkronisering av tredje parts-ID som är konfigurerad i behållaren (se steg 3 ovan).
Dessutom kan du filtrera efter
demdexoch hitta att var och en av de URL:er som refereras i nyttolasten utlöste en egen nätverksbegäran om ID-synkronisering, precis som med tjänsten Visitor ID. Dessa ID-synkroniseringar ska bara aktiveras på första sidan av en förstagångsbesökare och endast en gång var 14:e dag därefter. -
Alla efterföljande
/interact-begäranden som används för Analytics- och Audience Manager-datainsamling ska innehålladata.__adobe.analytics-noderna i nyttolasten.
Audience Manager-egenskaper som förlitar sig på dessa Analytics-variabler, samt egenskaper som använder
h_- ellerd_-plattformstangenterna, bör även fortsättningsvis fyllas i.note tip TIP Du kanske vill skapa en testegenskap med ett regeluttryck som bara kan uttryckas om Web SDK-data samlas in. Eftersom det inte finns någon utvecklingsmiljö i Audience Manager och flera webbplatser kan skicka data till samma Audience Manager-instans, behöver du inte validera alla populationsantal. -
I samma
/interact-anrop där Analytics-variabler skickas, kan alla cookie-mål eller URL-mål hittas i nyttolastnoderna för svaret. URL-mål kommer att finnas i nyttolaster av typenurl(precis som i synkroniseringar med tredje parts-ID) och cookie-mål kommer att finnas i nyttolaster av typencookie.
Du bör också se till att cookies har tagits bort i webbläsarens cookie-lagring.
note tip TIP På samma sätt som i föregående valideringssteg är det ett visst sätt att säkerställa att data flödar till och från Audience Manager att kvalificera ett segment som ska returnera en cookie-destination. -
Om du behöver skicka ytterligare kund-ID:n via identitetskartan autentiserar du webbplatsen och ser till att identiteter och deras associerade parametrar skickas i identitetskartan för nyttolasten.
note tip TIP Om Adobe Target är en av de mottagande lösningarna och det finns Target-aktiviteter som är beroende av Audience Manager-segment som kräver att rätt identitet skickas, kontrollerar du att identitetskartan skickas i de /interactanrop som används för att hämta personaliseringar och inte bara i datainsamlingsanrop. Adobe Target kommer att använda dessa identiteter i serveranropet till Audience Manager när segmentinformation hämtas.