Awin Access Technical Integration Developer Guide (lead) BNL
From Wiki
Contents |
Awin Access Tracking Implementation - Generieke Gids voor Ontwikkelaars (leidend)
Deze gids is bedoeld voor adverteerders die leads willen volgen. Als je een op verkoop gebaseerde adverteerder bent, zie dan de gids ontwikkelaars verkoop gids.
Master Tag
Plaats de volgende code op elke pagina van de site..
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, of 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 geladen wordt nadat een klant een succesvolle lead maakt).
<!—Image Pixel - Mandatory -->
<img src="https://www.awin1.com/sread.img?tt=ns&tv=2&merchant=XXXXX&amount=1.00&cr=GBP&ref={{order_ref}}&parts=DEFAULT:1.00&vc=&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 = "1.00";
AWIN.Tracking.Sale.orderRef = "{{order_ref}}";
AWIN.Tracking.Sale.parts = "DEFAULT:1.00";
AWIN.Tracking.Sale.currency = "GBP";
AWIN.Tracking.Sale.test = "0";
AWIN.Tracking.Sale.channel = "aw";
//]]>
</script>Vervang het volgende:
- XXXXX met je adverteerders-ID
- GBP met je plaatselijke valuta als je buiten het VK woont (bijv. EUR, SEK).
-
{{order_ref}}met een variabele die gebruikt wordt om voor elke transactie een ID te genereren, het kan een nummer zijn dat je al in je systeem gebruikt om leads bij te houden of een willekeurig gegenereerd nummer. Het nummer moet uniek zijn, want voor elke lead moet een ander ID gegenereerd worden.
Pas op: er zijn twee instanties van GBP en {order_ref} in deze code zorg ervoor dat je ze allebei verandert.
Server side voorbeeld
Hier is een server side voorbeeld van hoe het bovenstaande bereikt kan worden met PHP:
<!—Image Pixel - Mandatory -->
<img src="https://www.awin1.com/sread.img?tt=ns&tv=2&merchant=MYADVERTISERID&amount=1.00&cr=GBP&ref=<?php echo microtime(true); ?>&parts=DEFAULT:1.00&vc=&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 = "1.00";
AWIN.Tracking.Sale.orderRef = "<?php echo microtime(true); ?>";
AWIN.Tracking.Sale.parts = "DEFAULT:1.00";
AWIN.Tracking.Sale.currency = "GBP";
AWIN.Tracking.Sale.test = "0";
AWIN.Tracking.Sale.channel = "aw";
//]]>
</script>Voorbeeld aan de kant van de cliënt
De bovenstaande PHP code zou op de webpagina laden als:
<!—Image Pixel - Mandatory -->
<img src="https://www.awin1.com/sread.img?tt=ns&tv=2&merchant=MYADVERTISERID&amount=1.00&cr=GBP&ref=1602161929.4418&parts=DEFAULT:1.00&vc=&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 = "1.00";
AWIN.Tracking.Sale.orderRef = "1602161929.4418";
AWIN.Tracking.Sale.parts = "DEFAULT:1.00";
AWIN.Tracking.Sale.currency = "GBP";
AWIN.Tracking.Sale.test = "0";
AWIN.Tracking.Sale.channel = "aw";
//]]>
</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