Solução de problemas

Atualizado em 28 de outubro de 2026

Nada aparece no painel, venda sem origem, webhook sem chegar e outros problemas comuns.

Antes de tudo, abra o diagnóstico em Instalação, no painel do projeto: ele confere a chave, o primeiro evento, a lista de domínios e as conexões de pagamento.

Instalei e nenhuma visita aparece

1. Veja o código-fonte da página (clique direito → exibir código-fonte) e procure tracker.v1.js. Se não está lá, o código não foi publicado ou há cache antigo: limpe o cache do site, do plugin e do CDN.
2. Confira se data-key tem a chave completa, sem espaços nem aspas trocadas.
3. Abra as ferramentas do navegador, aba Rede, e filtre por collect. Uma resposta 403 origin_not_allowed significa que o domínio do site não está na lista de origens permitidas do projeto; ajuste em Configurações.
4. Teste em janela anônima, sem extensões: bloqueadores de anúncio e de rastreamento impedem o envio e não é possível contorná-los.
5. Se o projeto exige consentimento (data-consent="required"), nenhum evento sai até setConsent(true) ser chamado.

As visitas chegam, mas sem UTM

• Confira se o link do anúncio tem as UTMs. O gerador de UTM monta o link.
• Redirecionamentos que descartam parâmetros (encurtadores, páginas intermediárias) fazem a UTM sumir antes da página medida.
• Só as UTMs e os identificadores de clique conhecidos são guardados; parâmetros próprios são ignorados por privacidade.

A venda chegou, mas sem origem

• O link de checkout precisa estar numa página com o rastreador. Em Hotmart, Kiwify, Cakto e Hubla o parâmetro sck é acrescentado no clique; se o botão leva a outro domínio antes do checkout, o parâmetro se perde.
• Na Stripe, confira client_reference_id.
• Vendas por links diretos (sem passar por uma página sua) chegam sem visita para ligar: aparecem como sem origem conhecida.
• Se a compra foi dias depois da primeira visita em outro aparelho ou navegador, não há como ligar as duas.

O webhook não chega

• Confira se a URL cadastrada no checkout é exatamente a que a Utmetrica mostra em Configurações e se o segredo ou token foi colado sem espaços.
• Dispare um evento de teste no painel do checkout. Se ele chega, o Estado da conexão em Configurações muda; se não, veja o último erro mostrado ali.
• Webhooks com assinatura inválida são recusados de propósito. Isso costuma ser segredo errado ou de outro ambiente (teste e produção).

Os números não batem com o painel do anúncio

É esperado. O painel do anúncio conta conversões que ele mesmo atribui, com janelas próprias. A Utmetrica conta só vendas confirmadas pelo checkout e ligadas a uma visita com origem.

Não achou a causa? Dentro do painel, a tela Suporte envia o pedido com o contexto do projeto (sem dados pessoais). Se estiver sem acesso, escreva para [email protected]. Para saber se o problema é da plataforma, veja o status.