GTM CustomHTML DeDupe PT
From Wiki
Contents |
[-] Google Tag Manager - Integração HTML Personalizada
Google Tag Manager - Integração Custom HTML
Passo 1 - Instalando a Tag de Jornada
A Tag de Jornada da Awin é uma biblioteca JavaScript que contém todas as funções necessárias para o rastreamento da Awin funcionar conforme o esperado.
A Tag de Jornada PRECISA ser chamada em todas as páginas de entrada possíveis do seu site! Pedimos isso porque a Tag de Jornada é responsável pela criação de um first party cookie quando o usuário acessa o site. Como o usuário pode entrar no site por diversas outras páginas além da página inicial do site, precisamos cobrir todas as possibilidades de entrada, portanto, precisamos que a Tag de Jornada seja ativada em todas as páginas.
Se o usuário entrar por uma página que não contém a Tag de Jornada, não registraremos nada.
1) Acesse "Tags"
2) Clique em “Nova” e escolha a tag HTML Personalizada.
4) Cole o seguinte código nessa tag (ATUALIZE XXXXX para o seu MID, fornecido pelo seu integrador):
<script defer="defer" src="https://www.dwin1.com/XXXXX.js" type="text/javascript"></script>
5) Selecione "Todas as Páginas" como o gatilho e bloqueie o acionamento na página de sucesso.
6) Nomeie e salve essa tag como "Awin - Tag de Jornada".
Passo 2 - Deduplicação automática e Parâmetro Channel
Isso permite que a tag de conversão da Awin identifique qual foi a última mídia paga a gerar o último clique na jornada do usuário antes da finalização da compra; dessa forma, a plataforma da Awin pode determinar quais transações vieram da Awin e quais não vieram, realizando assim uma deduplicação automática.
1) Crie uma nova variável e nomeie-a como "Awin - Channel Cookie", isso deve ser uma variável de cookie de primeira parte:
2) Nomeie o cookie como "AwinChannelCookie":
3) Crie uma nova tag e nomeie-a como "Awin - Last Click Identifier", isso deve ser uma tag do tipo HTML Personalizada:
4) Adicione o seguinte código a essa tag:
<script> var Data = new Date(); var latency; var cookieLength = 30; // Cookie length in days; var origin; var sourceParameter = ["utm_source", "gclid"]; // Os parâmetros utilizados por outras mídias pagas para determinar a origem do click. var queryString = window.location.search; var urlParams = new URLSearchParams(queryString); var sourceValue; var domain = ".{INSERIR_SEU_SOMINIO_AQUI.COM}"; // Atualizar para o seu domínio de topo var organicFilter = true; //"true" irá considerar acessos SEO como outra mídia, "false" fara com que a Awin rastreie conversões vindas de SEO após interação com link pago Awin. Data.setTime(Data.getTime() + (cookieLength * 24 * 60 * 60 * 1000)); latency = Data.toUTCString(); //Checar se o usuário está navegando pelo site ou se é seu primeiro acesso na jornada atual if(!document.referrer.includes(window.location.hostname)){ //Checar se o usuário acessou o site via link do Google Parallel Tracking if(window.location.href.indexOf("awaid") > -1){ origin = "aw"; } else { //Checar se o usuário veio por SEO e de-duplicar contra se o filtro de orgânico estiver ativo. if(organicFilter == true && window.location.referrer.includes("google") || window.location.referrer.includes("yahoo") || window.location.referrer.includes("bing") || window.location.referrer.includes("yandex") || window.location.referrer.includes("duckduckgo")){ origin = "other"; } else { //Checar se a Awin foi a última mídia paga na jornada do usuário for (var i = 0; i < sourceParameter.length; i++) { if (queryString.includes(sourceParameter[i])) { sourceValue = urlParams.get(sourceParameter[i]); if (sourceValue == "awin" || sourceValue == null || sourceValue == "undefined") { origin = "aw"; } else { origin = "other"; } break; } else { //Nenhuma origem encontrada, configurar origem como "aw" como fallback para evitar problemas de rastreamento. origin = "aw" } } } } //Guardar a origem em um cookie primário document.cookie = "AwinChannelCookie=" + origin + "; expires=" + latency + ";path=/; Domain=" + domain; } </script>
6) Edite o código acima onde está escrito “INSIRA_SEU_DOMINIO_AQUI.COM”, para refletir o domínio do seu site, mantenha o "." antes do seu domínio, pois isso levará em consideração qualquer subdomínio do seu site.
7) Utilizar um trigger "All Pages" para esta tag.
Passo 3: Definindo o rastreamento de venda da Awin
1) Crie uma nova tag e selecione o tipo HTML Personalizada.
2) Copie e cole o seguinte código:
<img border="0" height="0" src="https://www.awin1.com/sread.img?tt=ns&tv=2&merchant=XXXXX&amount={{Awin - Transaction Total}}&ch={{Awin - Channel Cookie}}&parts=DEFAULT:{{Awin - Transaction Total}}&ref={{Awin - Transaction ID}}&cr={{Currency}}&vc={{VoucherCode}}&testmode=0" style="display: none;" width="0">
<script type="text/javascript">
//<![CDATA[
/*** Do not change ***/
var AWIN = AWIN || {};
AWIN.Tracking = AWIN.Tracking || {};
AWIN.Tracking.Sale = {};
/*** Set your transaction parameters ***/
AWIN.Tracking.Sale.amount = {{Awin - Transaction Total}}; //Deve refletir a matriz de produtos dentro do carrinho de compras.
AWIN.Tracking.Sale.channel = {{Awin - Channel Cookie}}; //Deve receber a variável criada anteriormente {Awin - Channel Cookie}
AWIN.Tracking.Sale.orderRef = {{Awin - Transaction ID}}; //Deve receber o ID do pedido.
AWIN.Tracking.Sale.parts = "DEFAULT:" + {{Awin - Transaction Total}}; //Deve refletir a matriz de produtos dentro do carrinho de compras.
AWIN.Tracking.Sale.currency = {{Currency}}; //Deve receber o código ISO da moeda usada na transação, por exemplo, "USD", "GBP", "EUR".
AWIN.Tracking.Sale.voucher = {{VoucherCode}}; //Deve receber o código de desconto adicionado à compra pelo usuário.
AWIN.Tracking.Sale.test = "0";
//]]>
</script>
<!--Atualize "XXXXX" para seu MID-->
<script defer="defer" src="https://www.dwin1.com/XXXXX.js" type="text/javascript"></script>2) Atualize as variáveis no código para refletir suas variáveis do GTM. Aqui está uma lista do que precisa ser atualizado:
{{Awin - Transaction Total}} - Deve refletir a matriz de produtos dentro do carrinho de compras.
{{Awin - Transaction ID}} - Deve receber o ID do pedido.
{{VoucherCode}} - Deve receber o código de desconto adicionado à compra pelo usuário.
{{Currency}} - Deve receber o código ISO da moeda usada na transação, por exemplo, "USD", "GBP", "EUR".
XXXXX - Deve ser alterado para o seu MID (ID do Comerciante), existem duas instâncias disso no código anterior, atualize ambas!Você pode usar variáveis do DataLayer para preencher os parâmetros mencionados. Caso não saiba como mapear variáveis do DataLayer, aqui está um guia que você pode seguir em Como mapear variáveis do DataLayer no GTM
3) Selecione o gatilho que dispara quando ocorre uma conversão ou o evento desejado (a página de "sucesso" para conversões ou um evento de confirmação para leads).
4) Nomeie a tag como "Awin - Tag de Conversão" e clique em ‘Salvar’. Sua tag deve se parecer com isso:
5) Clique em ‘salvar’ e agora você deve ter duas Tags listadas na tabela de Tags.
Passo 4 - Rastreamento em Nível de Produto (PLT)
Este passo deve ser seguido apenas por comércios eletrônicos, se você não possui um comércio eletrônico, ignore este passo.
O Rastreamento em Nível de Produto permite que o anunciante gere relatórios muito detalhados, mostrando o desempenho de cada produto no carrinho de compras individualmente, isso é especialmente relevante para anunciantes de comércio eletrônico.
1) Crie uma nova tag do tipo "Custom HTML" e cole o seguinte Código:
<script type="text/javascript"> var transactionProducts = {{transactionProducts}}; AWIN.Tracking.Sale.plt = ''; for (i = 0; i < transactionProducts.length; i++) { AWIN.Tracking.Sale.plt += "AW:P|XXXXX|{{Awin - Transaction ID}}|" + transactionProducts[i]['id'] + "|" + transactionProducts[i]['name'] + "|" + transactionProducts[i]['price'] + "|" + transactionProducts[i]['quantity'] + "|" + transactionProducts[i]['sku'] + "|" + "DEFAULT" + "|" + transactionProducts[i]['category'] + "\n"; } var basketForm = document.createElement('form'); basketForm.setAttribute('style', 'display:none;'); basketForm.setAttribute('name', 'basket_form'); var basketTextArea = document.createElement('textarea'); basketTextArea.setAttribute('wrap', 'physical'); basketTextArea.setAttribute('id', 'aw_basket'); basketTextArea.value = AWIN.Tracking.Sale.plt; basketForm.appendChild(basketTextArea); document.getElementsByTagName('body')[0].appendChild(basketForm); <!----End Product Level Tracking---> </script>
2) Ajuste as variáveis para que reflitam as variáveis do seu contêiner GTM. Aqui está uma descrição das variáveis necessárias:
* {{transactionProducts}} - Precisa refletir a matriz de produtos dentro do carrinho de compras.
* {{Awin - Transaction ID}} - Deve receber o ID do pedido.
* XXXXX - Deve ser alterado para seu MID (ID do Comerciante), Há duas instâncias disso no código anterior, por favor atualize ambas!3) Esta tag não deve ter um gatilho, em vez disso, abra a "Awin - Tag de Conversão" criada anteriormente e use a sequência de tags para acionar esta tag antes da Tag de Conversão da Awin, como mostrado abaixo:
Passo 6 - Testes
1) Tudo pronto! Agora, apenas publique as alterações!
2) Informe seu integrador que publicou os ajustes e ele irá auxiliar com os testes.