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 :

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.

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

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.

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.

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

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.

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.

Création d’un déclencheur / trigger pour la consultation d’une page/vue produit

• 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 trigger, nous recommandons ici “iAdvize - CE - view_item” (CE pour “Custom Event” et “view_item” 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 triggers disponibles
  (3) Puis cliquez sur “Événement personnalisé”

• (1) dans le nom de l’event, renseignez “view_item”, 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 trigger

Création de variable contenant l’ID produit consulté

• (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 - Product 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.items.0.item_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 “Enregistrer” pour enregistrer votre variable.

Configuration du tag

• Cliquez sur “Balise” dans le menu puis sur “Nouvelle” pour commencer la configuration du tag des données personnalisées iAdvize

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

• (1) Renseignez la variable en cliquant sur l’icône des briques (2) pour sélectionner la variables “iAdvize - DLV - Product ID” que nous avons créé précédemment

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 - view_item” que nous avons créé précédemment

• Cliquez enfin sur le bouton “Enregistrer” pour enregistrer