sinapse-ai 9.3.0 → 9.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (192) hide show
  1. package/.claude/CLAUDE.md +56 -343
  2. package/.claude/rules/agent-authority.md +6 -0
  3. package/.claude/rules/agent-handoff.md +5 -0
  4. package/.claude/rules/cross-squad-routing.md +5 -0
  5. package/.claude/rules/hook-governance.md +6 -0
  6. package/.claude/rules/mcp-usage.md +3 -1
  7. package/.claude/rules/safe-collaboration.md +10 -0
  8. package/.claude/rules/security-data-protection.md +9 -0
  9. package/.claude/rules/squad-awareness.md +3 -1
  10. package/.claude/rules/tool-examples.md +6 -0
  11. package/.claude/rules/workflow-execution.md +7 -0
  12. package/.codex/agents/analyst.md +253 -72
  13. package/.codex/agents/architect.md +455 -68
  14. package/.codex/agents/data-engineer.md +492 -106
  15. package/.codex/agents/developer.md +560 -0
  16. package/.codex/agents/devops.md +518 -69
  17. package/.codex/agents/product-lead.md +335 -0
  18. package/.codex/agents/project-lead.md +377 -0
  19. package/.codex/agents/quality-gate.md +449 -0
  20. package/.codex/agents/sinapse-orqx.md +9 -7
  21. package/.codex/agents/sprint-lead.md +287 -0
  22. package/.codex/agents/squad-creator.md +344 -0
  23. package/.codex/agents/ux-design-expert.md +495 -0
  24. package/.codex/delegation-matrix.json +756 -44
  25. package/.codex/handoff-packet.schema.json +30 -6
  26. package/.sinapse-ai/data/entity-registry.yaml +175 -363
  27. package/.sinapse-ai/data/registry-update-log.jsonl +16 -0
  28. package/.sinapse-ai/development/agents/analyst.md +90 -0
  29. package/.sinapse-ai/development/agents/architect.md +73 -0
  30. package/.sinapse-ai/development/agents/developer.md +69 -0
  31. package/.sinapse-ai/development/agents/devops.md +117 -0
  32. package/.sinapse-ai/development/agents/quality-gate.md +85 -0
  33. package/.sinapse-ai/development/checklists/agent-quality-gate.md +27 -0
  34. package/.sinapse-ai/development/checklists/brownfield-compatibility-checklist.md +20 -0
  35. package/.sinapse-ai/development/checklists/code-review-checklist.md +106 -0
  36. package/.sinapse-ai/development/checklists/issue-triage-checklist.md +9 -0
  37. package/.sinapse-ai/development/checklists/memory-audit-checklist.md +16 -0
  38. package/.sinapse-ai/development/checklists/pr-quality-checklist.md +72 -0
  39. package/.sinapse-ai/development/checklists/security-deployment-checklist.md +54 -0
  40. package/.sinapse-ai/development/checklists/self-critique-checklist.md +19 -1
  41. package/.sinapse-ai/development/skills/debug.md +57 -0
  42. package/.sinapse-ai/development/skills/fast-review.md +69 -0
  43. package/.sinapse-ai/development/skills/research-synthesis.md +77 -0
  44. package/.sinapse-ai/development/skills/security-scan.md +73 -0
  45. package/.sinapse-ai/development/skills/verify.md +53 -0
  46. package/.sinapse-ai/development/templates/squad/agent-template.md +17 -4
  47. package/.sinapse-ai/development/templates/squad/checklist-template.md +13 -5
  48. package/.sinapse-ai/development/templates/squad/task-template.md +7 -0
  49. package/.sinapse-ai/development/templates/squad/workflow-template.yaml +7 -0
  50. package/.sinapse-ai/development/workflows/fast-track.yaml +87 -0
  51. package/.sinapse-ai/infrastructure/scripts/validate-codex-delegation.js +3 -1
  52. package/.sinapse-ai/install-manifest.yaml +71 -35
  53. package/docs/codex-integration-process.md +22 -0
  54. package/docs/codex-parity-program.md +27 -0
  55. package/docs/ide-integration.md +36 -0
  56. package/package.json +1 -1
  57. package/squads/claude-code-mastery/knowledge-base/claude-code-internals-reference.md +927 -0
  58. package/squads/squad-brand/knowledge-base/archetype-brand-mapping.md +12 -1
  59. package/squads/squad-brand/knowledge-base/brand-activism-cultural-branding.md +216 -0
  60. package/squads/squad-brand/knowledge-base/brand-audit-criteria.md +58 -0
  61. package/squads/squad-brand/knowledge-base/brand-digital-strategy.md +188 -0
  62. package/squads/squad-brand/knowledge-base/brand-legal-ip.md +222 -0
  63. package/squads/squad-brand/knowledge-base/brand-naming-framework.md +163 -0
  64. package/squads/squad-brand/knowledge-base/branding-master-reference.md +1001 -0
  65. package/squads/squad-brand/knowledge-base/color-psychology.md +25 -12
  66. package/squads/squad-brand/knowledge-base/employer-personal-branding.md +206 -0
  67. package/squads/squad-brand/knowledge-base/routing-catalog.md +34 -0
  68. package/squads/squad-brand/knowledge-base/sonic-branding-principles.md +6 -1
  69. package/squads/squad-brand/knowledge-base/typography-personality.md +34 -0
  70. package/squads/squad-claude/knowledge-base/context-window-optimization.md +334 -0
  71. package/squads/squad-claude/knowledge-base/knowledge-architecture-reference.md +403 -0
  72. package/squads/squad-claude/knowledge-base/memory-systems-reference.md +412 -0
  73. package/squads/squad-claude/knowledge-base/obsidian-claude-integration.md +423 -0
  74. package/squads/squad-claude/knowledge-base/retrieval-augmented-generation.md +320 -0
  75. package/squads/squad-claude/knowledge-base/skill-creation-patterns.md +380 -0
  76. package/squads/squad-claude/knowledge-base/swarm-orchestration-patterns.md +411 -0
  77. package/squads/squad-cloning/knowledge-base/clone-quality-assurance.md +211 -0
  78. package/squads/squad-cloning/knowledge-base/confidence-scoring.md +51 -0
  79. package/squads/squad-cloning/knowledge-base/cross-squad-deployment.md +47 -0
  80. package/squads/squad-cloning/knowledge-base/ethical-guidelines.md +237 -0
  81. package/squads/squad-cloning/knowledge-base/knowledge-graph-for-clones.md +295 -0
  82. package/squads/squad-cloning/knowledge-base/memory-architecture-for-clones.md +229 -0
  83. package/squads/squad-cloning/knowledge-base/multi-agent-deployment-patterns.md +320 -0
  84. package/squads/squad-cloning/knowledge-base/skill-standard-for-clones.md +262 -0
  85. package/squads/squad-cloning/knowledge-base/sop-extraction-guide.md +243 -0
  86. package/squads/squad-commercial/knowledge-base/account-based-selling.md +206 -0
  87. package/squads/squad-commercial/knowledge-base/ai-as-competitive-infrastructure.md +14 -0
  88. package/squads/squad-commercial/knowledge-base/ai-in-sales.md +199 -0
  89. package/squads/squad-commercial/knowledge-base/brazilian-sales-context.md +195 -0
  90. package/squads/squad-commercial/knowledge-base/customer-success-operations.md +83 -2
  91. package/squads/squad-commercial/knowledge-base/prospecting-pipeline-generation.md +69 -0
  92. package/squads/squad-commercial/knowledge-base/sales-enablement-playbook.md +260 -0
  93. package/squads/squad-commercial/knowledge-base/sales-methodology-comparison.md +185 -0
  94. package/squads/squad-commercial/knowledge-base/sales-revenue-master-reference.md +1123 -0
  95. package/squads/squad-content/knowledge-base/brazilian-content-context.md +176 -0
  96. package/squads/squad-content/knowledge-base/competitor-analysis-methods.md +40 -1
  97. package/squads/squad-content/knowledge-base/content-architecture-taxonomy.md +206 -0
  98. package/squads/squad-content/knowledge-base/content-formats-encyclopedia.md +58 -1
  99. package/squads/squad-content/knowledge-base/content-references-bibliography.md +130 -0
  100. package/squads/squad-content/knowledge-base/content-strategy-master-reference.md +1097 -0
  101. package/squads/squad-content/knowledge-base/content-tech-stack.md +150 -0
  102. package/squads/squad-content/knowledge-base/copywriting-formulas-library.md +188 -0
  103. package/squads/squad-content/knowledge-base/email-newsletter-strategy.md +161 -0
  104. package/squads/squad-content/knowledge-base/platform-algorithm-intelligence.md +86 -1
  105. package/squads/squad-content/knowledge-base/social-algorithms-master-reference.md +1007 -0
  106. package/squads/squad-content/knowledge-base/video-audio-content-playbook.md +218 -0
  107. package/squads/squad-copy/knowledge-base/ai-copy-production.md +254 -0
  108. package/squads/squad-copy/knowledge-base/brazilian-copywriting-context.md +242 -0
  109. package/squads/squad-copy/knowledge-base/email-copywriting-system.md +299 -0
  110. package/squads/squad-copy/knowledge-base/landing-page-copy-architecture.md +267 -0
  111. package/squads/squad-copy/knowledge-base/power-words-catalog.md +205 -0
  112. package/squads/squad-copy/knowledge-base/seo-copywriting.md +255 -0
  113. package/squads/squad-copy/knowledge-base/video-script-copywriting.md +239 -0
  114. package/squads/squad-council/knowledge-base/brand-strategy-models.md +193 -0
  115. package/squads/squad-council/knowledge-base/growth-strategy-models.md +267 -0
  116. package/squads/squad-council/knowledge-base/innovation-disruption-frameworks.md +193 -0
  117. package/squads/squad-council/knowledge-base/market-analysis-frameworks.md +240 -0
  118. package/squads/squad-council/knowledge-base/organizational-leadership-models.md +212 -0
  119. package/squads/squad-council/knowledge-base/sales-strategy-models.md +215 -0
  120. package/squads/squad-courses/knowledge-base/course-launch-strategy.md +251 -0
  121. package/squads/squad-courses/knowledge-base/domain-advocacia-curriculum.md +385 -0
  122. package/squads/squad-courses/knowledge-base/domain-contabilidade-curriculum.md +266 -0
  123. package/squads/squad-courses/knowledge-base/platform-comparison.md +68 -0
  124. package/squads/squad-courses/knowledge-base/video-production-guide.md +70 -0
  125. package/squads/squad-cybersecurity/knowledge-base/cloud-security-reference.md +363 -0
  126. package/squads/squad-cybersecurity/knowledge-base/compliance-frameworks.md +273 -0
  127. package/squads/squad-cybersecurity/knowledge-base/database-security.md +438 -0
  128. package/squads/squad-cybersecurity/knowledge-base/incident-response-playbook.md +420 -0
  129. package/squads/squad-cybersecurity/knowledge-base/network-security-reference.md +477 -0
  130. package/squads/squad-cybersecurity/knowledge-base/penetration-testing-methodology.md +350 -0
  131. package/squads/squad-cybersecurity/knowledge-base/vulnerability-management.md +349 -0
  132. package/squads/squad-design/knowledge-base/brazilian-design-context.md +223 -0
  133. package/squads/squad-design/knowledge-base/component-api-patterns.md +208 -4
  134. package/squads/squad-design/knowledge-base/design-system-master-reference.md +1302 -0
  135. package/squads/squad-design/knowledge-base/design-systems-frameworks.md +91 -1
  136. package/squads/squad-design/knowledge-base/responsive-modern-css.md +96 -4
  137. package/squads/squad-design/knowledge-base/wcag-aria-reference.md +117 -5
  138. package/squads/squad-design/knowledge-base/web-performance-reference.md +127 -4
  139. package/squads/squad-finance/knowledge-base/brazilian-taxation.md +263 -0
  140. package/squads/squad-finance/knowledge-base/contabilidade-master-reference.md +998 -0
  141. package/squads/squad-finance/knowledge-base/finance-master-reference.md +946 -0
  142. package/squads/squad-finance/knowledge-base/financial-reporting-analysis.md +316 -0
  143. package/squads/squad-finance/knowledge-base/fintech-brazilian-context.md +242 -0
  144. package/squads/squad-finance/knowledge-base/fpa-planning-frameworks.md +286 -0
  145. package/squads/squad-finance/knowledge-base/ma-and-transactions.md +285 -0
  146. package/squads/squad-finance/knowledge-base/risk-management.md +233 -0
  147. package/squads/squad-finance/knowledge-base/startups-venture-capital.md +337 -0
  148. package/squads/squad-growth/knowledge-base/ai-growth-playbook.md +216 -0
  149. package/squads/squad-growth/knowledge-base/attribution-models.md +78 -0
  150. package/squads/squad-growth/knowledge-base/brazilian-growth-context.md +208 -0
  151. package/squads/squad-growth/knowledge-base/community-led-growth.md +175 -0
  152. package/squads/squad-growth/knowledge-base/content-marketing-flywheel.md +190 -0
  153. package/squads/squad-growth/knowledge-base/email-lifecycle-framework.md +192 -0
  154. package/squads/squad-growth/knowledge-base/growth-frameworks-catalog.md +82 -0
  155. package/squads/squad-growth/knowledge-base/growth-master-reference.md +1168 -0
  156. package/squads/squad-growth/knowledge-base/routing-catalog.md +53 -11
  157. package/squads/squad-paidmedia/knowledge-base/audiences-segmentation-deep.md +285 -0
  158. package/squads/squad-paidmedia/knowledge-base/creative-strategy-deep.md +294 -0
  159. package/squads/squad-paidmedia/knowledge-base/google-ads-account-architecture.md +87 -0
  160. package/squads/squad-paidmedia/knowledge-base/meta-ads-campaign-architecture.md +76 -0
  161. package/squads/squad-paidmedia/knowledge-base/paid-media-metrics-reference.md +117 -0
  162. package/squads/squad-paidmedia/knowledge-base/paid-traffic-master-reference.md +1308 -0
  163. package/squads/squad-paidmedia/knowledge-base/routing-catalog.md +95 -18
  164. package/squads/squad-paidmedia/knowledge-base/traffic-masters-frameworks.md +71 -0
  165. package/squads/squad-product/knowledge-base/brazilian-product-context.md +284 -0
  166. package/squads/squad-product/knowledge-base/discovery-methodology-playbook.md +141 -0
  167. package/squads/squad-product/knowledge-base/pm-frameworks-reference.md +125 -9
  168. package/squads/squad-product/knowledge-base/product-analytics-formulas.md +72 -0
  169. package/squads/squad-product/knowledge-base/product-led-growth-reference.md +155 -13
  170. package/squads/squad-product/knowledge-base/product-market-fit-framework.md +222 -0
  171. package/squads/squad-product/knowledge-base/routing-catalog.md +32 -0
  172. package/squads/squad-research/knowledge-base/agentic-second-brain-reference.md +591 -0
  173. package/squads/squad-research/knowledge-base/ai-augmented-research.md +212 -0
  174. package/squads/squad-research/knowledge-base/brazilian-market-research-sources.md +197 -0
  175. package/squads/squad-research/knowledge-base/community-platforms-reference.md +786 -0
  176. package/squads/squad-research/knowledge-base/community-research-methods.md +194 -0
  177. package/squads/squad-research/knowledge-base/mixed-methods-research-design.md +168 -0
  178. package/squads/squad-research/knowledge-base/network-effects-analysis.md +192 -0
  179. package/squads/squad-research/knowledge-base/qualitative-research-deep-methods.md +202 -0
  180. package/squads/squad-research/knowledge-base/quantitative-research-methods.md +208 -0
  181. package/squads/squad-research/knowledge-base/research-frameworks-encyclopedia.md +40 -0
  182. package/squads/squad-research/knowledge-base/research-synthesis-frameworks.md +223 -0
  183. package/squads/squad-storytelling/knowledge-base/brand-mythology-framework.md +236 -0
  184. package/squads/squad-storytelling/knowledge-base/brazilian-storytelling-context.md +237 -0
  185. package/squads/squad-storytelling/knowledge-base/data-storytelling.md +232 -0
  186. package/squads/squad-storytelling/knowledge-base/improv-storytelling.md +226 -0
  187. package/squads/squad-storytelling/knowledge-base/persuasion-narrative-techniques.md +269 -0
  188. package/squads/squad-storytelling/knowledge-base/social-movement-narratives.md +191 -0
  189. package/squads/squad-storytelling/knowledge-base/video-storytelling.md +252 -0
  190. package/squads/claude-code-mastery/data/swarm-orchestration-patterns.yaml +0 -378
  191. package/squads/squad-animations/knowledge-base/framer-motion-complete-reference.md +0 -710
  192. package/squads/squad-animations/knowledge-base/web-animations-api-view-transitions.md +0 -478
