idMigrationEnabled

Egenskapen idMigrationEnabled gör att Web SDK kan läsa AMCV-cookies som angetts av tidigare Adobe Experience Cloud-implementeringar. Om din organisation uppgraderar din implementering till Web SDK ger den här inställningen en smidigare övergång till den aktuella Adobe Experience Cloud ID-tjänsten. Den här inställningen är värdefull så att du inte ser någon större ökning av antalet unika besökare när du uppgraderar till SDK för webben.

Om din organisation kör en ny implementering av Web SDK påverkar detta inte datainsamling eller besöksidentifiering. Det finns inga nackdelar med att låta det vara aktiverat för alla implementeringar.

Så här fungerar identitetsmigrering how-it-works

Besökar-API:t lagrar Experience Cloud-ID (ECID) i en cookie med namnet AMCV_<ORG_ID>. När idMigrationEnabled är true (standardvärdet) läser Web SDK automatiskt ECID från AMCV-cookien och använder det som besökarens identitet på den första Edge Network-begäran.

För att migreringen ska fungera måste Web SDK konfigureras med samma orgId som Visitor-API:t använde och måste distribueras på samma domän (eller en underdomän till samma överordnade domän) där AMCV-cookien angavs.

Migreringsscenarier som stöds

ID-migrering har stöd för följande övergångsmönster:

Inaktiverar migrering turn-off-migration

När hela webbplatsen har körts på SDK och inga besökare har bara en AMCV_-cookie utan en motsvarande kndctr_-cookie kan du inaktivera identitetsmigreringen genom att ange idMigrationEnabled som false. Detta är en mindre prestandaoptimering och minskar ytan för identitetslogiken.

Som vägledning bör du vänta tills AMCV-cookie har passerat sin längsta livstid efter att den sista sidan har migrerats. Om dina AMCV-cookies har en tvåårig förfallotid, vänta två år efter att den sista sidan klipptes över till Web SDK. I praktiken avaktiverar de flesta organisationer migreringen tidigare (efter några månader) och godtar en försumbar inflationsnivå från det fåtal besökare som för första gången kommer tillbaka efter en lång frånvaro.

Uppdateringar för Audience Manager trait

När XDM-formaterade data skickas till Audience Manager under migreringen måste dessa data konverteras till signaler. Dina egenskaper måste uppdateras för att återspegla de nya nycklarna i XDM. Den här processen blir enklare om du använder BAAAM-verktyget.

Migrering av ID från tredje part third-party-id

Om implementeringen av Visitor API använde ID:n från tredje part (cookien demdex.net) kan Web SDK även migrera dem. Konfigurera thirdPartyCookiesEnabled till true i din Web SDK-konfiguration. Web SDK läser den befintliga Demdex-cookien och inkluderar tredjepartsidentiteten i sina Edge Network-förfrågningar, som följer samma migreringsmönster som AMCV-cookien.

Validering validation

Så här kontrollerar du att identitetsmigrering fungerar som den ska:

alloy("getIdentity", { namespaces: ["ECID"] }).then(function(result) {
   console.log("ECID:", result.identity.ECID);
});

Konfigurera idMigrationEnabled configure

Ange det booleska värdet idMigrationEnabled när du kör kommandot configure. Om du utelämnar den här egenskapen när du konfigurerar Web SDK blir standardvärdet true. Ange den här egenskapen om du vill inaktivera möjligheten att läsa AMCV-cookies som angetts av Visitor API. De flesta organisationer behöver inte ange den här egenskapen.

alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  idMigrationEnabled: false
});

Aktivera migrering av besökar-ID med hjälp av taggtillägget Web SDK

Dessa inställningar kan konfigureras i taggtillägget för Web SDK med hjälp av inställningarna för identitetskonfiguration.