Código JavaScript para Analytics for Advertising Cloud

Anunciantes somente com uma integração Advertising Cloud-Adobe Analytics

Anunciantes somente com o Advertising Cloud DSP

Para o Advertising Cloud DSP, a variável Analytics for Advertising Cloud a integração acompanha as interações de view-through e click-through do site. As visitas de click-through são rastreadas pelo código padrão do Adobe Analytics nas suas páginas da Web; o Analytics O código captura os parâmetros AMO ID e EF ID no URL da página de aterrissagem e os rastreia em suas respectivas eVars reservadas. Você pode rastrear visitas de view-through implantando um trecho de JavaScript nas suas páginas da Web.

Na primeira exibição de página de uma visita ao site, o código JavaScript do Advertising Cloud verifica se o visitante já viu ou clicou em um anúncio. Se o usuário tiver entrado no site anteriormente por meio de um click-through ou não tiver visto um anúncio, o visitante será ignorado. Se o visitante viu um anúncio e não entrou no site por meio de um click-through durante a janela de retrospectiva de clique definido no Advertising Cloud, em seguida, o código JavaScript do Advertising Cloud (a) usa a variável Serviço de ID de Experience Cloud para gerar uma ID complementar (SDID) ou b) usa a Adobe Experience Platform Web SDK generateRandomID para gerar um StitchID. A ID é usada para unir dados do Advertising Cloud à ocorrência do Adobe Analytics do visitante. A Adobe Analytics consulta a Advertising Cloud para a AMO ID e a EF ID associadas à exposição do anúncio. A AMO ID e as EF IDs são preenchidas nas respectivas eVars. Esses valores persistem por um período designado (por padrão, 60 dias).

Analytics envia métricas de tráfego do site (como exibições de página, visitas e tempo gasto) e qualquer Analytics eventos personalizados ou padrão para o Advertising Cloud por hora, usando a EF ID como chave. Esses Analytics As métricas são executadas pelo sistema de atribuição do Advertising Cloud para conectar as conversões ao histórico de cliques e exposições.

OBSERVAÇÃO

A lógica de rastreamento do JavaScript do Advertising Cloud ocorre no lado do Adobe e, portanto, praticamente não afeta o tempo de carregamento da página.

Por outro lado, a lógica da variável DCM conector de dados para Analytics (usando Google Campaign Manager 360) para Advertising Cloud DSP ocorre no lado do cliente. A costura do lado do cliente atrasa o carregamento da página e aumenta o risco de perda de dados. Isso ocorre porque a variável Analytics O JavaScript deve ser ping DoubleClick e esperar por DoubleClick para retornar os dados do último clique/impressão para Analytics. Quando o DSP equipe configura o DCM do conector de dados, você deve especificar por quanto tempo deseja atrasar a página.

Implantação do código JavaScript

A biblioteca JavaScript consiste em duas linhas que permitem Analytics e Advertising Cloud para se comunicar entre si. Se a variável Analytics for Advertising Cloud A integração foi concluída durante a implementação do Advertising Cloud e você já deve ter recebido esse código com instruções sobre como implantá-la.

O código

Implementações que usam o serviço de identidade do Experience Cloud visitorAPI.js código

<script>
     if("undefined" != typeof AdCloudEvent)
          AdCloudEvent('IMS ORG Id');
</script>

Implementações que usam o Experience Platform Web SDK alloy.jscódigo

<script>
     if("undefined" != typeof AdCloudEvent)
          stitchId = AdCloudEvent('IMS ORG Id').generateRandomId();
</script>

Onde colocar o código

O Analytics for Advertising Cloud A função JavaScript deve vir após o Serviço de ID do Experience Cloud, mas antes do código de medição de aplicativo do Analytics, para que a ID adicional (SDID) ou StitchID pode ser incluído na sua chamada do Analytics.

Inserção de código

Validando a implantação do código