@@ -136,3 +136,90 @@ OU
136
136
  - **Target CPA:** comecar 20% acima do CPA medio atual. Reduzir 10-15% a cada 2 semanas.
137
137
  - **Target ROAS:** comecar 20% abaixo do ROAS medio atual. Aumentar 10-15% a cada 2 semanas.
138
138
  - **NUNCA** mudar target mais de 15% de uma vez.
139
+
140
+ ---
141
+
142
+ ## Performance Max (PMax) — Atualizado 2025-2026
143
+
144
+ PMax é a campanha automatizada que roda em TODOS os canais Google simultaneamente:
145
+
146
+ **Canais:** Search, Display, YouTube, Shopping, Gmail, Discover, Maps
147
+
148
+ **O que fornecer:**
149
+ - Asset groups (imagens, vídeos, headlines, descriptions, logos)
150
+ - Feed de produtos (para e-commerce)
151
+ - Sinais de audiência (audience signals — não restrições, apenas hints)
152
+ - Negative keywords (Account-level)
153
+
154
+ ### Negative Keywords no PMax (Atualização jan/2025)
155
+
156
+ - Negative keywords agora disponíveis no nível de campanha via interface do Ads Manager
157
+ - Limite: até **10.000 por campanha** (aumentado de 100 em março/2025)
158
+ - Aplicam-se apenas a inventário de Search e Shopping
159
+ - Display, YouTube, Gmail e Discovery NÃO são afetados por negative keywords
160
+
161
+ ### Channel Reporting PMax (Atualização nov/2025)
162
+
163
+ Novo relatório de performance por canal disponível para todas as campanhas PMax:
164
+ - Breakdown por: Search, Display, YouTube, Shopping
165
+ - Permite identificar qual canal está entregando o resultado
166
+ - Acesso: Reports → Predefined reports → Extensions → Asset details
167
+
168
+ ### Quando Usar / Quando Evitar PMax
169
+
170
+ **Usar:**
171
+ - E-commerce com catálogo amplo
172
+ - Quando já tem dados de conversão suficientes (50+ conversões/30d)
173
+ - Para escala cross-channel com objetivo de conversão
174
+
175
+ **Evitar:**
176
+ - B2B com ciclo de venda longo
177
+ - Produtos de nicho muito específico
178
+ - Quando controle granular é essencial
179
+ - Contas novas sem histórico de dados
180
+
181
+ ### PMax Asset Group Strategy
182
+
183
+ ```
184
+ PMax: [Objetivo]_[Geo]_[YYYY-MM]
185
+ ├── Asset Group: Categoria_Principal (imagens/videos + copy + sinais)
186
+ ├── Asset Group: Categoria_Secundaria
187
+ └── Asset Group: Remarketing (sinais de website visitors)
188
+ ```
189
+
190
+ Cada Asset Group deve ter tema consistente (não misturar produtos/serviços muito diferentes).
191
+
192
+ ---
193
+
194
+ ## Google AI Max for Search (2025-2026)
195
+
196
+ Novo tipo de campanha que aplica automação de AI diretamente a Search:
197
+ - Semelhante ao PMax mas exclusivo para Search
198
+ - **Text guidelines (fev/2026):** Anunciante fornece diretrizes de marca que a AI respeita
199
+ - Expandido globalmente em fevereiro de 2026
200
+ - Combina broad match + responsive ads + URL expansion automática
201
+
202
+ ### Diferença AI Max vs PMax
203
+ | Aspecto | AI Max for Search | Performance Max |
204
+ |---------|------------------|-----------------|
205
+ | Canais | Apenas Search | Todos os canais |
206
+ | Controle | Mais controle (search-only) | Menos controle (cross-channel) |
207
+ | Negative KWs | Sim, funciona normalmente | Apenas Account-level |
208
+ | Ideal para | B2B, serviços, leads | E-commerce, catálogo |
209
+
210
+ ---
211
+
212
+ ## Extensions (Assets) — Lista Completa
213
+
214
+ | Extension | O Que Mostra | Impacto no CTR |
215
+ |-----------|-------------|----------------|
216
+ | **Sitelink** | Links para páginas internas | +10-20% |
217
+ | **Callout** | Textos curtos de benefícios | +5-10% |
218
+ | **Structured Snippet** | Listas de categorias/serviços | +5-10% |
219
+ | **Call** | Número de telefone clicável | +5-10% (mobile) |
220
+ | **Location** | Endereço e mapa | Variável |
221
+ | **Price** | Preços de produtos/serviços | +10-15% |
222
+ | **Promotion** | Ofertas e descontos | +10-20% |
223
+ | **Image** | Imagem ao lado do texto | +5-15% |
224
+
225
+ **Regra:** Adicionar TODAS as extensions relevantes. Sem downside — o Google só mostra quando estima que melhoram performance.
@@ -128,3 +128,79 @@ Ad: VID_Question_v1_0316
128
128
  | ATC | Add to Cart |
