DOCUMENTATION TRACKING

En plus des paramètres listés ci-dessus, les paramètres suivants sont toujours joints à un événement lorsque c’est possible :

​

• doorId : l’ID de la porte actuellement sélectionnée

• externalDoorId : l’ID externe de la porte actuellement sélectionnée

• scenarioId : l’ID du scénario actuellement sélectionné (image d’exemple)

• scenarioType : le type de scénario actuellement affiché. Valeurs possibles : « USER » pour un scénario importé par l’utilisateur, « EXAMPLE » pour un scénario d’exemple

• userId : l’ID de l’utilisateur côté frontend

• customerKey : la clé de votre environnement

​

Configuration de Google Tag Manager

Pour transmettre les événements personnalisés à un tag, les ressources suivantes doivent être correctement configurées :

• 1. Variables

• 2. Tag représentant la destination des événements personnalisés (p. ex. Google Analytics)​

• 3. Déclencheur qui définit quel événement doit être transmis au tag​

​​

​

1. Variables

Pour chacun des événements mentionnés ci-dessus que vous souhaitez transmettre, créez une variable personnalisée distincte en procédant comme suit :

1. Dans GTM, ouvrez la section Variables.

2. Cliquez sur « New » et sélectionnez « Data Layer Variable » :

   • Dans le champ Data Layer Variable Name, saisissez `body.<label>`, où label est le libellé indiqué dans le tableau ci-dessus.​​

   • Par exemple, la variable personnalisée de l’ID du scénario doit être nommée `body.scenarioId`.

   • Sélectionnez Version 2 comme version du Data Layer.

​

En plus de la variable personnalisée, créez une Data Layer Variable pour le champ event du Data Layer afin de récupérer le nom de l’événement. Procédez comme suit :​​​​​

1. Cliquez sur New pour créer une nouvelle variable.

2. Sélectionnez Data Layer Variable comme type de variable.

3. Dans le champ Data Layer Variable Name, saisissez « event » pour récupérer le nom de l’événement.

4. Sélectionnez Version 2 comme version du Data Layer.

​​

2. Déclencheur

Pour que les événements personnalisés que vous avez définis soient bien transmis à un tag, vous devez configurer un déclencheur. Suivez ces étapes pour créer un déclencheur qui écoute tous les événements personnalisés :

1. Dans GTM, ouvrez la section Triggers.

2. Créez un nouveau déclencheur :

   • Cliquez sur New et sélectionnez Custom Event comme type de déclencheur.

• Dans le champ Event Name, utilisez un caractère générique (.*) pour cibler tous les événements. Le déclencheur s’activera ainsi pour chaque événement personnalisé envoyé dans le dataLayer. Veillez à cocher la case qui active la correspondance par expression régulière.

  • Exemple :

    • Trigger Type : Custom Event

    • Event Name : .* (expression régulière)

    • This trigger fires on : All Custom Events

​

3. Tag

Une fois le déclencheur en place, configurez un tag qui envoie les données vers votre destination cible (p. ex. Google Analytics GA4). Suivez ces étapes pour créer le tag Google Analytics GA4 :

1. Dans GTM, ouvrez la section Tags.

2. Créez un nouveau tag :

   • Cliquez sur New et sélectionnez Google Analytics: GA4 Event comme type de tag.

3. Configurez votre tag d’événement GA4 :

   • Dans la configuration du tag, sélectionnez le GA4 Configuration Tag (qui contient votre Measurement ID).

   • Dans Event Name, saisissez {{event}} pour récupérer dynamiquement le nom de l’événement déclenché.

4. Associez les variables personnalisées aux paramètres GA4 :

   • Pour envoyer des données supplémentaires (comme scenarioId, userId ou doorId) en tant que paramètres personnalisés, ajoutez les correspondances dans la section Event Parameters.

   • Exemple :

     • Parameter Name : scenario_id, Value : le nom de la variable, par exemple {{scenario_id}}

5. Ajoutez le déclencheur :

   • Dans la section Triggering, sélectionnez le déclencheur « All Custom Events Trigger » créé à l’étape précédente.

​

Une fois cette configuration terminée, le tag se déclenchera pour chaque événement personnalisé envoyé dans le dataLayer, et les données correspondantes seront transmises à Google Analytics GA4.

​

4. Déboguer les événements en mode Preview

Une fois les variables personnalisées, déclencheurs et tags configurés, il est essentiel de tester et de vérifier que tout fonctionne correctement avant de publier. Google Tag Manager intègre pour cela un mode Preview qui permet de déboguer vos événements.

Pour déboguer vos événements, procédez comme suit :

​

Étapes pour utiliser le mode Preview :

1. Activez le mode Preview :

   • Dans l’espace de travail GTM, cliquez sur le bouton Preview, en haut à droite de l’écran.

   • Un nouvel onglet s’ouvre dans Tag Assistant : saisissez-y l’URL de votre site. Utilisez l’URL de votre environnement DoorVision, par exemple demo.door-vision.com pour notre environnement de démo.

2. Interagissez avec votre site :

   • Une fois en mode Preview, interagissez avec l’application en effectuant l’une des actions de la liste ci-dessus. Par exemple, pour tester un événement selectDoor, sélectionnez une porte dans le panneau de la gamme de portes.

3. Examinez les événements dans Tag Assistant :

   • Au fil de vos interactions avec l’application, Tag Assistant affiche la liste des événements déclenchés dans le volet de gauche.

   • Repérez l’événement personnalisé (p. ex. selectDoor) dans la liste des événements et cliquez dessus pour en examiner le détail.

4. Vérifiez le déclenchement du tag :

   • Pour chaque événement, vérifiez que votre tag d’événement GA4 s’est bien déclenché en consultant les sections Tags Fired et Tags Not Fired.

   • Si le tag ne s’est pas déclenché, revoyez les conditions de votre déclencheur et assurez-vous que l’événement correspond à sa configuration (p. ex., avec un déclencheur Custom Event, vérifiez que le nom de l’événement est correct).

5. Inspectez le Data Layer :

   • Dans la section Data Layer de Tag Assistant, examinez les données envoyées pour chaque événement. Vous devez y voir toutes les variables que vous avez configurées et leurs valeurs, comme scenarioId, userId et le champ event, qui décrit l’action effectuée.

   • Vérifiez que toutes les données requises sont présentes et que vos variables sont correctement associées.

6. Utilisez DebugView dans Google Analytics :

   • Si vous utilisez Google Analytics GA4, vous pouvez aussi vérifier les données d’événement dans DebugView de GA4.

     • Ouvrez Google Analytics, accédez à DebugView (dans la section Events) et vérifiez que GA4 reçoit bien vos événements.

     • Recherchez les paramètres personnalisés (p. ex. scenario_id, user_id) pour vérifier qu’ils sont correctement transmis.

​

Dépannage :

• Si le tag ne se déclenche pas, contrôlez à nouveau la configuration du déclencheur et du nom d’événement dans GTM.

• Si les variables ne transmettent pas les bonnes valeurs, vérifiez les noms des Data Layer Variables.

• Vérifiez qu’aucun bloqueur de publicités ou outil similaire susceptible de bloquer le tracking n’est activé dans votre navigateur (par exemple uBlock, Ghostery, etc.)