Déboguer et tester votre configuration côté serveur

Le Preview de GTM fonctionne dans les deux conteneurs à la fois. L'ordre compte : la session Preview du serveur doit être ouverte avant que le Preview web n'envoie quoi que ce soit, et les deux doivent tourner dans le même navigateur.

1. 1 Ouvrez le conteneur serveur dans GTM et cliquez sur Preview. Un onglet Tag Assistant s'ouvre sur sgtm.example.com. Laissez-le ouvert.
2. 2 Dans le même navigateur, ouvrez le conteneur web et cliquez sur Preview. Saisissez l'adresse de votre site et cliquez sur Connect.
3. 3 Naviguez sur le site et déclenchez l'événement que vous voulez tester.
4. 4 Passez sur l'onglet du Preview serveur. Chaque requête entrante apparaît dans la colonne de gauche.

Sélectionnez une requête et lisez-la de haut en bas :

• Request : la requête HTTP entrante, et le Client qui l'a prise en charge. Un hit GA4 doit être pris en charge par le client GA4.
• Tags : les balises qui se sont déclenchées et celles qui ne l'ont pas fait. Une balise qui ne s'est pas déclenchée a en général un déclencheur qui ne correspondait pas.
• Outgoing HTTP requests (dans l'onglet Request) : ce que le serveur a envoyé à GA4 ou à un autre fournisseur, et le code de statut reçu en retour. Un statut 2xx signifie que le fournisseur l'a accepté.
• Event Data : les paramètres extraits par le client. Vérifiez que le nom de votre événement et ses paramètres sont bien arrivés.

Le Preview vous montre ce que GTM a fait. Deux contrôles de plus confirment ce qui est réellement sorti du navigateur et ce qui est arrivé dans GA4.

1. 1 Ouvrez les DevTools (F12), allez dans l'onglet Network et filtrez sur collect.
2. 2 Rechargez la page. Vous devez voir des requêtes vers votre propre sous-domaine, pas vers google-analytics.com.
3. 3 Vérifiez le statut : 200 ou 204 signifie que votre serveur de tagging a accepté le hit.

https://sgtm.example.com/g/collect?v=2&tid=G-XXXXXXXXXX&en=page_view&...

Ouvrez ensuite GA4, allez dans Admin, puis Data display et DebugView. Les événements d'un navigateur en Preview GTM sont automatiquement marqués comme trafic de débogage. Hors Preview, ajoutez le paramètre debug_mode avec la valeur true à votre balise Google pour les y voir.

La plupart des configurations cassées échouent à l'un de ces endroits. Passez-les en revue dans l'ordre, du DNS jusqu'au fournisseur.

• « Vérifier le DNS » échoue ou le sous-domaine ne se résout pas. L'enregistrement est peut-être encore en cours de propagation (attendez jusqu'à une heure), le nom contient peut-être le domaine en double (sgtm.example.com.example.com, car certains panneaux ajoutent le domaine pour vous), ou le proxy Cloudflare est activé. Sur Cloudflare, l'enregistrement doit être en DNS only (nuage gris), pas en nuage orange.
• Container Config erroné ou ancien. Si le conteneur serveur affiché en Preview ne correspond pas à celui que vous modifiez dans GTM, copiez de nouveau le Container Config depuis Admin et Container Settings, et assurez-vous que votre conteneur SGTM.space utilise exactement cette chaîne. Une config issue d'un autre conteneur serveur envoie votre trafic vers le mauvais conteneur.
• Les hits partent toujours vers google-analytics.com. Le paramètre server_container_url manque dans la balise Google, contient une faute de frappe, ou le conteneur web n'a pas été publié après son ajout. Voir la leçon 3.
• Ça marche en Preview mais pas pour les vrais visiteurs. Le conteneur serveur n'a jamais été publié. Le Preview utilise votre espace de travail, le trafic réel utilise la version publiée. Cliquez sur Submit puis Publish dans le conteneur serveur.
• Les requêtes arrivent mais rien n'atteint GA4. Le conteneur serveur n'a pas de balise GA4, ou son déclencheur ne correspond pas. Ajoutez une balise Google Analytics: GA4 déclenchée par Client Name égal à GA4, comme dans la leçon 4.
• Des hits manquent pour certains visiteurs. Les bloqueurs de publicité peuvent encore arrêter des requêtes, et avec Consent Mode, les balises peuvent ne pas se déclencher ou n'envoyer que des pings sans cookies tant que le visiteur n'a pas accepté. Voir la leçon 6 et la leçon 8.
• Toutes les requêtes sont soudain refusées. Le conteneur a atteint la limite de requêtes de son forfait SGTM.space. Les requêtes sont refusées jusqu'à ce que la limite soit relevée ou que la période se réinitialise. L'onglet Analyses montre où vous en êtes.

Chaque conteneur dans SGTM.space dispose d'onglets qui répondent aux questions auxquelles GTM ne peut pas répondre.

• Aperçu : le statut du conteneur et ses contrôles de santé. Commencez ici quand rien n'arrive du tout.
• DNS : les enregistrements à ajouter et leur état. Utilisez Vérifier le DNS après chaque modification.
• Analyses : le nombre de requêtes par jour. Une chute soudaine à zéro indique une installation cassée ou un changement de DNS, pas un problème GA4.
• Preview Mode : envoie pendant 60 minutes les requêtes correspondantes issues de webhooks, d'un CRM ou de votre backend vers votre session Preview serveur ouverte.

Preview Mode est utile quand les requêtes ne viennent pas de votre navigateur et que le cookie Preview habituel manque donc.

1. 1 Ouvrez Preview dans le conteneur serveur. Dans le menu en haut à droite, choisissez Send requests manually et copiez la valeur de l'en-tête X-Gtm-Server-Preview.
2. 2 Dans SGTM.space, ouvrez l'onglet Preview Mode et collez le jeton.
3. 3 Définissez éventuellement un préfixe de chemin (par exemple /webhooks) et une IP source, pour que seules ces requêtes soient transmises.
4. 4 Cliquez sur Enregistrer et démarrer pour 60 minutes et déclenchez le webhook ou l'appel backend. Il apparaît dans votre session Preview.

• https://sgtm.example.com/healthz renvoie 200 et le conteneur est Prêt dans Aperçu.
• Les DevTools montrent des requêtes collect vers votre sous-domaine avec le statut 200 ou 204.
• Le Preview serveur montre la requête prise en charge par le client GA4.
• La balise GA4 s'est déclenchée et sa requête sortante a reçu un statut 2xx.
• L'événement apparaît dans GA4 DebugView.
• Les deux conteneurs sont publiés.