Intégration personnalisée

Intégration personnalisée des trackings Affilae

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

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.
  - Vérifier vos CSP
"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/".

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>

②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

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

Note: Valide pour le tracking en redirection.

➜ Paramètres à renseigner :

Variable	Obligatoire	Valeur
key	Oui	La 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`
id	Oui	Renseignez 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.
amount	Oui pour les ventes	Montant 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`
payment	Oui si la conversion est liée à un paiement	Si 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
customer	Oui 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.
cv	Non	Variable 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.
voucher	Non	Variable permettant d’identifier le code promo associé à une vente. Le code est sensible à la casse. Utiliser `;` comme séparateur permettant d’ajouter plusieurs codes.
product	Non	Liste d’IDs de produits, séparateur `;`.