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.

Par Ron Kopelman Publié le 20 novembre 2026 ⏱ 45 min, sur un conteneur de test Niveau : Avancé
Outils GTM Server-Side Google Analytics 4 Google Tag Manager Stape Cloud Run
Dans ce tutoriel
  1. Ce que fait le client GA4
  2. Les réglages à contrôler avant tout test
  3. Paramétrer le client GA4
  4. Déboguer en mode Aperçu
  5. Contrôler une requête copiée depuis le navigateur
  6. Erreurs fréquentes : symptôme, cause, correction

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.

Outils Google Tag Manager Google Analytics 4 GTM Server-Side Stape

Avant de commencer

⏱ 45 min, sur un conteneur de test Niveau : Avancé
  • 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.

Le chemin d'une requête GA4 dans le conteneur serveur

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églageOùValeur attendueSi elle est fausse
Default GA4 pathsClients, client GA4CochéeLe client ne revendique pas les requêtes /g/collect standard
PriorityClients, client GA4Au-dessus de tout autre client capable de reconnaître la même requêteUn client plus prioritaire capte la requête à la place du client GA4
Cookies and Client IdentificationClients, client GA4JavaScript Managed, tant que le domaine n’est pas configuréL’identifiant client n’est pas géré comme prévu
server_container_urlConfiguration de la balise Google ou GA4 côté webURL par défaut du conteneur serveurLa requête part directement vers Google, et le conteneur serveur ne la voit jamais
Déclencheur de la balise GA4 serveurDéclencheursClient Name est égal à GA4La balise ne part pas, même si le client a revendiqué la requête

Paramétrer le client GA4

  1. Ouvrir la liste des clients5 min

    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.

  2. Vérifier les chemins GA4 par défaut5 min

    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/collect et /j/collect sont reconnus par le client GA4.

  3. Régler la Priority5 min

    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.

  4. Créer la balise GA4 serveur15 min

    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.

  5. Renseigner l'URL du conteneur côté web10 min

    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.

  1. Lancer l'aperçu et naviguer sur le site5 min

    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.

  2. Lire la zone Client de l'onglet Request2 min

    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.

  3. Contrôler les données dans Event Data5 min

    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ètres ep. ou epn. et les propriétés up. sont arrivés.

    Résultat attendu : le nom d’événement et les paramètres attendus figurent dans Event Data.

  4. Vérifier les balises déclenchées3 min

    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.

  5. Lire la Console2 min

    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ômeCause probableCorrection
Aucune requête dans l’aperçu serveurLa balise web envoie directement à Google : server_container_url absent ou videRenseigner server_container_url côté web, publier, puis refaire un test
Requête reçue, zone Client videAucun client ne reconnaît le chemin : Default GA4 paths décochée, ou chemin non standardCocher Default GA4 paths, ou déclarer le chemin dans un client adapté
Requête revendiquée par un autre clientUn client de Priority plus haute reconnaît aussi la requêteBaisser la Priority du client concurrent ou relever celle du client GA4
Client GA4 correct, balise absente de Tags FiredLe déclencheur ne vaut pas Client Name égal à GA4Corriger la condition du déclencheur, puis relancer l’aperçu
Balise déclenchée, erreur dans la Console ou dans Outgoing HTTP RequestsRéponse refusée par le destinataire, ou point de terminaison incorrectLire 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êteL’aperçu du conteneur web est ouvert en même tempsFermer l’aperçu du conteneur web et retester
Erreur de politique de contenu dans la console du navigateurLa politique CSP du site n’autorise pas l’URL du conteneurAutoriser 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

Ron Kopelman

Vous préférez que je le fasse ?

Je mets en place ce tutoriel sur votre site, avec recette et documentation. Cadrage gratuit de 30 minutes.