Paramètres d’un appel d’événement dans Google Analytics 4

Note : GA4 est en constante évolution. La navigation a notamment été mise à jour en juin 2021. Pour vous permettre de retrouver les rapports mentionnés ci-dessous et leur nouvel emplacement, je vous ai concocté ce document Google Sheet. Presque aussi pratique que Waze 😉

Les événements sont à peu près la seule chose que vous pouvez collecter dans Google Analytics 4 et j’ai déjà rédigé un certain nombre d’articles sur le sujet auxquels je vous renvoie si nécessaire.

Dans ce post, j’avais envie d’aller un peu plus loin dans la structure des appels d’événements (pour le Web) et des paramètres liés, permettant d’avoir une meilleure compréhension de la façon dont les serveurs d’Analytics reçoivent et traitent la donnée.

Je parlerai notamment de la structure d’un événement (nom + paramètres), expliquerai comment lire un appel d’événement via les outils de développement de Chrome, et passerai en revue les types de paramètres existants (réservés, personnalisés ou propriétés utilisateur), avant de rappeler l’existence de quotas et limites concernant les paramètres à garder en tête.

Pour la façon de mettre en place les paramètres personnalisés dans vos tags via Google Tag Manager, je vous renvoie à l’article Les événements dans Google Analytics 4.

Structure d’un événement

Un événement, lorsqu'il est envoyé à GA4, comprend un nom et des paramètres, divisés en paramètres collectés automatiquement et en paramètres personnalisés.

Ci-dessous un événement nommé page_view, se déclenchant au chargement d’une page sur le site, envoyé avec tout un tas de paramètres à GA4 :

On y retrouve des paramètres tels que:

• _dbg - Mode débogage actif

• en - Nom de l’événement

• seg - L'utilisateur est considéré comme engagé pour cette session (=1)

• sr - Résolution d'écran

• tid - ID de mesure

Noter que GA4 regroupe les événements par batch, donc si vous déclenchez plus d'un événement dans une fenêtre de temps très courte, les événements seront envoyés dans un même appel.

Dans l’exemple ci-dessous, on a un événement de page vue, couplé à un événement de scroll ou défilement vertical de la page, pouvant avoir chacun des paramètres propres :

Le préfixe d’epn, pour epn.percent_scrolled, correspond à un paramètre numérique (l’événement scroll se déclenche automatiquement avec le suivi des mesures améliorées à 90% de lecture de la page), tandis que le préfixe ep correspond à du texte.

Les propriétés utilisateur sont quant à elles le plus souvent précédées du préfixe up lorsqu’elles existent.

Lire un appel d’événement

Chaque fois que le comportement d'un utilisateur déclenche le code de suivi, par exemple lorsque l'utilisateur charge une page du site, l’interaction est incorporée à un appel et envoyée aux serveurs de Google sous la forme d’une URL commençant pour Google Analytics 4 par https://www.google-analytics.com/g/collect?v=2. Figure également le paramètre tid contenant l’ID de mesure ce qui nous donne quelque chose comme https://www.google-analytics.com/g/collect?v=2&tid=G-XXXXXX…

Vous verrez ces appels si vous vous rendez dans les outils de développement de Chrome :

Puis dans l’onglet Network, faites une recherche sur collect?v et rechargez la page :

g/collect?v=1 correspond à Universal Analytics, tandis que g/collect?v=2 à Google Analytics 4.

Dans Universal, les types d'appels les plus courants sont les appels de suivi de page, les appels de suivi d'événement et les appels e-commerce. Dans GA4, rappelez-vous que tout devient un événement.

Vérifiez les codes de réponse HTTP et assurez-vous qu'ils renvoient un code 204 pour GA4. Le statut 204 indique que la requête a été traitée avec succès mais le contenu de la requête étant du texte, il n’y a pas d’information à renvoyer : la réponse est vide.

Sélectionnez un appel et parcourez-en les paramètres :

Si une des valeurs n’est pas bonne à ce stade, vous saurez que vous devez le corriger à sa source (par exemple dans Google Tag Manager).

Vous pouvez également faire ce déboggage dans la section DebugView de votre propriété Google Analytics 4, mais l’avantage de l’onglet Network est qu’il permet de voir de plus près comment sont composés les appels.

Les paramètres d’événement

