sinapse-ai 1.0.0

package/squad-paidmedia/knowledge-base/google-ads-account-architecture.md

@@ -0,0 +1,138 @@
+# Google Ads Account Architecture
+
+## Three Template Structures
+
+### Template 1: Simplified (<$5K/month)
+Para accounts com budget limitado. Foco em consolidacao e dados.
+
+```
+Account
+├── Campaign: Brand_Search_[Geo]
+│   ├── AG: Brand_Exact
+│   └── AG: Brand_Phrase
+├── Campaign: NonBrand_Search_[Geo]
+│   ├── AG: Theme_1 (5-15 kws)
+│   ├── AG: Theme_2 (5-15 kws)
+│   └── AG: Theme_3 (5-15 kws)
+└── Campaign: Pmax_[Geo] (se ecommerce)
+    └── Asset Group: All_Products
+```
+
+### Template 2: Standard ($5K-$50K/month)
+Para accounts em crescimento. Segmentacao por intent.
+
+```
+Account
+├── Campaign: Brand_Search_[Geo]
+│   ├── AG: Brand_Core
+│   ├── AG: Brand_Misspellings
+│   └── AG: Brand_Products
+├── Campaign: HighIntent_Search_[Geo]
+│   ├── AG: Intent_Buy
+│   ├── AG: Intent_Price
+│   └── AG: Intent_Compare
+├── Campaign: MidIntent_Search_[Geo]
+│   ├── AG: Category_1
+│   ├── AG: Category_2
+│   └── AG: Category_3
+├── Campaign: Shopping_Standard_[Geo]
+│   ├── AG: TopPerformers
+│   └── AG: AllProducts
+├── Campaign: Pmax_[Geo]
+│   ├── Asset Group: Category_1
+│   └── Asset Group: Category_2
+└── Campaign: Retargeting_Display
+    └── AG: Visitors_NoConversion
+```
+
+### Template 3: Scaled ($50K+/month)
+Para accounts maduros. Granularidade maxima.
+
+```
+Account (adicionar ao Standard):
+├── Campaign: Competitor_Search
+│   ├── AG: Competitor_A
+│   └── AG: Competitor_B
+├── Campaign: YouTube_Awareness
+│   └── AG: InMarket_Audiences
+├── Campaign: DemandGen
+│   ├── AG: Prospecting
+│   └── AG: Retargeting
+├── Campaign: Discovery/DemandGen
+└── Campaign: Shopping_HighPriority
+    └── AG: BestSellers
+```
+
+## Keyword Portfolio Management
+
+### Distribuicao Ideal por Intent
+| Intent Level | % Keywords | Match Type | Bid Strategy |
+|-------------|-----------|------------|-------------|
+| Brand | 10-15% | Exact + Phrase | tCPA ou manual |
+| High-Intent (buy, price, best) | 20-30% | Exact + Phrase | tCPA ou tROAS |
+| Mid-Intent (reviews, compare) | 30-40% | Phrase + Broad | tCPA |
+| Broad discovery | 10-20% | Broad | Maximize conversions |
+
+### Match Type Strategy
+
+| Match Type | Quando Usar | Volume | Controle | CPA Tipico |
+|-----------|------------|--------|---------|------------|
+| Exact | High-value, proven keywords | Baixo | Alto | Mais baixo |
+| Phrase | Temas validados, moderate control | Medio | Medio | Medio |
+| Broad | Discovery, high volume, Smart Bidding | Alto | Baixo | Variavel |
+
+**Regra moderna:** Broad + Smart Bidding e a combinacao default recomendada pelo Google. Funciona quando ha 30+ conversoes/30d e tracking robusto.
+
+### Keyword Cannibalization Rules
+- Mesma keyword em match types diferentes: ok (Google prioriza mais restritivo)
+- Mesma keyword em ad groups diferentes: problematico (competem entre si)
+- Resolver: consolidar no ad group mais relevante ou usar negative cruzada
+
+## Quality Score Optimization
+
+### Os 3 Componentes
+| Componente | Peso Estimado | Como Melhorar |
+|-----------|--------------|---------------|
+| Expected CTR | ~35% | Ad copy relevante, extensions, ad position |
+| Ad Relevance | ~25% | Keywords no headline, tema alinhado |
+| LP Experience | ~40% | Speed, relevancia, mobile UX |
+
+### Quality Score Improvement Workflow
+1. Exportar keywords com QS <6
+2. Agrupar por componente com pior rating ("Below Average")
+3. Priorizar:
+   - LP Experience Below Average → Lighthouse otimiza LP
+   - Ad Relevance Below Average → Query ajusta ad copy (keyword no headline)
+   - Expected CTR Below Average → Query melhora ad copy + extensions
+
+### QS Impact on CPC
+- QS 10 → ~50% desconto no CPC
+- QS 7 → baseline (sem desconto, sem penalidade)
+- QS 5 → ~25% markup
+- QS 3 → ~67% markup
+- QS 1 → ~400% markup
+
+## Smart Bidding Readiness
+
+### Pre-Requisitos
+| Requisito | Minimo | Ideal |
+|-----------|--------|-------|
+| Conversoes/30d/campanha | 30 | 50+ |
+| Conversion tracking | Correto | Enhanced conversions |
+| Attribution model | Any | Data-driven |
+| Historico de dados | 14 dias | 30 dias |
+| Estabilidade | Sem mudancas grandes | 30d sem mudanca |
+
+### Migration Path
+```
+Manual CPC → Maximize Clicks (warmup 2 semanas)
+→ Maximize Conversions (learning 2-3 semanas)
+→ Target CPA (set at 120% do CPA atual, reduce gradually)
+OU
+→ Target ROAS (set at 80% do ROAS atual, increase gradually)
+```
+
+### Target Settings
+- **Target CPA:** comecar 20% acima do CPA medio atual. Reduzir 10-15% a cada 2 semanas.
+- **Target ROAS:** comecar 20% abaixo do ROAS medio atual. Aumentar 10-15% a cada 2 semanas.
+- **NUNCA** mudar target mais de 15% de uma vez.

