Como configurar o pixel de anúncios do ChatGPT

O que é o pixel de anúncios do ChatGPT

O pixel de medição de anúncios do ChatGPT é a tecnologia de medição em JavaScript da OpenAI. Você o instala no seu site para medir o que acontece depois que alguém clica em um cartão patrocinado de ChatGPT Ads: compras, envios de formulário, cadastros ou qualquer outra conversão que importe para você.

O fluxo é simples: um usuário clica em um cartão patrocinado, chega ao seu site com uma referência de clique na URL, o pixel a captura e envia depois um evento de conversão, e esse evento aparece no Ads Manager da OpenAI.

Anúncio no ChatGPT
   ↓
Usuário clica no anúncio
   ↓
Seu site  (a URL de destino leva ?oppref=...)
   ↓
Píxel OpenAI
   ↓
Evento de conversão
   ↓
Ads Manager da OpenAI → relatório de conversões

Pixel vs Conversions API

A OpenAI oferece duas formas de enviar dados de conversão, e cada uma responde a uma pergunta diferente:

Quando enviar a mesma conversão pelos dois canais, reutilize o mesmo event_id para a OpenAI reconhecer um único evento e não contar duas vezes.

Antes de começar: o que você precisa

• Conta no Ads Manager da OpenAI (autogerenciada ou via agência) com acesso às configurações de medição.
• Uma fonte de dados (pixel) criada no Ads Manager — de onde sai o seu ID de pixel.
• Um site onde você possa adicionar um script no <head> (ou um gerenciador de tags / plugin / desenvolvedor).
• Os eventos de conversão que quer medir, configurados no Ads Manager para bater com o que o site envia.
• Se for usar a Conversions API: acesso ao servidor e uma forma de manter o token de acesso protegido.

Passo 1 — Instalar o pixel no seu site

Crie uma fonte de dados no Ads Manager, copie seu ID de pixel (pId_...) e adicione o JavaScript em todas as páginas onde pode haver conversão. Uma implementação básica é esta:

<script>
  (function (w, d, s, u) {
    if (w.oaiq) return;
    var q = function () {
      q.q.push(arguments);
    };
    q.q = [];
    w.oaiq = q;
    var js = d.createElement(s);
    js.async = true;
    js.src = u;
    var f = d.getElementsByTagName(s)[0];
    f.parentNode.insertBefore(js, f);
  })(window, document, "script", "https://bzrcdn.openai.com/sdk/oaiq.min.js");

  oaiq("init", {
    pixelId: "SEU_ID_DE_PIXEL"
  });
</script>

Dois detalhes importam. A validação if (w.oaiq) returnevita carregar o SDK duas vezes se o snippet aparecer repetido. E use sempre o snippet atual da documentação de desenvolvimento da OpenAI, porque o SDK evolui — verifique snippet e parâmetros antes de levar para produção.

Passo 2 — Configurar eventos de conversão

Instalar o pixel não transforma automaticamente uma ação em conversão. O evento que o seu site envia precisa bater com a conversão configurada no Ads Manager.

Evento do site:  order_created        Ads Manager:   order_created
Evento do site:  quote_requested      Ads Manager:   Personalizado → quote_requested

Em eventos personalizados o nome precisa bater exatamente — um nome parecido não resolve. Os nomes são em snake_case minúsculo (order_created, não orderCreated).

Passo 3 — Rastrear compras

Em e-commerce, o evento de compra é a conversão que mais importa. Envie-o quando o pedido for confirmado:

oaiq("measure", "order_created", {
  type: "contents",
  amount: 2599,
  currency: "USD",
  contents: [
    {
      id: "SKU-123",
      name: "Pacote inicial",
      content_type: "product",
      quantity: 1
    }
  ]
}, {
  event_id: "order_12345"
});

order_created é o nome do evento, amount e currency descrevem o valor, contents carrega os itens comprados e event_id é seu identificador único para deduplicação. Consulte o esquema de eventos suportados na documentação da OpenAI para o contrato exato dos campos.

Passo 4 — Rastrear leads

Em sites de geração de leads, dispare um evento de lead quando o formulário for enviado:

oaiq("measure", "lead_created", {
  type: "customer_action"
}, {
  event_id: "lead_98765"
});

Passo 5 — Eventos de conversão personalizados

