Guia do Gestor de Tráfego

Manual prático para quem usa o Gestão de Tráfego no dia a dia.

1. Primeiros passos

1. Criar conta em /cadastro.
2. Confirmar e-mail clicando no link recebido.
3. Fazer login → você cai no dashboard.
4. Siga o tour de 5 passos que aparece automaticamente.
5. Complete o checklist de primeiros passos no dashboard.

2. Fluxo de trabalho

Cliente → Campanha → Diagnóstico → Plano → Métricas → Relatório
                                       ↓
                                     Leads

Ordem recomendada

1. Cadastre o cliente (uma vez).
2. Cadastre a campanha (por canal e objetivo).
3. Faça o diagnóstico — responda 8 perguntas, receba score e recomendações.
4. Gere o plano — recomendação vira checklist executável.
5. Lance métricas diariamente (ou importe CSV semanalmente).
6. Mova leads no Kanban conforme o funil avança.
7. Gere relatório mensal para o cliente.

3. Cadastro de cliente

Menu Clientes → Novo cliente.

• Nome (obrigatório, único por usuário).
• Segmento, cidade, contato, site (opcionais).
• Ao salvar, o cliente aparece na lista.

Dica: use nomes que você reconheça rapidamente (ex.: Escola Bella — Teresópolis).

4. Cadastro de campanha

Menu Campanhas → Nova campanha.

• Cliente (obrigatório).
• Canal (Google Ads, Meta Ads, TikTok Ads, Instagram, Outro).
• Nome (único por usuário).
• Objetivo: Leads, Vendas, Tráfego, Reconhecimento.
• Orçamento mensal.
• Datas (opcionais — deixe em branco para contínuas).
• Status: Planejada, Ativa, Pausada, Encerrada.

5. Diagnóstico — o coração do produto

Menu Campanhas → escolha uma → Novo diagnóstico.

O wizard tem 8 perguntas:

1. Objetivo — está claro e mensurável?
2. Público-alvo — bem definido e segmentado?
3. Localização — correta para o raio de atendimento?
4. Orçamento — adequado ao objetivo?
5. Palavras-chave / Interesses — revisados nos últimos 30 dias?
6. Anúncios — há pelo menos 2 variações em teste?
7. Landing page — otimizada (velocidade, prova social, CTA)?
8. Rastreamento — tag/Geralmente GTM instalado e validado?

Ao concluir, você recebe:

• Score 0–100 (quanto maior, mais saudável).
• Classificação: Saudável, Atenção, Risco, Crítico.
• Problema principal destacado.
• Recomendações priorizadas (alta, média, baixa).

Regra prática: se o score for < 60, resolva as recomendações de prioridade
alta antes de aumentar orçamento.

6. Plano de execução

Do diagnóstico → Gerar plano do diagnóstico.

O sistema cria automaticamente:

• Estrutura (4 itens).
• Palavras-chave (2 itens).
• Criativos (2 itens).
• Landing page (0–1 item).
• Rastreamento (2 itens).
• Lançamento (3 itens).
• Otimização (3 itens).

Total: ~14 itens, cada um com prioridade. Marque os concluídos no próprio
checklist (progresso atualiza em tempo real).

7. Métricas

Menu Métricas.

Lançamento manual

Lançar métrica → campanha, data, investimento, impressões, cliques, leads,
vendas, receita.

• Uma métrica por campanha/dia. Relançar no mesmo dia sobrescreve.
• Não é possível lançar com data futura.
• Regras de coerência:
  • Cliques ≤ impressões
  • Leads ≤ cliques
  • Vendas ≤ leads

Importação CSV

Importar CSV → envie o arquivo → mapeie colunas → revise prévia → confirme.

• Aceita exportações nativas do Google Ads e Meta Ads.
• Detecta separador (,, ;, tab) e encoding automaticamente.
• A campanha precisa ter o mesmo nome no CSV e no sistema.

Exportação

Exportar CSV → arquivo com ; e acentuação correta no Excel pt-BR.

