Advertiser Tracking Guide PT/De-duplication

From Wiki

Jump to: navigation, search

[-] Guia de tracking de anunciantes

[-] Deduplicação

Se você estiver trabalhando com diversos canais de marketing e/ou redes de afiliação é necessário implementar a deduplicação para que a comissão não seja paga a mais de uma origem pela mesma conversão.

No entanto, é importante lembrar que alguns de nossos parceiros preferenciais, os quais você escolhe para trabalhar, solicitam integrar seu próprio tracking para captar todas as conversões. Por exemplo, os parceiros de remarketing utilizam seu próprio tracking para exluir do targeting os mesmos clientes que já finalizaram uma compra.

Isso significa que o ideal seria que nosso tracking seja exibido incondicionalmente (excluído páginas que exibem ou processam informações de pagamento), no entanto, você pode utilizar o Channel Parameter para instruir ao nosso sistema a se comportar de maneira diferente dependendo em qual canal leva a atribuição.



[-] Channel Parameter

A Awin recomenda que todos os clientes utilizem o Channel Parameter para instruir o nosso sistema em como processar cada conversão, baseando-se na origem do tráfego.

Ao preencher com um código/nome para o canal que fez a conversão em questão, nós podemos tratar o pedido de 4 formas diferentes:

  • Não processar, o que quer que seja
  • Processar caso exista um cookie da Awin
  • Apenas processar caso exista um cookie de clique da Awin
  • Apenas processar caso exista um cookie de post-view da Awin

File:Information.png

Certifique-se de preencher sempre o parâmetro com o valor "aw" se Awin é considerado como último referenciador de clique.

A solução também é, por padrão, compatível com todos os nossos parceiros que requerem uma visão de todas as conversões que estão acontecendo, independentemente de qual canal realmente ganhou, e a configuração de comportamento pode ser alterada simples e rapidamente.

Por favor, entre em contato com seu gerente de conta ou técnico caso queira configurar a deduplicação usando o Channel Parameter ou mudar a configuração atual.


O tracking pode cair se você tiver um programa existente rodando com a Awin e você implementar incorretamente o parâmetro de canal ou fazer alterações em como ele está sendo declarado!


Modelo - Tag de conversão

AWIN.Tracking.Sale.channel = "{{channel}}";


Modelo - Fall-back Conversion Pixel

&ch={{channel}}


  • {{channel}} deve ser substituído por um código/nome do canal que é considerado como último clique referente a conversão em questão, por exemplo "aw" (que deve ser sempre usado para Awin), "display" ou "ppc". Normalmente só os canais pagos devem ser contemplados na lógica de deduplicação. Caso nenhum canal tenha a atribuição do ultimo clique, é recomendavel encaminhar "aw" como valor.

Os Valores de "Channel" não devem ser maiores de 20 carateres alfanuméricos (0-9, A-Z, a-z).


Exemplo

<img border="0" height="0" src="https://www.awin1.com/sread.img?tt=ns&tv=2&merchant=1001&amount=8.33&ch=email&parts=DEFAULT:8.33&ref=AA000001&testmode=0" style="display: none;" width="0">
<script type="text/javascript">
//<![CDATA[
/*** Do not change ***/
var AWIN = {};
AWIN.Tracking = {};
AWIN.Tracking.Sale = {};
/*** Set your transaction parameters ***/
AWIN.Tracking.Sale.amount = "8.33";
AWIN.Tracking.Sale.channel = "email";
AWIN.Tracking.Sale.orderRef = "AA000001";
AWIN.Tracking.Sale.parts = "DEFAULT:8.33";
AWIN.Tracking.Sale.currency = "GBP";
AWIN.Tracking.Sale.voucher = "10OFF";
AWIN.Tracking.Sale.test = "0";
//]]>
</script>


[-] Exemplos de Integrações

Um par de modelos de deduplicação totalmente funcionais que podem ser adaptados aos requisitos da sua plataforma web.

File:Information.png

Infelizmente, não damos suporte técnico adicional ao desenvolvimento dos próprios exemplos.


Source Handler - PHP

Para ser incluído no side header ou similar, para que seja executado o mais cedo possível em todas as páginas do site.

<?php
 
$cookieLength = 30; // Cookie length in days, to be matched with programs' cookie lenght
$cookieName = "source"; // Name of the first party cookie to utilise for last click referrer de-duplication
$sourceParameterName = "source"; // The parameter used by networks and other marketing channels to tell you who drove the traffic
$domain = "example.com" // Cookie should always be set on eTLD+1 domain i.e. example.com instead of subdomain.example.com.
 
if ($_GET[$sourceParameterName]) {
setcookie($cookieName, strip_tags($_GET[$sourceParameterName]), time() + (60 * 60 * 24 * $cookieLength), "/", $domain, true, true);
}
 
if ($_GET['awc']) {
setcookie("awc",$_GET['awc'],time()+ 60 * 60 * 24 * 365,"/", $domain, true, true);
}
 
 
?>


Source Handler - JavaScript

Para ser incluído em todas as páginas; verifique se esse snippet é executado o mais cedo possível durante o carregamento da página.

<script type="text/javascript">
var iCookieLength = 30; // Cookie length in days
var sCookieName = "source"; // Name of the first party cookie to utilise for last click referrer de-duplication
var sSourceParameterName = "source"; // The parameter used by networks and other marketing channels to tell you who drove the traffic
var domain = "example.com"; // top level domain
 
