Résoudre les problèmes avec Tag Assistant

Cet article s'adresse aux personnes qui utilisent la balise Google ou Tag Manager et ont besoin de résoudre les problèmes de configuration de leurs balises.

Tag Assistant est un outil qui vous permet de résoudre les problèmes liés à la configuration de vos balises. Grâce à Tag Assistant, vous pouvez:

• Examinez les balises présentes sur un site Web.
• Examinez les événements qui ont été déclenchés.
• Examinez les données transmises à votre couche de données.
• Exportez une session de débogage afin de la partager avec une autre personne, par exemple l'assistance Google.
• Importer les sessions de débogage d'un autre utilisateur.
• Partagez une URL de débogage afin que quelqu'un d'autre puisse procéder au débogage pour vous.

Lorsque votre site contient la balise Google, Tag Assistant ajoute des pages avec et sans balises au Récapitulatif de couverture de la balise. Vous obtenez ainsi une vue d'ensemble de l'état des balises sur votre site.

Au sommaire de cet article :

• Installer l'extension Chrome Tag Assistant Companion
• À propos du paramètre "debug"
• Démarrer une session de débogage
• À propos de l'interface utilisateur de Tag Assistant
• Exporter une session de débogage
• Importer une session de débogage
• Partager l'accès au débogage avec une autre personne
• Quitter le mode débogage
• Valider les actions de conversion Google Ads avec Tag Assistant
• Résoudre les problèmes de connexion

Installer l'extension Chrome Tag Assistant Companion

L'extension Chrome Tag Assistant Companion fonctionne en complément du débogueur sans extension. Pour des résultats de débogage optimaux, installez l'extension Chrome Tag Assistant Companion. Lorsque l'extension Chrome est présente, les fonctionnalités suivantes sont activées :

• Détection de la balise Google dans un iFrame.
• Débogage des fenêtres pop-up ou des nouveaux onglets ouverts à partir de la fenêtre actuelle.
• Ouverture de la fenêtre de débogage dans un nouvel onglet du navigateur plutôt que dans une fenêtre pop-up, ce qui permet à l'utilisateur de se servir de la barre d'adresse du navigateur et facilite le débogage des actions basées sur l'URL de provenance.
• Possibilité de déboguer plusieurs fenêtres au cours de la même session de débogage. Toutes les fenêtres sont associées à un symbole dans l'arborescence d'événements, ce qui permet de les identifier facilement.
  

À propos du paramètre "debug"

Tag Assistant définit automatiquement un paramètre de débogage (_dbg) pour les appels envoyés à un ID de mesure Application + Web. Cela vous aide à visualiser les appels qui s'affichent dans d'autres outils de débogage (par exemple, DebugView pour une propriété Application + Web). Les appels Application + Web ne sont pas regroupés au moment de l'envoi pour vous permettre de les examiner individuellement.

Démarrer une session de débogage

Pour démarrer une session de débogage :

1. Ouvrez Tag Assistant.
2. Cliquez sur Ajouter un domaine.
3. Saisissez l'URL de la page que vous souhaitez déboguer.
4. Cliquez sur Démarrer. Tag Assistant charge le site Web à déboguer dans un nouvel onglet.
5. Il est possible que certains sites ne fonctionnent pas si un paramètre de débogage est ajouté à l'URL. Dans ce cas, décochez la case Inclure le signal de débogage dans l'URL.

Pour reprendre une session de débogage active ou fermée, cliquez sur le nom du domaine dans la section Domaines actifs ou Historique sur la page d'accueil de Tag Assistant.

Une fois le mode débogage activé, la page que vous avez indiquée s'affiche dans une nouvelle fenêtre, et l'interface utilisateur de débogage s'ouvre dans la fenêtre de navigateur Tag Assistant existante. L'interface de débogage de la fenêtre Tag Assistant contient des informations détaillées sur les événements et les commandes gtag(), y compris sur le mode de déclenchement des balises et les données traitées. Les visiteurs de votre site Web ne voient pas les informations de débogage. La fenêtre de débogage reste ouverte et affiche les informations de débogage pendant que vous naviguez sur le même domaine et tant que la balise Google est présente sur la page.

