idMigrationEnabled

A propriedade idMigrationEnabled permite que o Web SDK leia cookies AMCV definidos por implementações anteriores do Adobe Experience Cloud. Se sua organização atualizar sua implementação para o Web SDK, essa configuração permitirá uma transição mais suave para o serviço atual da Adobe Experience Cloud ID. Essa configuração é importante para que você não veja um aumento acentuado em visitantes únicos ao atualizar para o Web SDK.

Se sua organização executar uma nova implementação do Web SDK, ativar essa configuração não terá impacto na coleta de dados ou na identificação do visitante. Não há desvantagens em deixá-lo ativado para todas as implementações.

Como a migração de identidade funciona how-it-works

A API de visitante armazena a Experience Cloud ID (ECID) em um cookie chamado AMCV_<ORG_ID>. Quando idMigrationEnabled é true (padrão), o Web SDK lê automaticamente a ECID do cookie AMCV e a usa como a identidade do visitante na primeira solicitação Edge Network.

Para que a migração funcione, o Web SDK deve ser configurado com o mesmo orgId usado pela API de visitante e deve ser implantado no mesmo domínio (ou em um subdomínio do mesmo domínio pai) em que o cookie AMCV foi definido.

Cenários de migração compatíveis

A migração de ID é compatível com os seguintes padrões de transição:

Desativando migração turn-off-migration

Depois que todo o site for executado no Web SDK e nenhum visitante carregar apenas um cookie AMCV_ sem um cookie kndctr_ correspondente, você poderá desabilitar com segurança a migração de identidade definindo idMigrationEnabled como false. Esta é uma pequena otimização de desempenho e reduz a área da superfície da sua lógica de identidade.

Como diretriz, aguarde até que o tempo de vida máximo do cookie AMCV tenha decorrido após a última página ter sido migrada. Se os cookies AMCV tiverem uma expiração de dois anos, aguarde dois anos após a página final ter sido cortada para o Web SDK. Na prática, a maioria das organizações desativa a migração mais cedo (após alguns meses) e aceita um valor insignificante de inflação devido ao pequeno número de visitantes que retornam pela primeira vez após uma longa ausência.

Atualizações de características do Audience Manager

Quando dados formatados em XDM são enviados para o Audience Manager durante a migração, esses dados devem ser convertidos em sinais. Suas características devem ser atualizadas para refletir as novas chaves fornecidas pelo XDM. Este processo é facilitado com a ferramenta BAAAM.

Migração de ID de terceiros third-party-id

Se sua implementação da API de visitante usou IDs de terceiros (o cookie demdex.net), o Web SDK também poderá migrá-las. Configure de thirdPartyCookiesEnabled a true na sua configuração do Web SDK. O Web SDK lê o cookie Demdex existente e inclui a identidade de terceiros em suas solicitações do Edge Network, seguindo o mesmo padrão de migração do cookie AMCV.

Validação validation

Para verificar se a migração de identidade está funcionando corretamente:

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

Configurar idMigrationEnabled configure

Defina o booleano idMigrationEnabled ao executar o comando configure. Se você omitir essa propriedade ao configurar o Web SDK, o padrão será true. Defina essa propriedade se desejar desativar a capacidade de ler cookies AMCV definidos pela API do visitante. A maioria das organizações não precisa definir essa propriedade.

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

Habilitar a migração de ID de visitante usando a extensão de tag da Web SDK

Essas configurações podem ser definidas na extensão de marca do Web SDK usando configurações de identidade.