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
});