Nem toda conversão é compra ou lead. Solicitações de demo, de orçamento, calculadoras concluídas, inscrições e consultas agendadas se encaixam em um evento personalizado:

oaiq("measure", "custom", {
  type: "custom"
}, {
  custom_event_name: "quote_requested"
});

Configure no Ads Manager exatamente o mesmo nome de evento personalizado. Nomes personalizados aceitam letras, números, underscores e hífens (de 1 a 64 caracteres) e não podem colidir com um evento padrão.

Automatic Advanced Matching

Quando um identificador de clique não conecta uma conversão, o Automatic Advanced Matching (AAM) pode melhorar a medição com informações de primeira parte elegíveis — por exemplo, campos de formulário reconhecíveis. O pixel normaliza e aplica SHA-256 nessas informações dentro do navegador.

Você não precisa fazer hash de e-mails manualmente. Na configuração padrão de Automatic Advanced Matching, a orientação atual da OpenAI é que nenhuma mudança separada de pixel é necessária e que informações de cliente em texto claro não são enviadas à OpenAI via AAM.

oppref: a referência de clique que conecta tudo

oppref é o sinal de referência de clique da OpenAI, adicionado às URLs de destino dos anúncios do ChatGPT:

https://example.com/produto?oppref=gAAAAAb123

O pixel guarda esse valor em um cookie de primeira parte para que páginas posteriores e eventos de conversão continuem ligados à interação original com o anúncio. Ao enviar eventos de Conversões API, preservar oppref quando disponível melhora a qualidade da medição.

Regra prática: ao criar redirecionamentos, rotas de destino ou um sistema próprio de tracking, nunca remova oppref da URL.

Deduplicação com a Conversions API

Rodando os dois canais, um mesmo pedido cruza a OpenAI duas vezes — uma do pixel do navegador, outra do seu servidor. A OpenAI detecta duplicados com ID do pixel, nome do evento e event_id:

Pedido ORD-10001
   ├── Pixel do navegador ──→  event_id = ORD-10001
   └── CAPI do servidor ────→  event_id = ORD-10001

A OpenAI mantém o primeiro e ignora o duplicado.

Gere o event_id uma única vez (um ID de pedido real funciona bem) e reutilize exatamente o mesmo valor na chamada do pixel e na chamada do servidor.

Configuração no Google Tag Manager

O Google Tag Manager é uma forma suportada de instalar o pixel — desde que o gerenciador não bloqueie ou reordene a inicialização e as chamadas de evento. Estruture o contêiner em torno de três tags:

• Tag 1 — Base do pixel da OpenAI: a tag de init carregada em todas as páginas (executa o snippet com seu ID de pixel).
• Tag 2 — Compra do pixel de OpenAI: dispara no evento de compra/pedido confirmado, usando a data layer.
• Tag 3 — Lead do pixel de OpenAI: dispara no envio do formulário de lead.

Mapeie os eventos da sua data layer existente para que o pixel dispare nos mesmos gatilhos que o resto da sua análise.

Configuração no WooCommerce

No WooCommerce o funil normalmente é: produto visto → adicionar ao carrinho → checkout iniciado → pedido criado. O evento de pedido é a conversão de negócio.

WooCommerce
   ↓
Pedido criado
   ↓
Gere um ID de pedido único
   ↓
Pixel do navegador ────┐
                       ├── Anúncios OpenAI (mesmo event_id)
CAPI do servidor ──────┘

Use o ID do pedido do WooCommerce como event_id: um valor realmente único torna a deduplicação confiável. No WordPress, o plugin gratuito Ridoway Pixel cuida do pixel, da chamada de servidor e da deduplicação com event_id automaticamente.

Consentimento e privacidade

Antes de implementar o tracking, revise os requisitos de consentimento do seu país, da jurisdição dos seus usuários e da sua política de privacidade. A orientação da OpenAI é clara: você precisa informar claramente quais dados coleta e, onde a lei exigir, obter consentimento apropriado antes de enviar dados de conversão.

• Publique política de privacidade e um aviso de cookies/tracking.
• Conecte uma plataforma de consentimento quando exigido (LGPD brasileira, GDPR e equivalentes).
• Defina retenção de dados e quais canais podem receber eventos.
• Lembre que o SDK inicia com consentimento ativado por padrão e suporta oaiq("consent", false) antes do init.

