Show Menu
TOPICS×

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). 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.
  • 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

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

  • 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 o código da 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 Cloudadministração. Consulte também Administração - Principais serviços . 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 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 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 Experience Cloud servidor da do código.
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
If you're not sure how to find your tracking server see the FAQ and Correctly Populate the trackingServer and trackingServerSecure variables .

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)*Criação de 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: (ppcional) 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 Analyticsrelatórios do. 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.
É 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
.
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:
Implantar código
Implanta o código após o teste.
Caso você habilite 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.