Você pode executar a validação usando qualquer tipo de ferramenta de sniffer de pacote (como Charles, Fiddlerou Chrome Developer Tools), comparando os valores das quatro IDs entre a solicitação que vai para o Advertising Cloud e a solicitação que vai para Analytics, conforme descrito abaixo.

Como confirmar o código com Chrome Developer Tools

  1. Abrir Chrome Developer Tools e clique no botão Rede guia .

  2. Carregar uma página de site que contenha a variável Analytics for Advertising Cloud JavaScript.

  3. Filtre o Network tab by last e revisar duas linhas:

    Filtragem na última

    • A primeira linha é a chamada para a biblioteca JavaScript e é intitulada last-event-tag-latest.min.js.

    • A segunda linha é a chamada que envia a solicitação para a Advertising Cloud. Começa da seguinte maneira: _les_imsOrgId=[your_imsOrgId_here]&_les_url=[your_encoded_url]

      Se você não vir a chamada para o Advertising Cloud, talvez não seja a primeira exibição de página de sua visita. Para fins de teste, você pode remover o cookie para que a próxima chamada seja a primeira exibição de página para a visita correspondente:

      1. Na guia Aplicativo , localize a variável adcloud e verifique se o cookie contém _les_v (última visita) com um valor de y e um carimbo de data e hora da época UTC que expira em 30 minutos.
      2. Exclua o ad cloud e atualize a página.
  4. (Implementações que usam o serviço de identidade do Experience Cloud) visitorAPI.js código) Filtrar em /b/ss para ver a ocorrência do Analytics.

    Filtragem em

  5. (Implementações que usam o Experience Platform Web SDK alloy.jscódigo) Filtrar em /interact para verificar se a carga da solicitação para a rede de borda contém advertisingStitchID.

    Filtragem em

  6. Compare os valores de ID entre as duas ocorrências. Todos os valores estarão nos parâmetros da string de consulta, exceto a ID do conjunto de relatórios na ocorrência do Analytics, que é o caminho do URL imediatamente após /b/ss/.

    ID Parâmetro do Analytics Rede Edge Parâmetro Advertising Cloud
    Org. Experience Cloud IMS mcorgid _les_imsOrgid
    ID de dados complementares sdid _les_sdid
    Identificação do título stitchId advertisingStitchID nos termos do _adcloud propriedade
    Conjunto de relatórios do Analytics O valor após /b/ss/ _les_rsid
    ID de visitante Experience Cloud mid _les_mid

    Se os valores de ID corresponderem, a implementação do JavaScript será confirmada. A Advertising Cloud enviará a variável Analytics qualquer servidor de rastreamento de click-through ou view-through, caso existam.

Como confirmar o código com Adobe Experience Cloud Debugger

  1. Abra o Adobe Experience Cloud Debugger na sua página inicial.

  2. Vá para o Network guia .

  3. No Solutions Filter barra de ferramentas, clique em Advertising Cloud e Analytics.

  4. No Request URL – Hostname linha de parâmetro, localizar lasteventf-tm.everesttech.net.

  5. No Request – Parameters , audite os sinais gerados, de modo semelhante à Etapa 3 em "Como confirmar o código com Chrome Developer Tools."

    • (Implementações que usam o serviço de identidade do Experience Cloud) visitorAPI.js código) Certifique-se de que a variável Sdid corresponde ao parâmetro Supplemental Data ID no filtro Adobe Analytics.
    • (Implementações que usam o Experience Platform Web SDK alloy.jscódigo) Certifique-se de que o valor da variável advertisingStitchID corresponde ao parâmetro Sdid enviado para a rede Experience Platform Edge.
    • Se o código não estiver sendo gerado, verifique se o cookie do Advertising Cloud foi removido na Application guia . Depois de removido, atualize a página e repita o processo.

    Auditoria Analytics for Advertising Cloud Código JavaScript em Experience Cloud Debugger

Nesta página