Advertiser Tracking Guide PT/Product Level Tracking

From Wiki

Revision as of 21:45, 16 December 2019 by Gabriel Tenorio (Talk | contribs)
(diff) ← Older revision | Current revision (diff) | Newer revision → (diff)
Jump to: navigation, search

[-] Guia de tracking de anunciantes

[-] Product Level Tracking

Product Level Tracking permite que o anunciante gere relatórios muito mais detalhados, onde o desempenho de produtos individuais pode ser facilmente mensurado.

Da perspectiva de integração, desde que você já esteja utilizando o Mastertag, é tão simples quanto adicionar um elemento HTML oculto à página de confirmação que contém linhas individuais em um formato específico, descrevendo quais produtos estão incluídos no pedido.

A declaração do Product Level Tracking deve ser feita antes do carregamento da Mastertag!


Modelo parte 1 - Começo da declaração do PLT

<form style="display: none;" name="aw_basket_form">
<textarea wrap="physical" id="aw_basket">


Modelo parte 2 - Linhas de produto

AW:P|{{advertiserId}}|{{orderReference}}|{{productId}}|{{productName}}|{{productItemPrice}}|{{productQuantity}}|{{productSku}}|{{commissionGroupCode}}|{{productCategory}}


  • {{advertiserId}} deve ser substituído pelo ID do programa de anunciante Awin que corresponda. Consulte o contato da sua conta ou o técnico designado em caso de dúvida
  • {{orderReference}} deve ser substituído pelo ID único de reserva / pedido
  • {{productId}} deve ser substituído pelo ID do produto que corresponda (que deve ser único)
  • {{productName}} deve ser substituído pelo nome do produto que corresponda
  • {{productItemPrice}} deve ser substituído pelo valor total do produto - sem considerar o valor do frete, descontos, ou em determinados casos impostos. O valor deve ser um númeral, sem separador de milhar e por padrão a casa decimal deve ser separada usando ponto, por exemplo: "1083.29"
  • {{productQuantity}} deve ser substituído pela quantidade do mesmo produto no pedido, por exemplo: "1"
  • {{productSku}} é opcional, mas pode ser usado para salvar o SKU do produto; caso contrário, deixe em branco
  • {{commissionGroupCode}} deve ser substituído pelo código do grupo de comissões ao qual o produto em questão pertence, que também precisa corresponder à separação que você declarará em AWIN.Tracking.Sale.parts. Se você não mapea os produtos em grupos de comissão específicos, preencha apenas com "DEFAULT"
  • {{productCategory}} é opcional, mas pode ser usado para salvar a categoria à qual o produto pertence; caso contrário, deixe em branco

File:Information.png

Cada linha do produto deve ser finalizada por uma quebra de linha, mais especificamente "\r\n".


Modelo parte 3 - Fim da declaração PLT

</textarea>
</form>


Exemplo #1 - elementos formato HTML

<form style="display: none;" name="aw_basket_form">
<textarea wrap="physical" id="aw_basket">
AW:P|1001|AA000006|B000EMSUQA|The Knife – Silent Shout|5.55|2|B000EMSUQA|CD|Electronic Music
AW:P|1001|AA000006|B001N2Z41Y|Sigur Ros - Heima|14.99|1|B001N2Z41Y|DVD|Music DVD
</textarea>
</form>


Exemplo #2 - JavaScript anexo

var awProductsForm = document.createElement("form");
awProductsForm.name = "aw_basket_form";
awProductsForm.setAttribute("style", "display: none;");
document.getElementsByTagName("body")[0].appendChild(awProductsForm);
var awProductsTextArea = document.createElement("textarea");
awProductsTextArea.id = "aw_basket";
awProductsTextArea.wrap = "physical";
/*** sProductData in this example contains the correctly formatted product lines ***/
awProductsTextArea.value = sProductData; 
/*** Each line must be terminated by a line break, more specifically "\r\n" ***/
document.aw_basket_form.appendChild(awProductsTextArea);


Exemplos de chamadas

Se o Product Level Tracking, assim como a Mastertag e a Tag de Conversão, todos tenham sido implementados corretamente, as chamadas do tracking serão similares as seguintes

https://www.awin1.com/basket.php?product_line=AW%3AP%7C1001%7CAA000006%7CB000EMSUQA%7CThe%20Knife%20-%20Silent%20Shout%7C5.55%7C2%7CB000EMSUQA%7CCD%7CElectronic%20Music
https://www.awin1.com/basket.php?product_line=AW%3AP%7C1001%7CAA000006%7CB001N2Z41Y%7CSigur%20Ros%20-%20Heima%7C14.99%7C1%7CB001N2Z41Y%7CDVD%7CMusic%20DVD


