Tutoriel
Dimension personnalisée GA4 : créer et bien nommer
Créer une dimension personnalisée GA4 : choisir la portée, nommer le paramètre, éviter la cardinalité. Tableau de décision et script de contrôle testé.
Dans ce tutoriel
Une dimension personnalisée GA4 rend lisible dans les rapports un paramètre que votre site envoie déjà. Elle ne collecte rien : si le paramètre n’arrive pas, la dimension reste vide. Trois décisions se prennent avant de cliquer sur « Créer » : la portée, le nom du paramètre, et le nombre de valeurs différentes qu’il peut prendre.
Si votre propriété part de zéro, mon setup GA4 et GTM pose ces dimensions dans le plan de marquage. Les noms d’événements et de paramètres se fixent avant, avec la convention de nommage GA4.
Ce que Google fixe
Les chiffres ci-dessous viennent des pages d’aide Google. Ils s’appliquent par propriété. Une fois la limite atteinte pour un type, GA4 ne permet plus d’en créer un nouveau.
| Type | Standard | 360 |
|---|---|---|
| Dimensions personnalisées, portée événement | 50 | 125 |
| Dimensions personnalisées, portée utilisateur | 25 | 100 |
| Dimensions personnalisées, portée article | 10 | 25 |
| Métriques personnalisées | 50 | 125 |
| Élément | Limite | Source |
|---|---|---|
| Paramètres par événement | 25 | Limites de collecte |
| Nom d’un paramètre d’événement | 40 caractères | Limites de collecte |
| Nom d’une propriété utilisateur | 24 caractères | Limites de collecte |
| Nom affiché d’une dimension | Unique, sans trait d’union | Aide GA4 : dimension de portée événement |
Les pages d’aide que j’ai lues ne disent pas si une dimension remonte les données antérieures à sa création. Partez du principe qu’elles n’apparaîtront pas, et vérifiez-le sur votre propriété.
Choisir la portée
La portée répond à une question : la valeur change-t-elle à chaque geste, reste-t-elle la même pour une personne, ou décrit-elle un produit dans le tableau items ? « Article » désigne ici la portée item de GA4, utilisée en e-commerce, et non un article de blog. Pour un contenu éditorial, restez en portée événement.
La portée se choisit selon ce qui varie : le geste, la personne ou le produit. Les quotas sont ceux de la version standard.
Le tableau applique ce critère à des cas courants.
| Cas d’usage | Portée | Paramètre (exemple) | Pourquoi |
|---|---|---|---|
| Type de formulaire envoyé avec un lead | Événement | form_type | La valeur change à chaque envoi |
| Variante de test exposée au visiteur | Événement | ab_variant | Envoyée au moment de l’exposition |
| Type de compte (particulier ou professionnel), choisi à la connexion | Utilisateur | account_type | Stable pour la personne |
| Langue d’interface choisie | Utilisateur | interface_language | Stable tant que la personne ne la change pas |
Catégorie d’un produit dans items | Article | item_category | Attribut du produit, pas de l’événement. Si GA4 la fournit déjà en dimension prédéfinie, ne la recréez pas |
| Terme tapé dans la recherche interne | Événement, en catégorie seulement | search_category | Texte libre, quasi infini : gardez une catégorie courte |
| Identifiant de commande ou de client | Aucune | — | Identifiant unique : User-ID ou export BigQuery |
| E-mail, nom, téléphone | Aucune | — | Donnée personnelle, voir l’encadré ci-dessous |
| URL complète de la page | Aucune | — | page_location et page_path existent déjà |
Nommer la dimension et son paramètre
- Nom affiché : unique dans la propriété, sans trait d’union. Un libellé lisible suffit : « Type de formulaire ».
- Paramètre : minuscules, chiffres et tirets bas, première lettre alphabétique, comme
form_type. C’est ma convention, pas une obligation de Google : elle est détaillée dans la convention de nommage. - Préfixes réservés : pas de
_,firebase_,ga_,google_nigtag.en début de nom. - Longueur : 40 caractères au plus pour un paramètre d’événement, 24 pour une propriété utilisateur.
Éviter la cardinalité dès la création
Google appelle « à forte cardinalité » une dimension de plus de 500 valeurs, mais précise que ce chiffre est une recommandation et non une limite. Quand un tableau dépasse sa limite de lignes, les valeurs les moins fréquentes sont regroupées dans une ligne « (other) ». Le diagnostic d’une ligne « (other) » déjà présente dépasse le cadre de cette page : les limites de GA4 à connaître en rappellent le principe.
Pour ne pas la créer :
- Une dimension par information stable, jamais par objet. Pas une dimension par produit, par utilisateur ou par page.
- Des catégories courtes plutôt que du texte libre. Le terme tapé dans une recherche devient une catégorie.
- Le User-ID pour identifier les personnes. Google recommande cette fonction plutôt qu’une dimension personnalisée.
- Un paramètre d’événement ou une propriété utilisateur pour les valeurs très nombreuses. Google indique qu’elles restent exploitables dans BigQuery, les audiences et les segments.
- Une estimation du nombre de valeurs, notée dans le plan. Sans chiffre, la dimension se crée sans qu’on sache si elle tiendra.
Le script de contrôle
Le script applique ces règles à un plan de dimensions. Il tourne en Python 3, sans bibliothèque externe. Les cas ci-dessous sont synthétiques : il ne lit pas votre propriété, et le nombre de valeurs est votre estimation.
import re
from collections import Counter
# Règles relevées sur les pages d'aide Google (consultées le 20/11/2026) :
# quotas standard par propriété : utilisateur 25, événement 50, article 10 (aide 10075209)
# propriété utilisateur : nom 24 car. (aide 9267744) ; paramètre d'événement : nom 40 car.
# nom de dimension sans trait d'union (aide 14239618 et 14239696)
QUOTAS = {"utilisateur": 25, "evenement": 50, "article": 10}
MAX_NOM = {"utilisateur": 24, "evenement": 40}
SEUIL_REPERE = 500 # repère Google sur la cardinalité, pas une limite
NOM_PARAM = re.compile(r"^[a-z][a-z0-9_]*$") # convention maison : minuscules
PREFIXES_RESERVES = ("_", "firebase_", "ga_", "google_", "gtag.")
MOTS_IDENTIFIANT = {"id", "uid", "mail", "email", "tel", "telephone", "phone",
"user", "order", "commande", "session", "url", "search",
"recherche", "nom", "name", "adresse", "ip", "token"}
def verifier_plan(plan):
lignes = []
noms_vus = set()
par_portee = Counter(d["portee"] for d in plan)
for portee, n in par_portee.items():
if portee not in QUOTAS:
lignes.append(("KO", portee, "-", "portée inconnue"))
elif n > QUOTAS[portee]:
lignes.append(("KO", portee, "-", f"quota dépassé : {n} > {QUOTAS[portee]}"))
for d in plan:
nom, portee, p = d["nom"], d["portee"], d["parametre"]
erreurs, alertes = [], []
if "-" in nom:
erreurs.append("trait d'union dans le nom de dimension")
if nom in noms_vus:
erreurs.append("nom de dimension en double")
noms_vus.add(nom)
if not NOM_PARAM.match(p):
erreurs.append("paramètre hors convention (minuscules, _ seulement)")
if p.startswith(PREFIXES_RESERVES):
erreurs.append("préfixe réservé")
if portee in MAX_NOM and len(p) > MAX_NOM[portee]:
erreurs.append(f"nom de {len(p)} car. > {MAX_NOM[portee]}")
if d.get("donnee_perso"):
erreurs.append("donnée personnelle : ne pas envoyer")
if d["valeurs"] > SEUIL_REPERE:
alertes.append(f"{d['valeurs']} valeurs > repère {SEUIL_REPERE}")
if MOTS_IDENTIFIANT & set(p.split("_")):
alertes.append("nom d'identifiant probable : vérifier la cardinalité")
if erreurs:
lignes.append(("KO", portee, nom, "; ".join(erreurs)))
elif alertes:
lignes.append(("ATTENTION", portee, nom, "; ".join(alertes)))
else:
lignes.append(("OK", portee, nom, "-"))
return lignes
def choisir_portee(stable_par_utilisateur, dans_tableau_items, identifiant_unique, donnee_personnelle):
if donnee_personnelle:
return "aucune : donnée personnelle"
if identifiant_unique:
return "aucune : identifiant (User-ID ou BigQuery)"
if dans_tableau_items:
return "article"
if stable_par_utilisateur:
return "utilisateur"
return "evenement"
plan = [
{"nom": "Type de formulaire", "portee": "evenement", "parametre": "form_type", "valeurs": 12, "donnee_perso": False},
{"nom": "Type de compte", "portee": "utilisateur", "parametre": "account_type", "valeurs": 2, "donnee_perso": False},
{"nom": "Catégorie produit", "portee": "article", "parametre": "item_category", "valeurs": 620, "donnee_perso": False},
{"nom": "Recherche interne", "portee": "evenement", "parametre": "search_term", "valeurs": 8000, "donnee_perso": False},
{"nom": "E-mail client", "portee": "utilisateur", "parametre": "user_email", "valeurs": 50000, "donnee_perso": True},
{"nom": "Mon-Tiret", "portee": "evenement", "parametre": "Bad-Name", "valeurs": 3, "donnee_perso": False},
{"nom": "Langue choisie", "portee": "utilisateur", "parametre": "langue_interface_choisie_x", "valeurs": 3, "donnee_perso": False},
{"nom": "Variante test", "portee": "evenement", "parametre": "_ga_variant", "valeurs": 2, "donnee_perso": False},
]
print("== Contrôle du plan (cas synthétiques)")
for statut, portee, nom, raison in verifier_plan(plan):
print(f"{statut:9} | {portee:11} | {nom:18} | {raison}")
print()
print("== Quota : 51 dimensions de portée événement")
grand = [{"nom": f"dim {i}", "portee": "evenement", "parametre": f"p_{i}", "valeurs": 3, "donnee_perso": False} for i in range(51)]
print(verifier_plan(grand)[0])
print()
print("== Choix de portée (cas synthétiques)")
cas = [
("Type de formulaire envoyé à chaque clic", (False, False, False, False)),
("Type de compte choisi à la connexion", (True, False, False, False)),
("Catégorie produit dans le tableau items", (False, True, False, False)),
("Adresse e-mail saisie", (True, False, False, True)),
("Numéro de commande", (False, False, True, False)),
("Langue d'interface choisie", (True, False, False, False)),
]
for libelle, args in cas:
print(f"{libelle:42} -> {choisir_portee(*args)}")
Sortie de l’exécution, telle qu’elle apparaît dans le terminal :
== Contrôle du plan (cas synthétiques)
OK | evenement | Type de formulaire | -
OK | utilisateur | Type de compte | -
ATTENTION | article | Catégorie produit | 620 valeurs > repère 500
ATTENTION | evenement | Recherche interne | 8000 valeurs > repère 500; nom d'identifiant probable : vérifier la cardinalité
KO | utilisateur | E-mail client | trait d'union dans le nom de dimension; donnée personnelle : ne pas envoyer
KO | evenement | Mon-Tiret | trait d'union dans le nom de dimension; paramètre hors convention (minuscules, _ seulement)
KO | utilisateur | Langue choisie | nom de 26 car. > 24
KO | evenement | Variante test | paramètre hors convention (minuscules, _ seulement); préfixe réservé
== Quota : 51 dimensions de portée événement
('KO', 'evenement', '-', 'quota dépassé : 51 > 50')
== Choix de portée (cas synthétiques)
Type de formulaire envoyé à chaque clic -> evenement
Type de compte choisi à la connexion -> utilisateur
Catégorie produit dans le tableau items -> article
Adresse e-mail saisie -> aucune : donnée personnelle
Numéro de commande -> aucune : identifiant (User-ID ou BigQuery)
Langue d'interface choisie -> utilisateur
Le script ne voit ni GTM ni votre site : un nom juste dans le plan peut être mal recopié dans une balise. La recette de l’étape 4 reste obligatoire.
Créer la dimension dans GA4
Avant de commencer
- Un rôle éditeur ou administrateur sur la propriété GA4
- Un accès au conteneur GTM, avec droit de prévisualisation
- Le plan de taggage du site, ou un tableur qui en tient lieu
- Python 3 pour le script de contrôle
-
Lister les questions de reporting
Écrivez chaque question à laquelle un rapport doit répondre : « quel type de formulaire convertit ? ». Pour chacune, vérifiez d’abord si GA4 ne fournit pas déjà la dimension. Google demande de ne pas créer une dimension prédéfinie en double.
-
Choisir la portée de chaque donnée
Appliquez le tableau de la section « Choisir la portée ». Notez à côté une estimation du nombre de valeurs différentes.
-
Valider le plan avec le script
Remplissez la liste
planavec une ligne par dimension, puis lancez le script. Corrigez chaque KO. Un ATTENTION ne bloque pas, mais il demande une décision écrite : garder la dimension, la regrouper en catégories, ou la sortir de GA4. -
Vérifier que le paramètre arrive
Déclenchez l’action sur le site, en mode aperçu GTM, puis regardez le paramètre dans le rapport Temps réel ou dans DebugView de GA4. Un paramètre absent ici ne figurera jamais dans un rapport.
-
Créer la dimension dans GA4
Allez dans Administration, puis sous « Affichage des données », ouvrez « Définitions personnalisées », onglet « Dimensions personnalisées », et cliquez sur « Créer des dimensions personnalisées ». Renseignez le nom, la portée, la description, puis le paramètre d’événement (ou le nom de la propriété utilisateur) tel qu’il est écrit dans le code. Enregistrez.
-
Attendre les rapports
Google indique qu’il faut compter 24 à 48 heures après la création et l’envoi des données avant d’ajouter la dimension à un rapport. Si elle reste vide après ce délai, revenez à l’étape 4 : le paramètre est le premier suspect.
-
Suivre le quota
Relevez le nombre de dimensions utilisées dans « Définitions personnalisées ». Archiver une dimension libère un emplacement, mais elle ne se restaure pas. Une fois la limite atteinte, Google indique un délai de 48 heures après une suppression avant d’en créer une autre.
Erreurs fréquentes
- Une dimension par produit ou par page : la liste explose et la ligne « (other) » apparaît. Mettez l’identifiant dans un paramètre d’événement, et la catégorie seule en dimension.
- Un nom différent entre le plan et GTM : la dimension existe mais reste vide, parce que le paramètre reçu porte un autre nom.
- Une dimension pour une donnée déjà native :
page_locationou la source de trafic existent déjà. Vérifiez les dimensions prédéfinies avant chaque création.
Ce que cette méthode ne règle pas
Elle ne décrit ni le consentement, ni la configuration des balises, ni le diagnostic d’une ligne « (other) » déjà présente. Pour la convention des noms d’événements, lisez la convention de nommage GA4. Pour le plan complet, la méthode de plan de taggage GA4 détaille les autres colonnes, et le glossaire sur la dimension rappelle la différence avec une métrique.
Sources
- Google, Aide Google Analytics : dimensions et métriques personnalisées, quotas par portée, consultée le 20 novembre 2026.
- Google, Aide Google Analytics : créer une dimension personnalisée de portée événement, consultée le 20 novembre 2026.
- Google, Aide Google Analytics : créer une dimension personnalisée de portée utilisateur, consultée le 20 novembre 2026.
- Google, Aide Google Analytics : à propos de la ligne (other), consultée le 20 novembre 2026.
- Google, Aide Google Analytics : limites de collecte des événements, consultée le 20 novembre 2026.
- Google, Aide Google Analytics : règles relatives aux données, consultée le 20 novembre 2026.