Nesta página, explicamos como usar a gtag.js para enviar eventos do Google Analytics.
Enviar eventos
Para enviar eventos do Google Analytics a uma página da Web que inclui uma tag do Google, use o comando event
da gtag.js com esta sintaxe:
gtag('event', <action>, {
'event_category': <category>,
'event_label': <label>,
'value': <value>
});
Nome | Tipo | Valor padrão | Descrição |
---|---|---|---|
<action> |
string |
O valor que aparecerá como a ação do evento nos relatórios de eventos do Google Analytics. | |
<category> |
string |
"general" |
A categoria do evento. |
<label> |
string |
O rótulo do evento. | |
<value> |
number |
Um número inteiro não negativo que vai aparecer como o valor do evento. |
Veja a seguir um evento com uma ação 'aaa'
, uma categoria 'bbb'
e um rótulo 'ccc'
:
gtag('event', 'aaa', {
'event_category' : 'bbb',
'event_label' : 'ccc'
});
Se <category>
ou <label>
forem omitidos, eles serão definidos com os valores padrão "(not set)"
.
Consulte a anatomia dos parâmetros de evento do Google Analytics para mais informações sobre como a estrutura dos eventos é interpretada pelo Google Analytics.
Eventos padrão do Google Analytics
Você precisa usar os eventos padrão do Google Analytics, que têm categorias e rótulos predefinidos. O uso desses eventos facilita a geração de relatórios consistentes e a interoperabilidade com futuros recursos.
A tabela abaixo lista os eventos padrão do Google Analytics e as categorias e os tipos de rótulo padrão deles (se disponíveis). Para nomes de eventos não listados nesta tabela (por exemplo, nomes de evento arbitrários criados por você), a categoria padrão é "engagement"
, e o rótulo padrão é "(not set)"
.
Nome do evento | Categoria padrão | Tipo de rótulo padrão |
---|---|---|
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 |
Enviar eventos sem interação
Para enviar um evento sem interação, defina o parâmetro non_interaction
como true
:
gtag('event', 'video_auto_play_start', {
'event_label': 'My promotional video',
'event_category': 'video_auto_play',
'non_interaction': true
});