drm-core 1.0.0 → 1.3.0

package/scaffold/.drm-core/templates/estrutura-campanha-template.md

@@ -0,0 +1,492 @@
+---
+# ============================================================
+# ESTRUTURA DE CAMPANHA — Template de Campanha Meta Ads
+# ============================================================
+# Template completo para estruturacao de campanha no Meta Ads.
+# Cobre: conta, campanha, adset, ads, kill rules, test plan,
+# scaling plan.
+#
+tipo: estrutura-campanha
+formato: campanha-meta-ads
+agente_executor: "@analyst | @pm | @dev"
+frameworks_aplicados:
+  - nome: "CBO + ABO Strategy"
+    descricao: "Campaign Budget Optimization vs Ad Set Budget — quando usar cada"
+  - nome: "Testing Framework"
+    descricao: "Estrutura de testes A/B com isolamento de variaveis"
+  - nome: "Scaling Playbook"
+    descricao: "Protocolos de escala horizontal e vertical"
+  - nome: "Kill Rules"
+    descricao: "Regras automaticas de pausa baseadas em metricas"
+
+# --- CONTEXTO ---
+projeto:
+  nome: ""                    # [OBRIGATORIO] Nome do produto/oferta
+  url_destino: ""             # [OBRIGATORIO] URL de destino (LP, checkout, WhatsApp)
+  ticket_medio: ""            # [OBRIGATORIO] AOV — Average Order Value
+  margem_bruta: ""            # [OBRIGATORIO] Margem percentual. Ex: "60%"
+  meta_roas_minimo: ""        # [OBRIGATORIO] ROAS minimo aceitavel. Ex: "2.0"
+  meta_cpa_maximo: ""         # [OBRIGATORIO] CPA maximo aceitavel. Ex: "R$ 200"
+
+# --- VERSAO ---
+versao: "1.0"
+data_criacao: ""
+autor: ""
+status: "rascunho"            # "rascunho | aprovado | ativo | otimizando | pausado | encerrado"
+---
+
+# ESTRUTURA DE CAMPANHA — {{projeto.nome}}
+
+> **Produto:** {{projeto.nome}} | **Ticket:** {{projeto.ticket_medio}}
+> **CPA Max:** {{projeto.meta_cpa_maximo}} | **ROAS Min:** {{projeto.meta_roas_minimo}}
+> **Status:** {{status}}
+
+---
+
+## 1. CONTA DE ANUNCIOS
+
+```
+CONTA:
+ID: [Ex: "act_758149907165106"]
+Nome: [Ex: "CA - MF04 - D3F"]
+Alias (hub): [Ex: "acc_758"]
+Moeda: [BRL | USD]
+Fuso horario: [Ex: "America/Sao_Paulo"]
+Pixel ID: [Ex: "123456789"]
+Pagina vinculada: [Nome + ID da page]
+Instagram vinculado: [@ da conta IG]
+Dominio verificado: [URL do dominio verificado]
+
+STATUS DA CONTA:
+- [ ] Conta ativa e em boa situacao
+- [ ] Pixel instalado e disparando eventos
+- [ ] Conversions API (CAPI) configurada
+- [ ] Dominio verificado
+- [ ] Evento de otimizacao com dados suficientes (min 50 eventos/semana)
+- [ ] Forma de pagamento ativa
+- [ ] Business Manager vinculado
+```
+
+---
+
+## 2. CAMPANHA
+
+```
+NOME DA CAMPANHA: [Nomenclatura padrao. Ex: "[Produto]_[Objetivo]_[Tipo]_[Data]"]
+Exemplo: "MetodoX_Conversao_VSL_2026-05"
+
+OBJETIVO DA CAMPANHA:
+Opcoes Meta:
+- [ ] Vendas (Conversions)
+- [ ] Leads (Lead Generation)
+- [ ] Trafego (Traffic)
+- [ ] Reconhecimento (Awareness)
+- [ ] Engajamento (Engagement)
+- [ ] Promocao do app (App Promotion)
+
+OBJETIVO SELECIONADO: [Ex: "Vendas"]
+EVENTO DE CONVERSAO: [Ex: "Purchase" | "Lead" | "InitiateCheckout"]
+
+TIPO DE ORCAMENTO:
+- [ ] CBO (Campaign Budget Optimization) — recomendado para escala
+- [ ] ABO (Ad Set Budget) — recomendado para testes
+
+ORCAMENTO SELECIONADO: [CBO | ABO]
+
+BUDGET:
+- Diario: R$ [valor]/dia
+- Total do periodo: R$ [valor]
+- Periodo: [data_inicio] a [data_fim | continuo]
+
+ESTRATEGIA DE LANCE (BID):
+- [ ] Menor custo (Lowest Cost) — recomendado para inicio
+- [ ] Limite de custo (Cost Cap) — [valor do cap: R$ X]
+- [ ] Limite de lance (Bid Cap) — [valor do lance: R$ X]
+- [ ] ROAS minimo (Minimum ROAS) — [valor: X.X]
+
+BID SELECIONADO: [tipo + valor se aplicavel]
+
+CONFIGURACOES ESPECIAIS:
+- Advantage Campaign Budget: [on | off]
+- Advantage+ Shopping: [on | off] — se aplicavel
+- Advantage+ Audience: [on | off]
+- Campaign Spending Limit: R$ [valor] ou [sem_limite]
+```
+
+---
+
+## 3. AD SETS (Conjuntos de Anuncios)
+
+> **Instrucoes:** Crie um bloco para cada ad set. Cada ad set deve ter um objetivo claro de teste (publico diferente, placement diferente, etc.)
+
+### Ad Set 1 — [Nome descritivo]
+
+```
+NOME: [Nomenclatura. Ex: "[Campanha]_[Publico]_[Placement]"]
+Exemplo: "MetodoX_LAL1Buyers_AllPlacements"
+
+AUDIENCE (Publico):
+Tipo: [interesse | lookalike | custom_audience | broad | retargeting]
+Descricao: [Detalhe o publico]
+
+  Se INTERESSE:
+    Interesses: [Liste todos. Ex: "Fitness, Emagrecimento, Dieta, Gym"]
+    Exclusoes: [Interesses excluidos]
+
+  Se LOOKALIKE:
+    Seed: [Audiencia base. Ex: "Purchasers 180d"]
+    Percentual: [1% | 2% | 5% | 10%]
+    Pais: [Ex: "Brasil"]
+
+  Se CUSTOM AUDIENCE:
+    Fonte: [Ex: "Website visitors 30d", "Email list", "IG engagers 90d"]
+    Tamanho estimado: [Ex: "15.000 pessoas"]
+
+  Se RETARGETING:
+    Audiencia: [Ex: "Viewed VSL 50%+ sem Purchase, 14d"]
+    Exclusao: [Ex: "Purchasers 180d"]
+
+  Se BROAD:
+    Sem interesses — apenas demografico
+
+DEMOGRAFIA:
+  Idade: [Ex: "25-55"]
+  Genero: [todos | feminino | masculino]
+  Localizacao: [Ex: "Brasil" | "SP, RJ, MG, PR, RS"]
+  Idioma: [Ex: "Portugues"]
+
+PLACEMENT (Posicionamento):
+- [ ] Automatic Placements (Advantage+) — recomendado para inicio
+- [ ] Manual Placements:
+  - [ ] Facebook Feed
+  - [ ] Facebook Reels
+  - [ ] Facebook Stories
+  - [ ] Facebook Right Column
+  - [ ] Instagram Feed
+  - [ ] Instagram Reels
+  - [ ] Instagram Stories
+  - [ ] Instagram Explore
+  - [ ] Audience Network
+  - [ ] Messenger
+
+PLACEMENT SELECIONADO: [automatic | manual + lista]
+
+SCHEDULE (Agendamento):
+  Inicio: [data + hora]
+  Fim: [data + hora | continuo]
+  Dayparting: [sim | nao]
+  Se dayparting, horarios ativos: [Ex: "06h-23h"]
+
+OPTIMIZATION:
+  Evento de otimizacao: [Purchase | Lead | AddToCart | ViewContent]
+  Janela de conversao: [1d click | 7d click | 1d click + 1d view | 7d click + 1d view]
+  Janela selecionada: [Ex: "7d click, 1d view"]
+
+BUDGET (se ABO):
+  Diario: R$ [valor]
+  Bid strategy: [Lowest cost | Cost cap R$ X]
+```
+
+### Ad Set 2 — [Nome descritivo]
+
+```
+[Repita a estrutura acima para cada ad set]
+NOME:
+AUDIENCE:
+DEMOGRAFIA:
+PLACEMENT:
+SCHEDULE:
+OPTIMIZATION:
+BUDGET:
+```
+
+### Ad Set 3 — [Nome descritivo]
+
+```
+[Repita a estrutura]
+```
+
+### Mapa de Ad Sets
+
+```
+| Ad Set | Publico | Tipo | Tamanho | Budget | Objetivo de Teste |
+|--------|---------|------|---------|--------|------------------|
+| [AS1] | [LAL 1% Buyers] | [lookalike] | [2M] | R$ [X]/dia | [Publico controle] |
+| [AS2] | [Interesse Fitness] | [interesse] | [5M] | R$ [X]/dia | [Teste interesse vs LAL] |
+| [AS3] | [RT VSL 50%] | [retargeting] | [15K] | R$ [X]/dia | [Retargeting quente] |
+| [AS4] | [Broad 25-55 F] | [broad] | [30M] | R$ [X]/dia | [Teste broad] |
+```
+
+---
+
+## 4. ADS (Anuncios)
+
+> **Instrucoes:** Liste todos os criativos dentro de cada ad set. Referencie o template de copy usado.
+
+```
+AD 1:
+Nome: [Ex: "MetodoX_VideoReels_HookDor_v1"]
+Formato: [video_single | imagem | carrossel | collection | instant_experience]
+Specs:
+  - Aspect ratio: [9:16 | 1:1 | 4:5 | 16:9]
+  - Resolucao: [Ex: "1080x1920"]
+  - Duracao (video): [Ex: "30s"]
+  - Formato arquivo: [MP4 | JPG | PNG]
+Copy ref: [Ex: "ad-meta-template.md — Variacao A"]
+Primary text: [Texto ou ref]
+Headline: [Texto ou ref]
+Description: [Texto ou ref]
+CTA button: [Saiba mais | Comprar agora | Cadastre-se | Assistir mais]
+URL destino: [URL]
+URL parameters: [UTMs. Ex: "utm_source=meta&utm_campaign=metodo-x&utm_content=hook-dor-v1"]
+
+AD 2:
+Nome:
+Formato:
+Specs:
+Copy ref:
+Primary text:
+Headline:
+Description:
+CTA button:
+URL destino:
+URL parameters:
+
+AD 3:
+[Repita para cada ad]
+```
+
+### Mapa de Ads por Ad Set
+
+```
+| Ad Set | Ad | Formato | Hook | Angulo | Status |
+|--------|-----|---------|------|--------|--------|
+| AS1 | Ad1 | video_reels | dor | emocional | ativo |
+| AS1 | Ad2 | video_reels | social_proof | racional | ativo |
+| AS1 | Ad3 | imagem | resultado | aspiracional | ativo |
+| AS2 | Ad1 | video_reels | dor | emocional | ativo |
+| AS2 | Ad4 | video_feed | curiosidade | educativo | ativo |
+| AS3 | Ad5 | video_reels | urgencia | oferta | ativo |
+```
+
+---
+
+## 5. KILL RULES (Regras de Pausa Automatica)
+
+**Objetivo:** Definir criterios objetivos para pausar criativos, publicos, ou a campanha inteira. Sem kill rules, voce queima dinheiro.
+
+### 5.1 Kill Rules por Ad (Criativo)
+
+```
+| Regra | Condicao | Acao | Quando verificar |
+|-------|---------|------|-----------------|
+| CPA maximo | CPA > R$ {{projeto.meta_cpa_maximo}} por 3 dias consecutivos | Pausar ad | Diario |
+| CTR minimo | CTR < 0.5% apos 1.000 impressoes | Pausar ad | Apos 1K impr |
+| Sem conversao | 0 conversoes apos gastar 2x CPA max | Pausar ad | Diario |
+| Frequencia alta | Frequencia > 3.0 em 7 dias | Pausar ad ou renovar criativo | Semanal |
+| ROAS minimo | ROAS < {{projeto.meta_roas_minimo}} por 5 dias | Pausar ad | A cada 5 dias |
+| Hook rate | Hook rate 3s < 15% | Pausar e iterar hook | Apos 2K impr |
+```
+
+### 5.2 Kill Rules por Ad Set (Publico)
+
+```
+| Regra | Condicao | Acao | Quando verificar |
+|-------|---------|------|-----------------|
+| CPA publico | CPA do ad set > 1.5x CPA meta por 5 dias | Pausar ad set | A cada 5 dias |
+| Saturacao | Frequencia > 4.0 + CTR caindo | Pausar ou ampliar publico | Semanal |
+| Volume minimo | < 1 conversao/dia apos 7 dias | Avaliar: pausar ou aumentar budget | Semanal |
+```
+
+### 5.3 Kill Rules por Campanha
+
+```
+| Regra | Condicao | Acao | Quando verificar |
+|-------|---------|------|-----------------|
+| ROAS campanha | ROAS < 1.0 por 7 dias | Pausar campanha, revisar funil | Semanal |
+| Budget wasted | > 50% do budget sem conversao | Pausar, diagnosticar | Diario |
+| Conta em risco | Rejeicoes repetidas, conta restrita | Pausar tudo, compliance review | Imediato |
+```
+
+---
+
+## 6. TEST PLAN (Plano de Testes)
+
+**Objetivo:** Documentar o que sera testado, hipotese, metrica, e criterio de decisao.
+
+```
+FASE DE TESTES: [Fase 1 — Validacao | Fase 2 — Otimizacao | Fase 3 — Escala]
+
+TESTE 1:
+Nome: [Ex: "Hook Dor vs Social Proof"]
+Variavel testada: [hook | publico | copy | formato | placement | bid | LP]
+Variacao A (controle): [Descreva]
+Variacao B (teste): [Descreva]
+Hipotese: [Ex: "Social proof tera CPA 20% menor porque publico e solution aware"]
+Metrica primaria: [CPA | CTR | ROAS | Conv Rate]
+Metrica secundaria: [Hook Rate | ThruPlay]
+Budget do teste: R$ [valor]
+Duracao: [Ex: "5 dias ou 1.000 impressoes por variacao"]
+Criterio de decisao: [Ex: "Vence quem tiver CPA menor com min 10 conversoes"]
+Status: [planejado | rodando | concluido | inconclusivo]
+Resultado: [Preencher apos conclusao]
+
+TESTE 2:
+Nome:
+Variavel testada:
+Variacao A:
+Variacao B:
+Hipotese:
+Metrica primaria:
+Budget:
+Duracao:
+Criterio de decisao:
+Status:
+Resultado:
+
+TESTE 3:
+[Repita]
+
+ROADMAP DE TESTES:
+
+| Semana | Teste | Variavel | Budget | Status |
+|--------|-------|----------|--------|--------|
+| S1 | [Teste 1] | Hook | R$ [X] | [status] |
+| S2 | [Teste 2] | Publico | R$ [X] | [status] |
+| S3 | [Teste 3] | Copy LP | R$ [X] | [status] |
+| S4 | [Teste 4] | Bid strategy | R$ [X] | [status] |
+```
+
+---
+
+## 7. SCALING PLAN (Plano de Escala)
+
+**Objetivo:** Protocolo para escalar quando encontrar criativos e publicos vencedores.
+
+### 7.1 Escala Vertical (aumentar budget)
+
+```
+PROTOCOLO DE ESCALA VERTICAL:
+1. Identificar ad sets com ROAS > {{projeto.meta_roas_minimo}} por 3+ dias
+2. Aumentar budget em [20-30%] a cada [2-3 dias]
+3. NUNCA aumentar mais de [50%] de uma vez (reseta aprendizado)
+4. Monitorar CPA por 48h apos cada aumento
+5. Se CPA subir > 30%, voltar ao budget anterior
+
+BUDGET PROGRESSION:
+| Etapa | Budget/dia | ROAS Min | Criterio para avancar |
+|-------|-----------|---------|----------------------|
+| Teste | R$ [50-100] | [2.0] | 10+ conversoes, CPA < max |
+| Validacao | R$ [200-500] | [1.8] | 3 dias estavel |
+| Escala 1 | R$ [500-1000] | [1.5] | 5 dias estavel |
+| Escala 2 | R$ [1000-3000] | [1.5] | 7 dias estavel |
+| Escala 3 | R$ [3000+] | [1.3] | 14 dias estavel |
+```
+
+### 7.2 Escala Horizontal (novos ad sets/publicos)
+
+```
+PROTOCOLO DE ESCALA HORIZONTAL:
+1. Duplicar ad set vencedor com NOVO publico
+2. Manter mesmo criativo vencedor
+3. Budget do novo ad set = budget original do vencedor
+4. Testar 2-3 novos publicos simultaneamente
+5. Aplicar kill rules normalmente
+
+PUBLICOS PARA ESCALA HORIZONTAL:
+1. [Ex: "LAL 2% — ampliacao do LAL 1% vencedor"]
+2. [Ex: "LAL 1% de novo seed (email list)"]
+3. [Ex: "Interesses adjacentes ao vencedor"]
+4. [Ex: "Broad com Advantage+ Audience"]
+5. [Ex: "Novo pais/regiao"]
+```
+
+### 7.3 Renovacao de Criativos
+
+```
+PROTOCOLO DE RENOVACAO:
+- Frequencia de renovacao: A cada [2-4 semanas] ou quando frequencia > [3.0]
+- Pipeline de criativos: Sempre ter [3-5] criativos prontos na fila
+- Iteracao: Criativos novos devem ser ITERACOES do vencedor, nao completamente novos
+- Formato de iteracao: Mudar 1 elemento por vez (hook | visual | CTA | angulo)
+
+PIPELINE CRIATIVO:
+
+| Criativo | Status | Prazo | Responsavel | Baseado em |
+|----------|--------|-------|-------------|-----------|
+| [v2 — novo hook] | [em_producao] | [data] | [@copywriter] | [Ad vencedor B] |
+| [v3 — novo visual] | [planejado] | [data] | [@designer] | [Ad vencedor B] |
+| [v4 — novo angulo] | [briefing] | [data] | [@copywriter] | [Teste de angulo] |
+```
+
+---
+
+## NOMENCLATURA PADRAO
+
+```
+CAMPANHA: [Produto]_[Objetivo]_[Tipo]_[AAAA-MM]
+Ex: "MetodoX_Conversao_VSL_2026-05"
+
+AD SET: [Campanha]_[Publico]_[Placement]
+Ex: "MetodoX_LAL1Buyers_AutoPlacement"
+
+AD: [Campanha]_[Formato]_[Hook]_[Versao]
+Ex: "MetodoX_VideoReels_HookDor_v1"
+
+UTM: utm_source=meta&utm_medium=cpc&utm_campaign=[campanha]&utm_content=[ad_name]
+```
+
+---
+
+## HISTORICO DE VERSOES
+
+| Versao | Data | Autor | Alteracao |
+|--------|------|-------|-----------|
+| 1.0 | {{data_criacao}} | {{autor}} | Versao inicial |
+
+---
+
+## CHECKLIST FINAL
+
+```
+CONTA:
+- [ ] Conta ativa e verificada
+- [ ] Pixel + CAPI configurados
+- [ ] Dominio verificado
+- [ ] Evento de otimizacao com dados
+
+CAMPANHA:
+- [ ] Objetivo correto selecionado
+- [ ] Budget definido (CBO ou ABO)
+- [ ] Estrategia de lance definida
+
+AD SETS:
+- [ ] Min 2 ad sets para teste
+- [ ] Publicos definidos com exclusoes
+- [ ] Placements configurados
+- [ ] Janela de conversao otima
+- [ ] Schedule definido
+
+ADS:
+- [ ] Min 2-3 criativos por ad set
+- [ ] Variacoes de hook/angulo
+- [ ] Copy ref vinculada
+- [ ] UTMs configurados
+- [ ] Specs tecnicos corretos
+
+KILL RULES:
+- [ ] CPA max definido
+- [ ] CTR min definido
+- [ ] Regras de frequencia
+- [ ] Regras de campanha
+
+TESTES:
+- [ ] Roadmap de testes documentado
+- [ ] Hipoteses e metricas definidas
+- [ ] Criterios de decisao claros
+
+ESCALA:
+- [ ] Protocolo vertical documentado
+- [ ] Publicos para escala horizontal listados
+- [ ] Pipeline de criativos planejado
+```