Convention de nommage GA4 : événements et paramètres

Convention de nommage GA4 pour événements et paramètres : règles Google, tableau de décision et script de contrôle testé, à copier dans votre plan.

Par Ron Kopelman Publié le 19 novembre 2026 ⏱ 45 min Niveau : Intermédiaire
Outils Google Analytics 4 Google Tag Manager BigQuery
Dans ce tutoriel
  1. Ce que Google impose
  2. Le tableau de décision
  3. Le schéma : du nom au rapport
  4. Le script de contrôle
  5. Mettre la convention en place
  6. Erreurs fréquentes
  7. Ce que cette convention ne règle pas

Une convention de nommage GA4 tient en trois règles : des noms en minuscules et en snake_case, 40 caractères au plus, et aucun nom réservé par Google. Google fixe le minimum ; le reste est un choix de projet, que je documente ici pour qu’un développeur et un analyste écrivent le même nom. Le tableau de décision indique quand créer un événement, quand ajouter un paramètre, et quand ne rien créer. Le script de contrôle, exécuté sur dix cas d’essai, valide les noms avant leur passage dans GTM. Si votre propriété part de zéro, mon setup GA4 et GTM commence par cette convention.

Outils concernés Google Analytics 4 Google Tag Manager BigQuery Looker Studio

Ce que Google impose

Ces règles viennent des pages d’aide Google Analytics et de la référence développeur. Elles sont vérifiées à la date de publication, et Google précise que les listes de noms réservés ne sont pas exhaustives : relisez la page avant chaque refonte.

RègleValeur imposéeSource
CasseSensible à la casse : sign_up et Sign_Up sont deux événements distinctsAide GA4 : règles de nommage
CaractèresLettres, chiffres et tirets bas uniquement, commence par une lettre, aucun espaceAide GA4 : règles de nommage
Longueur du nom40 caractères pour un nom d’événement, 40 pour un nom de paramètreLimites de collecte
Longueur de la valeur100 caractères, avec des exceptions pour page_title, page_referrer et page_locationLimites de collecte
Paramètres par événement25 maximumLimites de collecte
Noms réservés (événements Web)page_view, scroll, session_start, user_engagement, video_startAide GA4 : règles de nommage
Préfixes réservés (paramètres)Pas de _, firebase_, ga_, google_ ni gtag. en début de nomAide GA4 : règles de nommage

Google ne demande pas de minuscules. Ma convention les impose, parce qu’un Clic_Bouton et un clic_bouton se comptent en deux lignes dans les rapports. C’est un choix de projet, et il est marqué comme tel dans le plan.

Le tableau de décision

Avant de nommer quoi que ce soit, placez le geste dans une des quatre lignes ci-dessous.

Ce que vous mesurezCe que vous créezExemplePourquoi
Un geste couvert par un événement recommandé (achat, ajout au panier, génération de lead, inscription)Le nom recommandé, sans changementpurchase, add_to_cart, generate_leadGoogle recommande ces noms ; il est possible d’en créer d’autres si besoin
Un geste propre au site, sans équivalent recommandéUn événement personnalisé en verbe_objetclic_telephoneLe nom décrit l’action, pas la page
Une information qui varie (produit, formulaire, page, montant)Un paramètre sur un événement existantform_id = "devis"Une donnée dans le nom multiplie les noms d’événements
Une donnée personnelle (e-mail, nom, téléphone)Rien dans GA4—Voir l’encadré juridique ci-dessous

Le schéma : du nom au rapport

Du nom validé au rapport GA4

Le nom part du plan, passe à l'identique dans GTM, arrive dans GA4, puis devient visible en rapport si un paramètre est enregistré comme dimension.

Le script de contrôle

Le script ci-dessous vérifie les noms et les paramètres contre les règles du tableau. Je l’exécute avant chaque ajout au plan. Il tourne en Python 3, sans bibliothèque externe.

import re

# Règles GA4 : aide Google Analytics (13316687) et limites de collecte (9267744)
NOM = re.compile(r"^[a-z][a-z0-9_]*$")  # convention maison : minuscules
RESERVES_EVT = {"page_view", "scroll", "session_start", "user_engagement", "video_start"}
PREFIXES_PARAM = ("_", "firebase_", "ga_", "google_", "gtag.")
MAX_NOM = 40
MAX_PARAMS = 25

def verifier_evenement(nom, params=()):
    erreurs = []
    if len(nom) > MAX_NOM:
        erreurs.append(f"longueur {len(nom)} > {MAX_NOM}")
    if not NOM.match(nom):
        erreurs.append("caractères interdits, majuscule, espace ou début non lettre")
    if nom in RESERVES_EVT:
        erreurs.append("nom réservé par GA4")
    if len(params) > MAX_PARAMS:
        erreurs.append(f"{len(params)} paramètres > {MAX_PARAMS}")
    for p in params:
        if len(p) > MAX_NOM:
            erreurs.append(f"paramètre '{p}' trop long")
        if not NOM.match(p):
            erreurs.append(f"paramètre '{p}' : format non conforme")
        if p.startswith(PREFIXES_PARAM):
            erreurs.append(f"paramètre '{p}' : préfixe réservé")
    return erreurs