package/squad-paidmedia/knowledge-base/google-ads-optimization-playbook.md

@@ -0,0 +1,148 @@
+# Google Ads Optimization Playbook
+
+## Search Term Hygiene
+
+### Frequencia de Revisao
+| Match Type Ativo | Frequencia | Razao |
+|-----------------|-----------|-------|
+| Broad match | 2x/semana | Broad trigga muitos termos inesperados |
+| Phrase match | 1x/semana | Mais controlado mas still precisa monitorar |
+| Exact only | 1x/mes | Minimo de surpresas |
+
+### N-Gram Analysis Process
+1. Exportar search terms report (30-90 dias)
+2. Quebrar cada search term em unigrams (palavras individuais)
+3. Contar frequencia de cada unigram em termos SEM conversao
+4. Unigrams que aparecem 10+ vezes em termos irrelevantes = candidatos a negative
+5. Exemplos comuns: "gratis", "emprego", "vaga", "como", "o que e", "tutorial"
+
+### Waste Benchmark
+- **<10%:** Excelente — negatives bem gerenciados
+- **10-15%:** Bom — manutencao rotineira suficiente
+- **15-25%:** Precisa atencao — revisao intensiva de negatives
+- **>25%:** Critico — reestruturar match types e negatives
+
+## Negative Keyword Strategy
+
+### Layers de Negatives
+1. **Account-level (shared lists):** termos universalmente irrelevantes
+   - "gratis", "free", "emprego", "vagas", "salario", "como fazer"
+2. **Campaign-level:** termos irrelevantes para aquele objetivo
+   - Brand campaign: negativar termos nao-brand
+   - Non-brand: negativar termos brand (evitar canibalismo)
+3. **Ad group-level:** refinamento tematico
+   - AG "sapato masculino": negativar "feminino", "infantil"
+
+### Match Type para Negatives
+| Situacao | Match Type | Exemplo |
+|----------|-----------|---------|
+| Termo exato irrelevante | Exact negative | [emprego marketing digital] |
+| Qualquer busca com a frase | Phrase negative | "emprego" |
+| Qualquer combinacao | Broad negative | gratis |
+
+**CUIDADO com broad negative:** pode bloquear termos relevantes. Ex: negativar "curso" com broad pode bloquear "curso de marketing" que era relevante.
+
+## Budget Pacing Analysis
+
+### Pacing Formula
+```
+Pacing Ratio = (% budget gasto) / (% periodo decorrido)
+```
+
+| Pacing Ratio | Status | Acao |
+|-------------|--------|------|
+| >1.15 | Overspending | Reduzir daily budget 10-15% |
+| 1.0-1.15 | Slightly over | Monitorar |
+| 0.9-1.0 | On pace | Ideal |
+| 0.75-0.9 | Slightly under | Investigar restricoes |
+| <0.75 | Severely under | Diagnosticar: bid, audience, ads |
+
+### Underspend Diagnostics
+1. **"Limited by budget" flag?** → Nao, entao nao e falta de budget
+2. **Impression Share Lost (rank)?** → Bids muito baixos
+3. **Impression Share Lost (budget)?** → Budget muito baixo
+4. **Ad Strength / disapprovals?** → Ads com problema
+5. **Search volume?** → Keywords muito nichadas ou sazonais
+6. **Day parting?** → Schedule muito restritivo
+
+## Ad Copy Improvement Framework
+
+### Headline Formulas (Google Search)
+1. **Keyword + Benefit:** "Marketing Digital | Aumente suas Vendas 3x"
+2. **Number + Noun:** "50.000+ Empresas Confiam"
+3. **Question:** "Cansado de CPA Alto?"
+4. **How-to:** "Como Reduzir seu CPA em 30 Dias"
+5. **CTA Direct:** "Comece seu Trial Gratis Hoje"
+
+### RSA Best Practices
+- 15 headlines: incluir keyword em pelo menos 5
+- 4 descriptions: 1 com beneficio, 1 com feature, 1 com social proof, 1 com CTA
+- Pin headline 1 com keyword (para ad relevance)
+- Nao pinnar demais (max 3 pins) — deixar Google otimizar
+- Cada headline deve fazer sentido independentemente
+
+### Ad Strength Target
+| Strength | Score | Acao |
+|----------|-------|------|
+| Excellent | Best | Manter |
+| Good | Target | Aceitavel |
+| Average | Improve | Adicionar headlines/descriptions |
+| Poor | Critical | Reescrever completamente |
+
+## Performance Anomaly Detection (Z-Score)
+
+### Calculo
+```
+Z-score = (valor_hoje - media_30d) / desvio_padrao_30d
+```
+
+### Thresholds de Acao
+| Z-score | Significado | Acao |
+|---------|------------|------|
+| |z| < 1.5 | Variacao normal | Ignorar |
+| 1.5 ≤ |z| < 2.0 | Notavel | Monitorar amanha |
+| 2.0 ≤ |z| < 3.0 | Significativa | Investigar causa |
+| |z| ≥ 3.0 | Critica | Acao imediata |
+
+### Metricas para Monitorar
+- CPA diario (mais importante)
+- CTR diario
+- Conversion rate diario
+- CPC medio diario
+- Impression share
+
+### Causas Comuns por Direcao
+**CPA subiu (z positivo):**
+- Competicao aumentou (auction pressure)
+- Creative fatigue
+- Tracking break (falso positivo — verificar primeiro!)
+- Sazonalidade / dia atipico
+- Mudanca de LP
+
+**CPA caiu (z negativo):**
+- Competidor saiu do leilao
+- Novo criativo winner
+- Melhoria de LP
+- Sazonalidade favoravel
+
+## Conversion Tracking Diagnostics
+
+### Checklist de Diagnostico
+```
+1. Google Ads reports X conversoes
+2. GA4 reports Y conversoes
+3. CRM reports Z conversoes (ground truth)
+
+Se X >> Z: over-counting (double fire, wrong page, attribution window too long)
+Se X << Z: under-counting (tag missing, consent blocking, cross-domain issue)
+Se X ≈ Y mas ambos ≠ Z: attribution model difference
+```
+
+### Common Fixes
+| Problema | Fix |
+|----------|-----|
+| Double-counting | Verificar tag na thank-you page (nao deve firing em reload) |
+| Under-counting | Verificar consent mode, cross-domain, enhanced conversions |
+| GA4 vs Google Ads diff | Normal ate 15% (modelos de atribuicao diferentes) |
+| Sudden drop | Verificar tag com Tag Assistant, verificar LP mudou |
+| Sudden spike | Verificar spam/bots, verificar tag em paginas erradas |

