Configurer des événements

Les événements vous permettent de mesurer les interactions des utilisateurs sur votre site Web ou dans votre application. Par exemple, vous pouvez mesurer le chargement d'une page, les clics sur un lien et les achats. Google Analytics utilise les données des événements pour créer des rapports contenant des informations sur votre activité. En savoir plus

Ce guide vous explique comment configurer des événements recommandés et des événements personnalisés sur votre site Web à l'aide de la balise Google (gtag.js) ou de Google Tag Manager. Vous n'avez pas besoin de configurer les événements collectés automatiquement ni ceux de mesures améliorées.

Audience

Vous avez configuré Google Analytics et vous commencez à voir des données dans vos rapports, mais vous souhaitez collecter plus d'informations que celles qu'Analytics collecte automatiquement, ou vous souhaitez débloquer certaines fonctionnalités dans Analytics.


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 dans le compte Google Analytics

Présentation de la balise Google (gtag.js)

Utilisez l'API de la balise Google (gtag.js) pour envoyer des événements à Google Analytics. L'API comporte une fonction appelée gtag(). Chaque fois que vous souhaitez envoyer un événement à Google Analytics, vous devez utiliser la syntaxe suivante :

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

Dans cet exemple, la fonction gtag() inclut les éléments suivants :

  • Une commande event qui indique à Google que vous envoyez un événement
  • Nom de l'événement recommandé ou personnalisé
  • (Facultatif) Collection de paramètres fournissant des informations supplémentaires sur l'événement

Par exemple, voici un événement recommandé appelé screen_view avec deux paramètres :

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

Ajouter des événements à votre code JavaScript

gtag() est une fonction JavaScript. Vous devez donc l'ajouter au code JavaScript de votre page Web. Par exemple, vous pouvez ajouter la fonction dans vos balises <script> ou dans un fichier JavaScript distinct que vous importez dans votre page HTML.

Vous pouvez ajouter des événements à votre code JavaScript n'importe où en dessous de l'extrait de la balise Google. Google ne traitera pas les données des événements que vous placez au-dessus de l'extrait de la balise Google. Par exemple, l'exemple de code suivant inclut un événement appelé screen_view dans une balise <script> :

<!DOCTYPE html>
<html lang="en">
<head>
    <!-- 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');
    </script>

    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Title of the page</title>
</head>
<body>
    <p>Welcome to my website!</p>
    
    <script>
      /**
      *   The following event is sent when the page loads. You could
      *   wrap the event in a JavaScript function so the event is
      *   sent when the user performs some action.
      */
      gtag('event', 'screen_view', {
        'app_name': 'myAppName',
        'screen_name': 'Home'
      });
    </script> 
</body>
</html>

Si vous souhaitez envoyer l'événement en fonction d'un clic sur un bouton (ou d'une autre action de l'utilisateur), vous pouvez ajouter du code JavaScript à votre événement.

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 indiquent les événements déclenchés par les utilisateurs sur votre site Web à mesure qu'ils sont déclenchés.

Étapes suivantes

Précédent
Web
Suivant
Ajouter des paramètres