Show Menu
TOPICS×

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). Entretanto, recomendamos que você use o DTM para implementar o serviço de ID. O DTM simplifica o fluxo de trabalho de implementação, além de garantir automaticamente a inserção e o sequenciamento correto 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 mbox v61 a fim de concluir o procedimento.
  • Configure e teste esse código em um ambiente de desenvolvimento
    antes
    de implementá-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 servidor permite a remoção do DIL (código de coleta de dados do Audience Manager) e a substituição pelo Módulo de gerenciamento de público-alvo . Consulte a documentação de encaminhamento 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 mudanças externas do código do site e das etapas internas que a Adobe deve executar para provisionar sua conta. Na verdade, muitos desses procedimentos de migração devem ocorrer simultaneamente e ser lançados juntos. O 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 site 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 do serviço de ID colocavam essa função em um local diferente e exigiam uma sintaxe diferente. Caso esteja migrando de uma versão anterior para a versão 1.4 , observe a nova disposição e sintaxe documentadas aqui.
  • O código em MAIÚSCULA é um espaço reservado para valores. Substitua o texto pela ID da organização, pelo URL do servidor de rastreamento ou outro valor nomeado.
Parte 1: copiar 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 API.js do visitante
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 a 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 as variáveis do servidor de rastreamento
Para determinar quais variáveis do servidor de rastreamento usar:
  1. Responda às perguntas da matriz de decisão abaixo. Use as variáveis que correspondem às suas respostas.
  2. Substitua os marcadores de posição com os 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
Se você não tiver certeza sobre como encontrar o servidor de rastreamento, consulte as Perguntas frequentes e Preenchimento correto das variáveis trackingServer e trackingServerSecure .

Etapa 6: atualizar o arquivo AppMeasurement.js

Essa etapa requer 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 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 daExperience Cloud.

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

If any of these use cases apply to your situation, ask Customer Care to set up a temporary grace period . Os períodos de carência podem durar até 180 dias. É possível renovar um período de carência, se necessário.
Implementação parcial
Se você possuir 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ê contar com um conjunto de relatórios globais que relatam entre domínios.
O período de carência será cancelado depois da implantação do serviço de ID em todas as suas páginas da Web que forem relatadas no mesmo conjunto de relatórios.
Exigências do cookie s_vi
É necessário ter um período de carência se os novos visitantes precisarem ter um cookie s_vi após migrarem para o serviço de ID. Isso é comum se a implementação ler o cookie s_vi e o armazenar em uma variável.
A descontinuação do período de carência após sua 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 Analytics SDID do em comparação à Target mboxMCSDID do) 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.
You can use the Adobe Debugger or the Charles HTTP proxy to check for these solution-specific IDs. 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çode identidade da Experience Cloud .
Analytics
Verifique se o identificador SDID está na solicitação de JavaScript. A SDID do Analytics deve corresponder à mboxMCSDID do Target.
Se os testes retornarem uma AID, isso indica o seguinte:
  • Você é um visitante constante no processo de migração de Analytics IDs herdadas do.
  • O período de carência está habilitado.
Ao observar uma AID, compare o valor com a Target mboxMCAVID do. 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:
Target
Verifique:
  • mboxMCGVID
  • mboxMCSDID (a mboxMCSDID deve corresponder à SDID do Analytics.)
Se os testes retornarem uma mboxMCAVID, isso indica o seguinte:
  • Você é um visitante constante no processo de migração de Analytics IDs herdadas do.
  • 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

Implanta o código após o teste.
Se você habilitou um período de carência:
  • Garanta que a ID do Analytics e a MID estejam presentes na solicitação de imagem.
  • Lembre-se de desabilitar o período de carência depois de atender aos critérios de descontinuação .