Eventos no GA4: o que são e como configurar

Web AnalyticsPublicado em 01/07/202612 min de leitura

No Google Analytics 4, toda interação que você mede é um evento. Cliques, carregamentos de página, envios de formulário e compras entram nos relatórios como eventos. Esse modelo unificado substituiu a lógica de sessões e visualizações de página do Universal Analytics.

O que é um evento no GA4?

Um evento no GA4 é o registro de uma interação específica do usuário com seu site ou app. Cada vez que alguém carrega uma página, rola até o fim do conteúdo, clica em um link externo ou conclui uma compra, o Google Analytics grava um evento com um nome e os parâmetros associados. Antigamente o Universal Analytics separava os dados em tipos de hit distintos (pageview, evento com categoria, ação e rótulo, transação de ecommerce), enquanto o GA4 usa um único modelo, no qual tudo é evento e o contexto vai nos parâmetros. Segundo a documentação oficial do Google, os eventos medem as interações dos usuários e são a base dos relatórios da propriedade.

Quais são os tipos de evento no GA4?

O GA4 agrupa os eventos em quatro categorias: coletados automaticamente, de medição avançada, recomendados e personalizados. A diferença prática entre elas está em quem define o evento e se ele exige configuração. Os dois primeiros tipos funcionam sem código adicional; os dois últimos você precisa implementar.

Eventos coletados automaticamente

Eventos coletados automaticamente são registrados assim que você instala a tag do Google no site, sem nenhum código extra. Eles formam a base dos relatórios e incluem nomes como first_visit (primeira visita), session_start (início de sessão) e user_engagement (tempo de engajamento ativo). Você não consegue desativá-los. De acordo com a documentação de limites de coleta, os eventos coletados automaticamente e os de medição avançada não contam para o limite de nomes de eventos distintos da propriedade.

Eventos de medição otimizada

Eventos de medição otimizada (enhanced measurement) são ativados com um botão no painel, sem código, e cobrem interações comuns de site. Quando você liga o recurso em um fluxo de dados da Web, a tag passa a enviar esses eventos na hora. Os principais são page_view, scroll, click (clique de saída), view_search_results (busca interna), file_download, os eventos de vídeo e as interações com formulário. Conforme a documentação de medição otimizada, o scroll dispara na primeira vez que o usuário atinge 90% da profundidade vertical da página, e os eventos de vídeo (video_start, video_progress, video_complete) valem para vídeos do YouTube incorporados com suporte à API JS, com o video_progress marcando 10%, 25%, 50% e 75% da duração. A busca interna procura por padrão os parâmetros de URL como search, query, q, s e keyword. Os eventos form_start e form_submit também fazem parte da medição avançada, mas os parâmetros que eles coletam (form_id, form_name, form_destination) só aparecem nos relatórios se você criar dimensões personalizadas para eles.

Eventos recomendados

Eventos recomendados são eventos que você implementa, mas usando nomes e parâmetros já definidos pelo Google. Eles desbloqueiam relatórios e recursos atuais e futuros do Analytics, por isso vale usar o nome padronizado em vez de inventar um. Exemplos incluem login, sign_up, purchase, generate_lead e toda a lista de ecommerce. Cada vertical de negócio, como varejo, viagens e jogos, tem sua própria relação de eventos recomendados na documentação do Google.

Eventos personalizados

Eventos personalizados são os que você mesmo define quando nenhum evento automático, de medição avançada ou recomendado atende ao caso. O Google recomenda criar um evento personalizado só depois de confirmar que não existe um evento pronto para aquilo que você quer medir. O evento personalizado em si aparece normalmente no relatório de Eventos, mas os parâmetros que ele carrega só ficam visíveis, tanto em relatórios padrão quanto em Explorações, depois de registrados como dimensões ou métricas personalizadas. E, ao contrário dos recomendados, eventos personalizados não desbloqueiam relatórios prontos específicos.

Principais eventos da Web no GA4

