Configurer les paramètres d'événement

Ce guide vous explique comment configurer des paramètres pour des événements recommandés et é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 axés sur les éléments, 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, consultez Configurer des événements.

Comprendre les paramètres d'événement

Les paramètres fournissent des informations supplémentaires sur les interactions des utilisateurs 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 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, rédigés 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.

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 modifier la config commande 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.

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 consulter vos événements et leurs paramètres à leur arrivée à l'aide des rapports Temps réel et DebugView. 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.

Valider dans DebugView

Lorsque vous utilisez le DebugView rapport, les paramètres définis avec gtag('set') sont appliqués à tous les appels gtag('event') suivants 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 insèrent automatiquement les dimensions et 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.