Implementar o serviço de identidade da Experience Cloud para o Analytics e o Audience Manager implement-the-experience-cloud-id-service-for-analytics-and-audience-manager

Estas instruções são para clientes do Analytics e do Audience Manager que desejam usar o Experience Cloud Identity Service e que não utilizam tags de coleta 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.

Etapa 1: plano de encaminhamento do lado do servidor section-880797cc992d4755b29cada7b831f1fc

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:

Etapa 2: baixar o código do serviço de ID section-0780126cf43e4ad9b6fc5fe17bb3ef86

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

Etapa 3: adicionar a função Visitor.getInstance ao código do serviço de ID section-9e30838b4d0741658a7a492153c49f27

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 ao Visitor.getInstance section-e2947313492546789b0c3b2fc3e897d8

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

Etapa 5: adicionar os servidores de rastreamento ao Visitor.getInstance section-0dfc52096ac2427f86045aab9a0e0dfc

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:

Parte 2: Definir variáveis do servidor de rastreamento

Para determinar quais variáveis do servidor de rastreamento usar:

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 section-5517e94a09bc44dfb492ebca14b43048

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");

(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 section-c2bd096a3e484872a72967b6468d3673

Insira o VisitorAPI.js arquivo nas tags <head> de cada página. Ao anexar o VisitorAPI.js arquivo à página:

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

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.

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

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.

Consulte também, Referência da coluna de dados de sequência de cliques.

Etapa 9: testar e implantar o código do serviço de ID section-f857542bfc70496dbb9f318d6b3ae110

É possível testar e implantar da seguinte maneira.

Testar e verificar

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

Para verificar o encaminhamento do lado do servidor, consulte Como verificar a implementação de encaminhamento do lado do servidor.

Implantar

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

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