A tabela abaixo reúne os eventos mais comuns para sites, agrupados por categoria. Os coletados automaticamente e os de medição avançada chegam sem código; os recomendados exigem implementação com nomes padronizados.

Fontes: documentação de eventos coletados automaticamente, de medição otimizada e recomendados do Google Analytics.

O que são parâmetros de evento?

Parâmetros são os dados que dão contexto a um evento. Um evento purchase, por exemplo, carrega parâmetros como value (valor), currency (moeda) e transaction_id (identificador da transação). O GA4 envia alguns parâmetros automaticamente com todo evento, e você pode adicionar os seus. A distinção que mais gera dúvida é que os parâmetros automáticos e os dos eventos recomendados já alimentam dimensões e métricas prontas, mas os parâmetros personalizados só aparecem nos relatórios depois que você os registra como dimensões ou métricas personalizadas. Sem esse registro, o dado é coletado, porém fica invisível na interface. A regra prática é usar dimensão personalizada para valores de texto (categoria de produto, tipo de usuário) e métrica personalizada para valores numéricos (valor da compra, duração).

Os parâmetros mais comuns em sites se dividem entre os que o GA4 coleta com todo evento e os que vêm de eventos específicos. A tabela a seguir resume os principais.

Fonte: parâmetros padrão e por evento conforme a documentação do Google Analytics.

Como criar um evento no GA4?

Há três formas de criar um evento no GA4: pela própria interface do Analytics, pelo Google Tag Manager ou diretamente no código com o gtag.js. Eventos coletados automaticamente e de medição otimizada não exigem nenhuma dessas etapas; o que segue vale para eventos recomendados e personalizados. Em qualquer um dos métodos, confirme depois que o evento está chegando pelos relatórios Tempo real e DebugView.

Pela interface do GA4

No painel, vá em Administrador e depois em Eventos, onde existe a opção de criar evento. Esse método gera um novo evento a partir de um evento que já chega à propriedade, aplicando condições. Por exemplo, você pode disparar um evento compra_concluida sempre que um page_view tiver o parâmetro page_location contendo /obrigado. É a via sem código, útil quando você não tem acesso ao Tag Manager nem ao código-fonte, mas ela depende de eventos que a propriedade já recebe.

Com o Google Tag Manager

O Google Tag Manager é a forma mais flexível e a mais usada. Você cria uma tag do tipo evento do GA4, define o nome e os parâmetros, e associa um acionador, como clique, envio de formulário ou visualização de elemento. O Tag Manager cobre casos que a medição avançada não captura, como formulários enviados via AJAX ou players de vídeo próprios. Ele não é obrigatório, mas centraliza a gestão das tags fora do código do site.

Com o gtag.js

Se você usa a tag do Google diretamente no código, envie eventos com a função gtag(). A sintaxe é:

gtag('event', 'pdf_baixado', {
  nome_documento: 'guia-seo-tecnico',
  categoria: 'materiais'
});

Cada chamada gtag('event', ...) envia um evento no momento em que ele ocorre. Você posiciona essas chamadas nos pontos certos do código do site, sempre abaixo do snippet da tag do Google. Não existe sintaxe especial para enviar vários eventos diferentes em lote: você faz uma chamada gtag('event', ...) para cada evento que quer registrar.

O que são eventos-chave (key events) no GA4?

Eventos-chave (key events) são os eventos que medem ações importantes para o negócio, como uma compra ou uma assinatura de newsletter. Qualquer evento que você coleta pode virar um evento-chave, basta marcá-lo como tal no painel. Em março de 2024, o Google renomeou as antigas conversões do GA4 para eventos-chave, reservando o termo conversão para ações compartilhadas com o Google Ads. Nenhuma reconfiguração foi necessária, porque as conversões existentes viraram eventos-chave automaticamente. Marcar um evento como chave permite acompanhar quantos usuários realizam aquela ação e avaliar os canais de aquisição que levaram a ela, incluindo o tráfego de assistentes de IA, que o GA4 passou a classificar em um canal próprio chamado AI Assistant.

