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.

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,
pode configurar webhooks para criar leads automaticamente.

Ver docs/WEBHOOKS.md para o passo a passo técnico. Em resumo:

1. Configure a URL https://seudominio.com.br/webhooks/google (ou /meta).
2. Cadastre o secret em .env.
3. Rode o worker: php bin/console queue:work webhooks.

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.