Implémentation via Google Tag Manager – script HTML
Notes : ⚠️⚠️⚠️
- 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.
- La balise d’affiliation de votre site web est différente pour chaque programme.
- La balise Affilae doit être ajoutée sur chaque page de votre site, y compris la page de confirmation.
- Vérifiez votre configuration CSP.
"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/"
Ce guide a pour but de vous aider à implémenter le tracking Affilae via les scripts HTML Affilae.
1- Installation de GTM Pour installer le conteneur GTM sur votre site, veuillez suivre la documentation pour la configuration et l’installation de Google : support.google.com/gtm
2- Ajouter la Balise Affilae Une fois GTM installé, connectez-vous à votre compte et naviguez à votre “Espace de travail” ; de là, dans la colonne de gauche, trouvez et cliquez sur “Balises”.
- Au chargement de la page, cliquez sur “Nouvelle” pour créer une nouvelle Balise, puis :
- Nommez votre balise e.g tag_affilae (si vous avez des balises existantes vous pouvez suivre la nomenclature).
- Cliquez dans le tableau “Configuration de la balise” puis dans le menu de droite qui apparaît sélectionnez “HTML personnalisée”.
- Copiez et collez votre Tag Affilae dans le champ HTML. Vous retrouverez votre script dans la configuration de votre programme au sein de l’onglet « tracking » via la partie « Intégration personnalisée (Scripts)« , « tracker les clics ».
La balise Affilae, qui doit être intégrée sur toutes les pages de votre site Web (ou pages de destination), détecte les clics provenant de sites Web affiliés et vous protège contre la fraude au clic.
- Une fois le Tag installé et le “pid » renseigné, cliquez sur le tableau « déclenchement« , le menu des déclencheurs prédéfinis apparaît et il vous suffira de sélectionner « Toutes les pages« .
- Enregistrez et envoyez vos changements.
Notes : Sur l’étiquette, n’oubliez pas de mettre à jour la variable _ae pour qu’elle corresponde à l’ID de votre programme (par exemple, 5f03acf00000000000000000).
3- Ajouter la Balise Conversion Affilae
La Balise de conversion doit être installée sur la page d’événement ou de confirmation pour laquelle vous voulez suivre les conversions (e.g. vente, formulaire de contact…) et ne doit se déclencher qu’après la balise de clic Affilae.
Avant d’aller plus loin ; il est bon d’avoir une compréhension du fonctionnement des variables définis par l’utilisateur, vous pouvez trouver la documentation GTM ici (ressource en anglais).
La balise de conversion Affilae dépend sur les variables définies par l’utilisateur, et ces variables devront être créées par vous-même et en utilisant le dataLayer de votre site. Chacune des données de conversion requis pour le bon fonctionnement de la balise (event.Conversion.id, event.Conversion.amount…) devra avoir une Variable défini par l’utilisateur correspondant ainsi assurant la remontée des données de conversions vers Affilae.
Variables : Depuis votre « Espace de travail« , dans la colonne de gauche, trouvez et cliquez sur « Variables«
- Cliquez sur « Nouvelle » pour créer une nouvelle variable
- Nommez votre Variable e.g dl_conversion_id (si vous avez des variables existantes, vous pouvez suivre la nomenclature).
- Cliquez dans le tableau « Configuration de la variable » puis dans le menu de droite qui apparaît, sélectionnez « Variable de couche de données« .
- Dans le champ « Nom de la variable de couche de données » renseignez votre valeur depuis le dataLayer de la page de votre site où la conversion se passe.**
- Pour la « Version de la couche de données » laissez « Version 2« .
- Enregistrez puis passez à la création de la prochaine variable.
ATTENTION : Lors du renseignement du « Nom de la variable de la couche de données« , comme expliqué ci-dessus, la valeur renseignée doit correspondre à la valeur trouvée dans le dataLayer.
Déclencheur : Une fois vos variables crées il faudra créées le déclencheur pour votre balise de conversion Affilae, pour ce faire, depuis votre « Espace de travail » dans la colonne de gauche, trouvez et cliquez sur « déclencheurs« .
Au chargement de la page cliquez sur « nouveau » pour créer une nouvelle déclencheur, puis :
- Nommez votre Déclencheur e.g trigger_confirmation_page (si vous avez des déclencheurs existants vous pouvez suivre la nomenclature).
- Cliquez dans le tableau « Configuration du déclencheur » puis dans le menu de droite qui apparait sélectionnez le type de déclencheur qui correspond le mieux à vos besoins, généralement le trigger se fait sur un événement Purchase.
- Enregistrez puis passez à la création de votre balise de conversion Affilae.
Balise de Conversion : Depuis votre « Espace de travail« , dans la colonne de gauche, trouvez et cliquez sur « Balises« .
Au chargement de la page cliquez sur « Nouvelle » pour créer une nouvelle Balise, puis :
- Nommez votre balise. e.g tag_affilae_conversion (si vous avez des balises existantes vous pouvez suivre la nomenclature).
- Cliquez dans le tableau « Configuration de la balise » puis dans le menu de droite qui apparaît sélectionnez « HTML personnalisée« .
- Copiez et Collez votre Tag de Conversion Affilae dans le champ HTML, puis renseignez vos variables que vous avez créées.
Vous retrouverez votre script dans la configuration de votre programme au sein de l’onglet « tracking » via la partie « Intégration personnalisée (Scripts)« , « tracker les conversions ».
- Une fois le tag installé et les variables renseignées, cliquez sur le tableau « déclenchement« , le menu des déclencheurs apparaîtra et il vous suffira de sélectionner le déclencheur que vous avez créé à l’étape précédente.
- Enregistrez et envoyez vos changements.
Votre configuration de tracking est terminée. Avant de lancer votre programme Affilae testez que votre configuration fonctionne bien en effectuant des conversions test pour vérifier que le déclenchement des balises s’effectue correctement, que les variables créées remontent bien et que les clics et conversions remontent dans la plateforme Affilae.
Les étapes ci-dessus seront à répéter pour chaque programme Affilae que vous créez car chaque programme aura un Program ID différent, mais selon vos programmes Affilae, vous pourriez potentiellement réutiliser certaines variables et déclencheurs sans devoir en créer de nouveaux.
Paramètres à renseigner :
Variable | Obligatoire | Valeur |
---|---|---|
key | Oui | La 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 |
id | Oui | 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 un Hash (e.g. MD5) du mail de l’internaute par exemple. |
amount | Oui pour les ventes | Montant 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 |
payment | Oui si la conversion est liée à un paiement | Si les conversions sont soumises à un paiement, spécifiez le mode choisi par votre client, laissez vide dans le cas contraire:
|
customer | Oui 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. |
cv | Non | 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 | Non | Variable 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 | Liste d’IDs de produits, séparateur `;`. |