Ir para o conteúdo

Campanhas (Campaigns)

O módulo de Campanhas gerencia a camada de tráfego pago da Brandvelia. Uma campanha conecta o objeto de venda (Oferta), o destino de conversão (Landing Page) e a peça publicitária (Criativo), controlando o orçamento diário, limites de gasto e fases operacionais.

Campos e Estrutura da Campanha

Campo Significado e Uso
name Nome da campanha (ex: [CB-PROD] Google - US - Search - Dor Articular).
launch_product Oferta associada (BV_Product).
launch_landing Landing/Bridge page de destino vinculada.
launch_creative Criativo ou ângulo publicitário utilizado.
budget_daily Orçamento diário estabelecido em USD.
status Estado operacional: DRAFT, ACTIVE, PAUSED, ARCHIVED.
pause_type Condição de pausa automática ou manual por stop-loss.
ad_spend Gasto total acumulado em mídia paga.
net_revenue Receita líquida gerada e atribuída à campanha.
net_roas ROAS líquido determinístico: $\text{Receita Líquida} / \text{Ad Spend}$.

Estrutura de Campanhas Google Ads Search (Fundo de Funil)

Para afiliados que vendem ofertas internacionais em USD no Google Ads, a Brandvelia adota a estrutura STAG (Single Theme Ad Groups) focada em intenção máxima de compra:

1. Grupos de Anúncios STAG

  • Grupo 1: Brand Exact (Marca Exata): Termos em correspondência exata [Nome do Produto], [Nome do Produto Official], [Nome do Produto Official Website].
  • Grupo 2: Buy Intent (Intenção de Compra): Termos como [Buy Nome do Produto], [Order Nome do Produto], [Nome do Produto Price], "Buy Nome do Produto online".
  • Grupo 3: Reviews & Results: Termos como [Nome do Produto Review], [Nome do Produto Customer Reviews], "Honest Nome do Produto review".

2. Gerador Automatizado de RSA (Responsive Search Ads)

A Brandvelia gera automaticamente pacotes de anúncios compatíveis com as diretrizes do Google Ads: - 15 Títulos (Headlines $\le 30$ caracteres): Com Dynamic Keyword Insertion {KeyWord:Official Store}, apelo de garantia de 60 dias, desconto oficial de até 75% e frete grátis nos EUA. - 4 Descrições ($\le 90$ caracteres): Destaque para fórmula original, entrega rápida e garantia incondicional de reembolso.

3. Lista Mestra de Palavras-Chave Negativas

Para blindar o orçamento diário contra cliques não-compradores, o sistema fornece uma lista mestra de mais de 100 termos negativos em inglês dividida em categorias: - Suporte / Área de Membros: login, log in, sign in, portal, member, password, customer service, contact number, phone number, email address, help desk, support. - Cancelamento / Reembolso: cancel, cancellation, refund, chargeback, complaint, bbb, scam, fraud, fake, hoax, side effects, danger, warning. - Pirataria / Gratuidade: free, pdf, ebook, download, torrent, crack, coupon code free, voucher free, diy, recipe. - Concorrentes & Marketplaces: amazon, walmart, ebay, cvs, walgreens, target, gnc, costco, chemist warehouse, aliexpress. - Pesquisa Acadêmica: wikipedia, reddit, quora, youtube, scientific paper, clinical study, fda approval letter, shark tank.

Estrutura de Campanhas Meta Ads (Facebook & Instagram)

Status: desativado. O operador atual roda apenas Google Ads. Os geradores Meta (3x3x3) e o pipeline CAPI permanecem no pacote @brandvelia/integrations em modo dormente, com testes, para reativação futura sem retrabalho.

Para escala e tráfego de descoberta no Meta Ads, a Brandvelia automatiza a matriz de testes 3x3x3:

1. Framework de Conjuntos de Anúncios (ABO / Testes)

  • AdSet 1 — Broad Advantage+: Público aberto segmentado por idade (ex: 35-65+) no país alvo (US), deixando o algoritmo do Meta encontrar compradores com base nos criativos.
  • AdSet 2 — Niche Interest Stack: Pilha de interesses em saúde natural, nutrição e bem-estar.
  • AdSet 3 — Problem Segment: Foco demográfico em quem busca prevenção e longevidade.

2. Matriz de Ângulos Criativos (3x3x3)

A plataforma gera automaticamente 3 variações completas com hooks de alto impacto: 1. Ângulo 1: Story & Discovery (Emocional / Jornada): Narrativa em primeira pessoa com quebra de ceticismo e revelação do ritual diário. 2. Ângulo 2: Scientific Mechanism (Causa Raiz & Mecanismo Único): Apelo científico focado no gatilho celular/biológico e ingredientes proprietários. 3. Ângulo 3: Warning & Direct Benefit (Alerta / Quebra de Padrão): Quebra de padrão sobre métodos convencionais e destaque para a garantia incondicional de 60 dias.

3. Meta Conversions API (CAPI Server-Side)

  • Rastreamento server-side via Graph API v22.0 com deduplicação por event_id = click_id.
  • Hashing criptográfico em SHA-256 de dados de usuário (em, ph, client_ip_address, fbp, fbc) para alimentar o algoritmo de lances inteligentes do Meta com vendas reais.

Fases do Motor de Decisão (Grafo Operacional)

No Brandvelia OS, campanhas de tráfego seguem uma máquina de estados finitos com transições auditadas:

PREFLIGHT → TEST → VALIDATE → SCALE → HOLD / BLOCKED / CLOSED
  1. PREFLIGHT: Avaliação econômica em cenários LOW/BASE/HIGH e verificação de saldo de capital disponível ($C_a$).
  2. TEST: Teste inicial com orçamento restrito ao valor de 1× o payout da oferta para validação de cliques e checkouts (medir CTR por coorte; sem meta fixa).

Jornada de lançamento (preparação persistente)

Entrada única Preparar lançamento (Radar, Ofertas, Campanhas) → /app/campaigns/wizard?launch_id=<uuid> com 4 etapas (Produto e afiliação → Sua pressel → Anúncios e orçamento → Revisar e criar no Google pausada). Rascunho de campanha via save_launch_campaign_draft (UUIDs reais, replay idempotente); envio só CREATE_PAUSED com claim direcionado e confirmação remota; ativação é decisão posterior explícita. Economia canônica via scenario_derived_economics; desconhecido aparece como desconhecido. 3. VALIDATE: Confirmação de consistência com pelo menos 10 a 15 conversões e taxa de reembolso monitorada. 4. SCALE: Escala gradual de orçamento (+20% a 50% ao dia) mantendo ROAS Líquido > 1.6. 5. HOLD / BLOCKED: Pausa automática por quebra de premissas, stop-loss atingido ou capital insuficiente.

Rastreamento de Tráfego e Repasse de Parâmetros

Para análise de tráfego sem depender de cookies de terceiros e com precisão cirúrgica: - Rastreamento completo de parâmetros UTM (utm_source, utm_medium, utm_campaign, utm_content, utm_term, keyword); - Captura de identificadores de clique das redes (gclid, fbclid, ttclid); - Repasse transparente para o HopLink (extclid = click_id) e ingestão pós-venda via webhooks (INS / IPN).