Advertiser Tracking Guide/Custom Tracking Parameters

From Wiki

Jump to: navigation, search

[-] Advertiser Tracking Guide

Recommended Custom Parameters

Here is a generic guide File:Custom Parameter Tracking - Overview.pdf outlining the benefits of custom parameters and the parameters we would recommend across a number of sectors.

[-] Custom Tracking Parameters

It is possible to declare other information and associate it with the transaction using custom tracking parameters, which will appear in transaction reports available in the Awin UI, certain endpoints in the Awin Advertiser API, and via custom reports.

File:Information.png

Please note that AWIN.Tracking.Sale.custom must be declared as an array - this also applies if just one custom tracking parameter is required to be recorded.

[-] Single Custom Tracking Parameter

If you only require one custom tracking parameter per transaction, then populate the desired value to AWIN.Tracking.Sale.custom in the Conversion Tag as well as the parameter p1 within the Fall-back Conversion Pixel's URL request string. Keep in mind though that AWIN.Tracking.Sale.custom must be declared as an array.


Template - Conversion Tag

AWIN.Tracking.Sale.custom = ["{{customParameter}}"];


Template - Fall-back Conversion Pixel

&p1={{customParameter}}


  • {{customParameter}} should be replaced by the information to associate with the transaction in question


Example

<img border="0" height="0" src="https://www.awin1.com/sread.img?tt=ns&tv=2&merchant=1001&amount=7.50&ch=aw&p1=Next%20Day%20Delivery&parts=DEFAULT:7.50&ref=AA000005&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 = "7.50";
AWIN.Tracking.Sale.channel = "aw";
AWIN.Tracking.Sale.custom = ["Next Day Delivery"];
AWIN.Tracking.Sale.orderRef = "AA000005";
AWIN.Tracking.Sale.parts = "DEFAULT:7.50";
AWIN.Tracking.Sale.test = "0";
//]]>
</script>


[-] Multiple Custom Tracking Parameters

If you require more than one custom tracking parameter per transaction, then populate the parameter AWIN.Tracking.Sale.custom in the Conversion Tag as normal, however for the Fall-back Conversion Pixel you would utilise p1 for the first value, p2 for the second value and so on.


Template - Conversion Tag

AWIN.Tracking.Sale.custom = ["{{customParameter1}}", "{{customParameter2}}"...];


Template - Fall-back Conversion Pixel

&p1={{customParameter1}}&p2={{customParameter2}}...


  • {{customParameter1}} should be replaced by the first value to be associated with the transaction in question
  • {{customParameter2}} should be replaced by the second value to be associated with the transaction in question
  • ...etc.etc.


Example

<img border="0" height="0" src="https://www.awin1.com/sread.img?tt=ns&tv=2&merchant=1001&amount=7.50&ch=aw&p1=Special%20Delivery&p2=Royal%20Mail&p3=5.99parts=DEFAULT:7.50&ref=AA000005&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 = "7.50";
AWIN.Tracking.Sale.channel = "aw";
AWIN.Tracking.Sale.custom = ["Special Delivery", "Royal Mail", "5.99"];
AWIN.Tracking.Sale.orderRef = "AA000005";
AWIN.Tracking.Sale.parts = "DEFAULT:7.50";
AWIN.Tracking.Sale.test = "0";
//]]>
</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