Como a CodeQR decide qual clique recebe a venda

Atribuição é uma regra, não um fato, e cada ferramenta escolhe a sua. Saber qual regra a CodeQR aplica é o que permite explicar um relatório em vez de defendê-lo.

Disponibilidade

• Plano: Pro ou superior, já que descreve o monitoramento de conversão.
• Onde: não há nada a configurar — é assim que os dados são produzidos.

A regra

A venda vai para o clique cujo ID estava no navegador quando a conversão aconteceu.

Daí saem três consequências:

• A janela é de trinta dias para links com monitoramento de conversão ligado. Clique mais antigo que isso já saiu do navegador e não pode ser creditado.
• Sem o monitoramento, a janela é de uma hora, o que basta para uma compra imediata e para nada além disso.
• O clique mais antigo dentro da janela ganha. O ID é gravado quando a pessoa chega e não é substituído por cliques posteriores no mesmo link, então, dentro da janela, a CodeQR credita o clique que iniciou a relação.

Onde o ID do clique fica

Em dois lugares, de propósito:

• A URL de destino recebe ?cq_id=…, para o seu site ler já na primeira requisição.
• Um cookie chamado cq_id, definido pelo próprio redirecionamento, com Path restrito àquele link.

O cookie é gravado pela resposta do servidor, não por um script. Essa diferença importa mais do que parece: as regras de proteção contra rastreamento que limitam a sete dias os cookies escritos por script não se aplicam da mesma forma a este.

Quando não há o que atribuir

• Sem ID de clique e sem cliente conhecido — o evento é aceito e descartado. Nada é registrado e nenhum erro aparece.
• ID de clique inexistente ou expirado — a chamada é recusada com 404.
• Conversão num aparelho que nunca clicou — a pessoa navega no celular e compra no computador. Nada liga os dois, e a venda fica sem atribuição.
• Robô — tráfego de robô não vira clique, então não vira lead.

Por que os totais diferem de Meta e Google Analytics

Eles medem coisas diferentes com regras diferentes, e as diferenças se acumulam:

• Janelas diferentes. Meta e Google aplicam as delas, por campanha.
• Âncoras diferentes. A CodeQR atribui ao clique no seu link; a Meta, à impressão ou ao clique no anúncio; o GA4, a uma sessão.
• Sobrevivência diferente. Um pixel de navegador é barrado por bloqueadores e por proteção de rastreamento; uma conversão informada pelo servidor, não.
• Deduplicação diferente. Cada plataforma decide sozinha o que conta como um evento.

Espere divergência grande e use cada um para o que serve: a CodeQR para saber qual link trouxe o dinheiro, a plataforma de anúncios para otimizar a campanha.

Verifique se funcionou

Dá para ver a regra acontecendo. Abra um link rastreado e repare no ID que ele acrescenta:

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

Max-Age=2592000 é trinta dias. Registre um lead com esse ID e a linha do tempo da pessoa em Clientes mostra o clique na base — é ele que vai carregar qualquer venda posterior.

Solução de problemas

Uma venda que eu esperava não apareceu

Algo interrompeu a cadeia: o cookie foi apagado, a compra aconteceu em outro aparelho, a janela passou, ou o ID do clique não chegou ao checkout. Corrigir conversões que não estão sendo registradas percorre cada caso.

A campanha errada levou o crédito

Dentro da janela, o primeiro clique fica com o crédito. Quem clicou na sua newsletter em março e no seu anúncio em abril é creditado a março.

Quero outra janela de atribuição

Não é configurável hoje.

Minha taxa de conversão parece impossivelmente baixa

Compare coisas comparáveis: cliques são contados pela CodeQR para todo mundo, enquanto conversões dependem do seu servidor informar. Todo visitante que bloqueia scripts, recusa cookies ou compra em outro aparelho é um clique sem conversão.

Artigos relacionados

• Acompanhar leads e vendas dos links e QR codes
• Enviar eventos de lead e venda pelo seu servidor
• Corrigir conversões que não estão sendo registradas