Suporte: seg. a sex., das 9h às 18h

Como funciona a integração com o ChatGPT Ads

Atualizado em 30/10/2026

A integração com o ChatGPT Ads envia os eventos da loja (produtos vistos, carrinhos, cadastros, início do checkout e compras) para a OpenAI, que usa esses dados para medir o resultado dos anúncios exibidos no ChatGPT e melhorar a entrega das campanhas.

Você a encontra em Marketing & SEO > Integrações, na pasta Pixels, item ChatGPT Ads. A integração tem duas partes, cada uma com a própria tela no menu da integração: o Pixel e a API de Conversão. A primeira tela, Visão geral, lista as duas com um selo de estado e o botão Configurar, que abre a tela da parte.

  • Selo verde — a parte está ligada e completa ("Ativo" ou "Ativa").
  • Selo amarelo — a parte foi configurada, mas falta algo para funcionar, como "Falta o ID do Pixel".
  • Selo cinza — a parte está desligada ou ainda não foi configurada.

Não confunda: a integração com a OpenAI, na pasta Vídeos e IA, é a chave que alimenta os botões de escrita com IA do painel. O ChatGPT Ads mede os anúncios da loja dentro do ChatGPT, e uma integração não depende da outra.

Pixel

O Pixel é o rastreamento que roda no navegador do cliente. É ele que registra cada passo da visita e permite à OpenAI reconhecer a compra de quem chegou à loja por um anúncio. Na tela Pixel:

  • Carregar o Pixel na loja — liga o Pixel. Desligado, a loja deixa de enviar eventos ao ChatGPT Ads pelo navegador.
  • ID do Pixel — o código do Pixel que o ChatGPT Ads Manager mostra na fonte de dados da loja.
  • Enviar os eventos da visita — desligado, o Pixel registra só a visita de página. Ligado, envia também o produto visto, o carrinho, o cadastro, a pergunta ao lojista, o início do checkout e a compra.

A seção Eventos enviados lista cada evento com o nome que ele recebe no ChatGPT Ads (como items_added e order_created), o que ajuda na hora de conferir a chegada dos eventos no ChatGPT Ads Manager.

Atenção: a fonte de dados mostra dois códigos, o da própria fonte, que começa com clidsrc_, e o ID do Pixel. Só o ID do Pixel funciona na loja, e por isso a tela recusa o código que começa com clidsrc_ com o aviso "Este é o ID da fonte de dados. Informe o ID do Pixel.".

A tela também não deixa ligar o Pixel com o ID do Pixel vazio, e o campo aceita só letras, números, hífen e sublinhado. Nos dois casos, nada é salvo, e o formulário volta com o campo marcado para você corrigir.

Dados do cliente

Quando o cliente está logado, o Pixel envia o e-mail e o código dele à OpenAI, para ela ligar a compra ao clique no anúncio. Os dois vão embaralhados de forma irreversível (hash), e nunca como texto legível: a OpenAI consegue comparar com os dados que já tem, mas não consegue ler o e-mail a partir do que recebeu.

A compra leva o número do pedido junto, o mesmo que a API de Conversão envia pelo servidor. Assim, a compra que chega à OpenAI pelos dois caminhos é contada uma vez só.

API de Conversão

O navegador é um mensageiro que às vezes não entrega: bloqueadores de anúncio, as proteções de privacidade dos navegadores e a aba fechada antes da hora fazem o Pixel perder parte das compras. Quando isso acontece, o ChatGPT Ads não sabe que a venda veio do anúncio e mede mal as campanhas.

A API de Conversão envia a compra, o cadastro, o contato e o início do checkout pelo servidor da loja, por um caminho que o bloqueador do navegador não alcança. Ela reforça cada evento com o IP e o navegador do cliente e, na compra, com os dados do pedido. Os dados que identificam o cliente (e-mail, telefone, código e nome) vão protegidos por hash, e a cidade, o estado, o CEP e o país da entrega seguem sem hash, como a OpenAI pede. Na tela API de Conversão:

  • Enviar os eventos pelo servidor — liga a API. Desligada, os eventos chegam ao ChatGPT Ads só pelo Pixel do navegador.
  • Chave da API — gerada no ChatGPT Ads Manager, com o escopo ads.third_party_events.write, que é o que permite enviar os eventos. Por segurança, o campo sempre aparece vazio: depois de gravada, a tela mostra "Chave gravada" e, na chave com 12 caracteres ou mais, os 4 últimos. Para trocar, cole a nova chave; deixar o campo em branco mantém a atual.

