Configurer les paramètres d'événement

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

Audience

Vous souhaitez collecter davantage 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, consultez 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'un utilisateur consulte un produit que vous vendez, vous pouvez inclure des paramètres qui décrivent le produit qu'il a consulté, comme le nom, la catégorie et le prix.

Les événements recueillis automatiquement et ceux collectés via 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 : Enregistrer 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 tous les 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 des paramètres sont collectées, mais ne sont pas disponibles pour la création de 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 gtag() fonction pour envoyer des paramètres pour un événement. Vous pouvez également mettre à jour la config commande dans l'extrait de code d'une balise Google (dans votre balise HTML <head>) pour envoyer des paramètres avec chaque événement sur la page.

Le code 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 plus large (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, les données peuvent mettre jusqu'à 48 heures pour être disponibles dans vos rapports.

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

Vérifier dans DebugView

Lorsque vous utilisez le DebugView 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. Sélectionnez ensuite 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 remplissent automatiquement des dimensions et des métriques prédéfinies dans Google Analytics. Par exemple, il en va de même pour 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.

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

Étapes suivantes

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