Gaviões 24h — Agente de Tráfego

Visão Geral — Todas as Unidades

Investimento total

—

Contatos

—

Vendas

—

Custo por Contato

—

Teto: mês anterior × multiplicador

Custo por Venda

—

Teto: ticket médio × multiplicador

Retorno sobre Investimento

—

Mínimo: 4x

Receita prevista imediata

—

vendas × ticket médio (R$ 130,42)

Receita prevista ao longo do tempo

—

receita imediata × LTV (9,3 meses)

Evolução ao longo do tempo

Distribuição Demográfica

Idade

Gênero

Região

Vendas

Contatos

Cliques

Impressões

Alcance

Gestor de Tráfego — Academia Gaviões 24h

Sou o agente operacional de tráfego, treinado com os Pilares 1, 2 e 3 do Playbook. Tenho acesso real à Meta Ads API e posso:

🔍 Análise (sem aprovação): listar campanhas, detalhar adsets/segmentação, diagnosticar pelo PMDO
⚠️ Ação (com aprovação): pausar/ativar campanhas, alterar orçamento, duplicar para A/B

Toda alteração destrutiva passa por card de aprovação aqui no chat — você decide antes de executar. O que vamos resolver hoje?

Diagnostique todas as campanhas ativas pelo PMDO

Quais campanhas estão queimando verba sem vendas?

Detalhe a campanha com pior CPV

Alguma campanha com frequência > 4?

Plano de ação corretiva pra esta semana

Quais campanhas devo pausar agora?

Diagnóstico PMDO — Gatilhos ativos

Cada gatilho recebe uma nota de 0–100 (quanto mais alto, mais atenção). A tabela está ordenada pela unidade que mais precisa de ação (soma das notas) → menor.

Unidade ↕	Tipo ↕	Gatilho ↕	Nota ↕	Ação recomendada
Carregando…

Aguardando dados

Análise por unidade

Selecione uma unidade para ver a análise individual

Visão geral — Todas as unidades

	Unidade ↕	Objetivo ↕	Investimento ↕	Vendas ↕	Custo/Venda ↕	Contatos ↕	Custo/Contato ↕	ROI ↕	Receita LTV ↕	Otim.
Carregando…

Estrutura de campanhas C1–C7 — 4 etapas

ETAPA 1

Geração de Audiência

~60 dias antes da inauguração

C1Reconhecimento — vídeos 15s, renders 3D, banners "Em Breve"

C2Tráfego Perfil — ativa em TODAS as etapas

ETAPA 2

Pré-Venda

~15 dias antes da inauguração

C2Tráfego Perfil (continua)

C3Mensagem WhatsApp — Lote 1

C4Virada de Lote — urgência

C5Último Lote — escassez final

ETAPA 3

Perpétuo

Pós-inauguração — operação contínua

C2Tráfego Perfil (continua)

C6Venda Direta — fotos reais + depoimentos

C7Distribuição — posts orgânicos impulsionados

ETAPA 4

Comercial

Ações esporádicas — qualquer momento

—Sazonais: Dia das Mães, Black Friday

—Promoções: Mês do Amigo, Taxa Zero

—Engajamento: Desafios, aulões, eventos

Detalhes técnicos do Pilar 1

Padrão de nome de campanha

▸

Palma1 - C3 - Mensagem WPP Lote 1

▸

LemSP1 - C6 - Venda Direta WPP

▸

Goian1 - C2 - Tráfego Perfil

Segmentação padrão

▸

Geográfica: raio 3-5km da unidade

▸

Interesses: fitness, musculação, artes marciais, vida saudável

▸

Lookalike: 1-3% (a partir de matriculados ou engajados)

▸

Retargeting: janelas de 7-30 dias

▸

Idade: 18-55 (ajustar por unidade)

Hierarquia de gatilhos PMDO

Protocolo Mestre de Diagnóstico e Otimização

GP1

CPA > R$ 200 — Gatilho Primário 1

Agência: 24h para diagnóstico + plano de ação escrito

GP2

CPL > R$ 10 — Gatilho Primário 2