A API usa o ID do Pixel da tela Pixel, sem um campo próprio, porque é o mesmo pixel nos dois caminhos que faz o ChatGPT Ads contar cada evento uma vez só. O Pixel do navegador pode estar desligado: com a API ligada, a chave gravada e o ID do Pixel preenchido, os eventos vão pelo servidor do mesmo jeito.

A tela não deixa ligar a API sem a chave ("Informe a chave para ativar a integração.") nem com o ID do Pixel vazio ("Informe o ID do Pixel na tela Pixel antes de ativar."). Com a API ligada, a tela Pixel também não deixa apagar o ID do Pixel ("Desligue a API de Conversão antes de apagar o ID do Pixel."), porque sem ele os eventos não teriam para onde ir. A opção Remover a chave gravada só funciona com a API desligada, e com ela ligada a tela avisa "Para remover a chave, desligue antes a integração que a usa.".

Teste da chave

O botão Testar a chave confere com a OpenAI a chave gravada e o ID do Pixel, sem registrar evento nenhum, então pode ser usado com a API desligada e quantas vezes você quiser. O resultado aparece logo abaixo do botão: em verde, "A OpenAI aceitou a chave e o ID do Pixel.", ou em vermelho, com o motivo da recusa.

O teste usa a chave gravada, e não a que está no campo: depois de colar uma chave nova, grave a tela e só então teste. Enquanto não houver chave gravada ou ID do Pixel na tela Pixel, o botão fica desabilitado, com o aviso do que falta.

O que é enviado

A API envia quatro eventos, com o mesmo código que o Pixel usa no navegador. Assim, o evento que chega pelos dois caminhos é contado uma vez só:

  • Compra (order_created) — com o valor e os itens do pedido.
  • Cadastro (registration_completed) — quando o cliente cria a conta, na página de cadastro ou no checkout.
  • Contato (lead_created) — quando o cliente envia o formulário de contato ou uma pergunta sobre o produto. Vale um por visita: os contatos seguintes da mesma visita não contam de novo.
  • Início do checkout (checkout_started) — quando o cliente se identifica no checkout, com os itens e o valor do carrinho. Se ele voltar e mudar o carrinho, o carrinho novo conta como outro início.

O clique no botão do WhatsApp chega ao ChatGPT Ads só pelo Pixel do navegador, porque leva o cliente para fora da loja sem passar pelo servidor. A navegação de quem está logado na loja como usuário do painel não é enviada pela API, para os seus testes não contarem como conversão.

O cadastro, o contato e o início do checkout seguem para a OpenAI na hora. A compra entra em uma fila logo depois do pedido e segue para a OpenAI em seguida. Se o envio falhar, a loja tenta de novo, até 3 vezes. A compra que aguarda envio aparece em ERPs > Transmissões, com o nome ChatGPT Ads.

Atenção: só a compra feita com a API ligada é enviada, porque é no fechamento do pedido que a loja guarda os dados do anúncio. Ligar a API não envia os pedidos anteriores, e a OpenAI só aceita a compra até 7 dias depois do pedido.

Chave recusada

Se a OpenAI recusar a chave em um envio (a chave foi apagada no ChatGPT Ads Manager ou perdeu o escopo), a loja desliga a API de Conversão sozinha e registra um alerta em Auditorias > Alertas, que indica o caminho da tela da API de Conversão. A recusa no Testar a chave não desliga nada, porque você pode estar no meio da troca da chave.

Para religar, gere uma chave nova com o escopo ads.third_party_events.write, cole em Chave da API, grave, confira com Testar a chave e ligue Enviar os eventos pelo servidor.