Tutoriel
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.
Dans ce tutoriel
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.
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ègle | Valeur imposée | Source |
|---|---|---|
| Casse | Sensible à la casse : sign_up et Sign_Up sont deux événements distincts | Aide GA4 : règles de nommage |
| Caractères | Lettres, chiffres et tirets bas uniquement, commence par une lettre, aucun espace | Aide GA4 : règles de nommage |
| Longueur du nom | 40 caractères pour un nom d’événement, 40 pour un nom de paramètre | Limites de collecte |
| Longueur de la valeur | 100 caractères, avec des exceptions pour page_title, page_referrer et page_location | Limites de collecte |
| Paramètres par événement | 25 maximum | Limites de collecte |
| Noms réservés (événements Web) | page_view, scroll, session_start, user_engagement, video_start | Aide GA4 : règles de nommage |
| Préfixes réservés (paramètres) | Pas de _, firebase_, ga_, google_ ni gtag. en début de nom | Aide 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 mesurez | Ce que vous créez | Exemple | Pourquoi |
|---|---|---|---|
| Un geste couvert par un événement recommandé (achat, ajout au panier, génération de lead, inscription) | Le nom recommandé, sans changement | purchase, add_to_cart, generate_lead | Google 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_objet | clic_telephone | Le nom décrit l’action, pas la page |
| Une information qui varie (produit, formulaire, page, montant) | Un paramètre sur un événement existant | form_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
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
- 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
-
Relever les noms déjà utilisés
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_cartetaddToCartpour le même geste, par exemple. -
Ranger chaque geste dans le tableau de décision
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.
-
Valider les noms avec le script
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. -
Écrire la convention dans le plan
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.
-
Copier le nom dans GTM sans le retaper
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.
-
Recetter dans l'aperçu GTM et DebugView
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.
-
Enregistrer les paramètres utiles comme dimensions
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_cartetadd_to_cartsdeviennent deux événements. - Accents :
clic_téléphoneest refusé par la convention (lettres sans accent) ; le plan écritclic_telephone. - Données dans le nom :
clic_produit_chaise_rougeoblige à créer un événement par produit. Mettezchaise_rougedans 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
- Aide Google Analytics : règles de nommage des événements et des paramètres, consultée le 19 novembre 2026.
- Aide Google Analytics : limites de collecte des événements, consultée le 19 novembre 2026.
- Google for Developers : paramètres d’événement GA4, consultée le 19 novembre 2026.