For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/guides/manage-pixels.md.
  • Português

      • Como cadastrar um pixel e escolher os eventos que ele recebe?

      Vá em Tráfego › Pixel e trackeamento — no menu lateral, Tráfego fica dentro de Marketing —, clique em Adicionar pixel e siga os três passos: plataforma, informações e eventos. O cadastro é único: o pixel fica disponível na conta inteira e você não precisa colá-lo de novo em lugar nenhum.

      Esta tela é lista e cadastro. Escolher onde o pixel rastreia é trabalho de cada tela — abra o funil, a página, o produto ou o formulário e marque o pixel lá dentro. Veja como escolher quais pixels rastreiam cada tela.

      Antes de começar

      • Você precisa de acesso de criação no workspace.
      • Para a Meta: o ID do pixel (só números) e, se quiser envio pelo servidor, um token de acesso da API de Conversões. Os dois ficam no Gerenciador de Eventos da Meta.
      • Para o Google Ads: o ID da conversão (começa com AW-) e o rótulo de conversão de cada evento que você for ligar.

      1. Cadastrar o pixel

      1. Abra Tráfego › Pixel e trackeamento.
      2. Clique em Adicionar pixel.
      3. Em Onde você anuncia?, escolha a plataforma. Os cartões estão separados em dois grupos — Pixel e Rastreamento de anúncios —, porque não toda ferramenta de medição se chama pixel: a do Google Ads é uma tag de conversão. As plataformas com o selo Em breve ainda não podem ser escolhidas.
      4. Clique em Continuar.
      5. Preencha o ID do pixel (Meta) ou o ID da tag de conversão (Google Ads).
      6. Preencha o Apelido do pixel. Só você vê: ele serve para diferenciar dois pixels da mesma conta.
      7. Se quiser, escolha um Projeto. É opcional e serve só para organizar a listagem — veja a seção abaixo.
      8. Decida as duas opções deste passo:
      9. Clique em Continuar.

      Se o ID estiver no formato errado, a tela avisa antes de deixar você seguir: o da Meta tem só números, e o do Google Ads começa com AW- seguido de números.

      2. Escolher os eventos

      O terceiro passo lista os 13 eventos da jornada. Cada linha traz a ação do visitante em português, o nome que a plataforma reconhece e dois interruptores:

      InterruptorO que faz
      No navegadorO evento é enviado pelo navegador de quem está visitando
      Pelo servidorO evento também sai do servidor da Clickmax, pela API de Conversões da Meta

      Um pixel novo já nasce com todos os eventos ligados. Desligue o que não quiser medir.

      Quando o mesmo evento vai pelos dois caminhos, a plataforma conta uma conversão só — você não precisa desligar um deles para evitar duplicidade. A explicação está em por que alguns eventos chegam ao Meta mesmo com bloqueador de anúncios.

      Alguns detalhes por evento:

      • Comprou tem os filtros de Formas de pagamento. Uma venda paga por uma forma desmarcada não gera evento de compra.
      • Abriu o checkout tem a opção Só contar depois dos dados pessoais. Ligada, o evento espera o visitante informar nome e e-mail.
      • Abriu uma página e Viu o conteúdo principal só podem ser enviados pelo navegador. O interruptor Pelo servidor aparece desligado, e o texto ao passar o mouse explica o motivo: são os eventos de maior volume e menor poder de identificação.
      • No Google Ads, o interruptor Pelo servidor fica indisponível em todos os eventos, e cada evento ligado pede o Rótulo de conversão. Sem o rótulo, o Google recebe o disparo e não registra a conversão.

      Clique em Adicionar pixel para salvar.

      3. Ligar a API de Conversões da Meta

      Com a Meta escolhida, o terceiro passo mostra o bloco API de Conversões da Meta:

      1. Cole o Token de acesso gerado na Meta.
      2. Clique em Testar token. O teste envia um evento de teste e não conta como conversão.
      3. Se aparecer Token recusado, gere um novo token na Meta e cole de novo.

      O Código de teste é opcional. Enquanto ele estiver preenchido, os eventos aparecem na aba de testes da Meta e não contam como conversão — limpe o campo antes de usar o pixel em campanha de verdade.

      Por segurança, o token nunca é mostrado de volta. Quando você editar um pixel que já tem token, o bloco mostra Token guardado com duas opções:

      • Trocar token abre o campo para colar um novo.
      • Remover apaga a credencial ao salvar, e os eventos pelo servidor param de ser enviados.

      Deixar o campo em branco mantém o token que já está guardado.

      4. Conferir o histórico de envio

      Quando parecer que o pixel "não está funcionando", comece por aqui — a resposta quase sempre está nesta lista.

      1. Em Tráfego › Pixel e trackeamento, abra o menu de ações da linha do pixel.
      2. Clique em Histórico de envio.

      O atalho leva à tela de detalhe do pixel, já no bloco do histórico — ele fica abaixo da lista de telas que escolheram o pixel. Veja onde este pixel está sendo usado, que explica também os botões de contagem por situação.

      Cada linha mostra o evento, a data e hora, e o resultado:

      ResultadoO que significa
      EnviadoA plataforma recebeu o evento
      FalhouA tentativa não completou. Tentamos de novo automaticamente
      Não enviadoAlguma configuração impediu o envio. O motivo aparece na própria linha
      Em andamentoO envio começou e ainda não terminou

      Os motivos mais comuns de Não enviado:

      Motivo mostradoO que fazer
      O evento está desligado neste pixelLigue o evento na edição do pixel. Se for uma compra, confira também a forma de pagamento
      Falta o token da API de Conversões neste pixelCole o token no bloco da API de Conversões
      Este evento espera os dados pessoais do visitanteÉ a opção Só contar depois dos dados pessoais. Desligue-a se quiser contar antes
      A Meta recusou o envioConfira o ID do pixel e gere um token novo
      Este evento não é enviado pelo servidorNada a fazer: o evento só sai pelo navegador
      O evento aconteceu há mais de 7 dias quando chegou a vez deleNada a fazer: a Meta não aceita eventos com mais de 7 dias. Os outros eventos seguem normalmente

      Ativar os eventos novos em um pixel que já existia

      Se você já usava o pixel antes desta mudança, a tela mostra o aviso Eventos novos disponíveis no topo. Enquanto ele estiver ali, o pixel envia só os eventos que você já tinha configurado antes — e envia três deles com o nome antigo.

      Clique em Ver o que muda para conferir a lista, e em Ativar eventos novos para aplicar. Depois disso o pixel passa a enviar os 13 eventos da jornada.

      O aviso fala da conta inteira, e o botão vale para todos os pixels que vieram da configuração antiga — inclusive os que estão em outras páginas da lista. O texto diz quantos são. Se algum não conseguir ativar, a mensagem informa quantos ativaram e o aviso continua na tela para os que faltaram; basta clicar de novo.

      Para ativar um pixel por vez, abra Editar naquela linha: o mesmo botão aparece dentro do cadastro e vale só para aquele pixel.

      Três eventos passam a chegar com outro nome:

      Ação do visitanteChega hoje comoPassa a chegar como
      Iniciou uma compra (abriu o checkout de uma oferta)InitiateCheckoutAddToCart
      Começou um período de testePurchaseStartTrial
      Agendou uma reuniãoLeadSchedule

      Se você usa esses nomes em públicos personalizados ou na otimização das suas campanhas, revise as campanhas depois de ativar: a campanha que otimiza por Purchase deixa de contar o início de teste, e a que otimiza por Lead deixa de contar o agendamento.

      Os outros eventos continuam com o mesmo nome, e nenhum evento é desligado — ativar só acrescenta.

      O que você já ajustou dentro de cada evento também fica como está. Se você desmarcou o boleto na compra, ele continua desmarcado; se pediu para só contar a abertura do checkout depois dos dados pessoais, o pedido continua valendo. A única exceção é a compra que estava desligada nos dois canais: ao ligar, ela passa a contar todas as formas de pagamento, porque ficar ligada sem nenhuma forma marcada não enviaria nada.

      Organizar a listagem por projeto

      Se você trabalha com vários projetos no mesmo workspace, o campo Projeto do cadastro ajuda a achar o pixel certo numa lista comprida. Em Filtros, o campo Projeto recorta a listagem, e Sem projeto mostra os que você não associou a nenhum.

      Só organiza sua listagem. O pixel continua disponível em toda a conta. Associar um pixel a um projeto não limita onde ele pode ser escolhido: ele continua aparecendo no seletor de qualquer funil, página ou produto do workspace, de qualquer projeto.

      Os outros filtros da mesma janela são Plataforma e Situação, e a busca no topo da lista procura por apelido ou ID.

      Onde ficava a configuração antiga

      O campo de Pixel ID que existia dentro de cada funil, página, produto e agenda saiu dessas telas. O cadastro agora é único, em Tráfego › Pixel e trackeamento, e a escolha de onde ele rastreia é feita dentro de cada tela.

      • O que você já tinha configurado por funil, por página, por domínio, por produto ou por agenda continua valendo: cada pixel foi trazido para esta tela automaticamente, com os eventos que ele já disparava e as telas que ele já rastreava. Você não precisa cadastrar nem escolher nada de novo.
      • Para escolher em quais funis, páginas, produtos, agendas ou formulários um pixel rastreia, abra a tela e marque o pixel dentro dela. Veja como escolher quais pixels rastreiam cada tela.
      • Para ver de uma vez todas as telas que escolheram um pixel, abra Ver detalhes no menu de ações da linha — veja onde este pixel está sendo usado.
      • As abas de rastreamento do editor de páginas e do funil continuam existindo, com o Google Tag Manager e os códigos personalizados — eles não são pixel e continuam sendo configurados por lá. É nas mesmas abas que fica a escolha de pixels da página e do funil.
      • A aba Pixels dentro de cada produto agora é onde você escolhe quais pixels rastreiam o checkout daquele produto. Ela não cadastra pixel: o cadastro continua em Tráfego › Pixel e trackeamento.
      • O campo Pixel ID do Meta da agenda deixou de aceitar valor novo. No lugar dele, a aba Geral da agenda tem o bloco Pixels desta agenda.

      Ativar, inativar e excluir

      No menu de ações de cada linha:

      • Inativar para o pixel de receber eventos sem apagá-lo. Dá para reativar pelo mesmo menu.
      • Excluir remove o pixel de vez. Os eventos param de chegar em todas as páginas, checkouts e formulários onde ele valia, e a ação não pode ser desfeita — por isso a tela pede o apelido do pixel para confirmar.

      Próximos passos