Customized integration

Customized integration of Affilae trackings

This documentation will guide you through the installation of Affilae Tracking Tags on your site.

Two steps are required to install the Affilae Tracking Tag.

• Add the Affilae Tag to all the pages on your site. This tag will track your partners’ clicks and conversions.
• Trigger the Conversion Tag to track a sale or lead.

① Tag Affilae – Track your partners’ clicks

The role of the Affilae Tag, which must be placed on all site pages (or landing pages), is to detect clicks originating from your affiliates’ sites and protect the advertiser against false-click fraud.

Notes :

• The Affilae Tag is different for each program.
• The Affilae Tag must be added to all pages of your site, including the confirmation page.
• The Affilae tag must be added between the head section or just after the body tag.
• Check your CSPs

"default-src 'self'; style-src 'self' 'unsafe-inline'; script-src 'self' 'unsafe-inline' https://static.affilae.com/; img-src 'self' https://static.affilae.com/ https://lb.affilae.com/; frame-src 'self' https://lb.affilae.com/; connect-src https://lb.affilae.com/".

How does it work?

• The tag below is loaded asynchronously from the static.affilae.com domain.
• The Tag is initialized by the _ae variable. This variable is mandatory.
• The Tag initializes the AeTracker object to collect clicks/conversions.
• The Tag to be deployed is similar to the Tag below, but you need to replace the PROGRAM_ID with your own.

<!-- Affilae Tag --> 
<script type="text/javascript">
    var _ae = {
      /* PROGRAM_ID must be changed */
      'pid': 'PROGRAM_ID'
    };
    (function () {
      var element = document.createElement('script'); element.type = 'text/javascript'; element.async = true;
      element.src = '//static.affilae.com/ae-v3.5.js';
      var scr = document.getElementsByTagName('script')[0]; scr.parentNode.insertBefore(element, scr);
    })();
</script>

② Conversion Tag – Tracking conversions

The Conversion Tag is used to contact the Affilae server to inform it that a new conversion has been generated. The server thus detects whether or not the surfer has been the subject of affiliate tracking, and if so, records a new conversion. This conversion tag should be placed on your conversion confirmation page (leads, sales). Different types of tag are available to suit your needs. You need to create a unique conversion tag for each existing rule (i.e. KEY); however, you can have a JS tag with a fall-back iframe tag.

JS Tag

<script type="text/javascript">
      var aeEvent = {};
      aeEvent.key = '{{KEY}}';
      aeEvent.Conversion = {};
      /* Values below must be updated */
      aeEvent.Conversion.id = '{{ID}}';
      aeEvent.Conversion.amount = '{{AMOUNT}}';
      aeEvent.Conversion.payment = '{{PAYMENT}}';
      aeEvent.Conversion.voucher = '{{VOUCHER_CODE}}';
      aeEvent.Conversion.subid = '{{SUB_ID}}';
      aeEvent.Conversion.customer = '{{CUSTOMER_ID}}';
      aeEvent.Conversion.currency = '{{CURRENCY_CODE}}';
      aeEvent.Conversion.product = '{{PRODUCT_ID}}'; // List of product_id separated by ;
      ('AeTracker' in window)
        ? AeTracker.sendConversion(aeEvent)
        : (window.AE = window.AE || []).push(aeEvent);
</script>

Note: To use this Tag, the Affilae Tag (Step 1) must be implemented.

Iframe Tag – Fall-back

<!-- Values in query string must be updated -->
<iframe src="https://lb.affilae.com/?key={{KEY}}&id={{UNIQUE_ID}}&amount={{AMOUNT}}&payment={{PAYMENT}}&customer={{CUSTOMER_ID}}&cv={{SUB_ID}}&voucher={{VOUCHER_CODE}}&currency={{CURRENCY_CODE}}" frameborder="0" width="1" height="1"></iframe>

Note: Valid for redirection tracking.

Image Tag – Fall-back

<!-- Values in query string must be updated -->
<img src="https://lb.affilae.com/?key={{KEY}}&id={{UNIQUE_ID}}&amount={{AMOUNT}}&payment={{PAYMENT}}&customer={{CUSTOMER_ID}}&cv={SUB_ID}&voucher={{VOUCHER_CODE}}&currency={{CURRENCY_CODE}}" style="display: none;" width="0" border="0" height="0">

➜ Parameters to be entered :