Comment les paramètres d'événement GA4 portent le détail de chaque événement

Que sont les paramètres d'événement GA4 ?

Chaque événement enregistré par Google Analytics 4 porte des paramètres d'événement GA4, les paires clé-valeur qui indiquent quel lien a été cliqué, combien valait un achat ou quel produit un visiteur a consulté. Le nom de l'événement dit ce qui s'est passé. Les paramètres en donnent le détail. Le guide pour développeurs de Google le résume en une ligne : "Parameters provide additional information about the ways users interact with your website."

Le centre d'aide de Google fait la même distinction entre les trois couches de données de GA4 : "Events measure what users do on your website or app, like clicking a link or watching a video. Event parameters provide more details about these actions, like which link was clicked or how much of the video a user watched. User properties tell you more about the users themselves." Si le modèle événementiel lui-même est nouveau pour vous, commencez par le suivi des événements puis revenez ici pour la couche des paramètres.

Quels paramètres GA4 collecte-t-il sans aucun code ?

GA4 associe un ensemble de paramètres à chaque événement d'un flux web, événements personnalisés compris, avant que vous n'écriviez une seule ligne de code de tracking. La liste des paramètres "collected by default with every event, including custom events" de Google cite language, page_location, page_referrer, page_title et screen_resolution pour les flux web. GA4 génère aussi ga_session_id et ga_session_number à chaque session et envoie engagement_time_msec avec des événements comme user_engagement et page_view.

Les événements recommandés ajoutent un second niveau : des paramètres que Google a déjà nommés et reliés à des rapports prédéfinis. L'événement purchase est celui que la plupart des équipes utilisent :

La référence de Google ajoute une règle qui casse les rapports de revenus quand on l'ignore : "If you set value then currency is required for revenue metrics to be computed accurately." Les paramètres des événements collectés automatiquement et des événements recommandés alimentent des dimensions et métriques prédéfinies. Tout ce que vous inventez vous-même, non.

Comment envoyer un paramètre d'événement personnalisé ?

Vous envoyez un paramètre d'événement personnalisé en l'ajoutant sous forme de paire clé-valeur dans le troisième argument de l'appel gtag('event', ...). Le guide de Google donne la structure gtag('event', '<event_name>', {<event_parameters>}); avec cet exemple :

gtag('event', 'screen_view', {
  'app_name': 'myAppName',
  'screen_name': 'Home'
});

Ici, app_name et screen_name sont les noms des paramètres, et myAppName et Home sont les valeurs. Pour associer un paramètre à chaque événement d'une page, placez-le plutôt dans la commande config, comme dans gtag('config', 'G-XXXXXXXXXX', {'page_title': 'Contact Us', 'currency': 'EUR'}). Google met en garde contre la troisième option pour les valeurs personnalisées : "The set command may not reliably propagate custom parameters to all Google Analytics measurement streams." Utilisez event ou config pour tout ce que vous avez inventé.

Vérifiez le résultat dans le rapport Realtime ou dans DebugView. Selon Google, "These reports show data as it arrives." DebugView liste l'ensemble fusionné, y compris les valeurs appliquées globalement, dans l'onglet Parameters de l'événement.

Pourquoi un paramètre personnalisé n'apparaît-il pas dans les rapports GA4 ?

Un paramètre personnalisé n'apparaît pas dans les rapports GA4 parce que Google ne le rapporte qu'une fois que vous l'avez enregistré comme dimension ou métrique personnalisée. Le guide pour développeurs le dit sans détour : "Without this registration, the parameter data is collected but isn't available for reporting." Realtime et DebugView affichent la valeur brute, et c'est pourquoi un paramètre peut sembler correct pendant les tests puis manquer dans toutes les explorations une semaine plus tard.

L'enregistrement prend deux minutes dans l'écran d'administration. La page d'aide de Google liste les étapes :

1. Dans Admin, sous Data display, cliquez sur Custom definitions.
2. Ouvrez l'onglet Custom dimensions et cliquez sur Create custom dimensions.
3. Saisissez un Dimension name. Google y autorise les underscores et les espaces, mais pas les traits d'union.
4. Réglez Scope sur Event.
5. Dans Event parameter, tapez le nom du paramètre exactement comme votre code l'envoie.
6. Cliquez sur Save.