package/squad-paidmedia/knowledge-base/local-seo-gmb-playbook.md

@@ -0,0 +1,140 @@
+# Local SEO & GMB Playbook
+
+## GMB Location Audit Framework
+
+### Score Card (5 areas)
+
+**1. Completude do Perfil (25 pontos)**
+| Item | Pontos | Verificar |
+|------|--------|-----------|
+| Nome correto | 3 | Sem keywords stuffing |
+| Endereco correto | 3 | NAP consistency |
+| Telefone correto | 3 | Numero local preferido |
+| Website URL | 2 | URL correta e funcionando |
+| Categoria primaria | 3 | A mais especifica possivel |
+| Categorias secundarias | 2 | 3-5 relevantes |
+| Horario de funcionamento | 2 | Atualizado, feriados |
+| Descricao do negocio | 3 | 750 caracteres, keywords naturais |
+| Atributos | 2 | Todos os relevantes marcados |
+| Area de servico (se aplicavel) | 2 | Definida corretamente |
+
+**2. Conteudo Visual (20 pontos)**
+| Item | Pontos | Verificar |
+|------|--------|-----------|
+| Logo | 3 | Alta resolucao, reconhecivel |
+| Cover photo | 3 | Representativa do negocio |
+| Fotos exterior | 3 | Min 3 angulos |
+| Fotos interior | 3 | Min 3 areas |
+| Fotos produtos/servicos | 4 | Min 5 fotos |
+| Fotos equipe | 2 | Humaniza o negocio |
+| Videos | 2 | Bonus, nao obrigatorio |
+
+**3. Reviews (25 pontos)**
+| Item | Pontos | Verificar |
+|------|--------|-----------|
+| Rating medio | 5 | >4.0 = bom, >4.5 = excelente |
+| Volume de reviews | 5 | vs concorrentes locais |
+| Reviews recentes (30d) | 5 | Min 2-3/mes |
+| Response rate | 5 | >80% respondido |
+| Response time | 5 | <24h ideal |
+
+**4. Posts & Engagement (15 pontos)**
+| Item | Pontos | Verificar |
+|------|--------|-----------|
+| Frequencia de posts | 5 | Min 2/mes |
+| Variedade (offer/event/update) | 5 | Mix de tipos |
+| Posts recentes (<30d) | 5 | Perfil ativo |
+
+**5. Q&A (15 pontos)**
+| Item | Pontos | Verificar |
+|------|--------|-----------|
+| Perguntas respondidas | 5 | Todas respondidas |
+| Q&A seeding | 5 | Perguntas frequentes pre-populadas |
+| Tempo de resposta | 5 | <48h |
+
+### Classificacao
+| Score | Rating | Status |
+|-------|--------|--------|
+| 85-100 | A | Excelente — manutencao |
+| 70-84 | B | Bom — melhorias pontuais |
+| 50-69 | C | Precisa trabalho — plano de acao |
+| <50 | D | Critico — acao imediata |
+
+## Local Market Competitive Analysis
+
+### Framework de Analise
+1. **Identificar top 5-10 concorrentes** por proximidade e relevancia
+2. **Comparar metricas GMB:**
+   - Rating medio
+   - Numero de reviews
+   - Response rate
+   - Frequencia de posts
+   - Completude do perfil
+3. **Gap analysis:** onde somos melhores? Onde somos piores?
+4. **SWOT local:** Strengths, Weaknesses, Opportunities, Threats
+
+## Review Management Strategy
+
+### Solicitar Reviews
+1. **Pos-compra (D0-D1):** email ou SMS com link direto para review
+2. **Follow-up (D7):** lembrete para quem nao avaliou
+3. **In-person:** QR code no estabelecimento
+4. **Meta:** 5-10 reviews novos/mes (consistencia > volume)
+
+### Responder Reviews
+**Positiva (4-5 estrelas):**
+```
+"Obrigado [Nome]! Ficamos felizes que [referencia ao que elogiou].
+[Convite para voltar ou experimentar algo novo]. Ate a proxima!"
+```
+
+**Negativa (1-3 estrelas):**
+```
+"[Nome], lamentamos pela experiencia. [Reconhecer o problema especifico].
+[Acao corretiva tomada]. Por favor entre em contato em [telefone/email]
+para que possamos resolver diretamente. Obrigado pelo feedback."
+```
+
+### Regras
+- Responder 100% das reviews negativas em <24h
+- Responder 80%+ das reviews positivas em <48h
+- Nunca ser defensivo ou discutir publicamente
+- Levar conversas problematicas para privado
+
+## Local Keyword Strategy
+
+### Patterns de Keywords Locais
+```
+[servico] + [cidade]            → "dentista sao paulo"
+[servico] + [bairro]            → "dentista pinheiros"
+[servico] + perto de mim        → "dentista perto de mim"
+[servico] + [qualificador]      → "melhor dentista sp"
+[servico] + aberto agora        → "dentista aberto agora"
+[servico] + [especializacao]    → "dentista implante sao paulo"
+```
+
+### Prioridade para Paid
+1. High-intent local: "[servico] + [cidade]" com CPC viavel
+2. "Perto de mim": capturar intencao imediata
+3. Qualificadores: "melhor", "barato", "aberto agora"
+4. Especializacao: nicho com menos competicao
+
+## Customer Engagement Action Plan
+
+### Calendario Mensal
+| Semana | Acao |
+|--------|------|
+| S1 | Post update (novidade, bastidores, equipe) |
+| S2 | Post offer (promocao, desconto, evento) |
+| S3 | Responder todas reviews pendentes + solicitar novas |
+| S4 | Post event/seasonal + review de Q&A |
+
+### Metricas de Sucesso
+| Metrica | Target |
+|---------|--------|
+| Reviews/mes | 5-10 novos |
+| Rating medio | >4.2 |
+| Response rate | >90% |
+| Response time | <24h |
+| Posts/mes | 4+ |
+| GMB actions (calls+directions+website) | +10% MoM |