8. Como interpretar os números

Ver docs/DICIONARIO-METRICAS.md para detalhes.

9. CRM de Leads

Menu Leads → pipeline Kanban com 5 colunas:

• Novo — acabou de entrar.
• Contatado — você já falou.
• Proposta — proposta enviada.
• Convertido — virou cliente.
• Perdido — não fechou.

Arraste o card entre colunas para mudar o estágio.

Abra um lead para:

• Registrar interações (ligação, e-mail, reunião, WhatsApp, proposta, nota).
• Mover estágio.
• Ver o histórico em timeline.

Receber leads de um formulário externo

Se a página de destino usa um formulário próprio, a integração pode enviar cada envio para o CRM sem cadastro manual ou importação de planilha. Assim, você mantém a experiência e os campos do formulário sob controle do seu site, e acompanha os contatos recebidos no mesmo pipeline de Leads.

Isso não é ativado apenas informando a URL da landing page nas configurações do canal Ads. O backend da página (ou uma função serverless) precisa encaminhar o envio ao endpoint da plataforma com assinatura segura e o ID da campanha. O segredo não deve ser colocado no navegador. Depois de integrado, os dados do contato entram no CRM como lead novo; UTMs e identificadores de anúncio podem ser preservados nas observações para consulta, mas não configuram por si só atribuição automática de métricas.

Consulte CONECTOR-FORMULARIO-PROPRIO.md para os requisitos e o passo a passo técnico.

10. Relatórios para o cliente

Menu Relatórios → Novo relatório.

• Escolha cliente + período (máx 1 ano).
• O sistema consolida: métricas, diagnósticos, planos, próximos passos.
• Snapshot imutável — o relatório não muda mesmo se você alterar métricas depois.
• Se quiser atualizar, clique em Atualizar dados (recalcula).
• Imprimir / PDF → layout limpo sem menu/sidebar.

11. Configurações de conta

Clique no seu nome no rodapé da sidebar.

• Alterar senha.
• Ativar 2FA (recomendado): use Google Authenticator, Authy ou similar. Guarde os backup codes em local seguro.

12. Webhooks (integração automática)

Se você usa Google Ads com conversões offline ou Meta Ads com Lead Ads, ou tem um formulário próprio em uma landing page, pode integrar o recebimento de eventos/leads à plataforma.

Para Google/Meta, veja WEBHOOKS.md para configurar o webhook do provedor e seus segredos. Para formulário próprio, é preciso desenvolver ou configurar o encaminhamento server-side na landing page; não basta informar a URL da página. Esse fluxo exige um campanha_id válido e um worker ativo:

1. Configure o FORMULARIO_SECRET no .env da plataforma e, de forma privada, no backend da landing page.
2. Faça esse backend enviar o formulário a /integracoes/leads, com a assinatura HMAC e o ID da campanha.
3. Mantenha ativo o worker php bin/console queue:work webhooks.

Consulte CONECTOR-FORMULARIO-PROPRIO.md para os detalhes técnicos.

13. Atalhos do dia a dia

14. Dúvidas frequentes

Por que não consigo logar?
Confirme o e-mail. Se não recebeu, verifique spam ou use "Esqueci a senha".

Perdi acesso ao 2FA.
Use um dos backup codes. Se não tiver, contate o admin.

O relatório ficou com dados antigos.
Clique em Atualizar dados — o snapshot é imutável por design.

Posso apagar um cliente?
Sim, mas cuidado: excluir remove campanhas, métricas, leads e relatórios em cascata.

Como adiciono outro canal?
Por enquanto os canais são fixos (Google, Meta, TikTok, Instagram, Outro).
Solicite ao admin via feedback interno.

Importei CSV e deu erro de campanha.
Confirme que o nome no CSV é exatamente igual ao nome cadastrado no sistema.

15. Suporte e feedback

Use o ícone de balão na topbar para enviar feedback, reportar bug ou sugerir melhoria. O time revisa semanalmente.