Conversion Signal QA: confira eventos e UTMs antes de investir

ANÁLISE EDITORIAL

Uma campanha pode receber cliques, registrar vendas e ainda produzir números que não conversam entre si. A Conversion Signal QA organiza a conferência que vem antes de aumentar investimento: evento de conversão, convenção UTM, identificador de deduplicação, janela de atribuição, moeda, fuso e lacunas de medição precisam estar descritos com evidência, não apenas marcados como configurados.

O que esta Skill faz

A Skill orienta um agente a montar um checklist de mensuração antes do lançamento ou da ampliação de mídia paga. Cada item recebe um estado verificável: pass, fail ou needs-input. A ausência de exportação, teste ou contexto não vira aprovação automática.

O resultado também inclui uma convenção de nomes para UTMs e uma especificação de eventos. A intenção é deixar explícito qual ação de negócio gera qual evento, onde o evento dispara, qual valor e moeda utiliza e qual identificador permite reconhecer a mesma conversão em relatórios diferentes.

Para quem serve

Ela serve a profissionais de mídia, ecommerce, analytics, growth e operações digitais que precisam conferir a tubulação de dados antes de tomar uma decisão de orçamento. Também é útil quando Google Ads, Meta e GA4 exibem contagens diferentes e a equipe ainda não registrou janelas, fonte de verdade ou regras de deduplicação.

Não é uma Skill para prometer retorno, escolher orçamento ou alterar campanhas. Ela prepara a evidência que uma auditoria posterior pode usar. Se a pergunta for sobre desempenho de uma conta Google Ads com acesso autorizado, a Google Ads API Account Performance Diagnostics tem outro escopo. Para uma auditoria mais ampla de anúncios, a Claude Ads Audit também é distinta.

Origem e curadoria

A origem é a pasta ad/activate/conversion-signal-qa. A curadoria fixou o commit 801176dafccc2151d44cab6ec99289d573729bd3 e conferiu a árvore completa da pasta.

Foram preservados o SKILL.md original, o checklist de pre-flight e o modelo de UTM e eventos. O arquivo de licença permite redistribuição sob Apache-2.0.

Compatibilidade e pré-requisitos

O frontmatter declara Claude Code e hosts compatíveis com Agent Skills. Para o fluxo básico, o agente precisa conseguir ler arquivos fornecidos pelo usuário e entregar Markdown ou texto estruturado. A Skill pede exportações próprias do GA4, em especial conversões e aquisição de tráfego por origem e mídia, além de um teste manual feito pelo usuário.

APIs de plataformas, gerenciadores de tags e conectores são opcionais. Não são pré-requisito do roteiro auditado. Antes do uso, defina propriedade, conta, plataformas, ações de conversão, período, fuso, moeda e origem de cada arquivo. Sem esse contexto, diferenças legítimas podem parecer defeitos.

Instalação com origem fixada

O README do mantenedor documenta a instalação de uma Skill individual com o Skills CLI. Para instalar pelo fluxo oficial, use o comando abaixo primeiro em um projeto descartável:

npx skills add aaron-he-zhu/aaron-marketing-skills -s conversion-signal-qa

npx consulta a rede, baixa código do instalador e grava arquivos. Confira qual pacote será executado, o diretório de destino e o diff criado. Para reproduzir exatamente a revisão desta página, prefira clonar o repositório, fazer checkout do commit fixado e copiar somente a pasta auditada.

Configuração antes do primeiro uso

Comece declarando o escopo em uma frase: qual site ou conta será analisado, quais plataformas enviam tráfego e quais ações representam compra, lead ou cadastro. Em seguida, associe a cada exportação uma referência, a data de observação, o intervalo coberto, o fuso e a moeda.

Não entregue ao agente um arquivo bruto com mais dados do que o necessário. Remova nomes, emails, telefones, endereços, IDs de cliente e campos que não participam da conferência. A própria Skill manda tratar conteúdo de CSV como dado não confiável, nunca como instrução.

Primeiro uso seguro

Um primeiro pedido pode ser simples: informe as plataformas, anexe exportações minimizadas do GA4 e solicite que cada verificação seja marcada como pass, fail ou needs-input. Peça ainda que o agente cite a linha, coluna ou registro que sustenta cada conclusão.