package/squad-paidmedia/knowledge-base/meta-ads-campaign-architecture.md

@@ -0,0 +1,130 @@
+# Meta Ads Campaign Architecture
+
+## Three-Tier Audience Architecture
+
+### Tier 1: Cold (Prospeccao) — 60-70% do Budget
+Objetivo: trazer novos usuarios que nunca interagiram com a marca.
+
+**Audiences recomendadas (em ordem de prioridade):**
+1. **Broad (sem interesses)** — confiar no algoritmo. Melhor opcao quando pixel tem 50+ conversoes/semana
+2. **Lookalike 1% de purchasers** — melhor seed possivel. Min 1000 na seed, ideal 5000+
+3. **Lookalike 1% de leads qualificados** — segundo melhor seed
+4. **Lookalike 1-3% de website visitors** — mais escala, menos qualidade
+5. **Interest stacking** — agrupar 3-5 interesses relacionados. Usar apenas quando broad nao funciona
+
+**Quando usar Broad vs LAL vs Interest:**
+- Pixel maduro (50+ conv/semana): Broad first
+- Pixel intermediario (15-50 conv/semana): LAL 1% first
+- Pixel novo (<15 conv/semana): Interest stacking como warmup
+
+### Tier 2: Warm (Nurturing) — 20-30% do Budget
+Objetivo: re-engajar usuarios que mostraram interesse.
+
+**Audiences recomendadas:**
+1. Website visitors all pages (30d, 60d, 90d)
+2. Instagram/Facebook engagers (30d, 90d, 180d)
+3. Video viewers 25%+ (ultimos 90d)
+4. Page followers
+5. Lead form openers sem submit
+
+### Tier 3: Hot (Conversao) — 10-15% do Budget
+Objetivo: converter usuarios com alta intencao.
+
+**Audiences recomendadas:**
+1. Add to Cart sem Purchase (7d, 14d)
+2. Checkout initiation sem Purchase (7d)
+3. Website visitors pagina de pricing (7d, 14d)
+4. Video viewers 75%+ (ultimos 30d)
+5. Engaged with ads (form openers, lead submits parciais)
+
+### Exclusion Architecture
+```
+Cold → exclui Warm + Hot audiences
+Warm → exclui Hot audiences
+Hot → exclui purchasers recentes (se objetivo = new customers)
+Global → exclui employees, existing customers (optional)
+```
+
+## CBO vs ABO Decision Matrix
+
+| Cenario | Usar | Razao |
+|---------|------|-------|
+| Conta madura, 3-5 ad sets balanceados | CBO | Meta otimiza alocacao entre ad sets |
+| Teste de audiences (quer gastar igual em cada) | ABO | Controlar spend por audience |
+| Budget muito baixo (<$50/day total) | ABO | CBO pode concentrar em 1 ad set |
+| Scaling agressivo | CBO | Meta encontra eficiencia |
+| Audiences com tamanhos muito diferentes | CBO com min spend | Evitar concentracao |
+
+**Default: CBO.** Usar ABO apenas para testes controlados.
+
+## Campaign Consolidation Principles
+
+### Regra dos 3-5
+- Max 3-5 campanhas ativas por objetivo de conversao
+- Mais campanhas = menos dados por campanha = pior otimizacao
+- Consolidar campanhas com mesmo objetivo e audience tier
+
+### Estrutura Ideal (Conversion objective)
+```
+Campaign 1: CONV_Cold_Purchase_[YYYY-MM]     (CBO, 60-70% budget)
+  ├── Ad Set: Broad_AllGeo
+  ├── Ad Set: LAL1_Purchasers
+  └── Ad Set: LAL1_Leads
+
+Campaign 2: CONV_Warm_Purchase_[YYYY-MM]     (CBO, 20-30% budget)
+  ├── Ad Set: WV_AllPages_30d
+  └── Ad Set: Engagers_90d
+
+Campaign 3: CONV_Hot_Purchase_[YYYY-MM]      (CBO, 10-15% budget)
+  ├── Ad Set: ATC_14d
+  └── Ad Set: Checkout_7d
+
+Campaign 4: TEST_Creative_[YYYY-MM]          (ABO, 10-15% de test budget)
+  ├── Ad Set: Test_HookA_vs_HookB
+  └── Ad Set: Test_Format_Video_vs_Image
+
+Campaign 5 (opt): ASC_Shopping_[YYYY-MM]     (Advantage+ Shopping, full funnel)
+```
+
+### Anti-Patterns a Evitar
+- 1 campanha por criativo (fragmentacao extrema)
+- 10+ ad sets por campanha CBO (diluicao)
+- Campanhas duplicadas para mesma audience
+- Campanhas de Traffic para objetivo de conversao
+
+## Naming Conventions
+
+### Formato
+```
+Campaign:  [Objective]_[Tier]_[Optimization]_[YYYY-MM]
+Ad Set:    [Audience-Type]_[Window/Detail]
+Ad:        [Format]_[Hook-Type]_[Version]_[MMDD]
+```
+
+### Exemplos
+```
+Campaign:  CONV_Cold_Purchase_2026-03
+Ad Set:    Broad_AllGeo
+Ad:        VID_Question_v2_0316
+
+Campaign:  CONV_Warm_Purchase_2026-03
+Ad Set:    WV_AllPages_30d
+Ad:        IMG_Testimonial_v1_0310
+
+Campaign:  TEST_Creative_2026-03
+Ad Set:    Test_Hook_Question-vs-Bold
+Ad:        VID_Question_v1_0316
+```
+
+### Codigos de Audience
+| Codigo | Significado |
+|--------|-----------|
+| Broad | Targeting amplo sem interesses |
+| LAL1 | Lookalike 1% |
+| LAL3 | Lookalike 1-3% |
+| WV | Website Visitors |
+| ENG | Engagers (social) |
+| VV | Video Viewers |
+| ATC | Add to Cart |
+| IC | Initiate Checkout |
+| PURCH | Purchasers |

