Ativar perfis de visitantes entre domínios

O SDK da Web da Platform oferece suporte a recursos de compartilhamento de ID de visitante que permitem aos clientes fornecer experiências personalizadas com mais precisão em seus domínios. Esse recurso permite fornecer personalização consistente em domínios e melhora a precisão do relatório de atividades do visitante, sem depender de cookies de terceiros.

Pré-requisitos

Para usar o compartilhamento de ID entre domínios, você deve usar o SDK da Web da plataforma versão 2.11.0 ou posterior. Esse recurso também é compatível com o VisitorAPI.js versão 1.7.0 ou posterior.

O compartilhamento de ID entre domínios funciona ao anexar um parâmetro de cadeia de caracteres de consulta adobe_mc especial à URL do domínio de destino. Esse parâmetro é usado para especificar a ID do visitante em vez de gerar uma nova ID ou usar uma ID existente.

O domínio de destino deve usar qualquer uma dessas bibliotecas para o compartilhamento de ID entre domínios para processar o parâmetro adobe_mc e compartilhar a ID do visitante corretamente.

Comparação de abordagens

Antes de implementar, determine primeiro se sua implementação existente usa a função visitor.appendVisitorIDsTo(). Qualquer código personalizado que use essa função deve ser atualizado para usar o novo comando do SDK da Web appendIdentityToUrl.

Usando o comando appendIdentityToURL

Para compartilhamento de ID entre domínios, o SDK da Web versão 2.11.0 adiciona suporte para o comando appendIdentityToUrl. Quando usado, este comando gera o parâmetro da cadeia de caracteres de consulta adobe_mc.

O comando aceita um objeto com uma propriedade, url, e retorna um objeto com a url da propriedade.

Esse comando não aguarda por nenhuma atualização de consentimento. Se o consentimento não foi fornecido, o URL é retornado inalterado.

Se uma ECID não for fornecida, o ponto de extremidade /acquire será chamado para gerar uma ECID.

Veja abaixo um exemplo de como implementar o compartilhamento de ID entre domínios.

Esse código adiciona um ouvinte de eventos para todos os cliques na página. Se o clique estava em um link para um domínio correspondente, neste caso adobe.com ou behance.com, ele adiciona a identidade ao URL e redireciona o usuário para lá.

document.addEventListener("click", event => {
  const anchor = event.target.closest("a");
  if (!anchor || !anchor.href) {
    return;
  }
  const url = new URL(anchor.href);
  if (!url.hostname.endsWith("adobe.com") && !url.hostname.endsWith("behance.com")) {
    return;
  }
  event.preventDefault();
  alloy("appendIdentityToUrl", { url: anchor.href }).then(result => {
    document.location = result.url;
  });
});

Em seguida, saiba como atualizar públicos-alvo e scripts de perfil para garantir a compatibilidade com o SDK da Web da Platform.