--- name: ads description: "Auditoria e otimização de Meta Ads (Facebook, Instagram, Threads). Analisa Pixel/CAPI, diversidade de criativos e risco de Entity-ID clustering (Andromeda + GEM + Lattice), estrutura de conta, Advantage+, fase de aprendizado e segmentação. Inclui tracking server-side, atribuição, budget/bidding, PPC math, A/B test e geração de criativos por IA." argument-hint: "audit | meta | creative | tracking | attribution | landing | budget | plan | competitor | math | test | report | dna | create | generate | photoshoot" license: MIT tested_date: 2026-05-17 tested_with: claude-code v2.x --- # 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 ` | 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 ` | 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 ` → `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)