True Conversionsby Nexopath

Como verificar se está funcionando

Depois de conectar o CRM, a plataforma de anúncios e configurar o mapeamento de campos, use esta página para confirmar que os eventos estão chegando, sendo processados corretamente e entregues às plataformas de anúncios.

Checklist da conta (visão geral)

Na página da conta, a seção Configuração mostra 5 passos numerados, cada um vira um ✓ verde ao ser concluído:

  1. Integrações de CRM
  2. Plataforma de anúncios — fica âmbar ("Conectado — falta configurar") se o Google Ads foi autorizado mas ainda falta escolher a ação de conversão.
  3. Mapeamento de campos — mostra "Automático" para contas com CRM conectado nativamente.
  4. Otimização de valor
  5. Primeira conversão — vira verde ("Primeira conversão enviada 🎉") assim que a conta tiver ao menos um envio com sucesso (enviado) a uma plataforma. É o sinal definitivo de que a configuração de ponta a ponta funcionou.

Verificação automática do código do clique (página Configuração e rastreamento)

Se você configurou o script de rastreamento, a página Configuração e rastreamento da conta (Passo 2 · Verifique) checa automaticamente os leads recentes:

  • 🟢 Verde — "Funcionando — último lead com código do clique [há X]": um lead com gclid/wbraid/gbraid/fbclid chegou nos últimos 30 dias.
  • 🟢 Verde, "Script ativo — última captura [há X]" — o script já capturou o código do clique de um visitante no site; ele será anexado ao lead assim que o webhook do CRM chegar.
  • 🟡 Âmbar, "verifique se a captura continua ativa" — o último lead com código do clique é mais antigo que 30 dias: a captura pode ter parado.
  • 🟡 Âmbar, "Nenhum lead recente chegou com código do clique" — já existem leads, mas nenhuma captura: revise o Passo 1 do guia de instalação (a linha instalada precisa incluir o token ?t=).
  • ⏳ "Aguardando os primeiros leads deste cliente…" — ainda não chegou nenhum evento para essa conta.

Esta é a forma mais rápida de confirmar a captura — use-a como primeira checagem antes de ir ao DevTools do navegador.

Verificação manual (alternativa/depuração)

Se quiser confirmar no próprio navegador antes de um lead real chegar:

  1. Visite a landing page com parâmetros de teste, ex.: https://seusite.com/?gclid=teste123&fbclid=teste456.
  2. Abra o DevTools → Application → Cookies e confirme que _tc_gclid aparece com o valor teste123.
  3. Se você usa os campos ocultos opcionais, inspecione o formulário e confirme que foram preenchidos.
  4. No Console, window.getTCParams() retorna todos os valores capturados.

Veja o Guia de instalação para a referência completa de cookies e nomes de campo.

Eventos recentes (página da conta)

Abra a conta (cliente) — a lista Eventos recentes mostra, para cada evento que gerou uma entrega real a alguma plataforma:

Coluna O que mostra
Status Pendente, Processando, Processado, Falhou ou Falha permanente.
Recebido Data/hora em que o webhook chegou.
Valor enviado O valor calculado (etapa × enriquecimento, se aplicável) que foi de fato enviado à plataforma de anúncios.
Envio Um badge por plataforma conectada (Google Ads, Meta) com o status de entrega: enviado ou falhou.

Clique em uma linha para expandir e ver:

  • Envio — o histórico completo de tentativas de entrega para aquele evento (útil quando o valor foi reafirmado várias vezes conforme o negócio avançou), com uma dica em português quando algo falhou.
  • Empresa — se o Enriquecimento identificou a empresa do lead, o nome aparece aqui.
  • Dados recebidos — o payload bruto recebido, achatado em pares campo/valor. Use isso para conferir exatamente o que o CRM enviou (e para encontrar caminhos de campos ao configurar mapeamento ou etapas).

Eventos ignorados pela Otimização de valor não aparecem aqui. Se a conta usa Otimização de valor e você espera ver mais negócios do que aparecem, veja Solução de problemas — a causa mais comum é deal_id não mapeado ou nomes de etapa que não batem com o texto exato do CRM.

Use o botão Ver todos para o histórico completo com filtro por data e exportação em CSV.

Tentativas de webhook recentes (página de Integrações de CRM)

Mostra as últimas 10 requisições recebidas na URL de webhook da conta — incluindo as que foram rejeitadas (token inválido, JSON malformado, payload grande demais) ou ignoradas (sem deal_id, funil/pipeline não selecionado) antes mesmo de virarem um evento de conversão. Use esta seção quando desconfiar que o CRM não está conseguindo entregar o webhook, mesmo que nenhum evento apareça na lista de Eventos recentes.

Envios e qualidade (página Stats)

Visão agregada da conta:

  • Total de eventos, Últimos 7 dias, Processados, Falhas.
  • Taxa de envio por plataforma — percentual dos envios iniciais aceitos pela plataforma, com a contagem de enviados / falharam por plataforma conectada. Considera só o primeiro envio de cada conversão — atualizações de valor (restatements) não entram nessa taxa. (Não é a "match rate" do Google, que só o próprio Google calcula; para vê-la, use Google Ads → Metas → Diagnóstico.)
  • Qualidade do sinal — percentual de eventos processados que incluem email, telefone, GCLID, FBCLID e que foram enriquecidos.
  • Eventos — últimos 30 dias — gráfico diário de processados vs. falhas.
  • Erros recentes — lista expansível dos eventos que falharam, com a mensagem de erro e o payload bruto.

A própria página já sinaliza alertas automáticos, por exemplo se 0% dos eventos tiverem GCLID, ou se a taxa de envio de alguma plataforma estiver abaixo de 30%.

Checklist rápido

  1. Dispare (ou espere) um evento real do CRM.
  2. Confirme que ele aparece em Eventos recentes com status Processado. (Se a conta usa Otimização de valor e o evento não aparece, veja a nota acima antes de assumir que algo está errado.)
  3. Confirme que Valor enviado não está vazio.
  4. Confirme que Envio mostra a plataforma como enviado.
  5. Confirme que o checklist da conta marcou 5 · Primeira conversão como concluído.
  6. Se algo estiver errado em qualquer um desses pontos, veja Solução de problemas.