Article

C2S – GTM – Manuelle

Découvrez les articles les plus lus

L’intégration manuelle consiste à coller vos scripts Affilae dans des balises HTML personnalisé de Google Tag Manager. Vous gardez la main sur le code, et vous n’avez rien à installer depuis la galerie de modèles.

Cette page décrit l’intégration C2S (client-side) manuelle. Comptez une balise de clic, une balise de conversion, et autant de variables que de données de commande à transmettre.

Prérequis : le format d’URL de votre programme doit être Paramètre ou Redirection (en Server-to-Server (S2S), suivez plutôt S2S – GTM). Vous le changez dans Programmes > [votre programme] > Configuration, section Paramètres généraux, champ Format d’URL. Il vous faut aussi un conteneur Google Tag Manager sur lequel vous pouvez publier, et un dataLayer qui expose les données de commande.

Ce qu’il faut savoir avant de commencer

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 avant de tester.

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

Configuration CSP (côté serveur)

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 Google Tag Manager

Suivez la documentation officielle de Google pour installer et configurer le conteneur GTM sur votre site : developers.google.com/tag-platform/tag-manager.

Ajouter la balise Affilae (tag de clic)

Connectez-vous à votre compte GTM, puis ouvrez Espace de travail > Balises.
Cliquez sur Nouvelle pour créer une balise.
Nommez-la, par exemple Affilae – Clic Tag.
Dans Configuration de la balise, choisissez HTML personnalisé.
Collez votre script Affilae, disponible dans votre programme sous Configuration > onglet Tracking > Intégration personnalisée (Scripts) > Tracker les clics.
Dans Déclencheur, sélectionnez Toutes les pages.
Enregistrez et publiez.

Important : le script copié contient déjà votre Program ID ; vérifiez qu’il s’agit du bon programme.

Balise HTML personnalisée contenant le script de clic Affilae dans Google Tag Manager — La balise de clic : type HTML personnalisée, script Affilae collé dans le champ HTML, déclencheur All Pages.

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é.

Dans Google Tag Manager, une balise bloquée au chargement de la page n’est pas relancée quand le visiteur accepte : ajoutez-lui un déclencheur Événement personnalisé sur l’événement que votre CMP envoie à l’acceptation (par exemple cookie_consent_update avec Cookiebot ou OneTrustGroupsUpdated avec OneTrust), et réglez ses options de déclenchement sur Une fois par page.

Suivre les conversions

Créer les variables dataLayer

Créez une variable par donnée de conversion à transmettre.

ID de conversion

Ouvrez Variables > Nouvelle.
Nom : dl_conversion_id.
Type : Variable de couche de données.
Nom de variable : dl_conversion_id, selon votre dataLayer.
Version : 2.

Montant HT, après remises et hors frais de livraison

Ouvrez Variables > Nouvelle.
Nom : dl_conversion_amount.
Type : Variable de couche de données.
Nom de variable : dl_conversion_amount, selon votre dataLayer.
Version : 2.

Variables supplémentaires, si nécessaire. Répétez l’opération pour customer, payment, voucher, etc.

Variable de couche de données créée dans Google Tag Manager — Une variable de couche de données, avec son nom de variable dataLayer et la version 2.

Créer le déclencheur

Ouvrez Déclencheurs > Nouveau.
Nom : purchase.
Type : Événement personnalisé.
Configuration : selon votre événement de conversion.
Enregistrez.

Créer la balise de conversion

Ouvrez Balises > Nouvelle.
Nommez-la.
Type : HTML personnalisée.

Récupérer le script de conversion

Dans Affilae, ouvrez Configuration > onglet Tracking > Intégration personnalisée (Scripts) > Tracker les conversions.
Copiez le script.
Configurez les variables : remplacez les valeurs par vos variables GTM.
Dans Déclencheur, sélectionnez purchase.
Enregistrez et publiez.

Balise HTML personnalisée contenant le script de conversion Affilae dans Google Tag Manager — La balise de conversion : le script Affilae, dont chaque valeur est remplacée par une variable GTM, et le déclencheur Purchase.

Donner le chemin complet de la variable

Le nom de la variable de la couche de données doit être le chemin complet, par exemple ecommerce.purchase.actionField.id. Un nom raccourci ne renvoie aucune valeur.

Exemple de dataLayer d’une page de confirmation de commande — Exemple de dataLayer : l’identifiant de commande est imbriqué sous ecommerce.purchase.actionField.

Gérer plusieurs programmes Affilae

Créez une nouvelle balise de conversion pour chaque programme, avec une KEY différente.
Réutilisez les variables et les déclencheurs existants si c’est approprié.
Testez chaque programme individuellement.

Tester avant de lancer

Mode aperçu GTM

Activez le mode aperçu, puis ajoutez un lien tracké.
Testez un parcours complet, du clic à la conversion.
Vérifiez que les balises se déclenchent.

Variables dataLayer

Vérifiez que vos variables récupèrent les bonnes valeurs.
Testez avec des données réelles.

Dans Affilae

Vérifiez que les clics remontent.
Vérifiez que les conversions remontent.
Contrôlez les montants et les données.

Astuce : testez d’abord en mode aperçu, puis avec une vraie commande. Le mode aperçu montre qu’une balise se déclenche, mais seule une vraie commande prouve que les valeurs transmises sont les bonnes.

Les autres intégrations Google Tag Manager

C2S – GTM – Templates : deux modèles prêts à l’emploi dans la galerie GTM, sans manipuler de script.
S2S – GTM : la conversion est validée côté serveur, avec deux conteneurs qui communiquent entre eux.

Articles liés

Questions
fréquentes

Voir plus de questions

Dans Affilae, ouvrez Configuration, onglet Tracking, puis l’encadré Intégration personnalisée (Scripts). Il contient Tracker les clics puis Tracker les conversions, chacun avec un bouton de copie.

Vérifiez le Program ID (champ pid de la variable _ae) de votre balise de clic. Vérifiez aussi que la balise est déclenchée sur Toutes les pages, et que votre conteneur a bien été publié.

Contrôlez les variables dataLayer et la clé (key) de votre balise de conversion. Vérifiez ensuite que votre déclencheur correspond bien à l’événement de conversion de votre site.

Contrôlez les noms des variables dans votre dataLayer, ils doivent correspondre exactement. Pensez au chemin complet : le nom de la variable de couche de données s’écrit par exemple ecommerce.purchase.actionField.id, et non id seul.

Créez une balise de conversion par programme, chacune avec sa propre clé (key). Les variables et les déclencheurs existants peuvent être réutilisés. Testez ensuite chaque programme séparément.

Oui si votre site en applique une. Elle doit autoriser static.affilae.com et lb.affilae.com. Les directives à ajouter à votre politique existante figurent dans la section Configuration CSP de cette page.

Les templates suffisent dans la plupart des cas et vous signalent chaque mise à jour dans Modèles. Passez en manuel quand vous avez besoin de maîtriser le script, par exemple pour transmettre des données que les modèles ne prévoient pas.