Implementar o serviço de identidade da Experience Cloud para Analytics

Estas instruções são para clientes do Analytics 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.

IMPORTANTE
  • Leia as exigências antes de começar.
  • Configure e teste esse código em um ambiente de desenvolvimento antes de implantá-lo na produção.

Siga estas etapas para implementar o serviço de ID do Adobe Analytics:

  1. Baixar o código do serviço de ID
  2. Adicionar a função Visitor.getInstance ao código do serviço de ID
  3. Adicionar a ID da organização da Experience Cloud ao Visitor.getInstance
  4. Adicionar os servidores de rastreamento ao Visitor.getInstance
  5. Atualizar o arquivo AppMeasurement.js ou s_code.js
  6. Adicionar o código da API do visitante à página
  7. (Opcional) Configurar um período de carência
  8. Testar e implantar o código de serviço de ID

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

O serviço de ID exige a biblioteca de código VisitorAPI.js. Para baixar a biblioteca de código:

  1. Acesse Administração > Gerenciamento de código.

  2. Em 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 2: Adicionar a função Visitor.getInstance ao código do serviço de ID

IMPORTANTE
  • 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 VisitorAPI.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 3: adicionar a ID da organização da Experience Cloud ao 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 Experience Cloud administração. Consulte também, Administração - Serviços principais. A função editada pode ser parecida com o exemplo abaixo.

var visitor = Visitor.getInstance("1234567ABC@AdobeOrg", { ...

IMPORTANTE

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 4: adicionar os servidores de rastreamento ao Visitor.getInstance

Rastreamento dos servidores usados para a coleta de dados doAnalytics.

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 Experience Cloud servidor da do código.

OBSERVAÇÃO

Quando usados, associe os Experience Cloud URLs do servidor da aos URLs do servidor de rastreamento correspondentes, desta forma:

  • Experience Cloud URL do servidor da = URL do servidor de rastreamento
  • Experience Cloud URL seguro do servidor da = 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 5: atualizar o arquivo AppMeasurement.js ou s_code.js

Adicione esta função ao arquivo AppMeasurement.js ou s_code.js:

s.visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE");

Coloque o código na mesma seção que contém configurações como linkInternalFilters, charSet, trackDownloads, etc.

(Opcional, mas recomendado) Criar um prop personalizado.

Defina um prop personalizado em AppMeasurement.js ou s_code.js para medir a cobertura. Adicione este prop personalizado à doPlugins função dos arquivos AppMeasurement.js ou s_code.js:

// prop1 is used as an example only. Choose any available prop. 
s.prop1 = (typeof(Visitor) != "undefined" ? "VisitorAPI Present" : "VisitorAPI Missing");

Etapa 6: 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.

Transfira esse código para a produção após os testes e a verificação.

Etapa 7: (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ê 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 Analyticsrelatórios do. 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.

Consulte Cookies e o serviço de identidade da Experience Cloud.

É 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.

Consulte Referência da coluna de dados de sequência de cliques.

Ingestão de dados da sequência de cliques

Etapa 8: testar e implantar o código do serviço de ID

É possível testar e implantar da seguinte maneira.

Testar e verificar

Para testar a implementação do serviço de ID, verifique:

Consulte Testar e verificar o serviço de identidade da Experience Cloud.

Implantar código

Implante o código depois que ele passar no teste.

Se você ativou um período de carência na Etapa 7:

  • Garanta que a Analytics ID do 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.

Nesta página

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now