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.

➜  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>

 

 

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 :

 

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. Le code est sensible à la casse. Utiliser `;` comme séparateur permettant d’ajouter plusieurs codes.

product        Non                                                    Correspond à l’identifiant unique (alphanumeric) en interne du produit disponible depuis votre solution e-commerce ainsi que celui de votre flux                                                                                          produits.