Advertiser Tracking Guide PT/Conversion Pixel Only Tracking

From Wiki

Revision as of 17:57, 21 February 2024 by Thomas AW Becker (Talk | contribs)
(diff) ← Older revision | Current revision (diff) | Newer revision → (diff)
Jump to: navigation, search

[-] Guia de tracking de anunciantes

[-] Conversão por Pixel

Observe que o Awin não permite mais o uso de integrações apenas de pixels devido a várias atualizações do navegador. Para obter mais informações, consulte o gerente de conta ou o ponto de contato técnico da Awin.

[-] Server To Server (S2S)


Server to Server Tracking e agora obrigatorio como elemento de tracking.

O requisito é que os dados de conversão sejam enviados (via a HTTP response) diretamente do seu servidor aos servidores da Awin. para criar a chamada server to server, utilize os mesmos parámetros do Fall-back Conversion Pixel, não obstante:

  • Adicione o parámetro cks (este irá capturar o valor de awc)
  • Substituir tt=ns com tt=ss assim Awin consegue processar a conversão como uma chamada S2S


Formato

https://www.awin1.com/sread.php?tt=ss&tv=2&merchant={{advertiserId}}&amount={{totalAmount}}&ch={{channel}}&parts={{commissionGroup}}:{{totalAmount}}&vc={{voucher_code}}&cr={{currencyCode}}&ref={{orderReference}}&testmode={{isTest}}&cks={{awc}}


  • {{advertiserId}} deve ser substituído por um ID do programa do anunciante Awin aplicável. Consulte o seu contato de contas ou integrador designado da Awin em caso de dúvidas.
  • {{totalAmount}} deve ser substituído pelo valor total da transação - 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"
    Se o tipo de transação for um lead, declare o número de leads, por exemplo: "1"
  • {{commissionGroupCode}} deve ser substituido pelo Código do Grupo de Comissão ao que deve ser atribuida a transação. Caso não existan Grupos de Comissão deve colocar Default. Os caracteres aceitos para o código commissionGroup são alfanuméricos (letra maiúscula), sublinhado '_', ponto '.' e menos '-'
  • {{channel}} deve ser substituído por "aw" caso o último clique tenha sido Awin, e "other" caso o último clique tenha sido de outra mídia paga. Veja o guia do parâmetro Channel para mais informações .
  • {{orderReference}} deve ser substituido pelo ID único de pedido / reserva
  • {{currencyCode}} se o site tiver múltiplas moedas, esse parâmetro deve ser preenchido com o código da moeda da transação específica, caso os clientes puderem fazer transações apenas em BRL, encaminhar BRL.
  • {{voucherCode}} se um cupom de desconto for utilizado em uma transação, o código dele deve ser preenchido dentro deste parâmetro; se não teve uso de cupom, deixar vazio.
  • {{isTest}} deve ser preenchido com "0" quando o tracking estiver LIVE, ou com "1" caso esteja em modo de teste. Quando definido para o último, os pedidos de teste recebidos não serão processados.
  • {{awc}} deve ser substituído pelo checksum do clique da Awin único que foi enviado no redireccionamento ao seu site, por exemplo"1001_1403695822_a430d81e22c9e8687f423efcf024fbaa"

Capturando o "awc"

O valor de “awc” é um parámetro encaminhado na URL de destino para que a Awin possa identificar a fonte de origem do clique. Deve ser configurada a captura do valor de awc quando o usuario é encaminhado no site, ussando server-side scripting language. Este valor será ussado para ser declarado no parámetro cks na conversão. Essa função precisa ser chamada em todas as páginas.

Se você estiver usando um cookie para capturar o awc, porfavor siga as seguintes diretrizes:

  • O cookie deve ser definido no HTTP response header e não em um script do lado do cliente, por exemplo um cookie em PHP seria correto.
  • O cookie deve setar o cookie só em HTTP Only flag
  • O cookie deve ser setado em modo seguro

Exemplo (PHP)

<?php
function setAwc() {
    if (!empty($_GET['awc'])) {
        setcookie("awc",$_GET['awc'],time()+ 60 * 60 * 24 * 365,"/", "example.com", true, true);   
    }
}
?>



Conversion Tracking

Quando seja gerada uma conversão, isso ativará seu servidor para enviar os dados de conversão para Awin.


Exemplo (cURL/PHP)

<?php 
 
$url = "https://www.awin1.com/sread.php?tt=ss&tv=2&merchant=1001";
$url .= "&amount=" . $totalAmount;
$url .= "&ch=" . $channel // Populate with "aw" if Last Click was Awin;
$url .= "&cr=" . $currencyCode;
$url .= "&ref=" . $orderReference;
$url .= "&parts=DEFAULT:" . $totalAmount;
$url .= "&testmode=0&vc=" . $voucherCode;
if (isset($awc)) {
    $url .= "&cks=" . $awc; // Populate the Awin click checksum if one is associated with the conversion
}
 
$c = curl_init();
curl_setopt($c, CURLOPT_CONNECTTIMEOUT, 10);
curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
curl_setopt($c, CURLOPT_URL, $url);
curl_exec($c);
curl_close($c);
 
?>

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