Corrigir conversões que não estão sendo registradas

Conversão falha em silêncio. O clique continua funcionando, o visitante continua comprando, e só o relatório fica errado. Esta página percorre as causas na ordem que vale conferir, começando pelas que não custam nada para descartar.

Disponibilidade

Plano: Pro ou superior, ou o teste de 14 dias.
Onde: o construtor, Configurações → Conversion tracking e o seu próprio site.

Comece por aqui

Abra um dos seus links e leia a resposta:

curl -sSI https://go.example.com/verao

HTTP/2 302
location: https://example.com/checkout?cq_id=qcdyQHsX1oajEock
set-cookie: cq_id=qcdyQHsX1oajEock; Path=/verao; Max-Age=2592000

Três coisas precisam ser verdade: o parâmetro cq_id no seu destino, um cookie cq_id e o Max-Age=2592000. Se faltar alguma, pare aqui — o monitoramento está desligado naquele link e nada adiante vai funcionar. Ligue link a link, já que a chave no nível do projeto não está sendo salva.

A cadeia, e onde ela quebra

Nada está informando a conversão

A causa mais comum, de longe. A CodeQR conta cliques sozinha; leads e vendas chegam porque o seu servidor envia. Uma conta com milhares de cliques e zero leads em geral nunca ligou a segunda metade — veja Enviar eventos de lead e venda pelo seu servidor.

Se você seguiu um trecho de código de navegador chamando trackLead ou trackSale, olhe o console: o script carregado não expõe essas funções, então a chamada falha e nenhuma conversão é enviada.

O checkout acontece em outro domínio

Stripe, Hotmart, Kiwify e todo checkout hospedado rodam no domínio deles, e cookie não viaja para lá. O ID do clique precisa ser levado de propósito — pelo client_reference_id no Stripe, ou pelo seu servidor, que conhece o ID pela sessão. Veja Atribuir pagamentos do Stripe ao link certo.

O parâmetro é removido da URL

Um redirecionamento no seu próprio site, uma plataforma de marketing ou um framework que normaliza URLs conseguem descartar o cq_id antes de qualquer coisa lê-lo. Leia o quanto antes e preserve o parâmetro nos seus redirecionamentos.

Um bloqueador removeu o script

Bloqueadores miram scripts de análise por URL e por CNAME, então domínio próprio não resolve de forma confiável. O clique não é afetado — ele acontece do lado da CodeQR —, mas tudo que depende do script no navegador se perde para aquele visitante. Conversão enviada pelo seu servidor é imune, o que é mais um motivo para enviá-la de lá.

O visitante recusou os cookies

Um banner de consentimento que bloqueia armazenamento não essencial impede o ID do clique de ser guardado. A visita redireciona, a compra acontece, e a conversão não pode ser atribuída. Isso é comportamento esperado, não defeito, e coloca um teto na taxa de conversão que dá para medir.

A proteção contra rastreamento encurtou a janela

Safari e Firefox limitam quanto tempo o estado de rastreamento sobrevive, e as regras pegam mais pesado nos cookies escritos por script. O cookie de clique da CodeQR é definido pela própria resposta do redirecionamento, que é tratada de outra forma, mas um intervalo longo entre clique e compra continua sendo o caso mais provável de se perder.

O valor está errado, e não faltando

amount vai na menor unidade da moeda. Enviar 49.90 registra 49 centavos. A venda existe, a receita é que fica sem sentido.

A compra foi em outro aparelho

A pessoa escaneia o QR code no celular e compra no computador. Não há o que ligue as duas sessões, e a venda fica sem atribuição.

O que parece bug e não é

Um robô não gerou lead. Tráfego de robô não vira clique, então não vira conversão.
Visitas na raiz aparecem zeradas. Abrir o seu domínio próprio sem link não é registrado.
Uma venda repetida não dobrou o contador. Se as duas chamadas levaram o mesmo invoiceId, é a idempotência funcionando.
A lista de vendas não carrega. Problema conhecido na aba Events; os contadores e Clientes estão corretos.

Verifique se funcionou

O teste de ponta a ponta que encerra a maioria das discussões, num link seu:

Abra o link curto numa janela anônima.
Confirme no seu site que o document.cookie contém cq_id.
Envie um lead pelo seu servidor com esse ID.
Abra Clientes — a pessoa aparece com o clique e o lead.

Se o passo 2 falha, o problema é a configuração. Se o passo 3 devolve 404, o ID está errado ou expirou. Se o passo 4 fica vazio depois de um 200, o lead não tinha ID de clique nem cliente conhecido a que se prender.

Solução de problemas

A chamada de lead devolve 404

O ID do clique não existe ou expirou. Sem o monitoramento de conversão ele vive só uma hora.

A chamada de lead devolve 200 e nada aparece

Aceito e descartado: sem ID de clique e sem cliente que a CodeQR já conheça.

As conversões pararam depois de um deploy

Confira se o script sobreviveu ao build e se os seus redirecionamentos ainda preservam o cq_id.

Meus totais estão muito abaixo do que o gateway informa

Essa diferença é a soma de tudo acima — script bloqueado, consentimento recusado, compra em outro aparelho, checkout que perdeu o ID. Informar as conversões pelo servidor fecha a maior parte dela.