Deux champs sont irréversibles. Google marque Scope et Event parameter avec la mention "You can't change this field after you save the new dimension." Une faute de frappe dans le nom du paramètre oblige à supprimer la dimension et à la recréer. Après l'enregistrement, Google indique que vous pouvez ajouter la dimension aux rapports "after 24-48 hours from when the custom data was sent and the custom dimension was created." Pendant ce délai, la dimension affiche l'une des causes documentées de (not set) dans GA4. Les pages de Google ne disent rien d'un remplissage rétroactif des valeurs collectées avant la création de la dimension, donc enregistrez la dimension le jour où vous livrez le paramètre.

Les nombres suivent un autre chemin. Un paramètre qui mesure une quantité, comme les secondes visionnées ou les articles d'un panier, relève d'une métrique personnalisée. La règle de Google est que pour les "categorical data, however, such as what text was clicked or which page was viewed, it's more appropriate to use an event-scoped custom dimension."

Quelles limites s'appliquent aux paramètres d'événement GA4 ?

Les paramètres d'événement GA4 sont limités à 25 par événement, 40 caractères par nom et 100 caractères par valeur, et Google n'enregistre rien au-delà de ces plafonds. La page des limites de collecte indique : "Google Analytics doesn't log events, event parameters, and user properties that exceed the following limits."

Google indique que passer à Analytics 360 permet d'"increase certain limits (but not event/parameter character limits)", donc les longueurs de nom et de valeur restent les mêmes sur toutes les propriétés. La limite qui bloque la plupart des sites est celle des 50 dimensions personnalisées de portée événement, pas celle des 25 paramètres par événement, car chaque dimension couvre un nom de paramètre sur tous les événements qui l'envoient. Atteindre ce plafond a aussi un coût : Google précise que "you'll need to wait 48 hours after deleting dimensions to add new ones."

Quels noms de paramètres GA4 réserve-t-il ?

GA4 réserve cinq préfixes et une liste de noms pour les paramètres d'événement, et un nom réservé ne peut pas servir de base à une dimension personnalisée. Les règles de nommage de Google indiquent que les noms de paramètres "can't begin with" un underscore, firebase_, ga_, google_ ou gtag.. Les noms réservés pour les dimensions et métriques personnalisées sont cid, currency, customer_id, customerid, dclid, gclid, session_id, sessionid, sfmc_id, sid, srsltid, uid, user_id et userid.

La casse compte pour les événements, et la même habitude est prudente pour les paramètres. Les règles de Google précisent : "Event names are case sensitive. For example, my_event and My_Event are distinct events." Choisissez un style, comme le snake case en minuscules, et gardez-le pour les événements comme pour les paramètres, afin que Plan et plan ne deviennent jamais deux colonnes.

Que ne faut-il jamais envoyer comme paramètre d'événement ?

Les données personnelles et les identifiants uniques ne doivent jamais être envoyés comme paramètres d'événement GA4. La politique de Google exige que "no data be passed to Google that Google could use or recognize as personally identifiable information (PII)", avec comme exemples les adresses e-mail, les numéros de mobile personnels et les numéros de sécurité sociale. La fuite habituelle est une valeur de formulaire ou une chaîne de requête d'URL copiée dans un paramètre, ce que détaille la section sur les événements et paramètres de comment Google Analytics collecte les données des utilisateurs.

Les valeurs uniques posent un second problème, même quand elles ne sont pas personnelles. Google demande aux propriétés standard de ne pas créer de "unnecessary high-cardinality custom dimensions" et donne trois exemples : un identifiant unique par utilisateur, un identifiant unique par session et un horodatage. De telles dimensions "may negatively impact your reports and explorations, and cause data to be condensed under the (other) row." Envoyez des catégories, comme plan: pro ou method: google, pas des valeurs différentes à chaque hit.

Une règle d'analyse piège les équipes. Google avertit que "any value in a custom dimension that resembles a number will be treated as a number, even if it was originally formatted as text", si bien qu'une valeur texte "94E40" est lue comme une notation scientifique. Préfixez les codes qui ressemblent à des nombres, par exemple sku_94E40, pour qu'ils restent du texte.

Comment Flowsery gère-t-il les données d'événements personnalisés ?