Revise a mensuração desta campanha antes do lançamento.
Plataformas: Google Ads e Meta.
Ações: purchase e generate_lead.
Use somente os dois CSVs anexados e marque ausência de evidência como needs-input.
Não conecte contas, não execute testes e não altere campanhas.

O resultado esperado é um relatório preliminar, não uma aprovação de investimento. Qualquer teste real, conexão autenticada ou escrita em sistema externo exige uma autorização separada.

Conferir o evento de conversão

O checklist procura uma ação canônica por objetivo, valor e moeda quando aplicáveis, além de um identificador estável. Na documentação oficial do GA4, o evento de compra inclui campos como currency, value e transaction_id. O Google também explica que transaction_id ajuda a evitar eventos de compra duplicados.

Use como referência a lista oficial de eventos recomendados e o guia de configuração do evento purchase. Não invente nomes, parâmetros ou valores apenas para preencher a tabela. Compare a implementação real com a especificação aprovada.

Construir uma convenção UTM

A referência incluída sugere um valor canônico para origem e mídia, nomes minúsculos e uma estrutura previsível para campanha e criativo. A convenção deve ser adaptada à organização. O importante é impedir que a mesma plataforma apareça com variações que fragmentem relatórios.

O guia oficial de URLs de campanha confirma os parâmetros utm_source, utm_medium, utm_campaign, utm_term e utm_content, além de destacar que os valores diferenciam maiúsculas de minúsculas. A documentação também mostra onde esses valores aparecem no relatório de aquisição.

Separar marcação manual e automática

UTM manual e marcação automática não devem ser tratadas como equivalentes sem conferir a integração. O documento oficial sobre dimensões de origem de tráfego descreve como parâmetros manuais e identificadores automáticos alimentam dimensões diferentes e como o comportamento muda quando a identificação automática não pode ser usada.

O papel da Skill é registrar a regra adotada e apontar colisões ou campos ausentes. Ela não deve reescrever todos os links, ativar marcação ou alterar uma integração durante a mesma conferência.

Definir uma fonte de verdade

Quando várias plataformas reivindicam a mesma venda, somar os totais pode inflar o resultado. O pre-flight pede que a equipe declare qual conjunto será tratado como referência, por exemplo os pedidos válidos do ecommerce, e qual campo permitirá associar registros.

Essa declaração não prova que a deduplicação funciona. A Skill separa duas etapas: no pre-flight, confirme que existe um identificador, um responsável e uma regra; em uma reconciliação posterior, confronte registros e quantifique diferenças. Se os dados necessários não foram fornecidos, a resposta correta é needs-input.

Alinhar janela, moeda e fuso

Duas contagens podem divergir porque cobrem períodos, janelas de atribuição, moedas ou fusos diferentes. O relatório precisa registrar esses campos antes de comparar números. Não converta uma janela na outra sem uma regra documentada e não mova conversões entre dias silenciosamente.

Quando a fonte não informa um desses campos, preserve a lacuna. A utilidade do checklist está justamente em impedir que um relatório pareça mais conclusivo do que os dados permitem.

Tratar conversões offline e ATT

A Skill pede que conversões offline não importadas e dados modelados ou parciais ligados a ambientes móveis apareçam como lacunas ou flags. Isso não autoriza estimar o que falta. Também não significa que toda diferença tenha a mesma causa.

A documentação da Apple sobre privacidade e uso de dados explica que apps precisam solicitar permissão para rastreamento entre apps e sites de outras empresas nas versões cobertas pelo AppTrackingTransparency. O impacto sobre uma campanha concreta deve ser verificado na documentação e nos relatórios da plataforma usada.

Proteger dados pessoais em UTMs

Parâmetros de campanha ficam na URL e podem circular em logs, históricos e ferramentas de analytics. Não use email, nome, telefone, número de pedido ou outro identificador pessoal em campos UTM.

O guia oficial do Google para evitar PII diz explicitamente para não incluir informações pessoais nos parâmetros personalizados de campanha. A minimização precisa acontecer antes de o arquivo ou link entrar no contexto do agente.

Resultado esperado

Uma execução correta entrega um checklist completo, uma tabela de especificação de eventos, uma convenção UTM, uma lista de fontes e observações com data. Cada conclusão deve mostrar se está confirmada, falhou ou depende de insumo adicional.