Lorsque vous cliquez sur votre site Web, les informations sur le mode de déclenchement des balises sont actualisées dans la fenêtre de débogage. Cela vous permet de voir si une balise s'est bien déclenchée, ce qui a activé ou empêché son déclenchement, et les requêtes réseau effectuées à la suite du déclenchement.

À propos de l'interface utilisateur de Tag Assistant

À la première ouverture de Tag Assistant, la vue Récapitulatif par défaut s'affiche, avec un aperçu des événements et des informations sur les balises pour la page demandée.Si plusieurs balises Google ou conteneurs Tag Manager sont détectés, sélectionnez-en un pour afficher tous les appels pour ce conteneur ou cette balise Google spécifique. 

Remarque : Les événements de navigateur peuvent être appliqués à tous les conteneurs, mais les appels sont filtrés en fonction du conteneur sélectionné.

Une liste d'événements s'affiche à gauche de l'écran. La section Sortie contient une fiche pour chaque appel détecté pour l'ID sélectionné.

Les événements sont regroupés en fonction de la page sur laquelle ils ont été enregistrés. Cliquez sur le titre d'une page dans la barre de navigation de gauche pour afficher un récapitulatif au niveau de cette page. Un nouveau groupe de pages est ajouté en haut de la liste lorsque l'utilisateur accède à une autre page du site qui contient la balise Google.

Les événements s'affichent dans l'ordre de leur déclenchement et sont numérotés en conséquence. Ceux associés à l'icône correspondent à des déclencheurs intégrés qui démarrent automatiquement lors du chargement de la balise Google. Cliquez sur un événement dans la colonne de gauche pour afficher plus d'informations.

La section Appel d'API indique le code JavaScript utilisé afin de configurer les données pour l'événement sélectionné. Il peut s'agir d'un appel gtag() ou d'un appel datalayer.push().

La section Sortie indique où les appels ont été envoyés, les mises à jour de la couche de données et les éventuelles erreurs.

Détails des appels

L'onglet Appels envoyés indique où un appel donné a été envoyé et de quel type d'appel il s'agit :

Lorsque vous cliquez sur cet appel, un panneau d'informations s'affiche. Cette vue contient des détails sur les paramètres envoyés avec chaque appel.

Couche de données

L'onglet Couche de données affiche les valeurs trouvées dans l'objet dataLayer. Lorsque la vue Récapitulatif est sélectionnée, l'état actuel de la couche de données s'affiche, ainsi que les données transmises à cette couche de données pour chaque événement.

Exporter une session de débogage

L'exportation d'une session Tag Assistant est utile lorsque vous avez besoin d'aide pour déboguer vos balises. Le fichier exporté stocke votre historique de débogage, qu'une autre personne peut importer dans la fenêtre de son navigateur Tag Assistant.

Attention: Si le site Web que vous testez envoie des informations permettant d'identifier personnellement l'utilisateur par le biais de balises, ces informations sensibles sont également exportées.

Pour exporter une session de débogage:

1. Ouvrez Tag Assistant.
2. Parcourez votre site Web pour renseigner les informations de débogage dans Tag Assistant.
3. Lorsque vous êtes prêt à exporter votre session de débogage, cliquez sur le menu à développer Exporter la session.
4. Lisez la clause de non-responsabilité, puis cliquez sur Exporter. Le fichier est alors enregistré sur votre ordinateur. Ne modifiez pas le nom du fichier ni son contenu, car cela pourrait corrompre son contenu.
5. Partagez le fichier avec la personne qui vous aide à déboguer vos balises, afin qu'elle puisse importer la session de débogage.

Importer une session de débogage