Flowsery enregistre un événement personnalisé à partir d'un seul appel comme window.flowsery("signup"), sans gestionnaire de balises et sans étape d'enregistrement de dimension personnalisée entre le code et le tableau de bord. Son suivi des objectifs et des événements couvre les clics sur les boutons, les envois de formulaires, les téléchargements de fichiers et les lectures de vidéos, permet d'associer des valeurs de revenu aux événements, et affiche chacun d'eux dans un flux d'événements en temps réel dès qu'il se déclenche, pour que vous vérifiiez le tracking au moment même où vous le livrez. Les événements sont suivis sans cookies ni données personnelles. Si vous sortez un plan d'événements de GA4, la comparaison du suivi des événements personnalisés dans une analytique respectueuse de la vie privée face à GA4 indique quelles habitudes GA4 abandonner en chemin.

Questions fréquentes

Combien de paramètres d'événement un événement GA4 peut-il avoir ?

Un événement GA4 peut porter 25 paramètres d'événement sur une propriété standard. Google n'enregistre pas les paramètres au-delà de cette limite, donc les valeurs supplémentaires n'atteignent jamais les rapports. Analytics 360 relève certaines limites, mais pas les plafonds de 40 caractères pour les noms et de 100 caractères pour les valeurs.

Pourquoi mon paramètre apparaît-il dans DebugView mais pas dans les rapports ?

DebugView et Realtime affichent les paramètres bruts à leur arrivée, alors que les rapports standard et les explorations n'affichent que les paramètres personnalisés que vous avez enregistrés comme dimensions ou métriques personnalisées. Enregistrez le paramètre sous Admin, Custom definitions, puis comptez 24 à 48 heures avant que les données apparaissent.

Quelle est la différence entre un paramètre d'événement et une dimension personnalisée ?

Un paramètre d'événement est la paire clé-valeur que votre code envoie avec un événement. Une dimension personnalisée est le champ de rapport que vous créez dans GA4 et qui lit un nom de paramètre sur tous les événements qui l'envoient. Une seule dimension personnalisée de portée événement couvre un paramètre sur autant d'événements que vous le souhaitez.

Les dimensions personnalisées s'appliquent-elles aux données collectées avant leur création ?

Les pages d'aide de Google ne disent pas que les dimensions personnalisées remplissent rétroactivement les données antérieures. Elles indiquent que vous pouvez utiliser une dimension 24 à 48 heures après l'envoi des données et la création de la dimension. Enregistrez la dimension le jour où le paramètre est livré pour éviter un trou.

Puis-je envoyer un identifiant utilisateur comme paramètre d'événement ?

N'enregistrez pas un identifiant utilisateur comme dimension personnalisée de portée événement. user_id figure sur la liste des noms réservés de Google, et Google cite un identifiant unique par utilisateur comme exemple de dimension à forte cardinalité à éviter. Pour ce cas, Google renvoie plutôt vers sa fonctionnalité User-ID.

Que devient une valeur de paramètre de plus de 100 caractères ?

GA4 n'enregistre pas une valeur de paramètre qui dépasse la limite de ce paramètre. La limite est de 100 caractères pour la plupart des paramètres, avec des exceptions à 300 pour page_title, 420 pour page_referrer et 1,000 pour page_location. Raccourcissez les valeurs longues ou ramenez-les à des catégories courtes avant de les envoyer.

Puis-je utiliser la commande set de gtag pour envoyer un paramètre personnalisé ?

Google le déconseille. La commande set peut ne pas propager de façon fiable les paramètres personnalisés vers tous les flux de mesure de Google Analytics. Envoyez les valeurs personnalisées via event ou config, les deux commandes que Google recommande pour cela.

Combien de paramètres personnalisés un article e-commerce peut-il porter ?

Le tableau des limites plafonne les paramètres personnalisés au niveau de l'article à 27 par événement e-commerce, en plus des paramètres d'article déjà imposés par GA4 comme item_id et item_name. Cette limite s'ajoute au plafond de 25 paramètres par événement.

Le nom d'une dimension personnalisée peut-il contenir un trait d'union ?

La règle de Google dans l'écran d'administration autorise les underscores et les espaces dans le nom d'une dimension personnalisée, mais pas les traits d'union. Tenez-vous aux lettres, chiffres, underscores et espaces pour éviter une erreur de validation à l'enregistrement.

Que se passe-t-il si je supprime une dimension personnalisée par erreur ?

Le délai s'applique une fois que vous avez atteint la limite de dimensions personnalisées. La note de Google indique : "If you hit the limit for custom dimensions, you'll need to wait 48 hours after deleting dimensions to add new ones." Quand les 50 emplacements de portée événement sont tous occupés, supprimer la mauvaise dimension pour faire de la place coûte deux jours avant de pouvoir la recréer.