Introduction

Pour simplifier l’installation et la configuration d’iAdvize sur votre site, nous avons publié 3 tags dans la galerie des modèles communautaires de Google Tag Manager.

Si vous ne les avez pas encore ajouté à votre Workspace Google Tag Manager, vous pouvez le faire en ajoutant les 3 Tags suivant : Main Tag, Transaction Tag et Custom Data tag.

Si vous souhaitez découvrir nos trois tags : comprendre à quoi ils correspondent, comment ils fonctionnent et quel est le lien entre eux, nous vous invitons à consulter notre article de présentation dédié.

Configuration

Pour commencer la configuration, connectez-vous à Google Tag Manager puis accédez à votre espace de travail.

Prérequis : ajout des tags iAdvize dans votre espace de travail

Si vous ne l’avez pas encore fait, nous allons ajouter les 3 tags iAdvize à votre espace de travail.

Dans votre espace de travail Google Tag Manager, cliquez sur “Modèles” dans le menu de gauche, puis, cliquez sur le bouton “Rechercher dans la galerie” :

Dans le panneau latéral qui s’ouvre sur la droite, cliquez sur l’icône de la loupe pour rechercher “iAdvize” :

Cliquez sur chacun des 3 tags et ajoutez-les à votre espace de travail en cliquant sur le bouton “Ajouter à l'espace de travail”

Cliquez ensuite sur le bouton “Ajouter” dans la fenêtre suivante pour chacun des 3 tags:

Tag principal

Configuration du tag principal iAdvize

Cliquez sur “Balises” dans le menu de gauche puis sur le bouton “Nouvelle” :

Dans la fenêtre qui s’ouvre:
(1) donnez un nom à votre tag, par exemple “iAdvize - Main tag”
(2) cliquez sur “Configuration de la balise”
(3) sélectionnez le tag principal iAdvize ("iAdvize - Main tag") que vous avez ajouté précédemment à votre espace de travail

Renseignez les différentes informations de votre tag iAdvize :
(1) l’id de votre projet iAdvize (il s’agit généralement d’un identifiant numérique à 4 chiffres)
(2) si vous le souhaitez, vous pouvez forcer la langue dans laquelle iAdvize s’affichera

Configuration du déclenchement / trigger

Nous allons maintenant définir les conditions de déclenchement du tag principal iAdvize
(1) Cliquez sur “Déclenchement” afin de sélectionner ensuite un trigger dans la nouvelle fenêtre
(2) Sélectionnez “Initialization - All Pages” afin que le tag iAdvize principal se déclenche à chaque initialisation de page de votre site web

Enfin, cliquez sur le bouton “Enregistrer” pour enregistrer la configuration du tag principal iAdvize :

L'événement “Initialization - All Pages” est généralement la solution que vous devrez choisir pour déclencher le dépôt de votre tag iAdvize principal.

Si vous êtes soumis à une réglementation de protection des données (comme le GDPR en Europe) et que vous n’avez pas une CMP (Consent Management Platform) compatible avec iAdvize (Didomi, Axeptio, One Trust ou Trust Commander), vous devrez alors conditionner le dépôt du tag iAdvize à l’acceptation des cookies par votre visiteur. Vous devrez donc adapter le trigger à votre situation.

Tag de transaction

Prérequis : création du déclenchement / trigger et des variables

Il est possible que vous ayez déjà les déclenchements / triggers et les variables dans votre espace de travail Google Tag Manager.

En effet, iAdvize peut s’appuyer sur les évènements et variables déclenchées et remontées par votre site ecommerce à travers le Data Layer.

‼️ Information importante ‼️

Le guide ci-dessous utilise les événements recommandés de Google Analytics 4 comme exemple.

Vous DEVEZ adapter la configuration avec vos propres events et variables

Création du déclenchement / trigger de transaction

Cliquez sur (1) “Déclencheurs” dans le menu latéral gauche puis sur (2) “Nouveau” pour commencer la création d’un nouveau trigger

(1) Donnez un nom à votre déclencheur / trigger, nous recommandons ici “iAdvize - CE - purchase” (CE pour “Custom Event” et “purchase” car c’est le nom de l’event sur lequel nous allons nous baser)
(2) Cliquez ensuite sur “Configuration du déclencheur” pour ouvrir la liste des déclencheurs / triggers disponibles
(3) Puis cliquez sur “Événement personnalisé”

(1) dans le nom de l’event, renseignez “purchase”, car c’est ici le nom de l’event que nous souhaitons surveiller dans le DataLayer
‼️ Gardez à l’esprit que les noms d’événements peuvent varier dans votre propre Data Layer.
Assurez-vous donc d’utiliser celui qui correspond à votre implémentation. ‼️
(2) puis cliquez sur le bouton “Enregistrer” pour enregistrer votre déclencheur / trigger

Création des variables d’id, montant de la transaction et produits achetés

(1) Cliquez “Variables” dans le menu latéral gauche puis sur (2) “Nouvelle” pour commencer la création d’une nouvelle variable

(1) Donnez un nom à votre variable, nous recommandons “iAdvize - DLV - Transaction ID” (par convention, “DLV” pour “DataLayer Variable)
(2) Cliquez ensuite sur “Configuration de la variable” pour ouvrir la liste des variables disponibles
(3) Sélectionnez ensuite “Variable de couche de données”

