# Conectar o OpenAI Ads (ChatGPT Ads) ao cPixel {#doc-title}

Por [B2B Gold](/about/#how-we-write) Atualizado em 25 de setembro de 2026 [Traduzido do inglês com ferramentas de IA](/docs/cpixel/connect-openai-ads/) [Página do cPixel](/shopify/cpixel/) [cPixel na Shopify App Store](https://apps.shopify.com/cpixel?utm_source=b2bgold.app&utm_medium=referral&utm_campaign=docs&utm_content=pt-br/docs/cpixel/connect-openai-ads&utm_term=docs-header)

## Como conecto o OpenAI Ads ao cPixel? {#how-do-i-connect-openai-ads-to-cpixel}

No OpenAI Ads Manager, abra Tools e depois Conversions: o Pixel ID aparece abaixo da sua data source na aba Data Source, e o ícone de chave no cabeçalho da página cria uma Conversions API key, exibida apenas uma vez. Cole os dois no cPixel, que passa a enviar checkouts e compras ao ChatGPT Ads pelos servidores dele.

### Cole os valores no cPixel {#paste-them-into-cpixel}

1. No cPixel, abra **Destinos** e clique no ícone do OpenAI Ads em **Conectar uma plataforma**. **Configurar OpenAI Ads** abre em **Cole seus IDs**.
2. Cole o **ID do pixel** ([onde encontrar](#where-do-i-find-my-openai-ads-pixel-id)) e a **Chave da Conversions API** ([como criar uma](#how-do-i-create-a-conversions-api-key)); ambos são obrigatórios. Nomeie a conta em **Dê um nome a esta conta (opcional)**, se quiser.
3. Clique em **Testar conexão**. A OpenAI valida um evento de teste sem registrá-lo, então **Your credentials reach this account** confirma o acesso, não a entrega.
4. Clique em **Continuar**. Em **Escolha as opções**, mantenha **Enviar eventos pelo navegador** e **Enviar eventos pelos nossos servidores** marcados, responda **O app oficial do OpenAI Ads também está instalado?** (abaixo) e clique em **Salvar e continuar**. **Teste** confirma **OpenAI Ads está conectado**.

> **Importante:** O próprio [app ChatGPT Ads para Shopify](https://help.openai.com/en/articles/20001523-set-up-chatgpt-ads-for-shopify) da OpenAI também envia os eventos da sua loja para um pixel da OpenAI. Dois remetentes dão a um mesmo pedido dois IDs de evento, e a OpenAI mantém os dois. Dê a cada ferramenta seu próprio Pixel ID, ou responda **Sim — mantenha-o, e o cPixel para de enviar o OpenAI Ads pelo servidor**, que, apesar do nome, interrompe os envios do cPixel pelo navegador e pelo servidor para aquele pixel ([um remetente por pixel](/pt-br/docs/cpixel/official-channel-apps/)).

## Onde encontro o Pixel ID do OpenAI Ads? {#where-do-i-find-my-openai-ads-pixel-id}

No [OpenAI Ads Manager](https://ads.openai.com/), abra **Tools** → **Conversions**: na aba **Data Source**, o ID cinza abaixo do nome da sua data source é o Pixel ID, não o ID da conta de anúncios que aparece na barra de endereço.

1. No menu à esquerda, expanda **Tools** e escolha **Conversions**.
2. Na aba **Data Source**, copie o ID cinza, ou [crie uma data source](https://help.openai.com/en/articles/20001409-conversion-measurement) se não tiver nenhuma.

## Como crio uma chave da Conversions API? {#how-do-i-create-a-conversions-api-key}

Clique no ícone de chave ao lado de **Warnings** na página **Conversions**, depois em **Create new key**. Copie a chave, que começa com `sk-svcacct-`, imediatamente: a OpenAI a mostra apenas uma vez.

1. Clique no **key icon**. **Conversion keys** lista suas chaves mascaradas; a OpenAI nunca revela uma chave antiga.
2. Clique em **Create new key**, dê um nome a ela e copie a chave em **Save your key** antes de fechar.
3. Cole-a no campo **Chave da Conversions API** do cPixel.

> **Dica:** Excluir uma chave a revoga imediatamente, então crie e cole a nova chave antes de excluir a antiga.

## O aviso “Ads cannot serve until you finish account setup” impede isso? {#does-ads-cannot-serve-until-you-finish-account-setup-block-this}

Não. Contas novas exibem esse aviso até que a cobrança e um logotipo da conta sejam configurados; ele bloqueia a veiculação de anúncios, não a Conversions API.

## O que o cPixel envia para o ChatGPT Ads? {#what-does-cpixel-send-to-chatgpt-ads}

Checkouts e compras sempre saem dos servidores do cPixel, como checkout_started e order_created, porque um tema não roda no checkout nem na página de agradecimento da Shopify. Com o [app embed](/pt-br/docs/cpixel/getting-started/) ativado, uma tag da loja adiciona visualizações de página, visualizações de produto e adições ao carrinho (page_viewed, contents_viewed, items_added), então nenhum evento tem dois remetentes.

- Se o navegador de um comprador não conseguir carregar a tag da OpenAI, o cPixel envia esse evento da loja pelos servidores dele com sua chave, nunca um que a tag já tenha enviado. Ele não consegue ver a OpenAI recusar um evento do navegador.
- Nenhum evento de informação de pagamento chega à OpenAI.
- Os envios pelo servidor levam e-mail, telefone, IDs de cliente e de dispositivo com hash, `oppref` e `obref`, endereço IP e user agent. O OpenAI Ads exige consentimento de marketing; o cPixel nunca envia nomes ou endereços postais.
- A OpenAI [deduplica](https://developers.openai.com/ads/conversions-api) por Pixel ID, nome do evento e ID do evento, mantendo a primeira cópia, e aceita eventos com até 7 dias.

O OpenAI Ads Manager [avalia diariamente a qualidade dos eventos de cada data source](https://help.openai.com/en/articles/20001513-understand-and-improve-event-quality). A página **Qualidade dos eventos** do cPixel não lê essa pontuação, e a nota do cPixel de que a OpenAI não publica nenhuma está desatualizada.

## O que é oppref, e o cPixel o envia? {#what-is-oppref-and-does-cpixel-send-it}

oppref é a referência de clique que a OpenAI adiciona ao endereço da sua landing page quando alguém clica em um anúncio do ChatGPT. A OpenAI [o usa](https://help.openai.com/en/articles/20001409-conversion-measurement) para conectar uma conversão ao clique, com dados de contato com hash como alternativa. O cPixel o envia com os eventos do servidor sempre que tiver um.

- O cPixel o lê do endereço e, com o app embed ativado, do cookie `__oppref` que a tag da OpenAI mantém no seu domínio, o que sobrevive a uma mudança entre `www` e o domínio puro.
- A tag da OpenAI [mantém esse cookie por 30 dias](https://developers.openai.com/ads/measurement-pixel), reiniciando a contagem sempre que o oppref aparece novamente no endereço.
- A OpenAI pede que você preserve o oppref em redirecionamentos: um que remove parâmetros de consulta o perde.

## Como confiro se funcionou? {#how-do-i-check-it-worked}

Inicie uma sessão no **Ao vivo** e faça um pedido real: a linha **Servidor** da compra mostra a resposta da OpenAI, **Aceito**, **Rejeitado** ou **Erro**, com o status HTTP. Depois confira a aba **Event Stream** no Ads Manager.

1. No cPixel, abra o **Ao vivo** e clique em **Iniciar sessão**.
2. Em outra aba, faça um pedido real; por padrão, o cPixel ignora pedidos de teste.
3. Abra a linha **Servidor** da compra: **OpenAI Ads** deve mostrar **Aceito**. Eventos da loja aparecem como linhas **Navegador**, sem resposta.
4. No Ads Manager, abra **Tools** → **Conversions**, depois a aba **Event Stream**. Eventos da loja também chegam ali, nunca das páginas de checkout.

**Destinos** marca a conta como **Verificado** após o primeiro envio pelo servidor aceito. As conversões atribuídas chegam aos relatórios da OpenAI em [24 a 48 horas](https://help.openai.com/en/articles/20001214-measure-results).

## E se não funcionar? {#what-if-it-doesnt-work}

Se a OpenAI rejeitar a chave, o cPixel marca a conta como **Token inválido**, interrompe os envios pelo servidor e envia um alerta crítico para o endereço de contato da sua loja; o **Início** mostra **Corrigir OpenAI**.

1. [Crie uma nova chave](#how-do-i-create-a-conversions-api-key).
2. Clique em **Corrigir OpenAI** no **Início**, ou em **Gerenciar** ao lado da conta em **Destinos**, e cole a chave sobre **Salvo — cole um novo para substituir**. **Testar conexão** verifica.
3. Clique em **Continuar**, depois em **Salvar e continuar**.

| What you see | What to do |
| --- | --- |
| **Testar conexão**: a plataforma rejeitou este token | A chave foi excluída ou digitada errada: crie uma nova |
| Conversions mostram 0 no Ads Manager | A meta de conversão da campanha precisa corresponder ao evento enviado, order_created para compras ([OpenAI](https://help.openai.com/en/articles/20001214-measure-results)) |
| Compras contadas em dobro | Outra ferramenta envia para este Pixel ID: [um remetente por pixel](/pt-br/docs/cpixel/official-channel-apps/) |
| Uma compra mostra **Ignorado** no Ao vivo | Leia o motivo, depois veja [compras que não aparecem](/pt-br/docs/cpixel/purchases-missing/) |

**Remover** em **Gerenciar OpenAI Ads** interrompe os envios e exclui a chave armazenada. Documentação oficial da OpenAI: [Conversions API](https://developers.openai.com/ads/conversions-api).

## Relacionados {#related}

- [Rastreie conversões do ChatGPT Ads na Shopify](/pt-br/blog/chatgpt-ads-conversion-tracking-shopify/)
- [Acompanhe cada envio no Ao vivo](/pt-br/docs/cpixel/live-events/)
- [Um remetente por pixel](/pt-br/docs/cpixel/official-channel-apps/)
- [O que o cPixel envia, e como o consentimento muda isso](/pt-br/docs/cpixel/event-quality-and-consent/)

[cPixel Facebook Pixel CAPI GA4](/shopify/cpixel/)

[Instalar grátis pela Shopify App Store](https://apps.shopify.com/cpixel?utm_source=b2bgold.app&utm_medium=referral&utm_campaign=docs&utm_content=pt-br/docs/cpixel/connect-openai-ads&utm_term=card) [Planos e preços](/shopify/cpixel/#pricing)

Precisa de ajuda com o cPixel? Envie um e-mail para [support@b2bgold.app](mailto:support@b2bgold.app).