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é.

Par Ron Kopelman Publié le 20 novembre 2026 ⏱ 40 min Niveau : Intermédiaire
Outils Google Analytics 4 Google Tag Manager BigQuery
Dans ce tutoriel
  1. Ce que Google fixe
  2. Choisir la portée
  3. Nommer la dimension et son paramètre
  4. Éviter la cardinalité dès la création
  5. Le script de contrôle
  6. Créer la dimension dans GA4
  7. Erreurs fréquentes
  8. Ce que cette méthode ne règle pas

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.

TypeStandard360
Dimensions personnalisées, portée événement50125
Dimensions personnalisées, portée utilisateur25100
Dimensions personnalisées, portée article1025
Métriques personnalisées50125
Outils concernés Google Analytics 4 Google Tag Manager BigQuery
ÉlémentLimiteSource
Paramètres par événement25Limites de collecte
Nom d’un paramètre d’événement40 caractèresLimites de collecte
Nom d’une propriété utilisateur24 caractèresLimites de collecte
Nom affiché d’une dimensionUnique, sans trait d’unionAide 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.

Trois portées, trois quotas

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’usagePortéeParamètre (exemple)Pourquoi
Type de formulaire envoyé avec un leadÉvénementform_typeLa valeur change à chaque envoi
Variante de test exposée au visiteurÉvénementab_variantEnvoyée au moment de l’exposition
Type de compte (particulier ou professionnel), choisi à la connexionUtilisateuraccount_typeStable pour la personne
Langue d’interface choisieUtilisateurinterface_languageStable tant que la personne ne la change pas
Catégorie d’un produit dans itemsArticleitem_categoryAttribut 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 seulementsearch_categoryTexte libre, quasi infini : gardez une catégorie courte
Identifiant de commande ou de clientAucune—Identifiant unique : User-ID ou export BigQuery
E-mail, nom, téléphoneAucune—Donnée personnelle, voir l’encadré ci-dessous
URL complète de la pageAucune—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_ ni gtag. 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

⏱ 40 min Niveau : Intermédiaire
  • 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
  1. Lister les questions de reporting10 min

    É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.

  2. Choisir la portée de chaque donnée10 min

    Appliquez le tableau de la section « Choisir la portée ». Notez à côté une estimation du nombre de valeurs différentes.

  3. Valider le plan avec le script5 min

    Remplissez la liste plan avec 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.

  4. Vérifier que le paramètre arrive15 min

    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.

  5. Créer la dimension dans GA45 min

    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.

  6. Attendre les rapports24 à 48 h

    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.

  7. Suivre le quota5 min

    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_location ou 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

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.