Vous pouvez importer une session de débogage Tag Assistant pour connaître les étapes suivies par un utilisateur pour tester la configuration de ses balises. Les sessions de débogage importées s'ouvrent en mode lecture seule, ce qui signifie que vous ne pouvez pas poursuivre le débogage. Aucun nouvel appel ni aucune nouvelle balise ne peuvent être déclenchés au cours d'une session importée. Si vous devez tester un site Web pour le compte d'une autre personne, demandez-lui de partager l'accès au débogage.

Pour importer une session de débogage:

1. Ouvrez Tag Assistant.
2. Dans le menu à développer , sélectionnez Importer une session 
3. Importez le fichier de session de débogage. La session importée s'ouvre en mode lecture seule.

Partager l'accès au débogage avec une autre personne

Si vous avez besoin d'aide pour déboguer la configuration de vos balises, vous pouvez autoriser une autre personne à accéder à Tag Assistant. 

Pour partager l'accès au débogage:

1. Ouvrez Tag Assistant.
2. Démarrez une session de débogage. 
3. Dans le  menu à développer , sélectionnez Partager 
4. Vérifiez les paramètres de débogage, puis cliquez sur Copy Link (Copier le lien).
5. Partagez le lien de débogage avec la personne qui vous aide.

Quitter le mode débogage

Pour quitter le mode débogage :

1. Accédez à l'onglet du navigateur Web sur lequel le mode débogage est actif.
2. Cliquez sur Arrêter le débogage dans la fenêtre flottante ou sur la page d'accueil, ou sur le X situé dans l'angle supérieur gauche de la fenêtre de débogage.

Valider les actions de conversion Google Ads avec Tag Assistant

L'intégration de Tag Assistant avec Google Ads comprend un mode guidé pour faciliter la validation des actions de conversion.

La page récapitulative des conversions Google Ads inclut des liens permettant de résoudre les problèmes liés aux actions de conversion non validées. Les liens vous permettent de lancer Tag Assistant, et vous pouvez accéder au mode débogage comme décrit ci-dessus.

La superposition de Tag Assistant dans la page affiche des conseils pour valider les actions de conversion. Une fois l'opération effectuée, cliquez sur Terminer : un récapitulatif s'affiche dans la fenêtre Tag Assistant et indique les actions de conversion testées. Ces résultats apparaissent sur la page récapitulative des conversions de Google Ads après un court délai. (en savoir plus).

Résoudre les problèmes de connexion

Si la fenêtre de débogage ne parvient pas à se connecter à votre page, essayez l'une des solutions suivantes :

• Il est possible que la page correspondant à l'URL que vous avez saisie ne comporte pas de balise Google. Essayez d'indiquer l'URL d'une autre page de votre site Web sur laquelle vous pensez qu'une balise Google est installée.
• Le paramètre de débogage ajouté à l'URL de la page peut interférer avec le comportement de la page. Pour résoudre ce problème, modifiez le domaine saisi pour le mode débogage, puis décochez la case Inclure le signal de débogage dans l'URL.
• Le script de la balise Google est chargé après que Tag Assistant tente de se connecter à la page. Cliquez sur Réessayer pour relancer la connexion.
• Votre page est au format AMP, qui n'est pas compatible avec Tag Assistant pour le moment.
• La page charge la balise Google dans un iFrame. Pour déboguer les configurations de balises chargées dans un iFrame, l'extension Chrome Tag Assistant Companion doit également être installée.
• Les redirections de navigateur multiples peuvent empêcher le chargement de la fenêtre de débogage.
• Les bloqueurs de publicité installés dans votre navigateur Web peuvent empêcher l'exécution de la balise Google. Désactivez-les pour les pages à tester.
• Si vous avez installé Tag Assistant Companion, assurez-vous que l'extension est autorisée à lire et à modifier les données de site pour les pages à tester.
• Les balises Google peuvent être bloquées par les outils de gestion du consentement. Configurez tous ceux que vous utilisez pour autoriser les interactions avec l'API Consent de Google.