Pular para o conteúdo principal
O pixel é um trecho de código que você cola na sua loja. Com ele, a Cliqo passa a saber o que a pessoa fez antes de comprar — que produto olhou, que categoria navegou, onde parou — e usa isso para montar segmentos sozinha. Sem o pixel, a Cliqo só conhece quem já está na sua lista e o que já comprou. Com ele, você alcança quem esteve interessado e não voltou.

​
O trecho

Em Configurações → Pixel, o painel Pixel de Rastreamento Cliqo mostra o seu snippet já personalizado, com o botão Copiar tudo. Ele tem esta forma:
O identificador vai duas vezes, de propósito. No endereço — https://app.cliqo.io/px.js?t=SEU-ID —, que o Google Tag Manager nunca altera, e no data-tenant, que o GTM remove ao injetar a tag. Por isso o mesmo snippet serve para GTM e para instalação direta. (Sem identificador nenhum o pixel ainda funciona: ele resolve a loja pelo domínio. Mas só se esse domínio já estiver cadastrado na Cliqo — o domínio verificado, ou o Site da loja em Configurações → Marca.)
Cole no <head> de todas as páginas da loja — não só na home. É o <head>, não o fim do <body>: o pixel precisa carregar antes do conteúdo para medir o tempo de página corretamente.

​
Onde colar, por plataforma

O painel oferece três caminhos, cada um com o passo a passo na tela:
  • GTM — marcado Recomendado, é o que abre primeiro. Uma tag de HTML personalizado acionada em todas as páginas; há um link que abre o Google Tag Manager.
  • Loja Integrada — aparece quando a sua conta está cadastrada como loja da Loja Integrada. O snippet vai em Design → Editar HTML do tema, logo acima de </head>; há um link que abre o painel da plataforma.
  • Manual — para qualquer outra loja: cole no template do tema, logo acima de </head>.
O snippet é o mesmo nos três caminhos. O Tag Manager remove atributos data-*, e o data-tenant é justamente um deles — por isso o snippet também leva o seu identificador dentro do endereço do script (?t=…), que o GTM não tem como apagar.

​
Conferir que funcionou

No topo do mesmo painel há o botão Verificar pixel (depois que o primeiro acesso chega, ele passa a se chamar Verificar agora). Depois de colar o snippet, abra uma página da sua loja em outra aba e clique nele. Com o painel aberto, a conferência também se repete sozinha a cada minuto. O resultado tem três estados:
  • Pixel ativo — chegou movimento nas últimas 24 horas. Está tudo certo.
  • Instalado · sem acesso há um tempo — o pixel já mandou acesso antes, mas nada nas últimas 24 horas. Está instalado; a loja só teve um dia parado. Não mexa no snippet.
  • Aguardando instalação — nenhum acesso chegou até hoje.
Se a tela diz “aguardando instalação”, abra uma página da loja você mesmo e clique em Verificar pixel de novo. Se aparecer o acesso, está instalado; se não, veja a última seção deste artigo.

​
O que ele captura sozinho

Você não precisa marcar nada. Depois de instalado, o pixel identifica o tipo de página e emite os eventos abaixo — e cada um alimenta um segmento automático em Público › Listas e segmentos, aba Segmentos: Além desses, o pixel mede profundidade de rolagem em páginas de produto (25%, 50%, 75%, 90%) e o tempo real na página — sinais de interesse que a taxa de abertura não captura. Para reconhecer o tipo de página, ele lê primeiro as marcações padrão do seu tema (og:type, og:title, og:price), depois dados estruturados de produto, e só então recorre a heurísticas. Isso é o que faz funcionar em qualquer plataforma, sem integração dedicada.

​
Marcar uma compra

O pixel reconhece sozinho a página de confirmação do pedido quando o endereço dela tem um dos trechos comuns — /finalizacao, /obrigado, /pedido/sucesso, /order/success, /thank-you, /order-received ou /concluido — e registra a compra com o número do pedido e o valor. Se a sua página de obrigado não segue nenhum desses, chame nela:
É isso que fecha a conta: sem a compra registrada, a Cliqo vê a navegação mas não sabe que virou venda, e a receita atribuída fica subestimada.

​
Ligar a compra a quem comprou

Esta é a chamada que separa “houve uma venda” de “a Marina comprou”. A Cliqo liga a navegação a uma pessoa quando ela chega por um link de e-mail seu. Quem entra direto na loja e compra nunca passa por esse caminho: o pedido existe de um lado, a navegação do outro, e os dois nunca se encontram. Sem essa ligação, carrinho abandonado e receita por campanha não têm como funcionar — a venda aparece sem dono. Na página de obrigado, informe quem comprou:
Troque EMAIL_DO_COMPRADOR pela variável da sua plataforma que traz o e-mail do pedido. O e-mail serve — e é o que a sua loja tem. A chamada aceita duas formas: o identificador do contato na Cliqo (um UUID, que a sua loja não conhece) ou o e-mail. Com o e-mail, o servidor resolve o contato e costura a navegação anterior sozinho.