Les événements dans Google Analytics 4 sont classés en différents groupes. Vous trouverez les événements collectés automatiquement, que GA4 récupère sans avoir besoin de tag supplémentaire autre que le tag de configuration - les événements recommandés, que Google conseille d'utiliser (s'ils s'appliquent à vos besoins évidemment) - et enfin les événements personnalisés, à utiliser s'il n'y a pas d'événements collectés automatiquement ou d'événements recommandés qui vous correspondent, à créer from scratch.

A chacun de ces événements sont rattachés des paramètres comme mentionné précédemment, divisés en paramètres réservés contenant des détails techniques sur l’appel, paramètres personnalisés (paramètres de texte et de nombre) et propriétés utilisateur.

De façon générale, il est important de rappeler que lorsque vous souhaitez utiliser des paramètres d'événement pour analyse, ils doivent d'abord être enregistrés en tant que dimensions et métriques personnalisées dans l’interface (Configurer > Définitions personnalisées).

Les paramètres réservés

Ces paramètres sont enregistrés avec chaque événement, qu'il soit collecté automatiquement ou manuellement :

• ul - Langue du navigateur ; par exemple en-us

• dl - URL active (document location)

• dr - URL du site référent (document referrer)

• dt - Titre de la page SEO (document title)

• sr - Résolution d’écran (screen resolution)

Il existe des paramètres “réservés” supplémentaires qui sont collectés dans certains cas. Ceux-ci incluent (mais ne sont pas limités à) :

• cid - ID client (client ID) ; l'identifiant de cookie qui aide Analytics à reconnaître les visites répétées à partir d’un même appareil

• uid - ID utilisateur (user ID) ; un identifiant supplémentaire qu’il est possible d’attribuer à un utilisateur une fois loggué pour l’identifier cross-appareils / navigateurs

Voir l’article Comment Google Analytics 4 reconnaît-il un utilisateur ? sur ces deux notions.

• sid - ID de session (session ID)

• sct - Nombre de sessions (session count) ; combien de sessions ont été enregistrées pour l'utilisateur actuel - noter que ce paramètre correspond à un cookie différent de l’ID Client, il est possible que les sommes ne soient pas tout à fait cohérentes, sur BigQuery notamment

• seg - Session engagée (session engaged) ; si la session en cours est considérée comme “engagée

• _fv - Première visite (first visit) ; si l’appel en question est le premier appel collecté de l’utilisateur

• _ss - Début de session (session start) ; si l’appel démarre une nouvelle session

Les paramètres personnalisés

Vous pouvez définir des paramètres personnalisés en les ajoutant à vos tags, mais les événements collectés automatiquement peuvent également enregistrer certains paramètres personnalisés.

On différencie :

• Les paramètres composés de texte ; préfixe ep.

• Les paramètres numériques ; préfixe epn.

Ci-dessous un exemple de ces paramètres envoyés avec la lecture d’une vidéo (nom de l’événement : video_progress) :

Les paramètres composés de texte pourront être enregistrés en tant que dimensions personnalisées et les paramètres numériques en tant que statistiques personnalisées.

Les propriétés utilisateur

Des propriétés utilisateur peuvent également être envoyées comme paramètres d’événements. Elles sont introduites par le préfixe up et doivent être enregistrées dans l'interface utilisateur GA4 pour être disponibles dans les rapports.

Quotas et limites

Le paramétrage des événements dans Google Analytics 4 a des limites dont il faut être conscient, notamment concernant la longueur du nom et le nombre de paramètres personnalisés que vous pouvez envoyer par événement (25). L’article du support [GA4] Limites de collecte et de configuration vous en donnera une vision complète.

La bonne nouvelle, c’est que même si vous dépassez les quotas indiqués, les éléments limités dans l’affichage des rapports seront toujours transmis dans l’export de vos données BigQuery, ce qui est un argument supplémentaire à la mise en place d’une association entre votre propriété GA4 et BigQuery dès que possible. Si vous êtes d’humeur à vous lancer, l’article Exporter ses données Google Analytics 4 vers BigQuery devrait vous aider.

Ces quotas et limites changeront très probablement au fur et à mesure que la plateforme mûrit. Gardez donc un oeil sur la documentation ;)

Articles complémentaires

Pour retrouver tous les articles sur Google Analytics 4.

Pour retrouver tous les articles sur le sujet des événements.