Custom integration

Notes: ⚠️⚠️⚠️

Add the Affilae Tag on all the pages of your website.
This Tag will allow tracking of your partners’ clicks and their conversions.
Trigger the conversion tag to track a sale or a lead.
The URL format of your program must be set as a parameter.
You can edit the URL format in your program settings, under General Parameters.
⚠️ Do not send personal data: examples: name, surname, or e-mail.

Install the Tracking Tag

Where to place it?

On ALL pages of your website
Inside the <head> section or just after <body>

Code to install:

<script type="text/javascript">
    var _ae = {
        "pid":"YOUR_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>

What this tag does:

Detects when a visitor comes from an affiliate partner
Protects against fake clicks
Tracks the visitor’s journey

Install the Conversion Tag

Where to place it?

Only on the order confirmation page.

Note: To use this tag, the tracking tag must be implemented.

<-- Affilae Conversion Tag -->
    <script type="text/javascript">
         var aeEvent = {};
         /* {{KEY}} must be updated for each rule */
         aeEvent.key = 'YOUR_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}}'; // List of voucher_id seperated by ;
         aeEvent.Conversion.subid = '{{SUB_ID}}';
         aeEvent.Conversion.customer = '{{CUSTOMER_ID}}';
         aeEvent.Conversion.currency = 'EUR';
         aeEvent.Conversion.product = '{{PRODUCT_ID}}'; // List of product_id seperated by ;
         ('AeTracker' in window)
           ? AeTracker.sendConversion(aeEvent)
           : (window.AE = window.AE || []).push(aeEvent);
   </script>

Installation Checklist

Before starting:

I have my Affilae Program ID
I have my conversion key
I have configured the URL format in my dashboard

Installation:

Tracking tag installed on all pages
Conversion tag installed on the confirmation page
Variables replaced with dynamic values
Test carried out with a test order

Important checks:

No personal data is transmitted
Tags load correctly (check in developer tools)
Conversions appear in my Affilae dashboard

Help

The tag is not loading?

Check that your Program ID and KEY are correct.
Check your security settings (CSP).

Conversions are not showing up?

The tracking tag must be installed AND functional (must be tested).
Verify that all mandatory parameters are filled.
Test with a real transaction through a tracked link.

Need help?

Check your Affilae dashboard
Contact Affilae technical support

➜ Parameters to be filled in:

Variable	Required	Value Information
key	Yes	This key is supplied to you on the “conversion code” page available through your affiliate program Configuration dashboard. e.g.`5f04fe700000000000000000-5f04fe700000000000000000`
id	Yes	Populate this parameter with a unique identifier, for example, a unique order number. If you use this code to confirm a subscription to a newsletter yet you do not have an automatically generated unique identifier, you can, for example, use the user’s email Hash (e.g. MD5) to populate this parameter.
amount	Yes for sales	Total amount Excluding Tax of an order, which will serve as the basis for calculating the commission and Revenue generated. e.g.`123.45`
payment	Yes if conversion requires payment	If the conversions are subject to payment, specify the client’s mode of payment, if not simply leave this parameter blank: `online` for online payment `bankwire` for payment by bank transfer `other` for all other types of payments
customer	Yes if revenue share is activated	Your client identifier if the “Revenue Share” option is activated. Please use an identifier that will not change over time, the best being the ID number used in your database. Leave this parameter blank if you do not use the Revenue Share option.
cv	No	custom variable that will be available in the interface and API: products, new customer etc.
voucher	No	Should be replaced by the voucher code that was applied during the check-out process. Value is case sensitive. Use `;` as a separator to add multiples codes.