Avaliar os eventos do Google Analytics

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 global do site, use o comando event da gtag.js com a seguinte sintaxe:

gtag('event', <action>, {
  'event_category': <category>,
  'event_label': <label>,
  'value': <value>
});
  • <action> é a string que aparecerá como a ação do evento nos relatórios de eventos do Google Analytics.
  • <category> é a string que aparecerá como a categoria do evento.
  • <label> é a string que aparecerá como o rótulo do evento.
  • <value> é um número inteiro não negativo que aparecerá como o valor do evento.

O exemplo a seguir dispara um evento do Google Analytics com uma ação "xyz", uma categoria padrão "general" e um rótulo padrão "(not set)":

gtag('event', 'xyz');

Substitua os valores padrão dos parâmetros inserindo seus próprios valores no código. O exemplo a seguir dispara um evento do Google Analytics com uma ação "aaa", uma categoria "bbb" e um rótulo "ccc":

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

Saiba mais sobre a anatomia dos parâmetros de evento do Google Analytics (por exemplo, categoria, ação, rótulo e valor).

Eventos padrão do Google Analytics

Na maioria dos casos, você deve usar os eventos padrão do Google Analytics, que são predefinidos com categorias e rótulos padrão. O uso desses eventos facilita a geração de relatórios consistentes e a interoperabilidade com funcionalidades futuras.

O exemplo a seguir dispara um evento do Google Analytics com uma ação "login", uma categoria "engagement" e um rótulo "Google:

gtag('event', 'login', { method : 'Google' });

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 na tabela (por exemplo, nomes de eventos 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
});