Esta página descreve idMigrationEnabled no método configure do SDK do Servidor. Para o Web SDK, consulte idMigrationEnabled.
A propriedade idMigrationEnabled permite que o SDK do servidor reutilize as Experience Cloud IDs (ECIDs) que o Serviço de ID de visitante herdado da Adobe (VisitorAPI.js) atribuiu aos seus visitantes. O Serviço de ID de visitante armazena a ECID em um cookie chamado AMCV_<orgId>. A reutilização dessas IDs impede um aumento acentuado em visitantes únicos quando você muda do Serviço de ID de visitante para o Web SDK ou para o SDK do servidor.
Como a migração de identidade funciona em um servidor how-it-works
O SDK lê e grava cookies por meio do serviço de cookies que você transmite para o forRequest. Quando idMigrationEnabled é true:
- Se o visitante não tiver um cookie
kndctr_<orgId>_identity, mas tiver um cookieAMCV_<orgId>, o SDK lerá a ECID do cookieAMCV_e a adicionará aoidentityMapdo evento. A Edge Network continua a usar essa ECID para o visitante. - Depois que o Edge Network retorna a identidade do visitante, o SDK a grava no cookie
kndctr_<orgId>_identitye no cookieAMCV_<orgId>, para que as páginas que ainda usam o Serviço de ID de visitante reconheçam o mesmo visitante.
A migração de identidade funciona somente se o serviço de cookies conceder à SDK acesso aos cookies reais do navegador do visitante e somente se o Serviço de ID do visitante for executado no mesmo domínio com o mesmo orgId. O SDK do servidor não pode ler as identidades da própria biblioteca do Serviço de ID de visitante, pois essa biblioteca é executada somente em navegadores.
Se o serviço de cookies não ler os cookies do navegador do visitante, ou se o site nunca tiver usado o Serviço de ID de visitante, a migração de identidade não terá efeito.
Exemplo de código
Defina o booleano idMigrationEnabled ao chamar configure. Se você omitir, o padrão será true. Defina-o como false para impedir que a SDK leia e grave 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
});