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 k7q2x.example.com (il s'ouvre à cette adresse quand la Server container URL est définie dans Admin, Container Settings du conteneur serveur, voir la leçon 2). 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://k7q2x.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. Retirez-le ensuite : le passer à false ne désactive pas le mode débogage.

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

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 dans État (DNS, DNS du loader, Conteneur, Script du loader). 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 provenant des pages de votre site, les bots probables (comptés même avant l'activation du Filtrage des bots) et, en mode Bloquer, les bots bloqués. Une chute soudaine à zéro indique une installation cassée ou un changement de DNS, pas un problème GA4.
• Forfait : votre forfait et la part de ses requêtes mensuelles que le conteneur a déjà consommée. C'est aussi là que vous activez le dépassement.
• Modules : chaque module est une carte avec Activer, et une fois qu'il est actif, Paramètres sur la carte ouvre sa page de réglages. L'un d'eux, 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 Modules, cliquez sur Paramètres sur la carte 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://k7q2x.example.com/healthy 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.