var _getQueryStringValue = function (sParameterName) {
    var aQueryStringPairs = document.location.search.substring(1).split("&");
    for (var i = 0; i < aQueryStringPairs.length; i++) {
        var aQueryStringParts = aQueryStringPairs[i].split("=");
        if (sParameterName.toLowerCase() == aQueryStringParts[0].toLowerCase()) {
            return aQueryStringParts[1];
        }
    }
};
 
var _setCookie = function (sCookieName, sCookieContents, iCookieLength, tlDomain) {
    var dCookieExpires = new Date();
    dCookieExpires.setTime(dCookieExpires.getTime() + (iCookieLength * 24 * 60 * 60 * 1000));
    document.cookie = sCookieName + "=" + sCookieContents + "; expires=" + dCookieExpires.toGMTString() +";domain=" + tlDomain + "; path=/;";
};
 
if (_getQueryStringValue(sSourceParameterName)) {
    _setCookie(sCookieName, _getQueryStringValue(sSourceParameterName), iCookieLength, domain);
}
</script>


Confirmation Page Tracking - PHP

A ser executado na página de confirmação e assume que a MasterTag está sendo anexada separadamente usando uma inclusão no side footer ou similar.

<?php
 
$cookieName = "source"; // Name of the cookie to use for last click referrer de-duplication
 
if (isset($_COOKIE[$cookieName])) {
$channel = $_COOKIE[$cookieName];
} else {
$channel = "aw"; // No paid channel assisted
}
 
$url = "https://www.awin1.com/sread.php?tt=ss&tv=2&merchant=1001";
 
$url .= "&amount=" . $totalAmount;
$url .= "&ch=aw";
$url .= "&cr=" . $currencyCode;
$url .= "&ref=" . $orderReference;
$url .= "&parts=DEFAULT:" . $totalAmount;
$url .= "&testmode=0&vc=" . $voucherCode;
$url .= "&cks=" . $_COOKIE["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);
 
?>
 
 
<img border="0" height="0" src="https://www.awin1.com/sread.img?tt=ns&tv=2&merchant=1001&amount=<?php echo $totalAmount; ?>&ch=<?php echo $channel; ?>&cr=<?php echo $currencyCode; ?>&parts=DEFAULT:<?php echo $totalAmount; ?>&ref=<?php echo $orderReference; ?>&testmode=0&vc=<?php echo $voucherCode; ?>" style="display: none;" width="0">
<script type="text/javascript">
//<![CDATA[
/*** Do not change ***/
var AWIN = {};
AWIN.Tracking = {};
AWIN.Tracking.Sale = {};
/*** Set your transaction parameters ***/
AWIN.Tracking.Sale.amount = "<?php echo $totalAmount; ?>";
AWIN.Tracking.Sale.channel = "<?php echo $channel; ?>";
AWIN.Tracking.Sale.currency = "<?php echo $currencyCode; ?>";
AWIN.Tracking.Sale.orderRef = "<?php echo $orderReference; ?>";
AWIN.Tracking.Sale.parts = "DEFAULT:<?php echo $totalAmount; ?>";
AWIN.Tracking.Sale.test = "0";
AWIN.Tracking.Sale.voucher = "<?php echo $voucherCode; ?>";
//]]>
</script>


Confirmation Page Tracking - JavaScript

A ser executado na página de confirmação e assume que a MasterTag está sendo anexada separadamente usando uma inclusão no side footer ou similar.

<script type="text/javascript">
var sCookieName = "source"; // Name of the cookie to use for last click referrer de-duplication
 
var _getCookie = function (sCookieName) {
    sCookieName += "=";
    var aCookies = document.cookie.split(";");
    for (var i = 0; i < aCookies.length; i++) {
        while (aCookies[i].charAt(0) == " ") aCookies[i] = aCookies[i].substring(1);
        if (aCookies[i].indexOf(sCookieName) != -1) {
            return aCookies[i].substring(sCookieName.length, aCookies[i].length);
        }
    }
};
 
if (_getCookie(sCookieName)) {
    var sChannel = _getCookie(sCookieName);
} else {
    var sChannel = "aw"; // No paid channel assisted
}
 
var awPixel = new Image(0, 0);
awPixel.src = "https://www.awin1.com/sread.img?tt=ns&tv=2&merchant=1001&amount=" + parseFloat(fTotalAmount).toFixed(2) + "&ch=" + sChannel + "&cr=" + sCurrency + "&parts=DEFAULT:" + parseFloat(fTotalAmount).toFixed(2) + "&ref=" + sOrderReference + "&testmode=0&vc=" + sVoucherCode;
 
var AWIN = {};
AWIN.Tracking = {};
AWIN.Tracking.Sale = {};
AWIN.Tracking.Sale.amount = parseFloat(fTotalAmount).toFixed(2);
AWIN.Tracking.Sale.channel = sChannel;
AWIN.Tracking.Sale.currency = sCurrency;
AWIN.Tracking.Sale.orderRef = sOrderReference;
AWIN.Tracking.Sale.parts = "DEFAULT:" + parseFloat(fTotalAmount).toFixed(2);
AWIN.Tracking.Sale.test = "0";
AWIN.Tracking.Sale.voucher = sVoucherCode;
</script>

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