Cliques não aparecem ou números não batem

Ao final deste guia você vai saber por que um clique ou uma leitura pode não aparecer no Analytics, por que você pode ver mais eventos do que esperava e por que a CodeQR e o Google Analytics nunca mostram o mesmo número — com a regra por trás de cada caso, para decidir se algo está errado.

Disponibilidade

Plano: todos. Algumas causas dependem do plano (janela de retenção, limite de cliques medidos, cartões bloqueados) e estão indicadas abaixo.
Onde: Análise e Eventos.

Antes de começar

A CodeQR conta no redirecionamento: o momento em que o link curto manda o visitante para o destino. O que acontece depois — a página carregar ou não, scripts bloqueados, o visitante sair — não muda a contagem. Ferramentas que medem a página de destino contam depois e contam menos.
Duas regras explicam a maioria das surpresas: robôs e prévias não contam (qualquer user agent que se identifique como robô) e o mesmo visitante conta uma vez a cada 5 minutos no mesmo link (cookie cq_id no domínio curto).
Os números ficam em cache: Os dados são armazenados em cache para otimização de desempenho. As análises atualizadas podem levar alguns minutos para aparecer.

Um clique que eu fiz ainda não apareceu

Espere dois ou três minutos e recarregue. Contadores e gráfico atualizam em cerca de dois minutos; os cartões abaixo e os períodos longos podem levar até dez. Confira se o período cobre agora (24h) e se não sobrou nenhum chip de filtro de uma sessão anterior.

Cliques ou leituras estão faltando

Percorra a lista; cada item é uma regra, não um erro.

Você abriu o link com ?codeqr-no-track=1. Nada é gravado — o parâmetro existe para os seus próprios testes.
Mesmo celular, mesmo link, menos de 5 minutos de intervalo. Um evento. Espere cinco minutos ou use outro aparelho.
A requisição veio de um robô ou de uma prévia de link. WhatsApp, Facebook, Google, Bing e qualquer user agent contendo bot são redirecionados, mas não contados. Enviar um link num chat não cria clique; alguém tocar nele, sim.
O link está expirado, protegido por senha, banido ou não existe. Links expirados e banidos nunca contam. Um link com senha conta só quando a senha correta é enviada, não quando a página de senha abre.
O QR code é estático. O conteúdo está dentro da imagem; a leitura nunca chega à CodeQR. Só códigos dinâmicos são medidos — veja QR code não lê ou abre a página errada.
O link foi excluído. Os eventos dele ficam nos totais do workspace, mas saem do cartão Links e do registro Eventos.
O evento é mais antigo do que o seu plano guarda. O Free mostra 30 dias, o Starter 90, o Pro 1 ano. Os dados antigos voltam quando você faz upgrade.
Você passou do limite de cliques medidos do seu plano (Free 1.000, Starter 6.000, Pro 30.000, Business 150.000 por ciclo). Os links continuam redirecionando; a página de preços diz: Your links on CodeQR will work forever. However, you can only access analytics for these clicks up to your plan limit. O uso zera na sua data de cobrança.
Você está lendo a aba ou o filtro errado. Os contadores separam Cliques, Scans e Views; um filtro Disparador restringe os cartões. Limpe os filtros e leia Total.

Mais cliques ou leituras do que eu esperava

Verificadores de link e monitores. Uma requisição HEAD ou um acesso simples de uma ferramenta que não se apresenta como robô é contado. Monitores de disponibilidade, proxies corporativos e alguns filtros de segurança de e-mail entram aqui.
A mesma pessoa depois de 5 minutos. Duas visitas com uma hora de intervalo são dois eventos; não existe métrica de "visitante único".
Seus próprios testes. Cada leitura da prova de impressão, cada clique do escritório conta, a menos que você adicione ?codeqr-no-track=1.
Prévias que não se identificam. A maioria dos mensageiros e apps sociais se identifica (e é excluída); um cliente incomum pode não se identificar.

Os números diferem do Google Analytics ou do meu site

CodeQR ≥ destino é normal. A CodeQR conta o redirecionamento; o GA conta uma visualização de página depois de a página e o script carregarem. Bloqueadores de anúncio, redes lentas, navegadores dentro de apps, banners de consentimento e pessoas que saem cedo baixam o número do destino.
Usuários não são cliques. "Usuários" ou "sessões" do GA deduplicam; a CodeQR conta eventos (só com a regra dos 5 minutos).
Parâmetros UTM. O GA atribui pelos parâmetros da URL de destino. Se o destino do seu link curto não tem UTM, o GA mostra a visita como direta ou como o referenciador, e o relatório UTM da CodeQR mostra (não definido). Coloque os parâmetros UTM na URL de destino — veja Meça campanhas UTM em links e QR codes.
Fuso horário. A CodeQR agrupa pelo fuso do seu navegador; o GA, pelo da propriedade. Um clique às 23h pode cair em dias diferentes.

O país ou a cidade está errado

O país vem do endereço de rede do visitante e é confiável. A cidade é aproximada: operadoras de celular, VPNs e redes corporativas resolvem para o hub delas. Leia cidade como pista. Veja Descubra de onde vêm seus cliques e leituras.

Está tudo (direct)

Leituras de QR e links abertos de apps e clientes de e-mail não mandam referenciador. É esperado. Atribua esses canais com parâmetros UTM ou com um link por canal.

Os cartões mostram mais que o contador Cliques

Os cartões somam cliques, leituras e visitas a páginas; os contadores separam. Defina Filter → Disparador → Clique no link para ver os cartões só de cliques.

O gráfico e o contador diferem em alguns eventos

O gráfico agrega por hora, dia ou mês e pode diferir do contador em pouca coisa quando muitos eventos idênticos caem no mesmo segundo. Leia o contador como o número de referência.

Cliques de ontem aparecem hoje

O painel usa o fuso do seu navegador; a API e as exportações usam UTC, a menos que você passe timezone. Compare com o mesmo fuso dos dois lados.

O card do link diz um número e o Analytics outro

O selo no card do link é o total de todos os tempos daquele link. O Analytics abre nas últimas 24 horas. Escolha Todo o Tempo (Business e acima) ou o maior período que o seu plano permite.

Dados antigos sumiram

O Analytics guarda 30 dias no Free, 90 dias no Starter e 1 ano no Pro. Depois de um downgrade a janela encolhe para a do plano novo. Business e acima mantêm o histórico completo no app.