Quais são os limites de eventos no GA4?

O GA4 impõe limites de coleta e de configuração por propriedade, e ultrapassá-los faz o Analytics simplesmente não registrar o dado. Não existe limite para a quantidade de nomes de eventos distintos em fluxos de dados da Web. O teto de 500 eventos distintos se aplica apenas a fluxos de app.

Fontes: limites de coleta e de configuração do Google Analytics.

Boas práticas de nomenclatura de eventos

Nomes de eventos no GA4 seguem regras rígidas: precisam começar com uma letra, usar apenas letras, números e sublinhados, e ter no máximo 40 caracteres. Eles também diferenciam maiúsculas de minúsculas, então comprar e Comprar contam como eventos distintos. Use snake_case, com palavras minúsculas separadas por sublinhado, e mantenha uma convenção única em toda a propriedade, porque dados consistentes são dados utilizáveis. Evite reaproveitar nomes de eventos reservados do Google (como page_view, scroll, click e purchase) para eventos personalizados. Já para nomes de parâmetro e de propriedade do usuário, não use os prefixos reservados ga_, google_, firebase_ e gtag., nem comece com sublinhado. Um detalhe técnico importante: se um evento marcado como chave passar de 40 caracteres, ele não será reportado como evento-chave, porque o GA4 adiciona internamente o sufixo _c ao final do nome, que ficaria de fora.

Perguntas frequentes sobre eventos no GA4

Qual a diferença entre evento e evento-chave no GA4?

Um evento é qualquer interação registrada, como page_view, scroll ou um clique. Um evento-chave é um evento que você marcou como importante para o negócio, como purchase ou uma assinatura. Todo evento-chave nasce de um evento comum, e a diferença é a marcação que o destaca nos relatórios. Desde março de 2024, evento-chave é o nome do que o GA4 chamava de conversão.

Preciso do Google Tag Manager para criar eventos no GA4?

Não. Eventos coletados automaticamente e de medição otimizada funcionam sem nenhuma ferramenta. Para eventos recomendados e personalizados, você pode usar o Google Tag Manager, o gtag.js direto no código ou a criação de eventos pela interface do GA4. O Tag Manager é o mais flexível, mas não é obrigatório.

Por que os dados do meu evento personalizado não aparecem nos relatórios?

Em geral o evento aparece: o nome e a contagem entram no relatório de Eventos, no Tempo real e no DebugView, normalmente em até 24 horas. O que costuma faltar são os parâmetros personalizados, que só aparecem depois de registrados como dimensões ou métricas personalizadas em Definições personalizadas, e esse registro não é retroativo. Se nem o evento aparece, verifique as regras de nomenclatura e se já passou o tempo de processamento.

Quantos eventos o GA4 permite por propriedade?

Em fluxos de dados da Web, não há limite para a quantidade de nomes de eventos distintos, o teto de 500 vale apenas para fluxos de app. Os eventos-chave, por sua vez, têm limite de 30 por propriedade no plano padrão, e cada evento aceita no máximo 25 parâmetros.

Eventos recomendados e personalizados são a mesma coisa?

Não. Eventos recomendados usam nomes e parâmetros predefinidos pelo Google e desbloqueiam relatórios específicos, por isso vale usá-los sempre que existir um para o seu caso. Eventos personalizados são criados por você quando nenhum evento pronto serve. A orientação do Google é só criar um evento personalizado depois de checar que não há um recomendado equivalente.

Conclusão

No GA4, dominar eventos é o que transforma um relatório genérico em um que responde a perguntas reais do negócio. Um bom ponto de partida é ativar a medição avançada, padronizar os nomes em snake_case e marcar como eventos-chave as ações que importam. Se o próximo passo é entender como esses dados se conectam à saúde técnica do site, o guia de análise de SEO mostra o que verificar. E para trazer métricas locais para dentro do Analytics, veja como o Google Business Profile no GA4 leva dados de ligações e rotas para os relatórios.