Se CTR<0,55% → criativo ruim. Se CPM>R$13,50 → audiência cara. Senão → lead mal qualificado

Frequência > 4,0 — Saturação de público

Novos criativos, expandir audiência, excluir engajados 7–15 dias — 48h

CPC > R$ 4 — Custo por clique elevado

Revisar copy e gancho, testar formatos, ajustar lances — 48h

CTR < 0,55% — Baixa relevância do criativo

Pausar anúncios, criar novos, teste A/B — 48h

⚑

Regra dos 7 dias

Se gatilho continuar após ação → escalonamento automático para o Hub

Diagnóstico de funil

▸

CPA alto + CPL alto → problema de mídia — agência ajusta

▸

CPA alto + CPL baixo → problema comercial — gestão intervém

▸

CPL bom + matrículas baixas → problema no atendimento/vendas

Como o painel calcula cada métrica

▸

Investimento: spend · direto

▸

Vendas: actions[] → omni_purchase (1ª prioridade), purchase, offsite_conversion.fb_pixel_purchase · direto

▸

Contatos: actions[] → onsite_conversion.messaging_conversation_started_7d (1ª prioridade), messaging_conversation_started · direto

▸

Custo/Venda (CPV): — · spend ÷ vendas (nulo se vendas = 0)

▸

Custo/Contato (CPL): — · spend ÷ contatos (nulo se contatos = 0)

▸

CTR, CPM, CPC, Frequência: ctr, cpm, cpc, frequency · direto (CTR é multiplicado por 100 pra virar percentual)

Tetos dinâmicos

▸

Teto Custo/Venda (CPV): ticket_medio × multiplicador · mult = 1,5×

▸

Teto Custo/Contato (CPL): R$ 10 (fixo do playbook) · —

Pontuação dos gatilhos (0–100)

Cada gatilho acionado recebe uma nota individual. Quanto maior, mais atenção. Gatilhos com nota zero não aparecem na lista. As notas são ordenadas pela criticidade do playbook: GP1 > GP2 > GS Frequência > GS CTR. Em uma campanha com vários gatilhos, o painel mostra apenas o mais crítico — clique para ver todos.

GP1 — Custo por Venda (CPV) — máxima prioridade

▸

Condição: vendas == 0 && spend > teto_cpv

▸

Fórmula: nota = max(50, min(100, 50 + log2(spend/teto) / log2(16) × 50))

▸

Começa em 50 (já é grave) e cresce até 100 conforme queima mais tetos sem retorno.

▸

Condição: cpv > teto_cpv

▸

Fórmula: nota = max(0, min(100, log2(cpv/teto) / log2(16) × 100))

▸

Escala log base 2: cada dobra acima do teto vale ~25 pontos.

▸

Exemplo (teto R$ 200): CPV R$ 240 → 5 · R$ 300 → 15 · R$ 400 → 25 · R$ 800 → 50 · R$ 1.600 → 75 · R$ 3.200 → 100

GP2 — Custo por Lead/Contato (CPL)

▸

Condição: cpl > R$ 10 (teto fixo)

▸

Fórmula: nota = max(0, min(100, log2(cpl/10) / log2(128) × 100))

▸

Escala log base 2 com saturação em 128× (R$ 1.280).

▸

Exemplo: R$ 11 → 1 · R$ 15 → 6 · R$ 20 → 14 · R$ 40 → 29 · R$ 80 → 43 · R$ 160 → 57 · R$ 320 → 71 · R$ 640 → 86 · R$ 1.280 → 100

GS — Frequência > 4,0

▸

Condição: frequency > 4

▸

Fórmula: nota = max(0, min(100, log2(freq/4) / log2(2) × 100)) = min(100, log2(freq/4) × 100)

▸

Exemplo: 4,5 → 18 · 5,0 → 32 · 6,0 → 58 · 7,0 → 78 · 8,0 → 100

▸

A partir de freq 4, dobrar a frequência (8) já é catastrófico (100).

▸

Ação (48h): novos criativos, expandir audiência, excluir engajados 7-15 dias.