Conversões sumindo? Solucione nesta ordem

O pixel disparar não significa que o Ads Manager mostre uma conversão imediatamente. Verifique nesta ordem:

• O pixel está inicializando? — Veja em DevTools/Rede o SDK carregando de bzrcdn.openai.com.
• ID de pixel correto? — Um ID errado envia eventos para outra fonte de dados e sua coluna fica vazia.
• O nome do evento bate? — O evento do site precisa corresponder exatamente à conversão configurada (grafia exata em eventos personalizados).
• Conversão anexada? — A campanha precisa ter um evento de conversão associado, criado a partir dos seus eventos.
• oppref preservado? — Perder referências de clique reduz a qualidade de atribuição.
• Deduplicação correta? — Eventos do navegador e do servidor de uma mesma conversão devem compartilhar um event_id.
• Atraso de relatório — a OpenAI informa que conversões atribuídas podem levar de 24 a 48 horas para aparecer no Ads Manager.

Um jeito rápido de ver se o pixel dispara é o verificador gratuito ChatGPT Ads Pixel Checker; a extensão Pixel Helper mostra cada chamada init e measure ao vivo.

Por que Ads Manager e Google Analytics diferem

Totais de conversão diferentes entre plataformas é normal. Anúncios OpenAI e Google Analytics não usam a mesma metodologia de atribuição. As diferenças vêm de janelas de atribuição, timestamps, fusos horários, consentimento, restrições do navegador, disponibilidade de armazenamento, deduplicação, configuração de campanhas e medição modelada.

OpenAI Ads:        100 conversões
Google Analytics:   82 conversões

Um desvio assim não prova que o pixel está quebrado. A própria OpenAI diz que totais podem diferir entre plataformas de análise.

Relatórios e janelas de atribuição atuais

No Ads Manager atual (Beta), anunciantes veem impressões, cliques, gasto, CTR, CPC médio, CPM médio e — quando a medição está configurada — conversões. Conversões por clique e view-through elegíveis são reportadas separadamente. Em setembro de 2026, as combinações de janela de atribuição disponíveis incluem:

Como relatórios e atribuição seguem evoluindo com o Beta do Ads Manager, verifique janelas e métricas atuais na documentação da OpenAI antes de decidir otimizações.

A arquitetura completa de medição

Uma configuração moderna e resiliente combina os dois canais em um único fluxo:

                   CHATGPT ADS
                        │
                        ▼
                   Clique no anúncio
                        │
                        ▼
                Página de destino (oppref)
                        │
            ┌───────────┴───────────┐
            ▼                       ▼
      OpenAI Pixel              Site / Servidor
            │                       │
            │                 Evento de conversão
            │                       │
            ▼                       ▼
        Navegador               Conversions API
            │                       │
            └───────────┬───────────┘
                        │
                    Mesmo event_id
                        │
                        ▼
               Medição da OpenAI
                        │
                        ▼
                  Ads Manager
                        │
           ┌────────────┼────────────┐
           ▼            ▼            ▼
        Cliques    Conversões       ROAS

Essa é a arquitetura completa em uma imagem: um clique, dois canais de eventos, um event_id compartilhado e uma única superfície de relatórios no Ads Manager.

Parceiros de medição

A OpenAI também suporta parceiros de medição de terceiros quando você prefere uma camada externa de atribuição, relatórios ou otimização. Exemplos documentados em setembro de 2026: Fospha, Hightouch, LiveRamp, Triple Whale e WorkMagic. Para medição mobile estão documentadas integrações com AppsFlyer, Adjust e Branch. As capacidades variam por parceiro.

Boas práticas

• Instale o pixel em todas as páginas onde a medição importa, não só na home.
• Nunca remova oppref em redirecionamentos, rotas ou tracking próprio.
• Rode pixel + Conversions API juntos quando for técnica e comercialmente adequado.
• Reutilize o mesmo event_id para a mesma conversão no navegador e no servidor.
• Faça os nomes de eventos de conversão baterem exatamente — principalmente os personalizados.
• Entenda o Automatic Advanced Matching: na configuração padrão você não faz hash manual.
• Espere um atraso de relatório de 24–48 horas antes de julgar números do fim de semana.
• Não compare às cegas Ads Manager, GA4 e outras plataformas — metodologias de atribuição diferem.

Perguntas frequentes