Configurer les paramètres d'événement

Ce guide vous explique comment configurer des paramètres pour les événements recommandés et les événements personnalisés sur votre site Web afin de collecter plus d'informations à partir de vos événements. Pour savoir comment ajouter des paramètres de portée article, consultez Mesurer l'e-commerce.

Audience

Vous souhaitez collecter plus d'informations sur l'activité de vos utilisateurs grâce aux événements que vous avez déjà configurés.

Vous utilisez la balise Google (gtag.js) ou Google Tag Manager sur votre site Web. Si vous souhaitez configurer des paramètres d'événement pour une application mobile, consultez Journaliser les événements.


Avant de commencer

Ce guide part du principe que vous avez effectué les opérations suivantes :

Il part également du principe que vous disposez des éléments suivants :

  • Vous avez accès au code source de votre site Web.
  • Le rôle Éditeur (ou supérieur) dans le compte Google Analytics

Avant de lire ce guide, vous devez également consulter Configurer des événements.

Comprendre les paramètres d'événement

Les paramètres fournissent des informations supplémentaires sur la façon dont les utilisateurs interagissent avec votre site Web. Par exemple, lorsqu'une personne consulte un produit que vous vendez, vous pouvez inclure des paramètres décrivant ce produit (comme son nom, sa catégorie et son prix).

Les événements collectés automatiquement et ceux collectés avec les mesures améliorées incluent des paramètres par défaut. Google fournit également un ensemble de paramètres obligatoires et facultatifs à inclure avec chaque événement recommandé. De plus, vous pouvez ajouter d'autres paramètres d'événement lorsque vous en avez besoin.

Configurer des paramètres d'événement

Les événements ont la structure suivante, où <event_parameters> correspond à vos paramètres d'événement, écrits sous forme de paires clé/valeur :

gtag('event', '<event_name>', {
  <event_parameters>
});

Prenons l'exemple suivant :

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

Dans cet exemple :

  • app_name et screen_name sont des noms de paramètres d'événement.
  • myAppName et Home sont des valeurs de paramètres d'événement.

Important : Enregistrez les paramètres personnalisés

L'envoi de paramètres personnalisés dans votre code n'est que la première étape. Pour que Google Analytics affiche et vous permette d'analyser les données de paramètres personnalisés dans les rapports standards et les explorations, vous devez les enregistrer en tant que dimensions ou métriques personnalisées dans l'interface Google Analytics. Sans cet enregistrement, les données de paramètre sont collectées, mais ne sont pas disponibles pour les rapports.

En savoir plus sur les dimensions et métriques personnalisées

Configurer des paramètres pour chaque événement

Les exemples de la section précédente utilisent la commande event dans une fonction gtag() pour envoyer des paramètres pour un événement. Vous pouvez également mettre à jour la commande config dans l'extrait de code de la balise Google (dans votre balise HTML <head>) pour envoyer des paramètres avec chaque événement sur la page.

L'exemple suivant définit le titre de la page, puis envoie le paramètre avec chaque événement sur la page :

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());

gtag('config', 'G-XXXXXXXXXX', {
  'page_title': 'Contact Us',
  'currency': 'EUR'
});
</script>

Si vous ajoutez plusieurs ID de balise à votre page, utilisez la commande set pour les paramètres globaux documentés (tels que user_id, page_title, currency) afin que tous les ID héritent des valeurs. Placez la commande set au-dessus de la commande config.

gtag('set', {
  'page_title': 'Travel Destinations',
  'currency': 'USD'
});
// Place your config commands after the set command like follows
gtag('config', 'G-XXXXXXXXXX-1');
gtag('config', 'G-XXXXXXXXXX-2');
gtag('config', 'G-XXXXXXXXXX-3');

Afficher vos événements dans Analytics

Vous pouvez vérifier que vos événements et paramètres sont envoyés correctement à l'aide des rapports Temps réel et DebugView. Ces rapports affichent les données à mesure qu'elles arrivent. Notez que le rapport DebugView nécessite une configuration supplémentaire pour que vous puissiez l'utiliser.

Toutefois, pour afficher et analyser les valeurs des paramètres personnalisés que vous envoyez dans l'interface de création de rapports Google Analytics (par exemple, dans les explorations ou les rapports standards), vous devez d'abord les enregistrer en tant que dimensions ou métriques personnalisées. Une fois que vous avez enregistré une dimension ou une métrique personnalisée, l'affichage des données dans vos rapports peut prendre jusqu'à 48 heures.

En savoir plus sur les dimensions et métriques personnalisées

Vérifier dans DebugView

Lorsque vous utilisez le rapport DebugView, les paramètres définis avec gtag('set') sont appliqués à toutes les invocations gtag('event') suivantes sur la page. Pour vérifier, assurez-vous que la commande gtag('set') est exécutée avant le déclenchement de l'événement. Ensuite, sélectionnez un événement dans DebugView et examinez son onglet Paramètres pour afficher la liste fusionnée des paramètres, y compris ceux définis globalement.

Certains paramètres insèrent automatiquement les dimensions et métriques prédéfinies dans Google Analytics. Par exemple, les paramètres des événements collectés automatiquement et de ceux recueillis via les mesures améliorées, ainsi que les paramètres obligatoires et facultatifs que vous envoyez avec les événements recommandés, remplissent les dimensions et métriques prédéfinies.

Pour afficher les valeurs d'autres paramètres dans Google Analytics, vous devez créer des dimensions et métriques personnalisées.

Étapes suivantes

Créez des dimensions et des métriques personnalisées pour vos paramètres d'événements personnalisés.

Précédent
Configurer des événements
Suivant
Envoyer des ID utilisateur