Ads

Ads: Auditoria & Otimização de Meta Ads

Análise completa de contas de Meta Ads (Facebook, Instagram, Threads) e das camadas que sustentam a performance no ecossistema Meta: tracking server-side, atribuição, budget, criativos e planejamento. Orquestra 14 sub-skills e 7 agentes.

Referência Rápida

Comando	O que faz
/ads audit	Auditoria completa de Meta Ads com agentes em paralelo (Meta + criativo + tracking)
/ads meta	Análise profunda de Meta Ads (FB, IG, Threads, Advantage+, Andromeda + GEM + Lattice)
/ads creative	Auditoria de qualidade de criativos + scoring de retrieval por Entity-ID
/ads tracking	Auditoria da pipeline de tracking server-side (sGTM, CAPI Gateway, dedup, hit ratio)
/ads attribution	Auditoria de atribuição (janelas Meta 7d-click/1d-view, GA4, Consent Mode V2, MMP)
/ads landing	Avaliação de qualidade de landing page para campanhas
/ads budget	Revisão de alocação de budget e estratégia de lance
/ads plan <tipo>	Plano estratégico de Meta Ads com templates por indústria
/ads competitor	Inteligência competitiva de anúncios (Meta Ad Library)
/ads math	Calculadora financeira de PPC (CPA, ROAS, break-even, LTV:CAC)
/ads test	Design de A/B test (hipótese, significância, duração, tamanho de amostra)
/ads report	Geração de relatório em PDF para entrega ao cliente
/ads dna <url>	Extrai o DNA da marca de um site → brand-profile.json
/ads create	Gera conceitos de campanha + briefs de copy → campaign-brief.md
/ads generate	Gera imagens de anúncio por IA a partir do brief → ad-assets/
/ads photoshoot	Fotografia de produto em 5 estilos (Studio, Floating, Ingredient, In Use, Lifestyle)

Context Intake (Obrigatório: fazer primeiro)

Antes de qualquer auditoria ou análise, colete este contexto. Sem ele, os benchmarks ficam genéricos e as recomendações podem ficar erradas para a situação do usuário.

Faça estas perguntas de cara (combine em uma mensagem só):

1. Indústria / tipo de negócio: qual descreve melhor? SaaS · E-commerce · Serviço Local · B2B · Info Produtos · App Mobile · Imobiliário · Saúde · Finanças · Agência · Outro
2. Investimento mensal em Meta Ads: budget total (aproximado tudo bem)
3. Objetivo principal: Vendas/Receita · Leads/Demos · Instalações de App · Ligações · Marca
4. Contas/ativos: BM, conta de anúncios, Pixel/Dataset e páginas ativas

Se o usuário já traz dados ("audita meu Meta Ads, gasto R$ 5k/mês em SaaS"), extraia o contexto disso e siga sem re-perguntar.

Use o contexto para:

• Selecionar os benchmarks corretos em references/benchmarks.md
• Aplicar recomendações compatíveis com o budget (ex.: fase de aprendizado exige volume mínimo de conversões)
• Calibrar a severidade do scoring (uma conta de R$ 500/mês tem prioridades diferentes de R$ 50k/mês)

Framework de Pensamento (10 princípios)

Todo comando desta skill opera sob uma disciplina de pensamento compartilhada: OBSERVE × 2 (Externo + Interno) → LISTEN → THINK → CONNECT × 2 (Lateral + Sistêmico) → FEEL → ACCEPT → CREATE → GROW.

Antes de produzir qualquer auditoria, plano ou criativo, carregue references/thinking-framework.md e deixe-o moldar a análise — não como checklist, mas como um portão de mentalidade. É o que separa um relatório de números de uma entrega estratégica.

Lógica de Orquestração

Quando o usuário chama /ads audit, delegue a subagentes em paralelo:

1. Colete o contexto (ver Context Intake acima; faça isso primeiro)
2. Colete dados da conta (exports, screenshots ou métricas coladas)
3. Detecte o tipo de negócio
4. Dispare subagentes via Task tool com context: fork: audit-meta, audit-creative, audit-tracking
5. Valide: confirme que cada subagente retornou JSON válido com os campos exigidos antes de agregar
6. Colete os resultados e gere o relatório unificado com o Ads Health Score (0-100)
7. Monte o plano de ação priorizado com Quick Wins

Para comandos individuais (/ads meta, /ads tracking, /ads attribution etc.), carregue a sub-skill relevante diretamente. Ainda assim colete o contexto primeiro se ele não tiver sido fornecido.

Fluxo de Criativos

Pipeline sequencial (cada passo roda de forma independente):

1. /ads dna <url> → brand-profile.json no diretório atual
2. /ads create → lê o profile + resultados de auditoria opcionais → campaign-brief.md
3. /ads generate → lê o brief + profile → diretório ad-assets/
4. /ads photoshoot → standalone ou lê o profile para injeção de estilo

Requer GOOGLE_API_KEY (Gemini padrão) ou ADS_IMAGE_PROVIDER + chave correspondente. Se a chave estiver ausente, /ads generate e /ads photoshoot exibem as instruções de setup e encerram; nunca falham em silêncio.

Detecção de Indústria

Detecte o tipo de negócio pelos sinais da conta:

• SaaS: eventos de trial/demo, targeting de página de preços, janelas de atribuição longas
• E-commerce: eventos de compra, catálogo de produtos, campanhas Advantage+ Shopping
• Serviço Local: extensões de ligação, targeting por localização, eventos de rota
• B2B: listas ABM, tolerância a CPA alto, ciclo de venda longo
• Info Produtos: funis de webinar/curso, formulários de lead, ofertas de baixo ticket
• App Mobile: campanhas de instalação, eventos in-app, deep linking
• Imobiliário: feeds de listagem, landing pages por imóvel, targeting geo-pesado
• Saúde / Finanças: Categorias Especiais de Anúncio declaradas, compliance específico

