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.
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.
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
-
Abra Chrome Developer Tools e clique na guia Rede.
-
Carregue uma página de site que contenha o JavaScript Analytics for Advertising.
-
Filtre a guia Network por
last
e revise duas linhas:-
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:
- Na guia Aplicativo, localize o cookie
adcloud
e verifique se o cookie contém_les_v
(última visita) com um valor dey
e um carimbo de data e hora UTC que expira em 30 minutos.- Exclua o cookie
adcloud
e atualize a página.
- Exclua o cookie
-
-
(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. -
(Implementações que usam o Experience Platform Web SDK
alloy.js
código) Filtrar em/interact
para verificar se a carga da solicitação para o Edge Network contémadvertisingStitchID
. -
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
-
Abra o Adobe Experience Cloud Debugger em sua página inicial.
-
Vá para a guia Network.
-
Na barra de ferramentas Solutions Filter, clique em Adobe Advertising e Analytics.
-
Na linha de parâmetro Request URL - Hostname, localize
lasteventf-tm.everesttech.net
. -
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âmetroSdid
corresponde aoSupplemental Data ID
no filtro Adobe Analytics. - (Implementações que usam o Experience Platform Web SDK
alloy.js
código) Verifique se o valor do parâmetroadvertisingStitchID
corresponde aoSdid
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.
- (Implementações que usam o código