Implémentation via Google Tag Manager – script HTML

Implémentation via Google Tag Manager – script HTML

  Ce guide à pour but de vous aider à implémenter le tracking Affilae via les script HTML Affilae .

1- Installation de GTM Pour installer le container GTM sur votre site veuillez suivre la documentation pour la Configuration et 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 ».

 

 

  • 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 confirmation pour lequel vous voulez suivre les conversions (e.g. vente, formulaire de contact…) et ne doit se déclencher qu’après la Balise 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éfinis par l’utilisateur (User-Defined Variables en anglais), et ces variables devront être créées par vous-même et en utilisant le dataLayer de votre site. Chacun 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« 

  • Au chargement de la page trouvez le tableau « Variables Définis par l’Utilisateur » et cliquez sur « Nouvelle » pour créer une nouvelle Variable, puis :
  •  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 votre site ou 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é doit correspondre à la valeur trouvée dans le dataLayer. Si la page ou la Balise se déclenche contient un dataLayer avec 2 valeurs « id » (commun pour le ecommerce) il faudra spécifier le chemin de la propriété, ci-dessous vous avez un exemple de dataLayer qui se trouverait sur un site ecommerce, si nous cherchons l’id de conversion le résultat à renseigner dans GTM serait : ecommerce.purchase.actionField.id

datalayer google tag manager

 

  Déclencheur : Une fois vos variables crées il faudra créer le déclencheur pour votre Balise de conversion Affilae, pour se 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 apparaît sélectionnez le type de déclencheur qui corresponds le mieux à vos besoins, si vous avez un URL spécifique comme page de confirmation le type « Fenêtre chargée » serait le choix le plus simple.
  • 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éé pour :

event.Conversion.id event.Conversion.amount Les autres données sont optionnels et peuvent être laissés vides en utilisant la syntax de string vide («  »)

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

conversion tracking prestashop affiliation plugin

  • 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 program 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 Clicks 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 program aura un Program ID différent mais selon vos programmes Affilae vous pourriez potentiellement ré-utiliser certains Variables et Déclencheurs sans devoir en créer de nouveaux.  

 

Remarques :

Vous pouvez laisser les variables inutilisées avec des chaînes vides.

Vous pouvez avoir plusieurs balises à mettre en œuvre si votre programme comporte plus d’une règle.

 

L’information clé à envoyer avec la conversion est une valeur statique. Celle-ci sera différente pour chaque règle créée (par exemple 5f025b700000000000000000-5f0118000000000000000000). Ces informations sont disponibles dans le back-office.

 

Problème courant : Pour pousser une conversion sur notre back-end, le Tag Affilae doit être chargé avant le Tag de conversion. Si le Tag de conversion n’est pas déclenché et, en fonction de votre site web et de votre implémentation, vous pouvez vouloir utiliser le déclencheur Fenêtre chargée. Pour ajouter plusieurs conditions de déclenchement, vous devez créer un groupe de déclencheurs. Une fois de plus, cela peut changer en fonction de votre stratégie de déclenchement.

 

Paramètres à renseigner :

 

VariableObligatoireValeur
keyOuiLa 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
idOuiRenseignez 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.

amountOui pour les ventesMontant 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
paymentOui si la conversion est liée à un paiementSi les conversions sont soumises à un paiement, spécifiez le mode choisi par votre client, laissez vide dans le cas contraire:

 

  • online pour un paiement en ligne
  • bankwire pour un paiement par virement
  • other pour un tout autre type de paiement
customerOui 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.

cvNonVariable 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.
voucherNonVariable permettant d’identifier le code promo associé à une vente. Le code est sensible à la casse. Utiliser `;` comme séparateur permettant d’ajouter plusieurs codes.
productNonListe d’IDs de produits, séparateur `;`.