GS — CTR < 0,55% (relevância do criativo)

▸

Condição: ctr < 0,55% E GP2 não está acionado para a mesma campanha

▸

Por que a exceção? Quando CPL alto + CTR baixo, o GP2 já cobre via diagnóstico "criativo irrelevante" → evita dupla contagem.

▸

Fórmula: nota = min(100, ((0,55 - ctr) / 0,55) × 100)

▸

Linear (não log), porque a faixa é limitada (0% a 0,55%). Mede o quanto está abaixo do limite, em percentual.

▸

Exemplo: 0,50% → 9 · 0,40% → 27 · 0,30% → 45 · 0,20% → 64 · 0,10% → 82 · 0% → 100

▸

Ação (48h): pausar anúncios ruins, criar novos, A/B contra o melhor atual.

Gates removidos da v atual

▸

~~GS — CPC > R$ 4~~ (absorvido pelo diagnóstico do GP2)

▸

~~GS — CPM > R$ 13,50~~ (absorvido pelo diagnóstico do GP2)

Cores das notas

▸

0–39: 🔵 azul/âmbar suave · atenção leve, monitorar

▸

40–69: 🟡 âmbar · intervenção necessária, mas não emergencial

▸

70–100: 🔴 vermelho · crítico — ação imediata

Ciclo PDCA

PLAN

▸Mapeamento de etapa por unidade

▸Campanhas C1–C7 a ativar

▸Orçamento e distribuição

▸Calendário e datas

▸Briefing de criativos

▸Setup técnico ≤10 dias úteis

▸Lançamento conforme Pilar 1

▸Monitoramento diário

▸1 teste A/B/semana/unidade

▸Planilha até 12h do dia seguinte

CHECK

▸Check semanal — toda segunda

▸Quinzenal — reunião 30–45min

▸Mensal — comparativo completo

▸Análise de funil completo

▸Top 3 e Bottom 3 unidades

ACT

▸GP1/GP2 → 24h diagnóstico

▸Secundários → 48h ação

▸Regra 7 dias → escalonamento

▸Plano por escrito obrigatório

▸Aprendizados → banco criativos

Escalonamento

Nível 1
0–48h

Agência resolveIdentifica, corrige, documenta e comunica o Hub.

Nível 2
48h–7 dias

Hub intervémRevisão conjunta. Hub pode exigir mudanças. Deadline: +7 dias.

Nível 3
14+ dias

Ary decideWARNING (30 dias última chance) ou SUBSTITUIÇÃO.

Detalhes do Pilar 3 — atribuições e contexto

1. Atribuições da AGÊNCIA (operacional + analítico)

1.1 Configuração e Manutenção Técnica

▸

Criar e otimizar páginas de Facebook por unidade

▸

Criar e gerenciar contas de anúncios (Meta Ads + Google Ads)

▸

Instalar pixels e tags (Meta Pixel, GA4, GTM)

▸

Configurar eventos de conversão (clique WhatsApp, formulário, checkout)

▸

Otimizar landing pages (A/B de elementos/copies/CTAs)

▸

Setup técnico completo em ≤10 dias úteis

1.2 Gestão e Otimização de Campanhas

▸

Pesquisa de público e segmentação aprofundada

▸

Pesquisa de palavras-chave (Google Ads)

▸

Estruturação de campanhas, conjuntos, lances e orçamentos

▸

Otimização DIÁRIA de lances/orçamentos

▸

Testes A/B sistemáticos (mínimo 1 por semana, por unidade)

▸

Retargeting + Lookalike

▸

Briefings detalhados pro time de criação

▸

Exploração de novos canais/formatos (TikTok Ads, Pinterest Ads)

1.3 Análise de Dados e Relatórios

▸

Monitoramento DIÁRIO de KPIs (CPC, CPM, CTR, ROAS, ROI, CPA, CPL)

▸

Análise de funil de vendas (identificar gargalos)

▸

Planilha de acompanhamento atualizada até 12h do dia seguinte

▸

Relatórios semanais e mensais (Looker Studio / Sheets)

