Como criar uma convenção de nomes para eventos de Analytics

Padrões claros evitam eventos redundantes e permitem comparação entre páginas. Use nomes de ação e parâmetros documentados, considerando eventos recomendados disponíveis.

Passo a passo

1. Antes de criar evento personalizado, verifique se um evento recomendado do GA4 já representa a ação; use o nome e os parâmetros indicados pelo Google quando o caso coincidir.
2. Para os eventos próprios, adote uma convenção única. Exemplo: verbo + objeto, minúsculas e _: request_quote, download_briefing, select_plan. O nome precisa começar com letra, usar somente letras, números e sublinhados, respeitar maiúsculas/minúsculas e ter menos de 40 caracteres. Evite nomes e prefixos reservados, como page_view, click, form_submit, ga_, google_ ou firebase_.
3. Use parâmetros para contexto que muda sem criar outro nome de evento: por exemplo, request_quote com form_id: "briefing_site" e placement: "service_page". Não envie email, telefone, nome ou outro dado pessoal identificável como parâmetro. Prefira valores controlados e consistentes, como service_page em todas as páginas.
4. Mantenha um dicionário com pergunta de negócio, nome, definição, condição única de disparo, parâmetros/tipos, evento recomendado equivalente, responsável, consentimento e data de revisão. Registre evento duplicado/inválido como caso negativo.
5. Teste em DebugView/Realtime e confirme que uma única ação gera um evento com os parâmetros esperados. Depois de coletar, crie dimensões personalizadas para parâmetros que precisam aparecer em relatórios.

Como comprovar que a tarefa terminou

Monte uma matriz com ação, condição de disparo, campos esperados, destino de dados e um caso negativo. Confirme o evento no destino e respeite os sinais de consentimento; o preview da tag, sozinho, não confirma processamento.

Checklist de revisão

• Equipe consegue explicar cada evento.
• Compare a informação com o que aparece na página e com a configuração ativa.
• Registre o responsável, a data da revisão e o resultado do teste.

Limites e interpretação

Confira restrições atuais de nomes e parâmetros. Revise as instruções oficiais antes de mudanças em contas, ferramentas ou interfaces, pois elas podem mudar. Não prometa indexação, rich results, posição ou resultado de negócio com base somente na configuração técnica.

Continue na biblioteca

Consulte também o hub de metricas para aprofundar as etapas relacionadas.

Fontes oficiais: regras de nomes de eventos, eventos recomendados e parâmetros de eventos. A lista de nomes reservados e limites pode mudar; confira antes de publicar a taxonomia.

Conteúdo da biblioteca de Diego Henrich. Confira as fontes citadas e valide orientações que dependem da versão de uma plataforma ou serviço.