Criativos (Creatives)¶

O módulo de Criativos é a central de geração e governança de peças publicitárias de resposta direta (direct response copywriting) da Brandvelia. Ele utiliza o gateway interno OpenRouter para produzir variações de anúncios em total conformidade com as diretrizes das principais redes de tráfego.

Estrutura de um Criativo¶

Cada criativo gerado armazena metadados e conteúdo estruturado:

Campo	Descrição
`id`	Identificador único (`BV_ID`) no escopo do workspace.
`platform`	Rede de destino: `META` (Facebook/Instagram), `GOOGLE`, `TIKTOK`, `YOUTUBE`, `NATIVE`.
`target_age`	Faixa etária e perfil do público-alvo pretendido.
`headline`	Título / Gancho magnético (Hook) focado em curiosidade, dor ou benefício.
`content`	Corpo do texto do anúncio (Body copy) estruturado para retenção e clique.
`rationale`	Justificativa estratégica da IA explicando por que aquele ângulo funciona para o público.
`compliance_status`	Status de conformidade: aprovado pelo validador sem termos de risco.

Contrato de Geração e Regras de Compliance¶

O endpoint de geração de criativos (/api/ai/creative) aplica regras rígidas de proteção de conta:

Bloqueio de Promessas Milagrosas: Proibição explícita de alegações de cura definitiva, resultados rápidos garantidos ou retorno financeiro irrealista.
Sem Falsa Escassez ou Depoimentos Fictícios: Não são permitidos cronômetros falsos ou histórias atribuídas a especialistas inexistentes.
Sem Uso Indevido de Imagem: Bloqueio de nomes de celebridades, figuras públicas e marcas comerciais sem autorização formal.
Formato JSON Estruturado Obrigatório: O modelo deve retornar exclusivamente o payload validado com Zod: { headline, content, rationale }.
Multi-idioma: Suporte nativo à geração em Português (pt), Inglês (en) e Espanhol (es).

Inteligência Competitiva & Espionagem de Anúncios (Spy Workflow)¶

Para que iniciantes e operadores experientes possam modelar o que já está funcionando no mercado americano antes de investir capital:

Simulação Geográfica US via usearchfrom.com:
Permite visualizar a SERP real dos EUA sem necessidade de VPN paga. As consultas obrigatórias do Spy são: [Product], Buy [Product], [Product] Reviews, [Product] Official Website, [Product] Discount Code e Is [Product] Legit — cada uma com link usearchfrom e link direto do Google US (pws=0&gl=us&hl=en, sem personalização).
Google Ads Transparency Center:
Visualização de todos os anúncios ativos no Google para o domínio do fabricante ou concorrentes diretos.
Meta Ad Library (Facebook & Instagram):
Filtro de anúncios ativos há mais de 7 a 14 dias (indicador chave de ROI e escala comprovada).
Diagnóstico competitivo persistente (Fase 4):
O operador cola múltiplos anúncios/textos observados (um bloco por anúncio); a IA analisa somente o material colado — nunca inventa concorrentes ou alegações; sem evidência, responde insufficient_evidence.
O resultado estruturado (hooks emocionais, bônus/escassez, posicionamento, objeções, gaps, ângulos fracos, diferenciação recomendada, alertas de compliance e resumo das fontes) é salvo em bv_offer_ai_analyses com analysis_type='competitor_diagnostic', hash determinístico da entrada e contagem de fontes. Reanalisar o mesmo material atualiza em vez de duplicar.
Síntese de Criativos com IA Copilot (/api/ai/creative):
O operador cola os títulos e ganchos observados no mercado. A IA disseca a estrutura psicológica, quebra de objeções e gatilhos de curiosidade, gerando peças inéditas, persuasivas e 100% aderentes às políticas das plataformas.
Competitor Campaign Synthesizer (POST /api/ai/ad-pack):
A rota recebe IDs (oferta/snapshot) e recarrega Oferta + Diagnóstico no servidor — fatos de oferta enviados pelo browser não são usados;
Gera o pacote completo RSA em um clique: exatamente 15 títulos categorizados (Marca / Benefício / Urgência / Oferta, ≤30 chars), 4 descrições (≤90), 4 sitelinks (≤25/≤35), 6–8 callouts (≤25), Structured Snippets (header ≤25 + 3–10 valores ≤25) e keywords separadas em keywordsExact [exact] · keywordsPhrase "phrase" · keywordsNegative;
Arquitetura híbrida: a IA gera a copy; o merge determinístico (packages/integrations/src/google/ad-pack-synthesis.ts) valida limites do Google, deduplica e completa o pacote com os templates do buildGoogleSearchCampaignPack (contrato verificado por validateRsaPackContract). Negativas = união IA + lista mestre curada (IA nunca remove termos);
Preview reutilizável (AdPackPreview): abas Desktop · Mobile · Assets · Keywords · Negativas, contadores de caracteres, categoria dos headlines, cópia por seção e CSV do Google Ads Editor com neutralização de CSV injection e UTF-8 (BOM);
Ações diretas: Salvar Criativos na Oferta (grava em bv_creatives, type='static_ad', content = JSON do pacote) e Lançar com estes anúncios — abre (ou retoma) a jornada de lançamento da oferta e leva o pacote para o passo 3 (Anúncios), onde a pressel e o orçamento são definidos antes de qualquer envio ao Google. O antigo "Criar Campanha e Criativos" (campanha sem pressel) foi removido; a RPC bv_create_campaign_with_creative segue no banco, sem uso pelo app.

Modelos e Registro de Custos¶

A geração utiliza modelos configurados na tabela bv_ai_models (como anthropic/claude-3.5-sonnet ou openai/gpt-4o-mini). Cada chamada registra os tokens de entrada e saída, latência e custo financeiro em bv_ai_runs, alimentando o relatório de custos de IA em Finanças.