▸

Análise competitiva (estratégias dos concorrentes)

2. Atribuições da GESTÃO (Ari Guariza — estratégico + insumos)

2.1 Direcionamento e Recursos

▸

Definir metas (matrículas, faturamento, CPL máximo, ROI mínimo)

▸

Alocar orçamento (total + por unidade + por campanha)

▸

Fornecer materiais de branding (logos, fotos, renders, vídeos)

▸

Manter agência atualizada sobre status da obra, datas, planos, promoções

▸

Conceder acessos administrativos (Meta Ads, Google Ads, GA, CRM, WhatsApp Business)

2.2 Gestão e Acompanhamento

▸

Reuniões periódicas (semanais/quinzenais) com a agência

▸

Aprovar criativos, copies, segmentações

▸

Análise crítica dos relatórios (questionar dados, pedir aprofundamento)

▸

Gerenciar expectativas da diretoria (Priscila/Leandro/Daniel)

▸

Integrar agência com time de vendas (feedback de qualidade dos leads)

▸

Validar propostas de novos canais/formatos

Avaliação trimestral da agência

Performance

50%

▸CPA < R$ 200

▸CPL < R$ 10

▸Meta de matrículas atingida

▸Evolução mês a mês positiva

Compliance

30%

▸Planilha diária até 12h

▸Relatórios quinzenais e mensais

▸SLAs de escalonamento

▸Setup técnico correto

Proatividade

20%

▸Melhorias espontâneas

▸A/B além do mínimo

▸Benchmarks de mercado

▸Otimizações proativas

Resultado possível

✓

CONTINUA — performance dentro ou acima do esperado

⚠

WARNING — 1+ critérios abaixo. Plano de melhoria 30 dias.

✗

SUBSTITUIÇÃO — 2 warnings consecutivos ou falha crítica.

Parâmetros do negócio

Esses valores são usados nos cálculos de receita e ROI da aba Unidades. Ficam salvos no navegador.

Ticket Médio (R$)

Valor médio de cada venda. Usado em: Receita prevista imediata = vendas × ticket médio

LTV — Tempo de permanência (meses)

Quanto tempo o aluno fica na unidade, em meses. Usado em: Receita ao longo do tempo = receita imediata × LTV

Multiplicador Custo por Contato (×)

Teto = (custo por contato do mês anterior) × este multiplicador. Deixe vazio para usar 1× (igual ao mês anterior).

Multiplicador Custo por Venda (×)

Teto = ticket médio × este multiplicador. Quanto estamos dispostos a pagar por venda. Deixe vazio para usar 1,5× (padrão).

ROI Mínimo (x)

Retorno mínimo sobre investimento. Abaixo disso, gatilho de alerta.

Ignorar campanhas que contém

Termos separados por vírgula. Campanhas cujo nome contenha qualquer um destes termos serão ignoradas em todo o sistema (PMDO, Unidades, totais, IA). Deixe vazio para não ignorar nada.

Nota: Os tetos de Custo por Contato (custo do mês anterior × multiplicador configurável acima) e Custo por Venda (ticket médio × multiplicador, padrão 1,5×) são dinâmicos — puxados automaticamente do Meta Ads.

Gestão de usuários

Apenas usuários ADM podem gerenciar acessos. Os 3 níveis disponíveis: LEITURA e EDIÇÃO veem tudo no painel mas não acessam Configurações. ADM tem acesso total.

Adicionar novo usuário

Usuários cadastrados

Usuário	Nível	Criado em	Ações
Carregando…

Documentação técnica — Mapeamento de dados

Fonte dos dados Todos os dados exibidos neste painel vêm diretamente da Meta Graph API v19.0, a mesma API que alimenta o Gerenciador de Anúncios do Meta. Nenhum dado é estimado, simulado ou inserido manualmente. O Worker (backend) faz as chamadas autenticadas e repassa os dados brutos para o frontend.

Colunas do Dashboard e Campanhas

Investimento

▸

