Tutoriel
Client GA4 dans sGTM : paramétrage et débogage
Client GA4 dans sGTM : revendication des requêtes /g/collect, ordre des clients, cookies, débogage en mode Aperçu et tableau des erreurs fréquentes.
Dans ce tutoriel
Le client GA4 est la pièce du conteneur serveur qui reconnaît une requête envoyée par Google Analytics 4, la revendique et la transmet aux balises. Quand il est mal réglé, la requête arrive bien sur votre serveur et ne déclenche rien : aucune erreur visible sur le site, mais des événements qui manquent dans GA4. Ce tutoriel couvre le paramétrage du client, la lecture du mode Aperçu, puis les erreurs qui reviennent le plus souvent, avec leur symptôme et leur correction. Il suppose un conteneur sGTM déjà créé ; si ce n’est pas le cas, la mise en place d’un sGTM vient avant.
Avant de commencer
- Un conteneur GTM Server-Side avec son URL d'hébergement
- Accès au conteneur GTM web qui envoie les événements
- Une propriété GA4 de test et son identifiant de mesure (G-…)
- Python 3 pour le script d'analyse des requêtes
Ce que fait le client GA4
Un client est l’adaptateur entre ce que le navigateur envoie et le conteneur serveur. Une requête ne peut être revendiquée que par un seul client. Plusieurs clients peuvent l’examiner, dans l’ordre de leur réglage Priority (0 par défaut ; la valeur la plus haute passe en premier), et le premier qui la reconnaît la garde. Un nouveau conteneur contient déjà un client GA4. Sa case « Default GA4 paths » l’active sur les chemins que GA4 utilise d’ordinaire : /collect, /g/collect et /j/collect.
Si aucun client ne revendique la requête, aucune balise ne part. C'est le premier point à vérifier quand un événement manque.
Le réglage « Cookies and Client Identification » du client GA4 est à « JavaScript Managed » dans le cours de Google sur le sujet. Ce mode convient tant que le conteneur ne pose pas de cookies serveur ; le passage à des cookies serveur dépend du domaine et se traite dans le guide du domaine first-party.
Les réglages à contrôler avant tout test
| Réglage | Où | Valeur attendue | Si elle est fausse |
|---|---|---|---|
| Default GA4 paths | Clients, client GA4 | Cochée | Le client ne revendique pas les requêtes /g/collect standard |
| Priority | Clients, client GA4 | Au-dessus de tout autre client capable de reconnaître la même requête | Un client plus prioritaire capte la requête à la place du client GA4 |
| Cookies and Client Identification | Clients, client GA4 | JavaScript Managed, tant que le domaine n’est pas configuré | L’identifiant client n’est pas géré comme prévu |
server_container_url | Configuration de la balise Google ou GA4 côté web | URL par défaut du conteneur serveur | La requête part directement vers Google, et le conteneur serveur ne la voit jamais |
| Déclencheur de la balise GA4 serveur | Déclencheurs | Client Name est égal à GA4 | La balise ne part pas, même si le client a revendiqué la requête |
Paramétrer le client GA4
-
Ouvrir la liste des clients
Dans le conteneur serveur, ouvrez Clients. Le client GA4 doit y figurer, avec sa Priority et ses critères d’activation.
Résultat attendu : un client GA4 unique, sans doublon, visible dans la liste.
-
Vérifier les chemins GA4 par défaut
Dans le client GA4, contrôlez que la case Default GA4 paths est cochée. Google recommande de la laisser cochée : l’analyse de ces requêtes est la fonction principale du client.
Résultat attendu : les chemins
/collect,/g/collectet/j/collectsont reconnus par le client GA4. -
Régler la Priority
Un client s’exécute selon sa Priority, la valeur la plus haute étant évaluée en premier. Si le client GA4 est le seul client capable de reconnaître
/g/collect, la valeur par défaut (0) suffit. Si vous ajoutez un client personnalisé qui reconnaît aussi ces chemins, il doit avoir une Priority inférieure, ou le client GA4 ne recevra plus rien.Résultat attendu : pour chaque requête GA4, un seul client la revendique, et c’est celui que vous attendez.
-
Créer la balise GA4 serveur
Créez une balise Google Analytics GA4 dans le conteneur serveur. Son déclencheur doit correspondre au nom du client, pas à son type : la condition est Client Name est égal à GA4.
Résultat attendu : dans l’aperçu serveur, la balise figure dans Tags Fired pour une requête
page_view. -
Renseigner l'URL du conteneur côté web
Côté web, la balise Google ou la balise GA4 doit recevoir le paramètre de configuration
server_container_url, dont la valeur est l’URL par défaut du conteneur serveur. Google le documente ainsi. Sans lui, la requête part directement vers Google.Résultat attendu : une navigation sur le site produit une requête reçue par le conteneur serveur.
Déboguer en mode Aperçu
Le mode Aperçu du conteneur serveur montre la requête telle qu’elle arrive, avant et après les balises. Lancez-le sur le conteneur serveur seul.
-
Lancer l'aperçu et naviguer sur le site
Ouvrez Preview dans le conteneur serveur, puis naviguez sur une page de test. Le panneau de gauche liste les requêtes reçues, par exemple
collect?v=…, avec les événements (page_view,purchase…) rangés sous chacune.Résultat attendu : la requête de la page visitée apparaît dans la liste.
-
Lire la zone Client de l'onglet Request
L’onglet Request contient trois zones : Client (le client qui a revendiqué la requête), Incoming HTTP Request (la requête reçue, à comparer avec l’onglet Réseau du navigateur) et Outgoing HTTP Requests (les envois des balises, avec le code et la réponse du destinataire).
Résultat attendu : la zone Client affiche le client GA4. Si elle est vide ou indique un autre client, revenez aux réglages de la section précédente.
-
Contrôler les données dans Event Data
L’onglet Event Data montre les paramètres de l’événement. Les valeurs de l’onglet Variables en sont extraites. C’est là qu’on voit si
en, les paramètresep.ouepn.et les propriétésup.sont arrivés.Résultat attendu : le nom d’événement et les paramètres attendus figurent dans Event Data.
-
Vérifier les balises déclenchées
L’onglet Tags sépare Tags Fired et Tags Not Fired. Une balise absente de la première liste n’a pas été déclenchée : c’est son déclencheur qu’il faut relire.
Résultat attendu : la balise GA4 serveur figure dans Tags Fired pour chaque événement attendu.
-
Lire la Console
L’onglet Console affiche les erreurs des balises déclenchées, avec leur message et leur source : point de terminaison invalide, appel d’API qui échoue.
Résultat attendu : aucune erreur pour les balises déclenchées.
Contrôler une requête copiée depuis le navigateur
Quand une requête est douteuse, copiez son URL depuis l’onglet Réseau du navigateur (filtrez sur collect) et passez-la au script ci-dessous. Il ne remplace pas l’aperçu : il indique seulement si le chemin est reconnu par le client GA4 et quels paramètres sont présents. L’exemple est une requête synthétique sur un domaine fictif.
"""Lit une requête GA4 copiée depuis l'onglet Réseau et indique ce que le client GA4 doit en faire.
Usage : python analyser_requete_ga4.py "https://metrics.votresite.fr/g/collect?v=2&tid=G-XXXXXXX&en=page_view&..."
"""
import sys
from urllib.parse import urlparse, parse_qs
CHEMINS_GA4 = ("/g/collect", "/collect", "/j/collect")
def analyser(url):
rapport = []
u = urlparse(url)
q = parse_qs(u.query, keep_blank_values=True)
chemin = u.path
if chemin in CHEMINS_GA4:
rapport.append(f"chemin {chemin} : reconnu par le client GA4 par défaut")
else:
rapport.append(f"chemin {chemin} : hors chemins GA4 par défaut, aucun client GA4 par défaut ne doit le revendiquer")
return rapport
tid = q.get("tid", [""])[0]
if not tid:
rapport.append("tid absent : identifiant de mesure manquant, la balise ne saura pas vers quelle propriété envoyer")
else:
rapport.append(f"tid = {tid}")
evenement = q.get("en", [""])[0]
if not evenement:
rapport.append("en absent : requête sans nom d'événement")
else:
rapport.append(f"événement = {evenement}")
if not q.get("cid", [""])[0]:
rapport.append("cid absent : pas d'identifiant client, vérifier le cookie et la source de l'identifiant")
params_evt = [k for k in q if k.startswith("ep.") or k.startswith("epn.")]
params_user = [k for k in q if k.startswith("up.")]
rapport.append(f"paramètres d'événement : {len(params_evt)} ({', '.join(sorted(params_evt)) or 'aucun'})")
rapport.append(f"propriétés utilisateur : {len(params_user)}")
if "gcs" not in q:
rapport.append("gcs absent : signal de consentement non transmis dans cette requête")
else:
rapport.append(f"gcs = {q['gcs'][0]}")
return rapport
if __name__ == "__main__":
if len(sys.argv) != 2:
sys.exit("Usage : python analyser_requete_ga4.py \"<URL de la requête>\"")
for ligne in analyser(sys.argv[1]):
print("-", ligne)
Sortie obtenue sur une requête /g/collect synthétique (domaine fictif exemple-fictif.fr) :
- chemin /g/collect : reconnu par le client GA4 par défaut
- tid = G-XXXXXXXXXX
- événement = purchase
- paramètres d'événement : 2 (ep.currency, epn.value)
- propriétés utilisateur : 1
- gcs = G111
Sur une requête /healthy, le script s’arrête dès le chemin : aucun client GA4 par défaut ne doit la revendiquer, et c’est le comportement attendu.
Erreurs fréquentes : symptôme, cause, correction
| Symptôme | Cause probable | Correction |
|---|---|---|
| Aucune requête dans l’aperçu serveur | La balise web envoie directement à Google : server_container_url absent ou vide | Renseigner server_container_url côté web, publier, puis refaire un test |
| Requête reçue, zone Client vide | Aucun client ne reconnaît le chemin : Default GA4 paths décochée, ou chemin non standard | Cocher Default GA4 paths, ou déclarer le chemin dans un client adapté |
| Requête revendiquée par un autre client | Un client de Priority plus haute reconnaît aussi la requête | Baisser la Priority du client concurrent ou relever celle du client GA4 |
| Client GA4 correct, balise absente de Tags Fired | Le déclencheur ne vaut pas Client Name égal à GA4 | Corriger la condition du déclencheur, puis relancer l’aperçu |
| Balise déclenchée, erreur dans la Console ou dans Outgoing HTTP Requests | Réponse refusée par le destinataire, ou point de terminaison incorrect | Lire la réponse dans Outgoing HTTP Requests, puis corriger le point de terminaison ou l’identifiant de la balise |
| Événements non regroupés dans une même requête | L’aperçu du conteneur web est ouvert en même temps | Fermer l’aperçu du conteneur web et retester |
| Erreur de politique de contenu dans la console du navigateur | La politique CSP du site n’autorise pas l’URL du conteneur | Autoriser l’URL du conteneur dans img-src, connect-src et frame-src, comme le demande la documentation Google |
Le tableau couvre les erreurs que la documentation Google décrit. Si l’aperçu est correct et que GA4 reste vide, le point à contrôler est l’identifiant de mesure de la balise serveur, puis les filtres de la propriété : l’aperçu confirme ce que le conteneur envoie, pas ce que GA4 a enregistré.
Pour replacer ce réglage dans l’ensemble du déploiement, la méthode de mise en place étape par étape suit le même ordre, le glossaire sGTM en donne la définition, et la page outil sGTM détaille ses coûts et ses limites.
Une fois le client GA4 réglé, la conversion Google Ads peut partir du même conteneur : voir la balise Google Ads en server-side.
Sources
- Google, Configuring the Google Analytics data stream with server-side tagging (page datée du 30/07/2026 ; consultée le 20/11/2026) : Priority, Default GA4 paths, Cookies and Client Identification, déclencheur Client Name, server_container_url.
- Google, Send data to server container (consultée le 20/11/2026) : une seule revendication par requête, ordre de Priority, CSP.
- Google, Preview and debug (consultée le 20/11/2026) : onglets Request, Tags, Variables, Event Data, Console.