File:Information.png

Dependendo da configuração do programa do anunciante, você poderá ver as solicitações de tracking direcionadas para nosso domínio de tracking alternativo zenaps.com.


[-] PLT Via Conversão por Pixel

IMPORTANTE: O pixel de imagem irá quebrar acima de 2048 caracteres, portanto, esta versão deve ser usada apenas com carrinhos menores ou nomes de produtos curtos


Como alternativa, se a integração não utiliza o tracking JavaScript (consulte o tópico Conversão por Pixel), é possivel declarar Product Level Tracking dentro da chamada a URL do pixel.

Faça isso preenchendo cada "linha do produto" como uma entrada na matriz bd.


Modelo - Fall-back Conversion Pixel

&bd[0]=AW:P|{{advertiserId}}|{{orderReference}}|{{productId}}|{{productName}}|{{productItemPrice}}|{{productQuantity}}|{{productSku}}|{{commissionGroupCode}}|{{productCategory}}&p1={{customParameter1}}&p2={{customParameter2}}


  • &bd[0]= é uma matriz e deve ser seqüencial para produtos extras. por exemplo &bd[0], &bd[1], &bd[2]
  • {{advertiserId}} deve ser substituído pelo ID do programa de anunciante Awin que corresponda. Consulte o contato da sua conta ou o técnico designado em caso de dúvida
  • {{orderReference}} deve ser substituído pelo ID único de reserva / pedido
  • {{productId}} deve ser substituído pelo ID do produto que corresponda (que deve ser único)
  • {{productName}} deve ser substituído pelo nome do produto que corresponda
  • {{productItemPrice}} deve ser substituído pelo valor total do produto - sem considerar o valor do frete, descontos, ou em determinados casos impostos. O valor deve ser um número variavel, sem separador de milhar, a casa decimal deve ser usando ponto como padrão, por exemplo: "1083.29"
  • {{productQuantity}} deve ser substituído pela quantidade do mesmo produto no pedido, por exemplo: "1"
  • {{productSku}} é opcional, mas pode ser usado para salvar o SKU do produto; caso contrário, deixe em branco
  • {{commissionGroupCode}} deve ser substituído pelo código do grupo de comissões ao qual o produto em questão pertence, que também precisa corresponder à separação que você declarará em AWIN.Tracking.Sale.parts. Se você não mapea os produtos em grupos de comissão específicos, preencha apenas com "DEFAULT"
  • {{productCategory}} é opcional, mas pode ser usado para salvar a categoria à qual o produto pertence; caso contrário, deixe em branco
  • {{customParameter1}} deve ser substituído pelo primeiro valor a ser associado à transação em questão
  • {{customParameter2}} deve ser substituído pelo segundo valor a ser associado à transação em questão


Exemplo com multiplos produtos

&bd[0]=AW:P|{{advertiserId}}|{{orderReference}}|{{productId}}|{{productName}}|{{productItemPrice}}|{{productQuantity}}|{{productSku}}|{{commissionGroupCode}}|{{productCategory}}&bd[1]=AW:P|{{advertiserId}}|{{orderReference}}|{{productId}}|{{productName}}|{{productItemPrice}}|{{productQuantity}}|{{productSku}}|{{commissionGroupCode}}|{{productCategory}}&bd[2]=AW:P|{{advertiserId}}|{{orderReference}}|{{productId}}|{{productName}}|{{productItemPrice}}|{{productQuantity}}|{{productSku}}|{{commissionGroupCode}}|{{productCategory}}&p1={{customParameter1}}&p2={{customParameter2}}


Exemplo

<img border="0" height="0" src="https://www.zenaps.com/sread.img?tt=ns&tv=2&merchant=1001&amount=26.09&ch=aw&parts=CD:11.10|DVD:14.99&ref=AA000006&testmode=0&bd[]=AW:P|1001|AA000006|B000EMSUQA|The Knife – Silent Shout|5.55|2|B000EMSUQA|CD|Electronic Music&bd[]=AW:P|1001|AA000006|B001N2Z41Y|Sigur Ros - Heima|14.99|1|B001N2Z41Y|DVD|Music DVD" style="display: none;" width="0">

Privacy

Due to new European legislation regarding how websites store information about you, AWIN is updating its privacy policy. You can see the new version of our policy here. If you would like to see the information we capture on this website, please click here for further details. In order to accept cookies on this site please click the 'I ACCEPT' button