Já perdi a conta de quantas contas de Google Analytics eu vi assim: centenas de eventos com nomes parecidos (click_button, button_click, cta-click), metade sem parâmetros, ninguém sabe quem criou e ninguém confia no número. A ferramenta não tem culpa. Faltou um plano antes do primeiro evento.
Comece pelas perguntas, não pelos eventos
O erro mais comum é sair rastreando tudo "para o caso de precisar". Isso gera ruído, custo e, com a LGPD, risco. O caminho inverso funciona melhor:
- Quais decisões vamos tomar com esses dados? "Vale manter a campanha X?", "O novo onboarding ativou mais gente?"
- Quais perguntas respondem essas decisões? "Qual o custo por conta ativada, por canal?"
- Quais eventos e parâmetros respondem essas perguntas? Só agora você escreve o evento.
Se um evento não responde nenhuma pergunta, ele não entra.
Uma taxonomia que escala
Os nomes dos eventos são uma API: depois de publicados, mudar é caro. Algumas regras que uso:
objeto_açãono passado, em snake_case:signup_completed,report_generated,plan_selected. O objeto primeiro agrupa os eventos de um mesmo assunto na lista.- Parâmetros carregam o contexto, não o nome. Em vez de
signup_googleesignup_email, umsignup_completedcommethod: 'google' | 'email'. - Nomes e valores em inglês, sem acento e sem espaço. Evita surpresas em relatórios e exportações.
- Um dicionário versionado. Uma tabela no repositório com evento, quando dispara, parâmetros e quem pediu.
| Evento | Quando dispara | Parâmetros |
|---|---|---|
signup_click | Clique em qualquer CTA de cadastro | location (hero, pricing, header) |
price_interest | Seção de preço visível por 2s | currency |
signup_completed | Conta criada com sucesso | method |
first_value | Primeira ação que entrega valor | days_since_signup |
signup_click acontece no site e signup_completed no app. O plano de medição atravessa repositórios, e por isso precisa estar escrito num lugar que os dois times leem.O evento nasce no mesmo PR da feature
Medição remendada depois sempre fica incompleta. A regra que funciona: feature sem evento não está pronta. O critério de aceite inclui "o evento X dispara com os parâmetros Y", e o review confere.
Na prática, centralizo o rastreamento num único composable ou serviço, para que nenhum componente fale direto com o gtag:
export function useTracking() {
const consent = useConsent()
function track(event: TrackingEvent, params: Record<string, string | number> = {}) {
// Sem consentimento para medição, nada sai do navegador
if (!consent.value.analytics) return
window.gtag?.('event', event, params)
}
return { track }
}
Isso dá três coisas: um único lugar para respeitar o consentimento, um tipo (TrackingEvent) que impede nomes inventados e um ponto para trocar de ferramenta no futuro sem caçar chamadas pelo código.
Consentimento não é detalhe
Com a LGPD (e o GDPR, se você atende a Europa), medição e consentimento andam juntos. O desenho que costumo propor:
- Cookies necessários sempre ativos (sessão, preferências);
- Medição (GA4) e marketing (pixels de anúncio) como categorias separadas, cada uma com base legal definida e escolha registrada;
- Um banner claro, com aceitar, recusar e personalizar no mesmo nível, sem botão escondido;
- A escolha guardada num cookie próprio e um link permanente, no rodapé, para revisar as preferências;
- Uma política de cookies que diz em português claro o que é coletado e por quê.
Valide antes de confiar
Antes de usar um número para decidir, confira:
- O evento aparece no DebugView do GA4 com os parâmetros certos?
- Os parâmetros importantes estão registrados como dimensões personalizadas?
- O volume bate com outra fonte (banco de dados, Stripe, CRM) numa ordem de grandeza razoável?
- Quem recusou o consentimento realmente não envia nada?
Resumo
Um bom plano de medição cabe numa página: as decisões, as perguntas, o dicionário de eventos e as regras de consentimento. Ele custa uma tarde no começo e economiza meses de dados em que ninguém confia. E tem um efeito colateral bonito: obriga produto, engenharia e marketing a combinarem, antes de construir, o que "dar certo" quer dizer.
Murilo Anzini
Engenheiro de software com cabeça de produto, olho de dados e repertório de marketing. Analiso, crio e evoluo a jornada completa de um produto e da empresa por trás dele.
North Star sem vaidade: como escolher a métrica que realmente orienta o produto
Usuários cadastrados, pageviews e downloads fazem gráficos bonitos e decisões ruins. Um roteiro para escolher a métrica que importa e montar a árvore que liga o trabalho do time a ela.
Meta Ads ou Google Ads? A pergunta certa é: a demanda já existe?
Comparar plataformas de anúncio por custo por clique é comparar ferramentas de trabalhos diferentes. Uma forma mais útil de decidir: capturar demanda ou criar demanda.