Article

C2S – Manuelle

Découvrez les articles les plus lus

L’intégration manuelle consiste à poser vous-même deux scripts Affilae sur votre site : le tag de suivi sur toutes les pages, et le tag de conversion sur la page de confirmation. C’est la méthode à utiliser quand aucun module ne correspond à votre technologie.

Prérequis : le format d’URL de votre programme doit être en Paramètre. Vous pouvez modifier le format d’URL en vous rendant dans la Configuration de votre programme, puis en modifiant les Paramètres généraux. Munissez-vous de votre Program ID et de votre Clé/Key.

Attention : ne renvoyez jamais de données personnelles dans les paramètres, par exemple un nom, un prénom ou une adresse e-mail.

Vérifier votre configuration CSP

Si votre serveur applique une politique de sécurité du contenu, elle doit autoriser les domaines Affilae. Voir la référence Content-Security-Policy.

Configuration CSP, côté serveur :

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

Installer le tag de suivi

Ce tag permet de traquer les clics de vos partenaires et leurs conversions.

Où le placer

Sur TOUTES les pages de votre site.
Dans la section <head> ou juste après <body>.

Le code à installer :

<script type="text/javascript">
    var _ae = {
        "pid":"YOUR_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>

Remplacez YOUR_PROGRAM_ID par votre Program ID. Vous le trouvez dans la Configuration de votre programme, onglet Tracking, section Intégration via un module Affilae.

Ce que fait ce tag

Il détecte quand un visiteur vient d’un partenaire affilié.
Il protège contre les faux clics.
Il suit le parcours du visiteur.

Installer le tag de conversion

Où le placer

Uniquement sur la page de confirmation de commande.

À noter : pour utiliser ce tag, le tag de suivi doit être implémenté.

Le code à installer :

<script type="text/javascript">
   var aeEvent = {};
   aeEvent.key = 'RULE_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 ;
   if ('AeTracker' in window) {
     AeTracker.sendConversion(aeEvent);
   } else {
     (window.AE = window.AE || []).push(aeEvent);
     var c = aeEvent.Conversion;
     new Image().src = 'https://lb.affilae.com/?key='   aeEvent.key
         '&id='   c.id   '&amount='   c.amount
         '&cv='   (c.subid || '')   '&payment='   (c.payment || '')
         '&voucher='   (c.voucher || '')   '&product='   (c.product || '')
         '&customer='   (c.customer || '')   '&currency='   (c.currency || '')
         '&fp=&cids=&t=&source=js&v=fallback';
   }
 </script>

Les paramètres à renseigner

VARIABLE	OBLIGATOIRE	VALEUR
KEY	Oui	La clé se trouve dans la Configuration de votre programme, onglet Tracking, section Intégration via un module Affilae. Exemple : 5f04fe700000000000000000-5f04fe700000000000000000
ID	Oui	Renseignez un identifiant unique pour ce paramètre. Le plus simple est de prendre le numéro de commande. Si vous utilisez ce code pour une inscription à une newsletter et que vous n’avez pas d’identifiant unique, nous vous conseillons un hash (par exemple MD5) de l’adresse e-mail de l’internaute.
Amount	Oui pour les ventes	Montant total de la commande HORS TAXES, qui sert de base au calcul de la commission et du chiffre d’affaires généré. Exemple : 123.45
Payment	Oui, si la conversion est liée à un paiement	Si vos conversions sont soumises à paiement, précisez le moyen choisi par votre client, sinon laissez ce champ vide : online pour un paiement en ligne, bankwire pour un virement bancaire, other pour un tout autre type de paiement.
Customer	Oui	Utilisez un identifiant qui ne changera pas dans le temps, de préférence le numéro d’identifiant utilisé dans votre base de données.
Cv	Non	Variable personnalisée remontée avec la conversion, disponible dans l’interface et dans l’API. Elle vous permet d’attribuer votre propre identifiant à une conversion.
Voucher	Non	Variable qui identifie le code promo associé à une vente. Le code est sensible à la casse. Utilisez le point-virgule comme séparateur pour ajouter plusieurs codes.
Product	Non	Liste des identifiants de produits, séparés par un point-virgule.

Votre checklist d’installation

Avant de commencer

J’ai mon ID de programme Affilae.
J’ai ma clé de conversion.
J’ai configuré le format d’URL dans mon tableau de bord.

Installation

Tag de suivi installé sur toutes les pages.
Tag de conversion installé sur la page de confirmation.
Les variables sont bien remplacées par des valeurs dynamiques.
Test effectué avec une commande de test.

Vérifications importantes

Aucune donnée personnelle n’est transmise.
Les tags se chargent correctement, à vérifier dans les outils développeur.
Les conversions apparaissent dans mon tableau de bord Affilae.

Astuce : testez toujours avec une vraie transaction passée depuis un lien tracké. Une commande créée à la main dans votre back-office ne déclenche pas le tag et ne prouve donc rien.

Articles liés

Questions
fréquentes

Voir plus de questions reponses

Vérifiez que votre ID de programme est correct, ainsi que la KEY. Contrôlez ensuite vos paramètres de sécurité, en particulier votre politique CSP, qui doit autoriser les domaines static.affilae.com et lb.affilae.com.

Le tag de suivi doit être installé ET fonctionnel, donc testé au préalable. Vérifiez que tous les paramètres obligatoires sont renseignés, puis testez avec une vraie transaction via un lien tracké.

Aucune donnée personnelle : ni nom, ni prénom, ni adresse e-mail. Pour identifier un client, utilisez un identifiant technique stable, par exemple celui de votre base de données.

Hors taxes. Le paramètre Amount attend le montant total de la commande HORS TAXES : c’est lui qui sert de base au calcul de la commission et du chiffre d’affaires généré.

En les séparant par un point-virgule dans le même paramètre. Attention, les codes promo sont sensibles à la casse.

Dans Affilae, ouvrez la Configuration de votre programme, puis l’onglet Tracking. La section Intégration via un module Affilae affiche le Program ID et, pour chaque règle, sa Clé/Key.

Oui, mais des documentations dédiées existent et vous feront gagner du temps. Voir C2S – WooCommerce – Manuelle pour une boutique WooCommerce, et C2S – GTM – Manuelle pour une pose via Google Tag Manager.