Awin Access Technical Integration Developer Guide (sale) BNL
From Wiki
Contents |
Awin Access Tracking Implementatie - Generieke Gids voor Ontwikkelaars (verkoop)
Als we je eCommerce platform niet ondersteunen volg dan de onderstaande gids om de Awin tracking code te implementeren.
Master Tag
De MasterTag is een JavaScript bibliotheek die alle functies bevat die nodig zijn voor onze tracking oplossing en moet onvoorwaardelijk aan elke pagina op de site worden toegevoegd.
<!--Master Tag add just before the closing </body> tag--> <script src="https://www.dwin1.com/XXXXX.js" type="text/javascript" defer="defer"></script>
Vervang XXXXX door je Adverteerders ID (AID).
Log in op de Awin UI, rechtsboven in het scherm vind je je AID.
Conversion Tag
De Conversion Tag, or Tracking Code zoals hij ook genoemd kan worden, is de declaratie van het AWIN.Tracking.Sale JavaScript object, dat op de bevestigingspagina gedaan wordt om de MasterTag te instrueren dat een conversie heeft plaatsgevonden. Die voert dan vervolgens de nodige tracking verzoeken uit.
Plaats de volgende code op de bevestigingspagina (de pagina die verschijnt nadat een klant een succesvolle aankoop heeft gedaan).
<!—Image Pixel - Mandatory -->
<img src="https://www.awin1.com/sread.img?tt=ns&tv=2&merchant=XXXX&amount={{order_total}}&cr={{currency_code}}&ref={{order_ref}}&parts=DEFAULT:{{order_total}}&vc={{voucher_code}}&ch=aw&testmode=0" border="0" width="0" height="0">
<!-- JavaScript Tracking - Mandatory -->
<script type="text/javascript">
//<![CDATA[ /*** Do not change ***/
var AWIN = {};
AWIN.Tracking = {};
AWIN.Tracking.Sale = {};
/*** Set your transaction parameters ***/
AWIN.Tracking.Sale.amount = "{{order_total}}";
AWIN.Tracking.Sale.orderRef = "{{order_ref}}";
AWIN.Tracking.Sale.parts = "DEFAULT:{{order_total}}";
AWIN.Tracking.Sale.voucher = "{{voucher_code}}";
AWIN.Tracking.Sale.currency = "{{currency_code}}";
AWIN.Tracking.Sale.test = "0";
AWIN.Tracking.Sale.channel = "aw";
//]]>
</script>Vervang XXXXX door je Adverteerders ID (AID).
De tekst tussen { haakjes } zijn plaatshouders - ze zullen vervangen moeten worden door de variabelen die je site gebruikt voor de volgende informatie:
{{order_total}}Het totale transactiebedrag in twee decimalen. Kan inclusief of exclusief leverings/BTW kosten zijn.{{currency_code}}Wordt ingevuld met de ISO valutacode van de valuta die bij de transactie gebruikt werd.
Example: GBP or EUR
{{order_ref}}Een uniek boeking/bestel referentie ID per bestelling.{{voucher_code}}De voucher code die bij de transactie gebruikt werd.
Voorbeeld
Bijvoorbeeld, als een klant een product koopt voor €5.99 met de Voucher Code 'HALFPRICE' dan moet de code laden als:
<!—Image Pixel - Mandatory -->
<img src="https://www.awin1.com/sread.img?tt=ns&tv=2&merchant=XXXX&amount=5.99&cr=GBP&ref=4-815162342&parts=DEFAULT:5.99&vc=HALFPRICE&ch=aw&testmode=0" border="0" width="0" height="0">
<!-- JavaScript Tracking - Mandatory -->
<script type="text/javascript">
//<![CDATA[ /*** Do not change ***/
var AWIN = {};
AWIN.Tracking = {};
AWIN.Tracking.Sale = {};
/*** Set your transaction parameters ***/
AWIN.Tracking.Sale.amount = "5.99";
AWIN.Tracking.Sale.orderRef = "4-815162342";
AWIN.Tracking.Sale.parts = "DEFAULT:5.99";
AWIN.Tracking.Sale.voucher = "HALFPRICE";
AWIN.Tracking.Sale.currency = "GBP";
AWIN.Tracking.Sale.test = "0";
AWIN.Tracking.Sale.channel = "aw";
//]]>
</script>Je kunt PHP gebruiken om deze variabelen te laden (zie voorbeeld hieronder). Als je een [Awin_Access_Technical_Integration_Guide_BNL|eCommerce platform van een derde partij] gebruikt, kan hun support team je misschien ook de te gebruiken variabelen bezorgen.
PHP voorbeeld
<img border="0" height="0" src="https://www.awin1.com/sread.img?tt=ns&tv=2&merchant=XXXX&amount=<?php echo $totalAmount; ?>&ch=aw&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 = "aw";
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>Laatste stap - Tests volgen
Na de integratie van de Awin tracking moet je een test transactie maken via de Awin Gebruikersinterface om te controleren of de tracking goed werkt.
Voltooi de stappen om een testtransactie uit te voeren via onze Gids voor testtransacties