Article

C2S – Manuelle

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 ou en Redirection (en Server-to-Server (S2S), suivez plutôt le guide S2S – Server-to-Server). 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.

Ajoutez les domaines Affilae à votre politique existante :

script-src https://static.affilae.com; img-src https://static.affilae.com https://lb.affilae.com; frame-src 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.
Bandeau de consentement (CMP) : chargez le tag dès l’acceptation Si votre site utilise une plateforme de gestion du consentement (CMP), elle doit charger le tag de suivi Affilae dès que le visiteur accepte, sur la page où il est arrivé. Le tag lit l’identifiant du clic dans l’adresse de cette première page : s’il ne se charge qu’à la page suivante, cet identifiant est perdu : avec un lien au format Paramètre, le clic n’est pas enregistré ; avec un lien en Redirection, la vente risque de ne plus être attribuée à l’affilié, même pour un visiteur qui a accepté.

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 = '{{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);
(function (event) {
var sent = false;
var sendFallback = function () {
if (sent || 'AeTracker' in window) return;
sent = true;
var c = event.Conversion;
new Image().src = 'https://lb.affilae.com/?key=' + event.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';
};
setTimeout(sendFallback, 5000);
window.addEventListener('pagehide', sendFallback);
})(aeEvent);
}
</script>

Les paramètres à renseigner

Dans le code, remplacez chaque valeur entre doubles accolades, par exemple {{ID}}, par la donnée de la commande. Le tableau donne le nom du champ dans le tag JavaScript, puis le nom du paramètre dans l’adresse de la version image ou du postback Server-to-Server.

CHAMP DU TAG PARAMÈTRE D’URL OBLIGATOIRE VALEUR
key key Oui La clé se trouve dans la Configuration de votre programme, onglet Tracking, section Intégration via un module Affilae. Exemple : 5f04fe700000000000000000-5f04fe700000000000000000
Conversion.id id Oui Renseignez un identifiant unique pour ce paramètre. Le plus simple est de prendre le numéro de commande. Pour une inscription sans numéro de commande, utilisez l’identifiant d’inscription généré par votre site. Sans cette valeur, la conversion est refusée.
Conversion.amount amount Oui pour les ventes Montant total de la commande hors taxes, après remises et hors frais de livraison, qui sert de base au calcul de la commission et du chiffre d’affaires généré. Exemple : 123.45
Conversion.currency currency Non Code de la devise sur 3 lettres (ISO 4217), par exemple EUR. Elle doit faire partie des Devises de la règle, sinon la conversion est refusée. Sans devise, la première devise de la règle s’applique.
Conversion.payment payment Non Envoyez online pour toute commande payée en ligne : une valeur vide ou différente, par exemple bankwire pour un virement ou other, applique l’état choisi dans la règle, champ État des nouvelles conversions non payées en ligne.
Conversion.voucher voucher Non Le ou les codes promo utilisés, séparés par un point-virgule. Les majuscules et minuscules ne comptent pas : LEA20 et lea20 désignent le même code.
Conversion.subid cv Non Référence libre de votre choix, remontée avec la conversion et disponible dans l’interface et dans l’API. À ne pas confondre avec les SubID que les affiliés ajoutent à leurs liens.
Conversion.customer customer Recommandé Identifiant de votre client, stable dans le temps, de préférence celui de votre base de données, jamais une adresse e-mail en clair. Il permet de reconnaître un même client d’une commande à l’autre. Il est indispensable si la règle active le mode commissions récurrentes.
Conversion.product product Non Identifiants des produits commandés, séparés par un point-virgule. Ils alimentent le top produits si votre programme a un flux produits dont les identifiants correspondent.

Le tag ne transforme pas les valeurs : encodez celles qui peuvent contenir des caractères spéciaux (espace, &, #, +…), par exemple avec encodeURIComponent() en JavaScript.

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

Vérifiez que votre ID de programme est correct, ainsi que la clé (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, après remises et hors frais de livraison. Le paramètre amount attend ce montant : 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. Les majuscules et minuscules des codes promo ne comptent pas.

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.

Besoin d’aide ?

Restez informés des dernières tendances en affiliation marketing et ne manquez aucun de nos articles.

Contactez-nous