Acompanhar eventos do Google Analytics

Esta página explica como usar gtag.js para enviar eventos do Google Analytics.

Enviar eventos

Para enviar eventos do Google Analytics em uma página da Web em que o snippet de acompanhamento foi adicionado, use o comando event do gtag.js com esta 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
});