Intégration personnalisée.

Besoin d’aide ?

Cette documentation va vous guider dans l’installation des Tags de Tracking Affilae sur votre site.

➜  Si vous utilisez le tracking par redirection, passez à l’étape 2.

Deux étapes sont requises pour installer le Tracking Affilae.
  • Ajouter le Tag Affilae sur toutes les pages de votre site. Ce Tag permettra de traquer les clics de vos partenaires et leurs conversions.
  • Déclencher le Tag de Conversion pour traquer une vente ou un lead.

 

Tag Affilae – Traquer les clics de vos partenaires

Le rôle du Tag Affilae, qui doit être placé sur toutes les pages du site (ou landing page), est de détecter les clics provenant des sites de vos affiliés et de protéger l’annonceur contre la fraude aux faux clics.

Notes :

  • Le Tag Affilae est différent pour chaque programme.
  • Le Tag Affilae doit être ajouté sur toutes les pages de votre site y compris la page de confirmation.
  • Le Tag Affilae doit être ajouté entre la section head ou juste après le tag body.

Comment cela fonctionne ?

  • Le Tag ci-dessous se charge de manière asynchrone depuis le domaine static.affilae.com.
  • Le Tag est initialisé par la variable _ae. Cette variable est obligatoire.
  • Le Tag initialise l’objet AeTracker pour collecter les clics/conversions.
  • Le Tag à déployer est similaire au Tag ci-dessous, il faut remplacer le PROGRAM_ID par le votre.
<-- 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>

 

➜ Configuration du Tag Affilae :

 

VariableStatutDescriptionValeurs
pidObligatoireIdentifiant de votre programme d’affiliation.La valeur est présente automatiquement sur la page de configuration de votre programme.
advertiserFirstOptionnelNombre de minutes pendant lesquels la première visite sur le site de l’annonceur sera comptabilisée dans le processus de conversion si le mode « Partage » des commissions est activé.La valeur doit être un nombre entier.
Défaut: 26600 (15 Jours).
cookieExpirationOptionnelExpiration en minutes du cookie permettant de traquer les clics.La valeur doit être un nombre entier.
Défaut: 43200 (30 Jours).
allowSiteUnderOptionnelAutorise ou non le tracking d’affiliation si le site de l’annonceur a été ouvert automatiquement en pop-up cachée derrière le navigateur de l’internaute.La valeur doit être true ou false.
Défaut: false.
skipMouseOptionnelDésactive la detection de mouvement de souris permettant d’initier le clic.La valeur doit être true ou false.
Défaut: false.
timerLimitOptionnelTemps en secondes permettant de détecter un mouvement de souris.La valeur doit être un nombre entier.
Défaut: 10
allowIframingOptionnelAutorise le site de l’annonceur de se charger à l’intérieur d’une iframe.La valeur doit être true ou false.
Défaut: true.
forceRefererOptionnelLes clics d’affiliation doivent provenir d’un site web. Mettez ce paramètre à true pour empêcher les affiliés d’utiliser des emailings afin de générer des clics d’affiliation.La valeur doit être true ou false.
Défaut: false.
hostOptionnelUniquement disponible via l’option SSL marque-blanche. Adresse du serveur qui réceptionnera les trackings des clics d’affiliation.URL
Défaut: https://lb.affilae.com
customVarOptionnelPermet d’inclure une variable personnalisée dans le tracking. (utilisé pour le cross-selling, cashback etc…)Chaîne de caractère « URL encoded »
cookieNameForAdvertiserFirstOptionnelNom du cookie permettant de détecter si l’internaute est passé sur le site annonceur avant de cliquer sur un lien d’affiliation.Chaîne de caractère sans espaces ni caractères spéciaux [a-zA-Z0-9].
Défaut: AeFirst
referrerOptionnelPermet de définir manuellement l’URL du site affilié référent qui sera associé au tracking.URL
Défaut: document.referrer
tagTypeOptionnelType de Conversion Tag iframe or pixelString
Défaut: pixel
fpOptionnelActive FingerPrintLa valeur doit être true ou false.
Défaut: true.
firstPartyOptionnelActive First Party CookieLa valeur doit être true ou false.
Défaut: true.

 

 

Tag de Conversion – Traquer les conversions

Le Tag de conversion permet de contacter le serveur Affilae afin de l’informer qu’une nouvelle conversion a été générée.

Le serveur détecte ainsi si l’internaute a fait l’objet d’un tracking d’affiliation ou non, et si c’est le cas il enregistre une nouvelle conversion.

Ce Tag de conversion doit être placé sur votre page de confirmation de conversion (Leads, ventes).

Différents types de Tag sont disponibles selon vos besoins. Vous devez créer un Tag de conversion unique pour chaque règles existantes (i.e. KEY); Cependant vous pouvez avoir un Tag JS avec un Tag iframe en fall-back.

 

JS Tag

<-- Affilae Conversion Tag --> 
 <script type="text/javascript">
      var aeEvent = {};
      /* {{KEY}} must be updated for each rule */
      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}}';
      ('AeTracker' in window)
        ? AeTracker.sendConversion(aeEvent)
        : (window.AE = window.AE || []).push(aeEvent);
</script>

Note: Pour utiliser ce Tag le Tag Affilae (Étape 1) doit être implémenté.

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}}" frameborder="0" width="1" height="1"></iframe>

Note: Valide pour le tracking en redirection.

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}}" style="display: none;" width="0" border="0" height="0">

Note: Valide pour le tracking en redirection.

➜ Paramètres à renseigner :

 

VariableObligatoireValeur
keyOuiLa clé vous est fournie sur la page de « code de conversion » accessible depuis le menu  » Config » de votre programme d’affiliation.
e.g. 5f04fe700000000000000000-5f04fe700000000000000000
idOuiRenseignez ce paramètre par un identifiant unique, le plus simple étant de prendre le numéro de commande.

Si vous utilisez ce code pour une inscription à votre newsletter et que vous n’avez pas d’identifiant unique, nous vous conseillons d’utiliser un Hash (e.g. MD5) du mail de l’internaute par exemple.

amountOui pour les ventesMontant total HORS TAXE de la commande, qui sera la base du calcul de la commission et du CA généré.
e.g. 123.45
paymentOui si la conversion est liée à un paiementSi les conversions sont soumises à un paiement, spécifiez le mode choisi par votre client, laissez vide dans le cas contraire:

  • online pour un paiement en ligne
  • bankwire pour un paiement par virement
  • other pour un tout autre type de paiement
customerOui si le « Revenue Share » est activéIdentifiant de votre client si le « Revenue Share » est activé. Veuillez utiliser un identifiant qui ne changera pas dans le temps, le mieux étant le numéro d’ID utilisé dans votre base de donnée.

Laisser vide si vous ne pratiquer pas le Revenue Share.

cvNonVariable personnalisée qui sera remontée avec la conversion, et disponible dans l’interface et l’API. Elle permet d’assigner votre propre identifiant à une conversion.
voucherNonVariable permettant d’identifier le code promo associé à une vente.

 

 

 

 

Si vous avez besoin d’informations complémentaires, contactez-nous.