Show Menu
TOPICS×

Implementar o serviço de identidade da Experience Cloud para o Analytics e o Audience Manager

Estas instruções são para clientes do Analytics e do Audience Manager 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 as exigências antes de começar.
  • Esse procedimento exige o AppMeasurement. Os clientes que usam s_code não podem concluir esse 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 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 implantar o código de 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:
Para verificar o encaminhamento do servidor, consulte Como verificar a implementação de encaminhamento do servidor .
Implantação
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 após atender os critérios para a descontinuação.