Plano de mensuração no GA4
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.
Instalar
Escolha o agente. O comando coloca a skill na pasta de usuário, válida em todos os seus projetos.
npx @conecto.cc/cli add plano-de-mensuracao-ga4~/.claude/skills/plano-de-mensuracao-ga4/ e cole o arquivo como SKILL.md.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
- 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.
- 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).
- Quem implementa e onde: desenvolvedor no código, analista no Google Tag Manager, plugin da plataforma. O plano muda de forma conforme a resposta.
- 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.
- 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
- 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.
- 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.
- 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.
- 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). - 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.
- 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_Formelead_formviram dois eventos. - 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
- Resumo: objetivos, KPIs, total de eventos (automáticos, recomendados, personalizados) e total de eventos-chave.
- 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).
- Contrato da camada de dados: um bloco de código por evento personalizado, com o momento do disparo escrito acima do bloco.
- Dimensões e métricas personalizadas a registrar: nome de exibição, escopo, parâmetro.
- Checklist de validação: evento, como testar, resultado esperado, data do teste, quem.
- 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
clickautomático com parâmetro resolve. - Deixar o
form_submitautomá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 é.