Configurar os parâmetros de evento

Este guia mostra como configurar parâmetros para eventos recomendados e personalizados no site e coletar mais informações dos seus eventos. Para saber como adicionar parâmetros no escopo do item, consulte Medir o e-commerce.

Público-alvo

Você quer coletar mais informações sobre a atividade dos usuários pelos eventos que já configurou.

Você usa a tag do Google (gtag.js) ou o Gerenciador de tags no seu site. Se você quiser configurar parâmetros de evento em um app para dispositivos móveis, consulte Registrar eventos.


Antes de começar

Para seguir este guia, você precisa ter concluído as seguintes etapas:

Você também precisa ter o seguinte:

  • Acesso ao código-fonte do site
  • Função de editor (ou superior) na conta do Google Analytics

Confira também o artigo Configurar eventos antes de ler este guia.

Entender os parâmetros de evento

Os parâmetros fornecem mais informações sobre como os usuários interagem com seu site. Por exemplo, quando alguém visualiza um produto que você vende, é possível incluir parâmetros que descrevem esse item, como nome, categoria e preço.

Por padrão, os eventos coletados automaticamente e de medição otimizada incluem parâmetros. O Google também oferece um conjunto de parâmetros obrigatórios e opcionais para usar em cada evento recomendado. Além disso, é possível adicionar mais parâmetros de eventos sempre que precisar.

Configurar os parâmetros de evento

Os eventos têm a estrutura a seguir, em que <event_parameters> são os parâmetros, escritos como pares de chave-valor:

gtag('event', '<event_name>', {
  <event_parameters>
});

Confira o exemplo a seguir:

gtag('event', 'screen_view', {
  'app_name': 'myAppName',
  'screen_name': 'Home'
});

Neste exemplo:

  • app_name e screen_name são nomes de parâmetros de evento
  • myAppName e Home são valores de parâmetros de evento

Configurar parâmetros para cada evento

Os exemplos na seção anterior usam o comando event em uma função gtag() para enviar parâmetros a um evento. Também é possível atualizar o comando config no snippet de tag do Google (na tag HTML <head>) para enviar parâmetros com cada evento na página.

Este snippet de código define o título da página e envia o parâmetro com cada evento nela:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());

gtag('config', 'G-XXXXXXXXXX', {
  'page_title': 'Travel Destinations',
  'currency': 'USD'
});
</script>

Se você adicionar mais de um ID de tag à página, inclua um comando set em vez de atualizar o comando config. Assim, todos os IDs herdam os parâmetros definidos. Coloque o comando set acima do comando config.

gtag('set', {
  'page_title': 'Travel Destinations',
  'currency': 'USD'
});
// Place your config commands after the set command like follows
gtag('config', 'G-XXXXXXXXXX-1');
gtag('config', 'G-XXXXXXXXXX-2');
gtag('config', 'G-XXXXXXXXXX-3');

Conferir seus eventos no Google Analytics

Acompanhe seus eventos e os parâmetros deles usando os Relatórios de tempo real e do DebugView. O Relatório do DebugView requer mais algumas configurações para ser usado. Esses dois relatórios mostram os eventos que os usuários acionam no seu site.

Alguns parâmetros preenchem automaticamente as dimensões e métricas predefinidas no Google Analytics. Por exemplo, os parâmetros dos eventos de medição otimizada e coletados automaticamente, assim como os parâmetros obrigatórios e opcionais enviados com os eventos recomendados, preenchem as dimensões e métricas predefinidas.

Para outros parâmetros, é preciso criar dimensões e métricas personalizadas para que os valores sejam conferidos no Google Analytics. Sempre que você cria um parâmetro personalizado, também precisa criar uma dimensão ou métrica personalizada correspondente para consultar os dados.

Próximas etapas

Crie dimensões e métricas personalizadas para seus parâmetros de eventos personalizados.