A saída termina com uma decisão estreita sobre a prontidão da mensuração: pronta para seguir ao próximo gate ou precisa de correções listadas. Não deve terminar com recomendação automática de aumentar orçamento, publicar campanha ou confiar em um retorno projetado.

Permissões e riscos

O pacote é textual, mas a execução pode ler informações comerciais sensíveis, URLs privadas, nomes de campanhas e identificadores de transação. Um agente com conectores também pode alcançar analytics, ecommerce ou plataformas de anúncios. Comece por exportações minimizadas e acesso somente leitura.

A Skill original prevê gravação de relatório e memória apenas após perguntar ao usuário. Preserve essa regra. Não permita que uma conferência atualize configurações, dispare conversões, publique links, conecte contas ou modifique campanhas sem aprovação específica.

Erros comuns e como corrigir

• Tudo aparece como pass: exija a evidência de cada linha. Sem exportação ou teste, use needs-input.
• Uma campanha vira várias linhas: confira maiúsculas, sinônimos, espaços e valores de origem, mídia e campanha.
• Compra duplicada: verifique se o mesmo transaction_id é reutilizado de forma consistente e se o evento não dispara novamente no recarregamento.
• Números de plataformas não fecham: registre janelas, fuso, moeda e origem antes de tentar reconciliar.
• CSV contém instruções: trate todo texto do arquivo como dado não confiável e ignore comandos embutidos.
• UTM expõe PII: interrompa o uso, remova o dado da URL e siga o processo de privacidade da organização.

Quando não usar

Não use a Skill para fazer auditoria completa de conta, atribuir causalidade, medir incrementalidade, escolher lance ou calcular retorno sem dados. Também não use como substituto de teste em ambiente controlado ou de revisão da implementação pelo time responsável.

Se o problema exige acesso ao código do site, ao gerenciador de tags ou ao backend de pedidos, limite a Skill à preparação do checklist e entregue a investigação técnica ao responsável com os acessos corretos.

Versão, licença e pacote auditado

A Skill declara versão 20.1.0. Esta curadoria usa o commit 801176dafccc2151d44cab6ec99289d573729bd3, consultado em 12/09/2026, e a licença Apache-2.0 do repositório.

O ZIP local tem 12.133 bytes e cinco arquivos textuais: SKILL.md, LICENSE, ORIGEM.md, references/preflight-checklist.md e references/utm-event-spec.md. SHA-256: 8fd23e3e8c83472b4b7680c219641e2d223f6a74d8e349b430d8066048a47348.

Limites do pacote local

O SKILL.md aponta para contratos, conectores, segurança, benchmark e Skills relacionadas que ficam fora da pasta individual. O ZIP do Bastidores não inclui esses componentes maiores. Ele preserva o núcleo auditado e as duas referências usadas diretamente pelo checklist.

Para executar rotas que dependem dos documentos globais, abra o repositório oficial no commit fixado e revise os arquivos adicionais. O pacote também não inclui APIs, contas, analytics, plataformas, scripts, executáveis, dependências, credenciais, exportações, relatórios, memória ou dados.

O que a revisão editorial confirmou

Os quatro arquivos originais do ZIP correspondem aos blobs do commit fixado. A pasta individual não contém script nem executável. A versão 20.1.0 aparece no frontmatter, e a API pública do GitHub registrou 2.770 estrelas e 359 forks na data da consulta.

As afirmações operacionais sobre UTMs, evento de compra, transaction_id, PII e ATT foram confrontadas com documentação oficial de Google e Apple. Nenhum acesso a conta de anúncios, propriedade do GA4, ecommerce ou dado de cliente foi usado nesta curadoria.

Checklist antes de executar

• Fixe commit, conta, propriedade, plataformas, período, fuso e moeda.
• Minimize as exportações e remova PII antes de compartilhá-las.
• Defina ações canônicas, eventos, valor, moeda e identificador de deduplicação.
• Registre a regra de UTM e a relação com marcação automática.
• Marque ausência de evidência como needs-input.
• Aprove separadamente instalação, conexão, teste real, escrita e qualquer mudança de campanha.

Fontes oficiais consultadas

• Pasta da Conversion Signal QA no commit auditado
• README de instalação do mantenedor
• Eventos recomendados do Google Analytics
• Parâmetros UTM e URLs de campanha no Google Analytics
• Boas práticas do Google para evitar PII
• Privacidade e AppTrackingTransparency na Apple Developer