Implementar o serviço de identidade da Experience Cloud para Analytics implement-the-experience-cloud-id-service-for-analytics

Estas instruções são para clientes do Analytics que desejam usar o serviço de identidade da Experience Cloud e não utilizam as tags da coleção de dados. No entanto, recomendamos fortemente o uso de tags ao implementar o serviço de ID. As tags simplificam o fluxo de trabalho de implementação e automaticamente garante o posicionamento e sequenciamento corretos do código.

IMPORTANT
  • 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:

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

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 section-6053a6b7c16c466a9f9fdbf9cb9db3df

IMPORTANT
  • 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 section-7b8a6e76dc124d0e9ab1ce96ab2ffb0e

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", { ...

IMPORTANT
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 section-70ec9ebff47940d8ab520be5ec4728c5

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.

NOTE
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 section-b53113aea1bd4de896e0e4e9a7edee19

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 de visitante à página section-d46d6aa324c842f2931d901e38d6db1d

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: configurar um período de carência (opcional) section-7bbb2f72c26e4abeb8881e18366797a3

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 section-e9c1764ac21a4ec5be1ff338c0e2e01b

É 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.
recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a