Intégration personnalisée

Modifié le  Mer, 20 Sept., 2023 à 3:54 H

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.

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

 

 

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

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

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">
Markup

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.

Cet article a-t-il été utile ?

C'est super !

Merci pour votre commentaire

Désolé ! Nous n'avons pas pu vous être utile

Merci pour votre commentaire

Dites-nous comment nous pouvons améliorer cet article !

Sélectionner au moins l'une des raisons
La vérification CAPTCHA est requise.

Commentaires envoyés

Nous apprécions vos efforts et nous allons corriger l'article