idMigrationEnabled

La propiedad idMigrationEnabled permite que Web SDK lea cookies AMCV establecidas por implementaciones de Adobe Experience Cloud anteriores. Si su organización actualiza la implementación a Web SDK, esta configuración permite una transición más suave al servicio de Adobe Experience Cloud ID actual. Esta configuración es valiosa para que no observe un marcado aumento de visitantes únicos al actualizar a Web SDK.

Si su organización ejecuta una implementación nueva de Web SDK, habilitar esta configuración no tiene ningún impacto en la recopilación de datos ni en la identificación de visitantes. No hay inconvenientes en dejarlo habilitado para todas las implementaciones.

Funcionamiento de la migración de identidad how-it-works

La API de visitante almacena el Experience Cloud ID (ECID) en una cookie llamada AMCV_<ORG_ID>. Cuando idMigrationEnabled es true (el valor predeterminado), Web SDK lee automáticamente el ECID de la cookie AMCV y lo utiliza como identidad del visitante en la primera solicitud de Edge Network.

Para que la migración funcione, Web SDK debe configurarse con el mismo orgId que la API de visitante utilizada y debe implementarse en el mismo dominio (o un subdominio del mismo dominio principal) donde se configuró la cookie AMCV.

Escenarios de migración admitidos

La migración de ID admite los siguientes patrones de transición:

Desactivación de la migración turn-off-migration

Después de que todo el sitio se ejecute en Web SDK y ningún visitante lleve solamente una cookie AMCV_ sin la cookie kndctr_ correspondiente, puede deshabilitar de forma segura la migración de identidades estableciendo idMigrationEnabled en false. Se trata de una optimización de rendimiento menor y reduce el área de superficie de la lógica de identidad.

Como guía, espere hasta que la duración máxima de la cookie AMCV haya transcurrido después de migrar la última página. Si las cookies AMCV tienen una caducidad de dos años, espere dos años después de que la página final se haya transferido a Web SDK. En la práctica, la mayoría de las organizaciones desactivan la migración antes (después de unos meses) y aceptan una cantidad insignificante de inflación debido al pequeño número de visitantes que regresan por primera vez después de una larga ausencia.

Actualizaciones de rasgos de Audience Manager

Cuando se envían datos con formato XDM a Audience Manager durante la migración, esos datos deben convertirse en señales. Las características deben actualizarse para reflejar las nuevas claves proporcionadas por XDM. Este proceso es más fácil gracias a la herramienta BAAAM.

Migración de ID de terceros third-party-id

Si la implementación de la API de visitante utilizó ID de terceros (la cookie demdex.net), Web SDK también puede migrarlos. Configure thirdPartyCookiesEnabled a true en la configuración de Web SDK. Web SDK lee la cookie de Demdex existente e incluye la identidad de terceros en sus solicitudes de Edge Network, siguiendo el mismo patrón de migración que la cookie de AMCV.

Validación validation

Para comprobar que la migración de identidad funciona correctamente:

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

Configurar idMigrationEnabled configure

Establezca el booleano idMigrationEnabled al ejecutar el comando configure. Si omite esta propiedad al configurar Web SDK, el valor predeterminado es true. Establezca esta propiedad si desea deshabilitar la capacidad de leer cookies AMCV establecidas por la API de visitante. La mayoría de las organizaciones no necesitan establecer esta propiedad.

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

Habilitar la migración de ID de visitantes con la extensión de etiquetas Web SDK

Estas opciones se pueden configurar en la extensión de etiquetas Web SDK con opciones de configuración de identidad.