package/squad-paidmedia/knowledge-base/meta-ads-optimization-playbook.md

@@ -0,0 +1,126 @@
+# Meta Ads Optimization Playbook
+
+## Marginal CPA Analysis
+
+### Conceito
+CPA marginal = custo de cada conversao ADICIONAL. Diferente do CPA medio, o marginal mostra quanto custa a PROXIMA conversao. Essencial para decisoes de budget.
+
+### Como Calcular
+1. Exportar dados diarios: spend e conversions por campanha (30+ dias)
+2. Ordenar dias por spend (menor para maior)
+3. Dividir em quartis (4 faixas de 25% cada)
+4. Para cada quartil: CPA = spend do quartil / conversoes do quartil
+5. CPA marginal do Q4 vs Q1 mostra quanto a eficiencia cai com mais spend
+
+### Interpretacao
+| CPA Marginal Q4/Q1 | Status | Acao |
+|---------------------|--------|------|
+| <1.2x | Eficiente | Headroom para escalar |
+| 1.2-1.5x | Aceitavel | Escalar com cautela |
+| 1.5-2.0x | Diminishing returns | Perto do limite |
+| >2.0x | Ineficiente | Reduzir spend ou reestruturar |
+
+## Budget Efficiency Tiers
+
+### Tier System por Ad Set
+| Tier | CPA vs Target | Acao | Budget Adjustment |
+|------|-------------|------|-------------------|
+| S | <70% do target | Escalar agressivamente | +20%/semana |
+| A | 70-100% do target | Escalar moderadamente | +10-15%/semana |
+| B | 100-130% do target | Manter e otimizar | Manter |
+| C | 130-170% do target | Reduzir e investigar | -20% |
+| D | >170% do target | Pausar ou reestruturar | Pausar |
+
+### Regra de Budget Minimo
+- Cada ad set precisa de budget >= 5x CPA target/dia para sair da learning phase
+- Se CPA target = $50 → minimum $250/dia por ad set
+- Se budget nao permite → consolidar ad sets (menos = melhor)
+
+## Creative Fatigue Detection
+
+### Indicadores de Fadiga
+| Indicador | Threshold Amarelo | Threshold Vermelho |
+|-----------|------------------|-------------------|
+| Frequency | >2.5 | >4.0 |
+| CTR WoW change | -10% a -20% | >-20% |
+| CPA WoW change | +15% a +30% | >+30% |
+| Days active | >21 dias | >45 dias |
+| Hook rate (3s views/impressions) | -15% | >-25% |
+
+### Lifecycle de um Criativo
+```
+Launch (D0-D3) → Learning (D3-D7) → Peak (D7-D21) → Decline (D21-D45) → Fatigue (D45+)
+```
+
+### Acoes por Stage
+- Peak: escalar budget, usar como base para iteracoes
+- Decline: preparar substituicao, reduzir budget gradualmente
+- Fatigue: pausar, substituir, documentar learning
+
+## Frequency Cap Management
+
+### Thresholds por Tier
+| Tier | Frequency Ideal | Max Aceitavel | Janela |
+|------|----------------|---------------|--------|
+| Cold | 1.5-2.0 | 3.0 | 7 dias |
+| Warm | 2.0-3.0 | 4.0 | 7 dias |
+| Hot | 3.0-5.0 | 7.0 | 7 dias |
+
+### Quando Frequency sobe demais
+1. Audience muito pequena → expandir ou consolidar
+2. Budget muito alto para o tamanho da audience → reduzir ou diversificar
+3. Poucos criativos → adicionar mais variacoes
+4. Placement limitado → expandir placements
+
+## CAPI Implementation Guide
+
+### Prioridade de Implementacao
+1. **Purchase/Lead event** — mais importante para otimizacao
+2. **Add to Cart / Initiate Checkout** — segundo mais importante
+3. **View Content / Page View** — menos critico mas bom ter
+
+### Event Match Quality (EMQ) Optimization
+| EMQ Score | Status | Acao |
+|-----------|--------|------|
+| 8-10 | Excelente | Manter |
+| 6-8 | Bom | Adicionar mais parametros |
+| 4-6 | Precisa trabalho | Implementar hashed PII |
+| <4 | Critico | Revisar implementacao CAPI |
+
+### Parametros que melhoram EMQ
+- **em** (email, hashed SHA256) — maior impacto
+- **fn** (first name, hashed)
+- **ln** (last name, hashed)
+- **ph** (phone, hashed)
+- **external_id** (user ID do sistema)
+- **client_ip_address** e **client_user_agent** — automaticos via server
+
+### Deduplication
+- Enviar mesmo `event_id` via Pixel (browser) e CAPI (server)
+- Meta deduplica automaticamente quando event_id match
+- Se dedup ratio >95%: um dos dois nao esta firing
+- Se dedup ratio <50%: event_ids nao estao matching
+
+## Optimization Cadence
+
+### Daily (Signal monitora)
+- Delivery check: campanhas gastando conforme esperado?
+- Anomalias: CPA spike, spend zerado, errors?
+- Learning phase: ads stuck?
+
+### Weekly (Signal + Apex)
+- Creative performance review
+- Audience performance review
+- Budget rebalancing (se necessario)
+- New creative deployment
+
+### Bi-Weekly (Signal + Canvas)
+- Creative fatigue check completo
+- New test hypothesis formulation
+- Winner scaling
+
+### Monthly (Apex + Pulse)
+- Full performance report
+- CPA marginal recalculation
+- Budget reallocation decision
+- Scaling roadmap review