News Produit

Aide à l’installation des tracking

Affilae

Fév 20, 2017

Cette documentation va vous guider dans l’installation des scripts de tracking sur votre site, afin de tracker les clics et les ventes issues de vos affiliés partenaires.

Si vous utilisez une des solutions CMS suivantes, utilisez nos modules ou guides d’intégration dédiés :

En revanche, si vous utilisez votre propre solution, suivez les deux étapes ci-dessous :

Remarque : Si vous utilisez le tracking par redirection, allez directement au point 2.

1. Présentation du script de sécurité

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

[pastacode lang= »javascript » manual= »%3Cscript%20type%3D%22text%2Fjavascript%22%3E%0A%20%20var%20_ae%20%3D%20%7B%0A%20%20%20%20’pid’%3A%20’YOUR%20PROGRAM%20ID’%2C%0A%20%20%20%20’advertiserFirst’%3A%2021600%2C%20%2F%2F%2015%20days%20in%20mins%0A%20%20%20%20’allowSiteUnder’%3A%20false%2C%0A%20%20%20%20’allowIframing’%3A%20false%2C%0A%20%20%20%20’host’%3A%20’https%3A%2F%2Flb.affilae.staging1.kaizen-developments.com’%0A%20%20%7D%3B%0A%20%0A%20%20(function()%20%7B%0A%20%20%20%20var%20element%20%3D%20document.createElement(‘script’)%3B%20element.type%20%3D%20’text%2Fjavascript’%3B%20element.async%20%3D%20true%3B%0A%20%20%20%20element.src%20%3D%20’%2F%2Fstatic.affilae.staging1.kaizen-developments.com%2Fae-v3.2.js’%3B%0A%20%20%20%20var%20scr%20%3D%20document.getElementsByTagName(‘script’)%5B0%5D%3B%20scr.parentNode.insertBefore(element%2C%20scr)%3B%0A%20%20%7D)()%3B%0A%3C%2Fscript%3E » message= » » highlight= » » provider= »manual »/]

Vous pouvez configurer les variables suivantes :

Variable	Statut	Description	Valeurs
`pid`	Obligatoire	Identifiant de votre programme d’affiliation.	La valeur est présente automatiquement sur la page de configuration de votre programme.
`advertiserFirst`	Optionnel	Nombre 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: `21600` (15mins).
`allowSiteUnder`	Optionnel	Autorise 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`.
`allowIframing`	Optionnel	Permet d’éviter que le site de l’annonceur soit chargé à l’intérieur d’un autre site via une balise HTML iframe.	La valeur doit être `true` ou `false`. Défaut: `false`.
`forceReferer`	Optionnel	Les 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`.
`host`	Optionnel	Uniquement disponible via l’option SSL marque-blanche. Adresse du serveur qui réceptionnera les trackings des clics d’affiliation.	URL
`customVar`	Optionnel	Permet d’inclure une variable personnalisée dans le tracking. (utilisé pour le cross-selling, cashback etc…)	Chaîne de caractère « URL encoded »
`cookieNameForAdvertiserFirst`	Optionnel	Nom 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`
`referrer`	Optionnel	Permet de définir manuellement l’URL du site affilié référent qui sera associé au tracking.	URL Défaut: `document.referrer`

2. Installation du code de conversion

Le code 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 code de conversion doit être placé sur votre page de confirmation de conversion (Leads, ventes).

[pastacode lang= »markup » manual= »%3Ciframe%20src%3D%22https%3A%2F%2Flb.affilae.staging1.kaizen-developments.com%2F%3Fkey%3D%7BKEY%7D%26id%3D%7BUNIQUE_ID%7D%26amount%3D%7BAMOUNT%7D%26payment%3D%7BPAYMENT%7D%26customer%3D%7BCUSTOMER_ID%7D%26cv%3D%7BCUSTOM_VAR%7D%26voucher%3D%7BVOUCHER_CODE%7D%22%20frameborder%3D%220%22%20width%3D%221%22%20height%3D%221%22%3E%3C%2Fiframe%3E » message= » » highlight= » » provider= »manual »/]

Vous pouvez configurer les variables suivantes :

Paramètres à renseigner	Consignes
KEY	La clé vous est fournie sur la page de « code de conversion » accessible depuis le menu » Config » de votre programme d’affiliation.
UNIQUE_ID	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 l’email de l’internaute par exemple.
AMOUNT	Montant total HORS TAXE de la commande, qui sera la base du calcul de la commission et du CA généré.
PAYMENT	Si les conversions sont soumises à un paiement, spécifiez le mode choisi par votre client, laissez vide dans le cas contraire: `cheque` pour un paiement par chèque `online` pour un paiement en ligne `bankwire` pour un paiement par virement `other` pour un tout autre type de paiement
CUSTOMER_ID	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.
CUSTOM_VAR	Optionnel: 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_CODE	Optionnel: Variable permettant d’identifier le code promo associé à une vente.