Mesurer les événements Google Analytics

Cette page explique comment utiliser gtag.js pour envoyer des événements Google Analytics.

Envoyer des événements

Pour envoyer des événements Google Analytics sur une page Web où la balise Google a été ajoutée, utilisez la commande gtag.js event avec la syntaxe suivante:

gtag('event', <action>, {
  'event_category': <category>,
  'event_label': <label>,
  'value': <value>
});

Nom	Type	Valeur par défaut	Description
`<action>`	`string`		Valeur qui apparaîtra en tant qu'action d'événement dans les rapports sur les événements Google Analytics.
`<category>`	`string`	`"general"`	Catégorie de l'événement.
`<label>`	`string`		Libellé de l'événement.
`<value>`	`number`		Entier non négatif qui apparaîtra en tant que valeur de l'événement.

La commande suivante envoie un événement avec une action 'aaa', une catégorie 'bbb' et un libellé 'ccc':

gtag('event', 'aaa', {
  'event_category' : 'bbb',
  'event_label' : 'ccc'
});

Si <category> ou <label> sont omis, ils sont définis sur les valeurs par défaut de "(not set)".

Consultez l'anatomie des paramètres d'événement Google Analytics pour en savoir plus sur la manière dont la structure des événements est interprétée par Google Analytics.

Événements Google Analytics par défaut

Vous devez utiliser les événements Google Analytics par défaut, qui ont des catégories et des libellés prédéfinis. L'utilisation de ces événements facilite la création de rapports cohérents et l'interopérabilité avec les fonctionnalités futures.

Le tableau suivant répertorie les événements Google Analytics par défaut, leurs catégories et les types de libellés par défaut (le cas échéant). Pour les noms d'événements qui ne sont pas répertoriés dans ce tableau (par exemple, les noms d'événements arbitraires que vous créez), la catégorie par défaut est "engagement" et le libellé par défaut est "(not set)".

Nom de l'événement	Catégorie par défaut	Type de libellé par défaut
`add_payment_info`	`ecommerce`
`add_to_cart`	`ecommerce`
`add_to_wishlist`	`ecommerce`
`begin_checkout`	`ecommerce`
`checkout_progress`	`ecommerce`
`generate_lead`	`engagement`
`login`	`engagement`	`method`
`purchase`	`ecommerce`
`refund`	`ecommerce`
`remove_from_cart`	`ecommerce`
`search`	`engagement`	`search_term`
`select_content`	`engagement`	`content_type`
`set_checkout_option`	`ecommerce`
`share`	`engagement`	`method`
`sign_up`	`engagement`	`method`
`view_item`	`engagement`
`view_item_list`	`engagement`
`view_promotion`	`engagement`
`view_search_results`	`engagement`	`search_term`

Envoyer des événements indépendants de toute interaction

Pour envoyer un événement indépendant de toute interaction, définissez le paramètre non_interaction sur true:

gtag('event', 'video_auto_play_start', {
  'event_label': 'My promotional video',
  'event_category': 'video_auto_play',
  'non_interaction': true
});