In questa pagina viene spiegato come utilizzare gtag.js per inviare eventi di Google Analytics.
Invia eventi
Per inviare eventi di Google Analytics in una pagina web in cui è stato aggiunto il tag Google, utilizza il comando event
gtag.js con la seguente sintassi:
gtag('event', <action>, {
'event_category': <category>,
'event_label': <label>,
'value': <value>
});
Nome | Tipo | Valore predefinito | Descrizione |
---|---|---|---|
<action> |
string |
Il valore visualizzato come azione evento nei report Eventi di Google Analytics. | |
<category> |
string |
"general" |
La categoria dell'evento. |
<label> |
string |
L'etichetta dell'evento. | |
<value> |
number |
Un numero intero non negativo che verrà visualizzato come valore dell'evento. |
Quanto segue invia un evento con un'azione di 'aaa'
, una categoria di 'bbb'
e un'etichetta 'ccc'
:
gtag('event', 'aaa', {
'event_category' : 'bbb',
'event_label' : 'ccc'
});
Se <category>
o <label>
vengono omessi, verranno impostati i valori predefiniti di "(not set)"
.
Per ulteriori informazioni su come la struttura degli eventi viene interpretata da Google Analytics, consulta l'anatomia dei parametri evento di Google Analytics.
Eventi predefiniti di Google Analytics
Utilizza gli eventi Google Analytics predefiniti, che hanno categorie ed etichette preimpostate. L'utilizzo di questi eventi facilita la generazione di report coerenti e l'interoperabilità con le funzionalità future.
La seguente tabella elenca gli eventi predefiniti di Google Analytics, le relative categorie predefinite
e i tipi di etichette predefinite (se disponibili). Per i nomi di eventi non elencati in questa tabella (ad es. nomi di eventi arbitrari creati da te), la categoria predefinita è "engagement"
e l'etichetta predefinita è "(not set)"
.
Nome evento | Categoria predefinita | Tipo di etichetta predefinito |
---|---|---|
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 |
Invia eventi non di interazione
Per inviare un evento non di interazione, imposta il parametro non_interaction
su true
:
gtag('event', 'video_auto_play_start', {
'event_label': 'My promotional video',
'event_category': 'video_auto_play',
'non_interaction': true
});