idMigrationEnabled

La proprietà idMigrationEnabled consente al Web SDK di leggere i cookie AMCV impostati da implementazioni Adobe Experience Cloud precedenti. Se l’organizzazione aggiorna l’implementazione al Web SDK, questa impostazione consente una transizione più fluida al servizio Adobe Experience Cloud ID corrente. Questa impostazione è utile per evitare un netto aumento dei visitatori univoci durante l'aggiornamento al Web SDK.

Se l’organizzazione esegue una nuova implementazione di Web SDK, l’abilitazione di questa impostazione non ha alcun impatto sulla raccolta dei dati o sull’identificazione dei visitatori. Non ci sono svantaggi a lasciarla abilitata per tutte le implementazioni.

Come funziona la migrazione delle identità how-it-works

L'API visitatore memorizza l'Experience Cloud ID (ECID) in un cookie denominato AMCV_<ORG_ID>. Quando idMigrationEnabled è true (impostazione predefinita), il Web SDK legge automaticamente l'ECID dal cookie AMCV e lo utilizza come identità del visitatore alla prima richiesta di Edge Network.

Affinché la migrazione funzioni, il Web SDK deve essere configurato con lo stesso orgId utilizzato dall'API visitatore e deve essere distribuito sullo stesso dominio (o su un sottodominio dello stesso dominio padre) in cui è stato impostato il cookie AMCV.

Scenari di migrazione supportati

La migrazione degli ID supporta i seguenti modelli di transizione:

Disattivazione della migrazione turn-off-migration

Se l'intero sito viene eseguito sul Web SDK e nessun visitatore dispone di un solo cookie AMCV_ senza il cookie kndctr_ corrispondente, è possibile disabilitare la migrazione delle identità impostando idMigrationEnabled su false. Si tratta di una piccola ottimizzazione delle prestazioni e riduce l’area di superficie della logica di identità.

Come linea guida, attendi che sia trascorso il periodo di vita massima del cookie AMCV dopo la migrazione dell'ultima pagina. Se i tuoi cookie AMCV hanno una scadenza di due anni, attendi due anni dopo che la pagina finale è stata tagliata sul Web SDK. In pratica, la maggior parte delle organizzazioni disabilita la migrazione prima (dopo alcuni mesi) e accetta una quantità trascurabile di inflazione dal numero ridotto di visitatori che ritornano per la prima volta dopo una lunga assenza.

Aggiornamenti delle caratteristiche di Audience Manager

Quando i dati formattati XDM vengono inviati ad Audience Manager durante la migrazione, devono essere convertiti in segnali. Le caratteristiche devono essere aggiornate per riflettere le nuove chiavi fornite da XDM. Questo processo è semplificato utilizzando lo strumento BAAAM.

Migrazione degli ID di terze parti third-party-id

Se l'implementazione dell'API Visitor ha utilizzato ID di terze parti (cookie demdex.net), anche Web SDK può migrarli. Configurare thirdPartyCookiesEnabled in true nella configurazione Web SDK. Il SDK web legge il cookie demdex esistente e include l’identità di terze parti nelle sue richieste Edge Network, seguendo lo stesso modello di migrazione del cookie AMCV.

Convalida validation

Per verificare che la migrazione delle identità funzioni correttamente:

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

Configurare idMigrationEnabled configure

Impostare il valore booleano idMigrationEnabled durante l'esecuzione del comando configure. Se si omette questa proprietà durante la configurazione del Web SDK, per impostazione predefinita viene utilizzato true. Imposta questa proprietà se vuoi disabilitare la capacità di leggere i cookie AMCV impostati dall'API visitatore. La maggior parte delle organizzazioni non deve impostare questa proprietà.

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

Abilitare la migrazione degli ID visitatore tramite l’estensione tag Web SDK

Queste impostazioni possono essere configurate nell'estensione tag Web SDK utilizzando Impostazioni di configurazione identità.