Configurar Pixel da OpenAI (ChatGPT Ads)

O Pixel da OpenAI mede as conversões das campanhas de anúncios no ChatGPT. Com o Track Combo, os eventos saem pela web tag no navegador e também pela Conversions API (server-side), com o mesmo identificador, para a OpenAI deduplicar e atribuir melhor.

# Requisitos

• Conta de anunciante no ChatGPT Ads
• Pixel ID criado no Gerenciador de Anúncios
• API Key da Conversions API (opcional, necessária só para o envio server-side)

# Passo a Passo

# 1. Crie o Pixel ID

1. Acesse o Gerenciador de Anúncios do ChatGPT
2. Vá na aba Conversões
3. Crie um novo pixel e copie o Pixel ID

# 2. Gere a API Key da Conversions API

1. Ainda na aba Conversões, abra as configurações do pixel
2. Gere uma chave de acesso para a Conversions API
3. Copie a chave. Ela só aparece uma vez, guarde num lugar seguro

Sem a API Key o pixel funciona só pela web tag. Com ela, o Track Combo também envia os eventos de webhook (compras aprovadas, leads) direto do servidor, que o navegador não consegue enviar.

# 3. Adicione no Track Combo

1. Abra seu projeto no Track Combo
2. Clique em + Adicionar Pixel
3. Selecione OpenAI
4. Cole o Pixel ID
5. Cole a API Key (para o envio server-side)
6. Clique em Salvar
7. Publique a tag do projeto para a mudança entrar no site

# Eventos Enviados

O Track Combo converte os eventos do seu site e das integrações para os eventos padrão da OpenAI:

Evento no Track Combo	Evento na OpenAI
page_view	page_viewed
view_item	contents_viewed
add_to_cart	items_added
initiate_checkout	checkout_started
purchase	order_created
lead	lead_created

Outros eventos (por exemplo add_payment_info ou eventos personalizados) são enviados como evento customizado, com o nome original.

O valor da compra vai em amount com a moeda da venda, e os dados do cliente (email, telefone, nome) são normalizados e enviados com hash SHA-256, como a OpenAI exige.

# Atribuição do Clique

Quando alguém clica num anúncio no ChatGPT, a URL de destino chega com o parâmetro oppref. A web tag guarda esse valor no cookie __oppref (válido por 30 dias) e o Track Combo o anexa a todos os eventos daquele visitante, inclusive nas compras que chegam por webhook dias depois. Não é preciso configurar nada nas URLs das campanhas, mas evite redirecionamentos que descartem os parâmetros da URL.

# Testar o Pixel

1. Abra seu site com ?tc_debug=visual no final da URL e confira se o pixel OpenAI aparece como carregado e os eventos como disparados
2. No Gerenciador de Anúncios, abra a aba Conversões e verifique se o pixel está recebendo eventos
3. Faça uma conversão de teste (lead ou compra) e confirme o evento order_created ou lead_created
4. No Track Combo, a aba de pixels do projeto mostra o status do envio server-side e eventuais erros

# Dicas Importantes

• Use o mesmo pixel na web tag e na Conversions API (é o que o Track Combo faz por padrão). A OpenAI deduplica pelo Pixel ID + nome do evento + ID do evento
• Eventos com mais de 7 dias são rejeitados pela OpenAI; o Track Combo descarta esses automaticamente
• A API Key é secreta. Se ela vazar, gere outra no Gerenciador de Anúncios e atualize o pixel no Track Combo
• O envio server-side depende de a venda chegar ao Track Combo por uma integração (webhook do checkout). Confira se a integração do seu checkout está ativa

# Problemas Comuns

Pixel marcado com erro de credencial?

• A API Key foi recusada pela OpenAI. Edite o pixel, cole uma chave válida e salve: o pixel é reativado e os eventos pendentes são reenviados

Eventos não aparecem no Gerenciador de Anúncios?

• Confirme que a tag do projeto foi publicada depois de adicionar o pixel
• Verifique se o Pixel ID está correto
• A OpenAI pode levar algumas horas para refletir os eventos nos relatórios

Conversões sem atribuição?

• O clique precisa chegar ao site com o parâmetro oppref na URL. Verifique se o link do anúncio não passa por um encurtador ou redirecionamento que remova os parâmetros
• Se o visitante bloqueia scripts de terceiros, o cookie __oppref não é gravado e a atribuição depende do match por email ou telefone