Show Menu
TÓPICOS×

Implementar o serviço de identidade da Experience Cloud no Analytics, no Audience Manager e no Target

Estas instruções são para clientes do Analytics, do Audience Manager e do Target que desejam usar o serviço de identidade da Experience Cloud e não usam o Dynamic Tag Management (DTM). No entanto, recomendamos que você use o DTM ao implementar o serviço de ID. O DTM simplifica o fluxo de trabalho de implementação e garante automaticamente a inserção e o sequenciamento corretos do código.
Leia os requisitos do serviço de ID antes de começar e observe os seguintes requisitos que são específicos desta implementação: >
  • Os clientes que usam s_code não podem concluir esse procedimento. Atualize para o código da mbox v61 para concluir este procedimento.
  • Configure e teste esse código em um ambiente de desenvolvimento antes de implantá-lo na produção.

Etapa 1: plano de encaminhamento do lado do servidor

Além das etapas descritas, os clientes que usam o Analytics e o Audience Manager devem migrar para o encaminhamento do lado do servidor. O encaminhamento do lado do servidor permite remover o DIL (código de coleta de dados do Audience Manager) e substituí-lo pelo Módulo de gerenciamento de público-alvo . Consulte a documentação de encaminhamento do lado do servidor para obter mais informações.
A migração para o encaminhamento do lado do servidor requer planejamento e coordenação. Esse processo envolve alterações externas ao código do site e etapas internas que a Adobe deve tomar para provisionar sua conta. Na verdade, muitos desses procedimentos de migração precisam acontecer em paralelo e ser lançados juntos. Seu caminho de implementação deve seguir esta sequência de eventos:
  1. Trabalhe com os contatos do Analytics e do Audience Manager a fim de planejar a migração do serviço de ID e do encaminhamento do lado do servidor. A seleção do servidor de rastreamento é uma parte importante do plano.
  2. Preencha o formulário no local de integrações e provisionamento para começar.
  3. Implemente o serviço de ID e o Audience Management Module ao mesmo tempo. Para funcionar adequadamente, o Audience Management Module (encaminhamento do lado do servidor) e o serviço de ID devem ser lançados para o mesmo conjunto de páginas e ao mesmo tempo.

Etapa 2: baixar o código do serviço de ID

O serviço de ID exige a VisitorAPI.js biblioteca de código. Para baixar a biblioteca de código:
  1. Acesse Administração > Gerenciamento de código .
  2. No Gerenciamento de código, clique em JavaScript (Novo) ou JavaScript (Herdado) . As bibliotecas de código comprimidas serão baixadas.
  3. Descomprima o arquivo de código e abra o VisitorAPI.js arquivo.

Etapa 3: adicionar a função Visitor.getInstance ao código de serviço de ID

  • As versões anteriores da API de serviço de ID colocavam essa função em um local diferente e exigiam uma sintaxe distinta. Se você estiver migrando de uma versão anterior à versão 1.4 , observe a nova disposição e sintaxe documentadas aqui.
  • O código em ALL CAPS é um espaço reservado para valores reais. Substitua esse texto pela ID da organização, URL do servidor de rastreamento ou outro valor nomeado.
Parte 1: Copie a função Visitor.getInstance abaixo
var visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE", { 
     trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer 
     trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure 
 
     // To enable CNAME support, add the following configuration variables 
     // If you are not using CNAME, DO NOT include these variables 
     marketingCloudServer: "INSERT-TRACKING-SERVER-HERE", 
     marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure 
}); 

Parte 2: Adicionar código de função ao arquivo Visitor API.js
Insira a Visitor.getInstance função ao final do arquivo, após o bloqueio do código. O arquivo editado deve ficar parecido com o exemplo abaixo:
/* 
========== DO NOT ALTER ANYTHING BELOW THIS LINE ========== 
Version and copyright section 
*/ 
 
// Visitor API code library section 
 
// Put Visitor.getInstance at the end of the file, after the code library 
 
var visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE", { 
     trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer 
     trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure 
 
     // To enable CNAME support, add the following configuration variables 
     // If you are not using CNAME, DO NOT include these variables 
     marketingCloudServer: "INSERT-TRACKING-SERVER-HERE", 
     marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure 
}); 

Etapa 4: adicionar a ID da organização da Experience Cloud à Visitor.getInstance

