Configurar o rastreamento de conversão no seu site

A configuração tem duas metades que costumam ser confundidas. A chave e o script preparam o clique; o seu servidor informa a conversão. Esta página cobre a primeira metade e diz com todas as letras onde ela para.

Disponibilidade

Plano: Pro ou superior, ou o teste de 14 dias.
Onde: a chave Monitoramento de conversão no construtor e Configurações → Conversion tracking.

Antes de começar

Decida quais links e QR codes carregam as campanhas que você quer medir. A chave é por link e por QR code.
Tenha acesso ao HTML do seu site, ou a um gerenciador de tags.
QR code estático não é rastreável — o destino está gravado na imagem e nenhum clique chega à CodeQR.

Passo 1 — Ligue a chave

Crie ou edite um link ou QR code.
Abaixo do divisor Opcional, ligue Monitoramento de conversão.
Salve.

A chave Monitoramento de conversão ligada no construtor de links

A partir daí o redirecionamento acrescenta ?cq_id=… à sua URL de destino e o cookie cq_id passa a durar 30 dias.

A chave Rastreamento de conversão no nível do projeto, na tela de configurações, deveria aplicar isso a tudo que for criado depois. Ela não está sendo salva hoje — ligue a conversão link a link e QR code a QR code.

A chave de rastreamento de conversão no nível do projeto

Passo 2 — Gere a chave publicável

O script que roda no navegador dos visitantes se autentica com uma Chave Publicável, que pode aparecer no código-fonte da página sem risco.

Abra Configurações → Conversion tracking.
Em Chave Publicável, selecione Gerar Chave.

A seção Chave Publicável na tela de configuração de conversão

Passo 3 — Libere o seu domínio

Domínios Permitidos lista os sites onde o rastreamento no navegador é aceito. Acrescente o domínio do seu site, sem o protocolo — exemplo.com.

A seção Domínios Permitidos, onde o rastreamento no navegador é liberado

Passo 4 — Instale o script

Acrescente isto a todas as páginas, de preferência dentro de <head>:

<script
  src="https://cdn.codeqr.io/analytics/script.site-visit.outbound-domains.conversion-tracking.js"
  data-publishable-key="SUA_CHAVE_PUBLICAVEL"
  defer
></script>

Aplicações React e Next.js podem montar o pacote:

import { Analytics } from '@codeqr/analytics/react'

<Analytics publishableKey="SUA_CHAVE_PUBLICAVEL" />

O que o script faz, e o que não faz

O script lê o ID do clique na URL e guarda no navegador, para ele continuar disponível quando a pessoa voltar depois ou finalizar a compra em outra página do seu site.

Ele não informa leads nem vendas. Esses eventos saem do seu servidor, com uma chave de API secreta — veja Enviar eventos de lead e venda pelo seu servidor. Se você encontrou um trecho de código de navegador chamando trackLead ou trackSale, saiba que o script carregado não expõe essas funções hoje: a chamada falha e nenhuma conversão é registrada.

Verifique se funcionou

Abra um dos seus links rastreados, vá até o seu site e procure o cookie:

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

Duas coisas provam que a chave está ligada: o parâmetro cq_id acrescentado ao seu destino e o Max-Age=2592000 — trinta dias. Sem o monitoramento de conversão não vem o parâmetro nem mais do que Max-Age=3600.

No navegador, o document.cookie do seu site deve conter cq_id depois de uma chegada por link rastreado.

Solução de problemas

A chave está cinza

O espaço de trabalho está abaixo do Pro, ou este é um QR code estático. A dica na tela diz qual dos dois é o caso.

A URL de destino não tem cq_id

O monitoramento está desligado naquele link específico. A chave é por link, não por espaço de trabalho.

O cookie existe e nenhuma conversão chega

Esperado nesta etapa — o script só preserva o ID do clique. Informar o lead e a venda é o próximo artigo.

Meu site remove o parâmetro da URL

Alguns frameworks e redirecionamentos descartam parâmetros desconhecidos. Leia o cq_id o quanto antes, ou conte com o cookie.