# > # Do plano de tracking à conversão comprovada: como combinar analytics, webapp-testing, conversion-tracking e attribution - Tipo: Artigo - Autor: Dionatha Rodrigues - Publicado em: 2026-11-03 · Atualizado em: 2026-11-03 - URL: https://clubmartech.com.br/blog/do-plano-de-tracking-a-conversao/ Se você já viveu a frustração de ligar uma campanha milionária de tráfego pago na segunda-feira e descobrir na quarta-feira que o formulário de captura estava quebrado no Safari, que a tag do Google Ads disparava no clique do botão em vez do envio real ou que os relatórios do Meta e do GA4 apresentavam números completamente irreconciliáveis, você sentiu na pele o custo da falta de validação técnica. Neste tutorial prático, a gente vai ensinar você a implementar uma esteira de QA e mensuração ponta a ponta com 4 skills de código aberto. Você verá como criar um plano de taxonomia e UTMs padronizado, automatizar testes funcionais de formulários e páginas com navegadores headless (Playwright), auditar e comprovar a chegada física das conversões aos destinos e interpretar relatórios de atribuição multicanal com base em evidências defensáveis. --- ## O resultado final: o que essa esteira entrega na prática Em vez de torcer para que os dados cheguem corretos após o lançamento, essa esteira valida cada elo da cadeia antes de gastar qualquer verba: ``` +-----------------------------------------------------------------------------------------+ | Fluxo de Entrega da Cadeia | +-----------------------------------------------------------------------------------------+ | | | 1. Contrato de Dados (analytics): Dicionário de eventos, parâmetros e padrão de UTMs | | 2. QA Técnico (webapp-testing): Robô de teste Playwright preenchendo formulários | | 3. Validação de Chegada (conversion-tracking): Comprovação de que o pixel registrou | | a conversão real (sem contar cliques vazios como leads gerados) | | 4. Reconciliação (attribution): Comparação de modelos de primeiro clique, último | | clique e data-driven para entender o retorno real de cada canal de aquisição | | | +-----------------------------------------------------------------------------------------+ ``` Você elimina suposições e garante que toda a sua equipe de marketing tome decisões sobre números limpos, auditados e comparáveis. --- ## Pré-requisitos técnicos Para executar este fluxo no seu ambiente: - **Terminal de agentes de IA:** Claude Code, OpenAI Codex ou Google Antigravity instalado. - **Node.js (v18+) instalado:** Para rodar o Playwright e o instalador de skills. - **Instalador de skills universal:** O utilitário `skills` instalado globalmente (`npm install -g skills`). - **Navegador Playwright instalado:** Executar `npx playwright install` para permitir testes automatizados de ponta a ponta. - **Ambiente local ou staging:** URL da landing page rodando localmente (ex.: `http://localhost:3000`) ou em ambiente de homologação protegido. --- ## O passo a passo: conectando as 4 etapas da esteira ``` +-----------------------------------------------------------------------------------------+ | Arquitetura de QA e Atribuição Passo a Passo | +-----------------------------------------------------------------------------------------+ | | | [ analytics ] ---> Definição de eventos, parâmetros e taxonomia de UTMs | | | | | v | | [ webapp-testing ] ---> Teste funcional com Playwright (campos, erros e sucesso) | | | | | v | | [conversion-track.] ---> Auditoria de disparo do pixel e eliminação de duplicidades | | | | | v | | [ attribution ] ---> Reconciliação entre CRM, analytics e plataformas de mídia | | | +-----------------------------------------------------------------------------------------+ ``` --- ### Passo 1: Definir o contrato de rastreamento com analytics Antes de tocar em qualquer código ou configurar tags, você precisa de um documento que estabeleça as regras do jogo: quais eventos existem, quando eles devem disparar e qual é o padrão rigoroso de nomenclatura de UTMs que todos os canais devem obedecer. - **O que faz:** Cria a taxonomia oficial de eventos para o GA4 e plataformas de mídia, detalhando parâmetros obrigatórios (como `form_id`, `campaign_id` e `lead_type`) e padronizando a estrutura de links rastreados para evitar tráfego marcado como *Unassigned*. - **Repositório GitHub:** [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills/tree/main/skills/analytics) - **Licença:** MIT (mantido por Corey Haines) - **Como instalar:** `bash npx skills add coreyhaines31/marketingskills --skill analytics` - **Prompt para execução:** > "Desenvolva o plano de mensuração completo para a nossa campanha de captura de leads. Defina o evento de conversão do formulário, os parâmetros que devem acompanhar o disparo e a regra rigorosa de nomenclatura de UTMs (letras minúsculas, hífens para separação de palavras e canais autorizados)." - **Saída esperada:** Arquivo `tracking-plan.md` contendo a matriz de eventos, dicionário de variáveis e o gerador de URLs padronizadas para a equipe de mídia. --- ### Passo 2: Executar o teste funcional com webapp-testing De nada adianta ter um plano de eventos perfeito se o formulário travar no envio quando o usuário digitar um telefone com DDD ou se a tela de confirmação não abrir. A skill `webapp-testing` usa o framework Playwright para simular o comportamento de um usuário real no navegador. - **O que faz:** Abre uma instância headless do navegador, acessa a página de destino, testa campos obrigatórios, preenche dados válidos e inválidos, captura prints de tela e inspeciona se houve erros no console do navegador ou falhas de requisição de rede (erros 400 ou 500). - **Repositório GitHub:** [anthropics/skills](https://github.com/anthropics/skills/tree/main/skills/webapp-testing) - **Licença:** Apache-2.0 (mantido pela Anthropic) - **Como instalar:** `bash npx skills add anthropics/skills --skill webapp-testing` - **Prompt para execução:** > "Execute um teste funcional com Playwright na nossa landing page local `http://localhost:3000/inscricao`. Simule o preenchimento de um e-mail inválido para checar a mensagem de erro e depois submeta um cadastro com dados válidos, capturando o print da tela de sucesso." - **Saída esperada:** Relatório de execução técnica com capturas de tela das etapas, registro de tempo de resposta da submissão e confirmação de que a resposta HTTP retornou status 200 (sucesso). --- ### Passo 3: Auditar a recepção de conversão com conversion-tracking O formulário funcionou, mas a tag disparou corretamente? Um dos erros mais perigosos em Marketing Ops é configurar a tag no evento de clique do botão (`click_button`), fazendo com que qualquer tentativa de envio — mesmo com campos incorretos — seja computada como um lead no Google Ads. - **O que faz:** Inspeciona as requisições de rede enviadas aos endpoints de coleta de dados (Google, Meta, LinkedIn), garantindo que a conversão seja disparada estritamente após a confirmação do servidor (`lead_success`) e eliminando duplicidades de envio. - **Repositório GitHub:** [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills/tree/main/skills/conversion-tracking) - **Licença:** MIT (mantido por Corey Haines) - **Como instalar:** `bash npx skills add coreyhaines31/marketingskills --skill conversion-tracking` - **Prompt para execução:** > "Inspecione os envios de rede durante o teste do formulário do Passo 2. Verifique se o evento de conversão do Meta Pixel e do Google Ads disparou apenas após a validação do backend e comprove se os parâmetros de identificação única foram anexados à carga útil (payload)." - **Saída esperada:** Diagnóstico comprovando que a tag dispara no momento correto com relatório dos identificadores enviados, ou alerta apontando que cliques sem submissão válida estavam inflando a contagem de conversões. --- ### Passo 4: Reconciliar a atribuição de canais com attribution Após o lançamento da campanha e o início do recebimento de leads, surge o dilema inevitável: o Gerenciador de Anúncios do Meta diz que gerou 80 leads, o Google Ads afirma que foi responsável por 50, e o CRM registra apenas 100 contatos únicos no total. A skill `attribution` reconcilia essas divergências. - **O que faz:** Compara modelos de atribuição (primeiro clique, último clique, decaimento linear e atribuição baseada em dados), avalia janelas de conversão (1 dia vs 7 dias) e constrói uma leitura defensável que separa canais de atração de canais de conversão final. - **Repositório GitHub:** [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills/tree/main/skills/attribution) - **Licença:** MIT (mantido por Corey Haines) - **Como instalar:** `bash npx skills add coreyhaines31/marketingskills --skill attribution` - **Prompt para execução:** > "Compare os relatórios anexados do CRM, GA4 e Meta Ads dos últimos 30 dias. Explique as discrepâncias de volume com base nas janelas de clique e visualização de cada plataforma e proponha uma leitura consolidada de contribuição de canal para a diretoria." - **Saída esperada:** Relatório de reconciliação analítica destacando o papel assistido de cada plataforma (ex.: Meta atuando fortemente no primeiro ponto de contato e Google Search fechando o último clique), eliminando a falsa ilusão de canibalização. --- ## Onde costuma dar errado e como verificar cada passo 1. **Uso de UTMs com maiúsculas e minúsculas misturadas:** O GA4 trata `utm_source=Instagram` e `utm_source=instagram` como duas fontes completamente distintas. Utilize a regra do Passo 1 para forçar o tratamento de strings em caixa baixa antes de publicar links em anúncios. 2. **Formulários que usam iframes fechados:** Se o seu formulário de CRM estiver incorporado via `