129
129
  | IC | Initiate Checkout |
130
130
  | PURCH | Purchasers |
131
+
132
+ ---
133
+
134
+ ## Advantage+ Sales Campaigns (ASC) — Atualizado 2025
135
+
136
+ O Advantage+ Shopping Campaign foi renomeado para **Advantage+ Sales Campaign** em fevereiro de 2025 e expandiu seu escopo:
137
+
138
+ **O que mudou:**
139
+ - Suporta agora: Sales, App Installs e Lead Generation (não apenas e-commerce)
140
+ - Múltiplos ad sets permitidos (antes limitado a 1), cada um com até 50 ads
141
+ - Controles adicionados: exclusão de custom audiences, preferências de idade/gênero
142
+ - Você fornece: catálogo de produtos, criativos, budget, país
143
+ - A Meta otimiza tudo automaticamente
144
+
145
+ **Resultados reportados:** ROAS 15-30% superior vs campanhas manuais em muitos casos.
146
+
147
+ **Quando NÃO usar ASC:**
148
+ - Produtos de nicho muito específico
149
+ - B2B com ciclo de venda longo
150
+ - Serviços complexos que exigem qualificação granular
151
+
152
+ ### Estrutura ASC no Funil
153
+
154
+ ```
155
+ Campaign: ASC_Sales_[YYYY-MM] (Advantage+ Sales, full funnel)
156
+ ├── Ad Set: Prospecting (cold audiences)
157
+ └── Ad Set: Remarketing (existing customers, site visitors)
158
+ ```
159
+
160
+ A Meta gerencia automaticamente a divisão entre prospecting e remarketing. O anunciante pode definir orçamento mínimo por segmento.
161
+
162
+ ---
163
+
164
+ ## ODAX — Objetivos Unificados
165
+
166
+ Meta organiza campanhas em 6 categorias ODAX (Outcome-Driven Ad Experiences):
167
+
168
+ | Objetivo | Otimiza Para | Use Quando |
169
+ |----------|-------------|-----------|
170
+ | **Awareness** | Impressões, alcance, brand recall | Lançamentos, branding de marca |
171
+ | **Traffic** | Link clicks, landing page views | Gerar visitantes qualificados ao site |
172
+ | **Engagement** | Curtidas, comentários, mensagens | WhatsApp CTW, prova social, conteúdo |
173
+ | **Leads** | Formulários, instant forms, conversas | Lead gen B2B e B2C |
174
+ | **App Promotion** | Instalações, eventos in-app | Apps mobile |
175
+ | **Sales** | Purchase, ATC, initiate checkout | E-commerce e conversão direta |
176
+
177
+ **Regra crítica:** O algoritmo otimiza EXATAMENTE para o que você pede. Objetivo de Traffic = clicadores, não compradores. Sempre usar Sales com evento Purchase para campanhas de conversão.
178
+
179
+ ---
180
+
181
+ ## Andromeda — Nova Infraestrutura (2025)
182
+
183
+ Novo motor de ad retrieval da Meta que substitui o sistema anterior:
184
+ - Processa maior variedade de criativos simultaneamente
185
+ - Pode causar volatilidade temporária de CPMs durante fase de adaptação
186
+ - Criativos mais diversificados (diferentes formatos, durações) são favorecidos
187
+
188
+ **Implicação prática:** Maior diversidade de formatos de criativo (imagens, vídeos curtos, carrosseis, Reels) no mesmo ad set melhora a entrega via Andromeda.
189
+
190
+ ---
191
+
192
+ ## Incremental Attribution (Meta, abril 2025)
193
+
194
+ Nova feature no Ads Manager que separa:
195
+ - Conversões **causadas pelo anúncio** (incrementais)
196
+ - Conversões que teriam ocorrido **organicamente** (sem o anúncio)
197
+
198
+ **Como usar:**
199
+ 1. Acessar: Ads Manager → Columns → Customize → Incremental Attribution
200
+ 2. Comparar Incremental CPA vs CPA total reportado
201
+ 3. Usar para decisões de alocação de budget entre canais
202
+
203
+ **Junto com Engaged-View Attribution (2025):**
204
+ - Threshold de visualização reduzido de 10s para **5s** (ou 97% de vídeos curtos)
205
+ - Meta reporta 46% das conversões de compra em Reels nos primeiros 2s de atenção
206
+ - Usar engaged-view para otimização diária; incremental attribution para decisões estratégicas
@@ -131,3 +131,120 @@ Target: depends on business model (DTC tipicamente 3-5x)
131
131
 