cas = [
    ("generate_lead", ["form_id", "value", "currency"]),
    ("clic_bouton_ajout", ["button_label"]),
    ("Clic_Bouton", []),
    ("clic bouton", []),
    ("page_view", []),
    ("1er_clic", []),
    ("x" * 41, []),
    ("add_to_cart", ["item_id", "currency"]),
    ("form_submit", ["_session", "ga_cookie"]),
    ("lead_envoye", [f"p{i}" for i in range(26)]),
]
for nom, params in cas:
    res = verifier_evenement(nom, params)
    statut = "OK" if not res else "KO"
    shown = nom if len(nom) <= 30 else nom[:12] + "… (" + str(len(nom)) + " car.)"
    print(f"{statut} | {shown} | {'; '.join(res) if res else '-'}")

Sortie de l’exécution sur les dix cas d’essai :

OK | generate_lead | -
OK | clic_bouton_ajout | -
KO | Clic_Bouton | caractères interdits, majuscule, espace ou début non lettre
KO | clic bouton | caractères interdits, majuscule, espace ou début non lettre
KO | page_view | nom réservé par GA4
KO | 1er_clic | caractères interdits, majuscule, espace ou début non lettre
KO | xxxxxxxxxxxx… (41 car.) | longueur 41 > 40
OK | add_to_cart | -
KO | form_submit | paramètre '_session' : format non conforme; paramètre '_session' : préfixe réservé; paramètre 'ga_cookie' : préfixe réservé
KO | lead_envoye | 26 paramètres > 25

Le script ne voit que les noms. Il ne prouve pas qu’un événement arrive dans GA4 : c’est le rôle de la recette, à l’étape 5.

Mettre la convention en place

Avant de commencer

⏱ 45 min Niveau : Intermédiaire
  • Un accès en lecture à la propriété GA4 et aux événements reçus
  • Le conteneur GTM web, avec droit de modifier les balises
  • Le plan de taggage du site, ou un tableur qui en tient lieu
  • Python 3 pour exécuter le script, ou un tableur avec la même règle
  1. Relever les noms déjà utilisés10 min

    Listez les événements reçus sur les 30 derniers jours, dans l’interface GA4, et les balises GTM qui les envoient. Notez les doublons évidents : add_to_cart et addToCart pour le même geste, par exemple.

  2. Ranger chaque geste dans le tableau de décision10 min

    Pour chaque geste, choisissez la ligne : événement recommandé, événement personnalisé, paramètre, ou rien. Un événement recommandé gagne toujours sur un nom maison.

  3. Valider les noms avec le script5 min

    Passez la liste des noms et des paramètres dans la fonction verifier_evenement. Corrigez chaque KO avant de passer à l’étape suivante. Un nom qui ne passe pas le script ne doit pas entrer dans le plan.

  4. Écrire la convention dans le plan10 min

    Une ligne par événement, avec le nom exact, les paramètres et le propriétaire. Datez la version : une modification du nom doit apparaître comme une nouvelle version, pas comme une correction silencieuse. Le plan de taggage GA4 complet détaille les autres colonnes.

  5. Copier le nom dans GTM sans le retaper10 min

    Collez le nom du plan dans le champ « nom de l’événement » de la balise GA4. Ne le retapez pas : une lettre de trop crée un événement distinct, sans message d’erreur.

  6. Recetter dans l'aperçu GTM et DebugView15 min

    Déclenchez chaque événement sur le site, puis vérifiez son nom et ses paramètres dans le mode aperçu de GTM et dans le rapport DebugView de GA4. Testez aussi avec le consentement refusé, si votre CMP le bloque.

  7. Enregistrer les paramètres utiles comme dimensions5 min

    Google indique qu’un paramètre n’apparaît dans les rapports qu’après création d’une dimension ou d’une métrique personnalisée. N’en enregistrez que les paramètres que vous utilisez dans les analyses : les emplacements sont limités. La méthode pour choisir la portée et nommer la dimension détaille ces choix avant la création.

Erreurs fréquentes

  • Singulier et pluriel mélangés : add_to_cart et add_to_carts deviennent deux événements.
  • Accents : clic_téléphone est refusé par la convention (lettres sans accent) ; le plan écrit clic_telephone.
  • Données dans le nom : clic_produit_chaise_rouge oblige à créer un événement par produit. Mettez chaise_rouge dans un paramètre.
  • Nom par page : un même geste sur deux pages garde un seul nom, et la page devient un paramètre.

Ce que cette convention ne règle pas

Elle ne décrit ni les valeurs attendues ni les noms de balises, déclencheurs et variables : pour ceux-ci, lisez la convention de nommage GTM. Les valeurs relèvent du plan de taggage et, pour le commerce en ligne, de la spécification e-commerce. Pour le détail des limites de la propriété, lisez les limites de GA4 à connaître.

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.