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.
② 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
Note: To use this Tag, the Affilae Tag (Step 1) must be implemented.
Iframe Tag – Fall-back
Note: Valid for redirection tracking.
Image Tag – Fall-back
Important note:
- The programme must be in Parameter.
➜ Parameters to be entered :
Variable | Obligatoire | Valeur |
---|---|---|
key | Yes | The key is provided on the “conversion code” page accessible from the “Config” menu of your affiliate program. e.g. 5f04fe700000000000000000-5f04fe700000000000000000 |
id | Yes | Fill in this parameter with a unique identifier, the simplest being the order number. If you’re using this code to subscribe to your newsletter and you don’t have a unique identifier, we advise you to use a Hash (e.g. MD5) from the surfer’s e-mail, for example. |
amount | Yes for sales | Total amount of the order, excluding VAT, which will be the basis for calculating the commission and sales generated. e.g. 123.45 |
payment | Yes if the conversion is linked to a payment | If conversions are subject to payment, specify the method chosen by your customer, otherwise leave blank:
|
customer | Yes, if Revenue Share is enabled | Customer ID if Revenue Share is enabled. Please use an identifier that will not change over time, the best being the ID number used in your database. Leave blank if you don’t use Revenue Share. |
cv | No | Custom variable that will be returned with the conversion, and available in the interface and API. Allows you to assign your own identifier to a conversion. |
voucher | No | Variable used to identify the promo code associated with a sale. The code is case-sensitive. Use `;` as separator to add multiple codes. |
product | No | List of product IDs, separator `;`. |