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 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 mettre à jour 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 à 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. Ces deux rapports vous montrent les événements que les utilisateurs déclenchent sur votre site Web au fur et à mesure.

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.