Avaliar os eventos do Google Analytics

Esta página explica 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 global do site, 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 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 como os valores padrão de "(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
});