---
name: plano-de-mensuracao-ga4
description: >-
  Monta o plano de mensuração de um site ou app no GA4: traduz objetivos de negócio em KPIs, KPIs
  em eventos e cada evento em parâmetros, gatilho, responsável e local de implementação, com
  convenção de nomes, eventos-chave (conversões), dimensões personalizadas e checklist de
  validação. Use quando pedirem plano de mensuração, plano de tagueamento, quais eventos
  rastrear, configurar conversões no GA4, camada de dados (dataLayer) ou implementação de
  analytics.
license: MIT
metadata:
  conecto-area: analytics
  conecto-tools: ga4, google-tag-manager
  conecto-version: "1.0.0"
  conecto-author: Ecto
---

# Plano de mensuração no GA4

## Quando usar

Use quando a pergunta é **"o que medir e como"** antes de mexer em tag: site novo, redesign,
propriedade do GA4 que só tem os eventos automáticos, ou time que não confia no que está
configurado. Não use para ler relatórios nem para auditar um contêiner que já existe (para isso
há a skill `auditoria-de-tags-gtm`): aqui se decide o que precisa existir, não se confere o que
existe.

## O que você precisa

1. **Objetivos do negócio** em ordem de prioridade e a conversão principal de cada um (venda,
   lead, cadastro, agendamento). Até 3 objetivos; mais que isso ninguém mede.
2. **Mapa do funil no site**: as páginas ou telas por onde a pessoa passa até converter, e o
   que acontece depois (página de obrigado, e-mail, redirecionamento).
3. **Quem implementa e onde**: desenvolvedor no código, analista no Google Tag Manager,
   plugin da plataforma. O plano muda de forma conforme a resposta.
4. **Situação de consentimento**: existe banner de cookies, o que ele bloqueia, se o Modo de
   consentimento está ativo. Sem isso, parte dos eventos não chega e o plano precisa dizer isso.
5. **O que já existe**: exportação da lista de eventos e das dimensões personalizadas em
   Administrador, se a propriedade já roda. Não se apaga histórico sem saber o que ele mede.

## Passo a passo

1. **Traduza cada objetivo em 1 ou 2 KPIs** com definição escrita: "leads qualificados por
   mês = envios do formulário de contato com o campo empresa preenchido". KPI sem definição vira
   discussão em toda reunião.
2. **Dê um evento a cada KPI**, nesta ordem de preferência: evento coletado automaticamente ou
   de medição aprimorada (page_view, scroll, click, file_download, form_submit, video_start),
   depois evento recomendado do Google (generate_lead, sign_up, purchase, add_to_cart, login,
   search), e só por último evento personalizado. Recomendado alimenta relatórios prontos;
   personalizado precisa de configuração para aparecer.
3. **Defina os parâmetros de cada evento**, e só os que vão segmentar análise: método do
   formulário, nome do plano, valor, moeda, categoria. Limites da propriedade padrão: 25
   parâmetros por evento, nome até 40 caracteres, valor de texto até 100, 50 dimensões
   personalizadas de escopo de evento e 25 de escopo de usuário. Nenhum parâmetro leva dado
   pessoal (nome, e-mail, telefone, CPF, endereço), nem na URL da página de obrigado.
4. **Especifique gatilho e local**: em que ação e em que página o evento dispara, uma vez só, e
   por qual caminho (push na camada de dados, clique capturado no GTM, chamada gtag no código).
   Para camada de dados, escreva o contrato: o objeto exato do `dataLayer.push`, com exemplo de
   valores e o momento do disparo (antes ou depois de carregar a página, antes do
   redirecionamento).
5. **Marque os eventos-chave** (as conversões): só os que representam a conversão principal de
   um objetivo, com método de contagem definido (uma vez por evento para compra, uma vez por
   sessão para lead) e valor com moeda quando houver dinheiro. Evento-chave demais dilui o
   relatório de conversões e piora o lance automatizado do Google Ads que usa a importação.
6. **Feche a convenção de nomes**: minúsculas, snake_case, verbo_objeto (`lead_form_submit`,
   `plan_select`), sem acento, espaço ou prefixos reservados (`google_`, `ga_`, `firebase_`).
   O GA4 diferencia maiúsculas: `Lead_Form` e `lead_form` viram dois eventos.
7. **Escreva o plano de validação** por evento: como testar (DebugView, Tag Assistant,
   relatório em tempo real), o que deve aparecer e em que prazo os relatórios padrão refletem
   (24 a 48 horas). Registre dimensão personalizada para cada parâmetro que precisa aparecer
   em relatório; o GA4 não preenche o histórico anterior ao registro.

## Formato da entrega

1. **Resumo**: objetivos, KPIs, total de eventos (automáticos, recomendados, personalizados) e
   total de eventos-chave.
2. **Tabela de mensuração**, uma linha por evento: KPI atendido, nome do evento, tipo,
   gatilho (ação e página), parâmetros com exemplo de valor, evento-chave (sim ou não e método
   de contagem), quem implementa, como, status (existe, ajustar, criar).
3. **Contrato da camada de dados**: um bloco de código por evento personalizado, com o
   momento do disparo escrito acima do bloco.
4. **Dimensões e métricas personalizadas** a registrar: nome de exibição, escopo, parâmetro.
5. **Checklist de validação**: evento, como testar, resultado esperado, data do teste, quem.
6. **Pendências e riscos**: consentimento, páginas fora do domínio, redirecionamentos,
   iframes de terceiros, apps.

## Critérios de qualidade

- Todo KPI tem pelo menos um evento; todo evento atende a um KPI ou explica por que existe.
- Todo evento personalizado tem uma frase dizendo por que nenhum automático ou recomendado
  serve.
- Nenhum parâmetro carrega dado pessoal, e a URL da página de obrigado foi conferida.
- Até 30 eventos no total para um site institucional ou de geração de leads; e-commerce pode
  passar disso só com os eventos recomendados de comércio.
- Os blocos de camada de dados são objetos válidos, com os mesmos nomes da tabela.
- Todos os nomes passam pela convenção do passo 6.

## Armadilhas

- Medir tudo "para depois ver": o relatório fica ilegível e ninguém acha a conversão.
- Duplicar o que a medição aprimorada já faz: um evento de clique para cada botão quando o
  `click` automático com parâmetro resolve.
- Deixar o `form_submit` automático como conversão: ele dispara em qualquer formulário,
  inclusive na caixa de busca e na newsletter do rodapé.
- Renomear evento depois que o dado começou a entrar: o GA4 não reprocessa e a série quebra.
- Esquecer moeda em evento com valor: o relatório mostra zero de receita ou soma moedas
  diferentes.
- Não filtrar tráfego interno e depois "testar" em produção: cada teste vira conversão.
- Ignorar o consentimento no plano: sem Modo de consentimento, a parte da base que recusa
  cookies some do relatório e a conversão parece menor do que é.