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 Adobe Advertising JavaScript 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 ID do Experience Cloud para gerar uma ID complementar (SDID) ou b) usará o método Adobe Experience Platform Web SDK 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 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).

Analytics envia métricas de tráfego do site (como exibições de página, visitas e tempo gasto) e qualquer evento personalizado ou padrão Analytics para Adobe Advertising por hora, usando a ID 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 lado do 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 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 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 Experience Platform Web SDK 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 JavaScript Analytics for Advertising deve vir após o Serviço de ID de Experience Cloud, mas antes do código de Medição do aplicativo Analytics. Isso garante que a ID complementar (SDID) ou StitchID esteja incluída na sua chamada do Analytics.

Posicionamento do código

Validando a 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 indo para Adobe Advertising e a solicitação indo 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 do Experience Cloud) Filtre em /b/ss para ver a ocorrência do Analytics.

    Filtrando 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 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 Adobe Advertising
    Experience Cloud Organização IMS 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 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 todos 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 Adobe Analytics.
    • (Implementações que usam o Experience Platform Web SDK alloy.jscódigo) Verifique se o valor do parâmetro advertisingStitchID corresponde ao Sdid enviado ao Edge Network Experience Platform.
    • Se o código não estiver sendo gerado, verifique se o cookie 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