Quality Gates

Regras rígidas (nunca violar):

• 3x Kill Rule: sinalize qualquer ad set/campanha com CPA >3x a meta para pausa
• Suficiência de budget: Meta ≥5x CPA por ad set
• Fase de aprendizado: nunca recomende edições durante a fase de aprendizado ativa
• Compliance: sempre cheque Categorias Especiais para habitação/emprego/crédito/finanças
• Atribuição: padrão 7 dias clique / 1 dia visualização (Meta)
• Diversidade de criativos (Andromeda): sinalize contas Meta com <10 criativos genuinamente distintos
• Portão de infraestrutura de privacidade: sempre verifique o stack de tracking (Consent Mode V2, CAPI, Events API) antes de recomendar otimizações
• Portão de qualidade do PDF: ao gerar relatórios via /ads report, use sempre scripts/generate_report.py com --check antes de --output e corrija os warnings antes de entregar

Arquivos de Referência

Carregue sob demanda; NÃO carregue tudo no startup.

Resolução de path: as referências ficam no diretório references/ desta skill, ao lado deste SKILL.md. Quando sub-skills ou agentes citarem ads/references/*.md, resolva para o arquivo correspondente nessa pasta references/ local.

• references/thinking-framework.md: Framework de 10 princípios — carregue antes de qualquer auditoria, plano ou criativo
• references/scoring-system.md: Algoritmo de scoring ponderado e limiares de nota
• references/benchmarks.md: Benchmarks por indústria (CPC, CTR, CVR, ROAS)
• references/bidding-strategies.md: Árvores de decisão de lance
• references/budget-allocation.md: Regras de escala e MER
• references/platform-specs.md: Especificações de criativo
• references/conversion-tracking.md: Pixel, CAPI, EMQ, implementação
• references/compliance.md: Requisitos regulatórios, políticas de anúncio, privacidade
• references/meta-audit.md: Checklist de auditoria de Meta Ads (50 checks — M01-M40 + 10 checks v1.5+)
• references/meta-creative-specs.md: Specs de Feed/Reels/Stories + safe zones
• references/brand-dna-template.md: Schema e guia de extração do DNA da marca
• references/image-providers.md: Config de provedores (Gemini/OpenAI/Stability/Replicate)
• references/voice-to-style.md: Mapeamento de voz da marca → atributo visual para geração de imagem
• references/copy-frameworks.md: Frameworks de copy (AIDA, PAS, BAB, 4P, FAB, Star-Story-Solution)
• references/mcp-integration.md: Integração via MCP para acesso a dados de conta

Metodologia de Scoring

Ads Health Score (0-100)

Score usando o algoritmo ponderado de references/scoring-system.md.

Notas

Nota	Score	Ação necessária
A	90-100	Só otimizações menores
B	75-89	Algumas oportunidades de melhoria
C	60-74	Problemas relevantes a tratar
D	40-59	Problemas significativos presentes
F	<40	Intervenção urgente

Níveis de Prioridade

• Crítico: risco de perda de receita/dados (corrigir imediatamente)
• Alto: forte arrasto de performance (corrigir em 7 dias)
• Médio: oportunidade de otimização (corrigir em 30 dias)
• Baixo: boa prática, impacto menor (backlog)

Sub-Skills

Esta skill orquestra 14 sub-skills especializadas:

1. ads-meta: Análise profunda de Meta Ads (FB, IG, Threads, Advantage+, Andromeda + GEM + Lattice)
2. ads-creative: Auditoria de qualidade de criativos + scoring de retrieval por Entity-ID
3. ads-attribution: Auditoria de atribuição (janelas Meta, GA4, Consent Mode V2, MMP, stitching server-side)
4. ads-server-side-tracking: Auditoria da pipeline de tracking server-side (sGTM, CAPI Gateway, dedup, hit ratio, hashing de PII)
5. ads-landing: Qualidade de landing page para campanhas
6. ads-budget: Alocação de budget e estratégia de lance
7. ads-plan: Planejamento estratégico com templates por indústria
8. ads-competitor: Inteligência competitiva de anúncios
9. ads-math: Calculadora financeira de PPC (CPA, ROAS, break-even, LTV:CAC)
10. ads-test: Design de A/B test (hipótese, significância, tamanho de amostra)
11. ads-dna: Extração do DNA da marca a partir de uma URL
12. ads-create: Conceitos de campanha, copy decks, briefs de criativo
13. ads-generate: Geração de imagem por IA com provedores plugáveis
14. ads-photoshoot: Fotografia de produto em 5 estilos profissionais

Subagentes

Para análise em paralelo durante auditorias completas:

• audit-meta: Checks de Meta Ads (M01-M40 + 10 IDs v1.5+ = 50 total; inclui Andromeda + Entity-ID clustering)
• audit-creative: Qualidade de criativos + scoring de diversidade para retrieval por Entity-ID (Andromeda)
• audit-tracking: Saúde do tracking de conversão (Pixel, CAPI, EMQ, dedup)

Para o pipeline de geração de criativos:

• creative-strategist: Conceitos de campanha a partir do brand profile + resultados de auditoria (Opus, maxTurns: 25)
• visual-designer: Geração de imagem com injeção de marca via generate_image.py (Sonnet, maxTurns: 30)
• copy-writer: Headlines, CTAs, texto primário dentro dos limites da plataforma (Sonnet, maxTurns: 20)
• format-adapter: Validação de dimensões de asset e relatório de conformidade de specs (Haiku, maxTurns: 15)