132
132
  ### Para Creative Team
133
133
  - CTR por criativo, Hook rate, VTR, Creative fatigue status, Winner/loser patterns
134
+
135
+ ---
136
+
137
+ ## Benchmarks Brasil (BRL) — CPM por Plataforma
138
+
139
+ | Plataforma | Formato | CPM Médio Brasil |
140
+ |-----------|---------|----------------|
141
+ | **Meta — Feed (Foto/Video)** | — | R$15-40 |
142
+ | **Meta — Reels** | — | R$10-25 |
143
+ | **Meta — Stories** | — | R$10-25 |
144
+ | **Google Search** | CPC | R$5-30 por clique |
145
+ | **Google Display** | CPM | R$3-10 |
146
+ | **YouTube Pre-Roll** | CPM | R$15-35 |
147
+ | **YouTube Shorts** | CPM | R$8-20 |
148
+ | **TikTok In-Feed** | CPM | R$8-25 |
149
+ | **LinkedIn Sponsored** | CPM | R$40-120 |
150
+ | **Facebook Feed** | CPM | R$8-20 |
151
+
152
+ *Valores variam por indústria, audiência e sazonalidade. Black Friday pode subir CPMs em 50-200%.*
153
+
154
+ ---
155
+
156
+ ## Métricas de Social Algorithms (Para Organic Synergy)
157
+
158
+ ### Instagram
159
+
160
+ | Métrica | Fórmula | Benchmark 2025 |
161
+ |---------|---------|----------------|
162
+ | **Hook Rate (Reels)** | 3s views / Impressões | >30% bom, >50% excelente |
163
+ | **Completion Rate** | Vídeos completos / Impressões | >50% bom |
164
+ | **Save Rate** | Saves / Reach | >2% conteúdo de referência |
165
+ | **Share Rate (DM)** | DM Shares / Reach | >1% excelente |
166
+ | **Engagement Rate (Reach-based)** | (Likes+Comm+Saves+Shares) / Reach | 1.5-3% Brasil |
167
+
168
+ ### TikTok
169
+
170
+ | Métrica | Fórmula | Benchmark |
171
+ |---------|---------|-----------|
172
+ | **Completion Rate** | Vídeos completos / Impressões | >50% bom para algoritmo |
173
+ | **Watch Time Total** | Soma de segundos assistidos | Relativo ao tamanho do vídeo |
174
+ | **Share Rate** | Shares / Views | >0.5% excelente |
175
+ | **ER TikTok** | (Likes+Comm+Shares) / Views | 5-9% Brasil |
176
+ | **Pool Progression** | Pool 1 → 2 → 3 completion rate | >50% CR cada pool |
177
+
178
+ ### YouTube
179
+
180
+ | Métrica | Fórmula | Benchmark |
181
+ |---------|---------|-----------|
182
+ | **CTR (Thumbnail)** | Cliques / Impressões | 2-10% dependendo do nicho |
183
+ | **AVD (Avg View Duration)** | Total watch time / Views | >50% do vídeo |
184
+ | **Session Start Rate** | Vídeos que iniciaram sessões | Alto = boost no Browse |
185
+ | **Shorts Loop Rate** | Views com loop / Total views | Sinal positivo forte |
186
+
187
+ ### LinkedIn
188
+
189
+ | Métrica | Fórmula | Benchmark |
190
+ |---------|---------|-----------|
191
+ | **Dwell Time** | Segundos médios no post | 30s+ = alta qualidade |
192
+ | **ER LinkedIn** | (Reactions+Comm+Reposts) / Impressões | 2-5% bom, >5% excelente |
193
+ | **SSI Score** | Índice 0-100 LinkedIn | >70 para creators |
194
+
195
+ ---
196
+
197
+ ## Formulas de Atribuição
198
+
199
+ ### MER (Marketing Efficiency Ratio)
200
+ ```
201
+ MER = Receita Total do Negócio / Custo Total de Marketing
202
+
203
+ Alvo DTC: 3-5x
204
+ ```
205
+
206
+ ### Break-Even ROAS (com Margem)
207
+ ```
208
+ Break-Even ROAS = 1 / Margem Bruta
209
+
210
+ Se margem = 30% → Break-Even ROAS = 3.33x
211
+ Se margem = 50% → Break-Even ROAS = 2.0x
212
+ ```
213
+
214
+ ### LTV:CAC e Payback Period
215
+ ```
216
+ LTV:CAC = Lifetime Value / Customer Acquisition Cost
217
+ Alvo: >3:1
218
+
219
+ Payback Period = CAC / (Receita mensal por cliente × Margem)
220
+ Alvo: <12 meses (SaaS), <6 meses (e-commerce)
221
+ ```
222
+
223
+ ### Contribution Margin por Pedido
224
+ ```
225
+ Contribution Margin = Receita - COGS - Ads - Shipping - Payment fees - Returns
226
+
227
+ Métrica mais honesta de lucratividade por pedido
228
+ ```
229
+
230
+ ---
231
+
232
+ ## Métricas de Video Ads — Hierarquia de Importância
233
+
234
+ ```
235
+ 1. CPA / ROAS (resultado final)
236
+ ↑ determinado por:
237
+ 2. CVR (landing page + offer)
238
+ ↑ influenciado por:
239
+ 3. CTR (relevância do criativo + audiência)
240
+ ↑ influenciado por:
241
+ 4. Hook Rate (primeiros 3 segundos)
242
+ ↑ determinado por:
243
+ 5. Completion Rate (retenção do vídeo)
244
+ ```
245
+
246
+ **Para diagnóstico de underperformance:**
247
+ - CPA alto + CVR baixo = problema de landing page/oferta
248
+ - CPA alto + CVR ok + CTR baixo = problema de criativo ou audiência
249
+ - CTR baixo + Hook Rate baixo = problema de hook (primeiros 3s)
250
+ - CTR ok + Completion baixo = o vídeo não entrega o que o hook promete