Docs
Conceito

Introdução aos Pixels

Um Pixel no TagServer é a sua conexão com uma plataforma de destino, operando em modelo server-side. No rastreamento de navegador, é o próprio navegador do visitante que dispara o evento e o entrega à plataforma. No TagServer, o evento passa pelo servidor, e é o servidor que faz a chamada até o destino.

O que é um Pixel no TagServer?

Um Pixel é a representação da sua conta de anúncio ou ferramenta de análise dentro da plataforma. Ele recebe os eventos do seu site (uma visualização de página, um clique, uma compra) e os reencaminha ao destino final por uma conexão de servidor para servidor. É essa conexão que caracteriza o rastreamento server-side, em oposição ao rastreamento feito pelo navegador.

O termo "Pixel" (e "Pixel ID") é mantido de propósito. A Meta passou a chamar isso de "dataset", mas quem opera tráfego reconhece o pixel, então preferimos o nome que você já usa a inventar um novo.

Por que server-side

O rastreamento pelo navegador perde eventos. Bloqueadores de anúncio, restrições a cookies de terceiros e limites de privacidade como os do iOS interceptam parte dos sinais antes que cheguem à plataforma. O envio server-side contorna esses bloqueios e recupera parte desses dados: é uma melhoria de entrega, não uma garantia de que nada se perca.

Server-side também abre espaço para deduplicação. O TagServer propaga um event_id compartilhado com o pixel de navegador, de modo que a mesma conversão chega ao destino pelos dois caminhos carregando o mesmo identificador. Quem deduplica é a plataforma de destino (Meta CAPI, GA4): ela reconhece que os dois envios descrevem o mesmo evento e conta uma vez só. O papel do TagServer aqui é fazer o mesmo id viajar em ambos os caminhos.

Há ainda o tratamento dos dados de correspondência. Dados como e-mail e telefone são normalizados e convertidos em hash SHA-256 antes do envio, e o evento pode ser enriquecido com o IP do cliente, o user agent e os cookies fbc/fbp. O hashing atende à LGPD e ao GDPR, e os sinais adicionais melhoram a taxa de correspondência (match rate) no destino.

Como o evento viaja até o destino

Conectar a plataforma. Você vincula a conta de destino informando as credenciais daquela plataforma. Na Meta, por exemplo, isso é o Pixel ID mais o token de conversão; no LinkedIn e no Google Ads, é uma conexão OAuth feita dentro do próprio formulário de adicionar pixel. O detalhe de cada credencial vive na referência Plataformas e credenciais.

Mapear evento a gatilho. Você define quais ações do site disparam quais eventos. Isso pode ser feito na tela nativa de Regras (item "Regras" do grupo "Rastreamento", visível com o recurso de rastreamento web), em que uma regra associa um nome de regra, um nome de evento e um gatilho, ou pelo Google Tag Manager.

Receber. Quando o visitante interage com o site, o evento chega ao seu subdomínio de rastreamento: a tag de navegador instalada envia o sinal para esse subdomínio.

Despachar servidor a servidor. O servidor do TagServer faz a chamada de API autenticada para a plataforma parceira. O mecanismo varia conforme o destino: a Meta usa a CAPI (Conversions API), o GA4 usa o Measurement Protocol e o Google Ads usa o upload de conversões (Enhanced Conversions).

Registrar. Cada tentativa de entrega é registrada com o status remoto que a plataforma retornou e um sinalizador de erro. Esse registro aparece na própria tela de Pixels e também pode ser consultado por uma IA via MCP; a taxa de erro é derivável a partir dele. Como cada evento pode falhar, a entrega fica sob monitoramento em vez de garantida, e você consegue ver o que passou e o que falhou.

Onde fica no app

O gerenciador de pixels fica no item Pixels do grupo "Rastreamento" do menu lateral, ao lado de "Visão geral", "Subdomínios" e "Regras". A rota é escopada pela conta, /<sua-conta>/pixels, e a tela também se chama "Pixels".

Nessa tela você pode adicionar um pixel ("Adicionar pixel"), inspecionar os eventos que ele está recebendo ("Inspecionar", disponível para as seis plataformas) e excluí-lo ("Excluir"). Não há operação de editar nem de renovar um pixel. Acima da tabela "Pixels cadastrados" fica a seção "Eventos", onde a etapa de registro se torna visível: o gráfico "Monitoramento de eventos" (sucesso x erro), os eventos recentes e, com Meta (ou todas as plataformas) selecionada, a tabela "Eventos com erros". O passo a passo dessas ações está no how-to Criando e gerenciando pixels.

As plataformas que você adiciona como pixel são Meta Ads, Google Analytics, Google Ads, LinkedIn Ads, TikTok Ads e Pinterest Ads. LinkedIn e Google Ads pedem a conexão OAuth dentro do formulário ("Conectar LinkedIn" / "Conectar Google Ads"); no Google Ads, depois de conectar, você cadastra a conta (Customer ID, MCC opcional) e a ação de conversão. Os campos de cada plataforma estão em Plataformas e credenciais.

Veja também

AnteriorReferência de DNS e SSLPróxima Criando e gerenciando pixels