(1) Renseignez le nom de la variable dans le Data Layer qui porte l’information de l’id de transaction “ecommerce.transaction_id”
‼️ Gardez à l’esprit que le chemin des variables peut varier dans votre propre Data Layer.
Assurez-vous donc d’utiliser celui qui correspond à votre implémentation. ‼️
(2) Cliquez ensuite sur le bouton “Enregistrer” pour enregistrer votre variable.

Effectuez ensuite la même chose pour une deuxième variable que vous (1) nommerez cette fois-ci “iAdvize - DLV - Transaction Amount” qui est également une variable de type (2) “Variable de couche de données” et dont la valeur (3) est “ecommerce.value”
‼️ Gardez à l’esprit que le chemin des variables peut varier dans votre propre Data Layer.
Assurez-vous donc d’utiliser celui qui correspond à votre implémentation. ‼️

Enfin, vous devrez créer une troisième variable GTM qui contient le tableau des produits commandés. Ce tableau doit être disponible dans votre Data Layer au moment où la commande est confirmée.

Si vous utilisez des événements de type GA4, ce tableau se trouve généralement dans “ecommerce.items”. Mais cela peut être différent selon votre configuration.

Rendez-vous dans Variables > Nouvelle
Choisissez le type Variable de couche de données
Donnez-lui un nom parlant (exemple : iAdvize - DLV - Transaction Items)
Renseignez le chemin vers vos produits dans le Data Layer

‼️ Point d'attention
Le chemin à renseigner dépend de votre propre Data Layer. Ne renseignez pas un chemin d'exemple sans vérifier qu'il correspond à votre implémentation.

Configuration du tag

Cliquez sur “Balises” dans le menu puis sur “Nouvelle” pour commencer la configuration du tag de transaction iAdvize

Dans la fenêtre qui s’ouvre:
(1) donnez un nom à votre tag, par exemple “iAdvize - Transaction tag”
(2) cliquez sur “Configuration de la balise”
(3) sélectionnez le tag de transaction iAdvize (iAdvize - Transaction tag) que vous avez ajouté précédemment à votre espace de travail

(1) Renseignez les trois variables en cliquant sur l’icône des briques (2) pour sélectionner les variables “iAdvize - DLV - Transaction ID”, “iAdvize - DLV - Transaction Amount” et "iAdvize - DLV - Transaction Items" que nous avons créé précédemment.

Les produits dans votre Data Layer doivent contenir trois informations : l'identifiant produit, la quantité commandée et le prix unitaire.

💡 Bon à savoir
Vos produits contiennent d'autres informations ? Pas d'inquiétude. Le template iAdvize va automatiquement extraire uniquement ce dont il a besoin : l'identifiant produit, la quantité et le prix unitaire. Vous n'avez pas à modifier la structure de vos données existantes.

Par défaut, le template attend que ces trois informations soient nommées selon le standard GA4 :

item_id pour l'identifiant produit
quantity pour la quantité commandée
price pour le prix unitaire

Si vos produits utilisent des noms de propriété différents, cochez la case :

☑️ My item properties use non-GA4 names (item_id, quantity and price)

Trois champs apparaissent alors. Renseignez-y les noms exacts tels qu'ils apparaissent dans votre Data Layer.

Exemple :

Dans notre dataLayer, l'identifiant des produits est renseigné dans une propriété nommée "product_id", la quantité dans "qty" et le prix dans "price".

J'ai donc "product_id" et non pas "item_id", et "qty" au lieu de "quantity". "price" est bien conforme à la valeur attendue par défaut.

items: [
  {
    product_id: 'ABC_702810',
    qty: 2,
    price: 39.9
  },
  {
    product_id: 'DEF_604064',
    qty: 1,
    price: 19.9
  },
]

Je vais donc cocher la case et mentionner "product_id" et "qty" dans les champs correspondants. Je laisse le champ "price" vide car je n'ai pas besoin de le personnaliser.

‼️ Attention
Les valeurs à renseigner dépendent de votre propre configuration. Si vous ne connaissez pas les noms utilisés dans votre Data Layer, vérifiez avec votre équipe technique avant de compléter ces champs.

Configuration du déclencheur / trigger

(1) Cliquez sur “Déclenchement” pour ouvrir la liste des triggers disponibles
(2) Sélectionnez ensuite le trigger “iAdvize - CE - purchase” que nous avons créé précédemment

Cliquez enfin sur le bouton “Enregistrer” pour enregistrer

Tag des données personnalisées

Ce tag permet de remonter en temps réel à iAdvize des informations sur la fiche produit que votre visiteur consulte, des informations à propos de votre visiteur ou tout autre information contextuelles que vous souhaitez rattacher aux conversations iAdvize.

Dans l’exemple suivant, nous allons nous concentrer uniquement sur la remontée de l’identifiant de la fiche produit que votre visiteur consulte. Cela a pour intérêt de permettre à iAdvize de personnaliser le contenu des notifications d’engagement mais également d’aider l’AI Shopping Assistant d’iAdvize à répondre aux questions du produit actuellement consulté par votre visiteur.

Prérequis : création d’un déclencheur / trigger et d’une variable

Il est possible que vous ayez déjà les déclencheurs / triggers et les variables dans votre espace de travail Google Tag Manager.