Código JavaScript para Analytics for Advertising

Somente anunciantes com o Advertising DSP

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

Na primeira exibição de página de uma visita ao site, o código JavaScript do Adobe Advertising verifica se o visitante viu ou clicou anteriormente em um anúncio. Se o usuário tiver entrado anteriormente no site por um click-through ou não tiver visto um anúncio, o visitante será ignorado. Se o visitante tiver visto um anúncio e não tiver entrado no site por um click-through durante a janela de pesquisa de cliques definida no Adobe Advertising, o código JavaScript do Adobe Advertising a) usará o Serviço de Experience Cloud ID para gerar uma ID complementar (SDID) ou b) usará o método Web SDK do Adobe Experience Platform generateRandomID para gerar um StitchID. Qualquer ID é usada para compilar dados do Adobe Advertising na ocorrência do Adobe Analytics do visitante. Em seguida, o Adobe Analytics consulta o Adobe Advertising para obter a ID do AMO e a ID do EF associadas à exposição do anúncio. A ID do AMO e as IDs EF são preenchidas em seus respectivos eVars. Esses valores persistem por um período designado (por padrão, 60 dias).

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

NOTE
A lógica de rastreamento do Adobe Advertising JavaScript ocorre no Adobe e, portanto, praticamente não afeta o tempo de carregamento da página.
Por outro lado, a lógica do conector de dados DCM para Analytics (usando Google Campaign Manager 360) para Advertising DSP ocorre no lado do cliente. A compilação no lado do cliente reduz o carregamento da página e aumenta o risco de perda de dados. Isso ocorre porque o JavaScript Analytics deve executar o ping de DoubleClick e esperar que DoubleClick retorne os últimos dados de clique/impressão para Analytics. Quando sua equipe do DSP configura o conector de dados do DCM, você deve especificar quanto tempo você deseja atrasar a página.

Implantação do código JavaScript

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

O código

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

<script src="https://www.everestjs.net/static/le/last-event-tag-latest.min.js">
<script>
     if("undefined" != typeof AdCloudEvent)
          AdCloudEvent('IMS ORG Id','rsid');
</script>

Implementações que usam o código Web SDK do Experience Platform alloy.js

<script src="https://www.everestjs.net/static/le/last-event-tag-latest.min.js">
<script>
     if("undefined" != typeof AdCloudEvent)
          stitchId = AdCloudEvent('IMS ORG Id','rsid').generateRandomId();
</script>

Onde colocar o código

A função do JavaScript Analytics for Advertising deve vir após o Serviço da Experience Cloud ID, mas antes do código de Medição do aplicativo do Analytics. Isso garante que a ID complementar (SDID) ou StitchID esteja incluída na sua chamada do Analytics.

Posicionamento do código

Validação da implantação do código

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

Como confirmar o código com Chrome Developer Tools validate-js-chrome

  1. Abra Chrome Developer Tools e clique na guia Rede.

  2. Carregue uma página de site que contenha o JavaScript Analytics for Advertising.

  3. Filtre a guia Network por last e revise duas linhas:

    Filtrando no(s) último(s)

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

    • A segunda linha é a chamada que envia a solicitação para o Adobe Advertising. Ele começa da seguinte forma: _les_imsOrgId=[your_imsOrgId_here]&_les_url=[your_encoded_url]

      Se você não vir a chamada para o Adobe Advertising, talvez não seja a primeira exibição de página da 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 da visita correspondente:

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

    Filtrando em

  5. (Implementações que usam o Web SDKcódigo de alloy.js do Experience Platform) Filtrar em /interact para verificar se a carga da solicitação para o Edge Network contém advertisingStitchID.

    Filtrando em

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

    table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4
    ID Parâmetro do Analytics Edge Network Parâmetro do Adobe Advertising
    Experience Cloud IMS Org mcorgid _les_imsOrgid
    ID de dados complementares sdid _les_sdid
    ID da compilação stitchId advertisingStitchID na propriedade _adcloud
    Conjunto de relatórios do Analytics O valor após /b/ss/ _les_rsid
    ID de visitante do Experience Cloud mid _les_mid

    Se os valores de ID corresponderem, a implementação do JavaScript será confirmada. O Adobe Advertising envia ao servidor Analytics os detalhes de rastreamento de click-through ou view-through, se existirem.

Como confirmar o código com Adobe Experience Cloud Debugger

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

  2. Vá para a guia Network.

  3. Na barra de ferramentas Solutions Filter, clique em Adobe Advertising e Analytics.

  4. Na linha de parâmetro Request URL - Hostname, localize lasteventf-tm.everesttech.net.

  5. Na linha Request - Parameters, faça uma auditoria dos sinais gerados, semelhante à Etapa 3 em "Como confirmar o código com Chrome Developer Tools."

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

    Auditando o código JavaScript Analytics for Advertising em Experience Cloud Debugger

recommendation-more-help
fbbdcc36-f208-41e5-b715-a077abaec5c3