Esta página describe idMigrationEnabled en el método Server SDK configure. Para Web SDK, consulte idMigrationEnabled.
La propiedad idMigrationEnabled permite que el SDK del servidor reutilice los Experience Cloud ID (ECID) que el servicio de ID de visitante de Adobe heredado (VisitorAPI.js) asignó a sus visitantes. El servicio de ID de visitante almacena el ECID en una cookie denominada AMCV_<orgId>. La reutilización de estos ID evita un marcado aumento de visitantes únicos al pasar del servicio de ID de visitante a Web SDK o a Server SDK.
Funcionamiento de la migración de identidad en un servidor how-it-works
SDK lee y escribe cookies a través del servicio de cookies que pasa a forRequest. Cuando idMigrationEnabled tiene true:
- Si el visitante no tiene una cookie
kndctr_<orgId>_identity, pero tiene una cookieAMCV_<orgId>, SDK lee el ECID de la cookieAMCV_y lo agrega aidentityMapdel evento. A continuación, Edge Network seguirá utilizando ese ECID para el visitante. - Una vez que Edge Network devuelve la identidad del visitante, SDK la escribe tanto en la cookie
kndctr_<orgId>_identitycomo en la cookieAMCV_<orgId>, de modo que las páginas que todavía usan el servicio de ID de visitante reconozcan al mismo visitante.
La migración de identidad solo funciona si el servicio de cookies proporciona a SDK acceso a las cookies reales del explorador del visitante y solo si el servicio de ID de visitante se ejecutó en el mismo dominio con el mismo orgId. Server SDK no puede leer identidades de la propia biblioteca del servicio de ID de visitante, ya que dicha biblioteca solo se ejecuta en exploradores.
Si el servicio de cookies no lee las cookies del explorador del visitante o si el sitio nunca ha utilizado el servicio de ID de visitante, la migración de identidad no tiene ningún efecto.
Ejemplo de código
Establezca el booleano idMigrationEnabled al llamar a configure. Si lo omite, el valor predeterminado es true. Configúrelo en false para evitar que SDK lea y escriba cookies AMCV_.
await alloy.configure({
datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
edgeCredentials: {
clientId: process.env.ADOBE_CLIENT_ID,
clientSecret: process.env.ADOBE_CLIENT_SECRET,
scopes: process.env.ADOBE_SCOPES.split(",")
},
idMigrationEnabled: false
});