​
A ordem é o que faz funcionar

O e-mail precisa estar na página antes da compra ser registrada. Ele não é enviado sozinho: pega carona no próximo evento daquela página — e na página de obrigado o único evento é a compra. Se chegar depois dela, não sobra nada para carregá-lo, e a identificação não acontece. Sem erro na tela. Por isso duas recomendações:
  • Use o formato acima (window._cliqo.push), não window.cliqo.identify(...). Ele funciona mesmo rodando antes de o pixel carregar, e é o único seguro quando você não controla a ordem.
  • Ponha o trecho acima da chamada de compra no template (ou acima do snippet do pixel, se a compra for detectada sozinha).

​
Pelo Google Tag Manager

Uma tag de HTML personalizado, acionada só na página de confirmação do pedido, com prioridade maior que a da tag que dispara a compra. No GTM, número de prioridade maior dispara primeiro — se a outra está em 0, ponha esta em 10.

​
Como conferir que funcionou

Faça um pedido de teste. Na página de obrigado, abra as ferramentas do desenvolvedor (F12) → aba Rede → filtre por track. A requisição precisa trazer um campo identify_email com o e-mail do comprador. Se ele não estiver lá, quase sempre é a ordem: a tag do e-mail está disparando depois do pixel.

​
Privacidade desta chamada

O e-mail é usado só para encontrar o contato que já existe na sua base. Ele nunca aparece em log, e a Cliqo não responde se o e-mail existe ou não — a identificação é silenciosa dos dois lados, para que o endereço do pixel não possa ser usado para descobrir quem está na sua lista.

​
Privacidade e LGPD

O pixel guarda um identificador anônimo no navegador do visitante e registra que páginas ele viu. Isso é dado pessoal pseudonimizado pela LGPD, mesmo sem nome ou e-mail. Duas obrigações que são suas, não da Cliqo:
  1. A sua política de privacidade precisa dizer que a loja usa pixel de rastreamento, para que serve e com quem os dados são compartilhados.
  2. Se a sua loja exibe aviso de cookies, o pixel entra nele.
Nada disso impede o uso — é o mesmo enquadramento de qualquer ferramenta de análise. Só precisa estar escrito.

​
Quando o visitante recusa

Se o visitante recusa os cookies de marketing, o pixel continua contando as visitas, mas não liga a navegação a nenhum cliente: os eventos seguem anônimos. Ele entende a recusa sozinho em dois casos:
  • Google Consent Mode v2 (o aviso de cookies manda ad_storage ou analytics_storage = denied);
  • Shopify, pela privacidade do cliente da própria loja.
Se o seu aviso de cookies é outro, avise o pixel quando o visitante recusar:
Se ele aceitar depois, mande { marketing: true }.

​
Quando parar de esperar e pedir ajuda

Se o snippet está no <head>, você acessou a loja e mesmo assim o painel não registra acesso nenhum, abra o código-fonte da página no navegador e procure por px.js. Achar o px.js não quer dizer que está funcionando — quer dizer que ele carregou. São três respostas diferentes, e só uma delas encerra o assunto. ① Não aparece. O snippet está num template que aquela página não usa. É o caso mais comum. Mova para o template que a loja realmente carrega. ② Aparece com o seu identificador — data-tenant="..." na própria tag, ou ?t=... no fim do endereço do px.js. Carregou e se identificou: a instalação está certa e o problema é do nosso lado. Fale com a gente. ③ Aparece, mas sem identificador nenhum. Este é o caso que engana. A página carrega o pixel, ele dispara normalmente, e mesmo assim nada chega ao painel — sem erro, sem aviso. Sem identificador ele se apresenta anônimo, e aí o acesso só é contado se o endereço da sua loja já estiver registrado do nosso lado. Se não estiver, é descartado em silêncio. Acontece sobretudo com instalação por Gerenciador de Tags: o Google Tag Manager apaga atributos data-* ao injetar a tag, mas nunca mexe no endereço. Como confirmar que é o ③: abra o console do navegador (F12 → aba Console) e recarregue a página. Se aparecer a linha [cliqo] sem token na tag, é este o caso. A saída: ponha o identificador no próprio endereço, https://app.cliqo.io/px.js?t=SEU-ID. O endereço sobrevive ao Gerenciador de Tags; o data-tenant não. Persistindo, fale com a gente em [email protected] com o endereço de uma página onde deveria estar.