Na Visitor.getInstance função, substitua INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE pela Experience Cloud ID da organização. Caso não saiba a ID da organização, é possível encontrá-la na página de administração da Experience Cloud. A função editada pode ser parecida com o exemplo abaixo.
var visitor = Visitor.getInstance("1234567ABC@AdobeOrg", { ...
Não altere a caixa dos caracteres na ID da organização. A ID diferencia maiúsculas e minúsculas e deve ser usada exatamente como foi fornecida.

Etapa 5: adicionar os servidores de rastreamento ao Visitor.getInstance

O Analytics usa servidores de rastreamento para coleta de dados.
Parte 1: encontrar os URLs do servidor de rastreamento
Verifique os arquivos s_code.js ou AppMeasurement.js para encontrar os URLs do servidor de rastreamento. Os URLs devem ser especificados pelas variáveis:
  • s.trackingServer
  • s.trackingServerSecure
Parte 2: Definir variáveis do servidor de rastreamento
Para determinar quais variáveis do servidor de rastreamento usar:
  1. Responda às perguntas na matriz de decisão abaixo. Use as variáveis que correspondem às suas respostas.
  2. Substitua os espaços reservados do servidor de rastreamento pelos URLs do servidor de rastreamento.
  3. Remova o servidor de rastreamento não usado e as variáveis do servidor da Experience Cloud do código.
Quando usados, associe os URLs do servidor da Experience Cloud aos URLs do servidor de rastreamento correspondentes desta forma:
  • URL do servidor da Experience Cloud = URL do servidor de rastreamento
  • URL seguro do servidor da Experience Cloud = URL seguro do servidor de rastreamento
Caso não tenha certeza de como encontrar o servidor de rastreamento, consulte Perguntas frequentes e Preencher corretamente as variáveis trackingServer e trackingServerSecure .

Etapa 6: atualizar o arquivo AppMeasurement.js

Essa etapa exige o AppMeasurement. Não é possível continuar se você estiver usando o s_code.
Adicione a Visitor.getInstance função mostrada abaixo ao AppMeasurement.js arquivo. Insira-o na seção que contém configurações, como linkInternalFilters , charSet , trackDownloads , etc.:
s.visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE");
Nesse momento, é necessário remover o código Audience Manager DIL do e substituí-lo pelo Módulo de gerenciamento de público-alvo. Consulte Implementar o encaminhamento do lado do servidor para obter instruções.
(Opcional, mas recomendado)  Criar um prop personalizado.
Definir um prop padrão em AppMeasurement.js para medir a cobertura. Adicione este prop personalizado à doPlugins função do AppMeasurement.js arquivo:
// prop1 is used as an example only. Choose any available prop. 
s.prop1 = (typeof(Visitor) != "undefined" ? "VisitorAPI Present" : "VisitorAPI Missing");

Etapa 7: adicionar o código da API do visitante à página

Insira o [VisitorAPI.js] arquivo nas tags <head> de cada página. Ao anexar o VisitorAPI.js arquivo à página:
  • Coloque-o no início da <head> seção para que apareça antes de outras tags de solução.
  • É necessário executar antes do AppMeasurement e do código de outras soluções da Experience Cloud.

Etapa 8: (opcional) configurar um período de carência

Se algum desses casos de uso se aplicar à sua situação, peça ao Atendimento ao cliente para configurar um período de carência temporário. Os períodos de carência podem durar até 180 dias. Você pode renovar um período de carência, se necessário.
Implementação parcial
Se você tiver páginas que usam o serviço de ID e outras que não o usam, é necessário ter um período de carência para que todas sejam relatadas no mesmo conjunto de relatórios do Analytics. Isso é comum se você tiver um conjunto de relatórios global que faz relatórios entre domínios.
Descontinue o período de carência depois que o serviço de ID é implantado em todas as páginas da Web que relatam no mesmo conjunto de relatórios.
Requisitos de cookie s_vi
É necessário um período de carência se você precisar que os novos visitantes tenham um cookie s_vi após migrar para o serviço de ID. Isso é comum se sua implementação ler o cookie s_vi e armazená-lo em uma variável.
A descontinuação do período de carência após a implementação pode capturar a MID em vez de ler o cookie s_vi.
Integração de dados da sequência de cliques
É necessário ter um período de carência caso envie dados para um sistema interno de um feed de dados de sequência de cliques que processe os usos das colunas visid_high e visid_low .
Faça a descontinuação do período de carência se o processo de ingestão de dados conseguir usar as colunas post_visid_high e post_visid_low .

Etapa 9: testar e verificar

As soluções da Experience Cloud nesta implementação retornam IDs na forma de pares de valor chave. Cada solução usa chaves diferentes (por exemplo, a SDID do Analytics em comparação à mboxMCSDID do Target) para a mesma ID. Para testar a implementação, carregue as páginas em um ambiente de desenvolvimento. Use o console do navegador ou o software que monitora as solicitações e respostas HTTP para verificar as IDs listadas abaixo. O serviço de ID está implementado corretamente quando os pares de valores chave listados abaixo retornam os mesmos valores da ID.
Você pode usar o Adobe Debugger ou o proxy HTTP Charles para verificar essas IDs específicas da solução. Entretanto, você pode usar qualquer ferramenta ou depurador adequado para suas necessidades.
Todas as soluções
Verifique:
  • Cookie AMCV no domínio em que a página está hospedada.
  • A Experience Cloud ID (MID) com o Adobe debugger ou a ferramenta de depuração preferencial.
Para obter verificações adicionais que ajudam a determinar se o serviço de ID está funcionando corretamente, consulte Testar e verificar o serviço de identidade da Experience Cloud .
Analytics
Verifique o identificador SDID na solicitação do JavaScript. O SDID do Analytics deve corresponder ao mboxMCSDID do Target.
Se os testes retornarem uma AID, isso indica uma destas opções:
  • Você é um visitante constante no processo de migração de IDs herdadas do Analytics.
  • O período de carência está habilitado.
Ao observar uma AID, compare o valor com a mboxMCAVID do Target. Esses valores são idênticos quando o serviço de ID é implementado corretamente.
Audience Manager
Para testar o encaminhamento do lado do servidor, consulte Como verificar a implementação do encaminhamento do lado do servidor.
Target
Verifique:
  • mboxMCGVID
  • mboxMCSDID (a mboxMCSDID deve corresponder à SDID do Analytics.)
Se os testes retornarem uma mboxMCAVID, isso indica uma destas opções:
  • Você é um visitante constante no processo de migração de IDs herdadas do Analytics.
  • O período de carência está habilitado.
Ao observar uma mboxMCAVID, compare o valor à Analytics AID do. Esses valores são idênticos quando o serviço de ID é implementado corretamente.
Implantação

Etapa 10: implantar

Implante o código depois que ele passar no teste.
Se você ativou um período de carência:
  • Garanta que a ID do Analytics (AID) e a MID estejam presentes na solicitação de imagem.
  • Lembre-se de desabilitar o período de carência após atender os critérios para a descontinuação .