Campo da API: spend
Valor total gasto na campanha no período selecionado. Equivale à coluna "Valor usado" no Gerenciador de Anúncios.
Tipo: valor direto (sem cálculo)

Vendas (Compras)

▸

Campo da API: actions → busca por action_type
Tipos aceitos (por prioridade):
1. omni_purchase — compras omnichannel (online + loja física). Este é o tipo principal usado pelo Meta no Gerenciador de Anúncios quando a coluna "Compras" está configurada.
2. purchase — compras online (Pixel/CAPI)
3. offsite_conversion.fb_pixel_purchase — compras registradas pelo Pixel do Facebook

Lógica: o sistema busca o primeiro tipo encontrado nessa ordem. O omni_purchase é a soma de todas as compras (online + offline), por isso bate com o Gerenciador de Anúncios.
Tipo: valor direto do campo value da action encontrada

Custo por Venda

▸

Cálculo: spend ÷ vendas
Investimento total dividido pelo número de compras (omni_purchase). Equivale à coluna "Custo por compra" no Gerenciador de Anúncios.
Alerta vermelho: quando ultrapassa R$ 200 (referência do Playbook Gaviões)

Contatos (Conversas)

▸

Campo da API: actions → busca por action_type
Tipos aceitos (por prioridade):
1. onsite_conversion.messaging_conversation_started_7d — conversas iniciadas via Messenger/WhatsApp/Instagram Direct nos últimos 7 dias após ver o anúncio
2. messaging_conversation_started — conversas iniciadas (formato alternativo)

Lógica: busca o primeiro tipo encontrado. Equivale à coluna "Conversas por mensagem iniciadas" no Gerenciador de Anúncios.
Tipo: valor direto do campo value da action encontrada

Custo por Contato

▸

Cálculo: spend ÷ contatos
Investimento total dividido pelo número de conversas iniciadas. Equivale à coluna "Custo por conversa por mensagem iniciada" no Gerenciador de Anúncios.
Alerta vermelho: quando ultrapassa R$ 10 (limite do Playbook Gaviões)

Cards de métricas (topo do Dashboard)

▸

Investimento total: soma de spend de todas as campanhas ativas e pausadas que tiveram gasto no período

▸

Vendas: soma de omni_purchase de todas as campanhas ativas e pausadas no período

▸

Custo por Venda: investimento total ÷ vendas totais

▸

Custo por Contato: investimento total ÷ contatos totais

Filtros aplicados

▸

Status: campanhas com effective_status IN (ACTIVE, PAUSED) — pausadas com gasto no período entram no total pra bater com o Gerenciador. PMDO ignora pausadas (não faz sentido recomendar ação pra campanha já parada).

▸

Limite: até 100 campanhas por requisição

▸

Períodos disponíveis: last_7d (7 dias), last_30d (30 dias), last_90d (90 dias)

▸

Endpoint: GET /{ad_account}/campaigns com insights.date_preset()

Diagnóstico PMDO — Gatilhos automáticos

▸

CPL > R$ 10 (GP2): usa spend ÷ contatos por campanha. Diagnóstico automático: se CTR < 0,55% → criativo ruim; se CPM > R$ 13,50 → audiência cara; senão → lead mal qualificado

▸

Frequência > 4,0 (GS): usa campo frequency da API. Indica saturação de público.

▸

CTR < 0,55% (GS): usa campo ctr da API (multiplicado por 100 para percentual). Indica baixa relevância do criativo.

Arquitetura técnica

▸

Frontend: gavioes-painel.pages.dev — Cloudflare Pages (HTML estático)

▸

Backend: gavioes-agente-trafego.arijguariza.workers.dev — Cloudflare Worker

▸

Segurança: token Meta e chave Anthropic ficam como secrets no Worker. Nunca expostos no frontend. Login com JWT (8h de expiração).

▸

Chat IA: usa Claude Sonnet via API Anthropic, com system prompt do Playbook Gaviões (Pilares 1, 2, 3 + PDCA)

▸

API do Meta: Graph API v19.0 — chamadas autenticadas pelo Worker com token de usuário do sistema (BM)