Como rastrear conversões do ChatGPT Ads na Shopify

Como você rastreia as conversões do ChatGPT Ads na Shopify?

Na Shopify, o caminho mais simples é o app gratuito ChatGPT Ads da OpenAI, por enquanto disponível só para lojas dos Estados Unidos, que conecta o pixel da OpenAI para você. Caso contrário, use um pixel personalizado, um app de rastreamento ou a Conversions API da OpenAI. Envie checkouts e compras a partir do checkout da Shopify ou de um servidor, nunca do código do tema, que não roda ali, e dê a cada pixel um único remetente.

O ChatGPT Ads, suas ferramentas de medição e o app da OpenAI para Shopify mudaram muito em questão de meses, então cada informação da OpenAI abaixo traz um link para sua fonte, verificado em 24 de setembro de 2026.

O que a OpenAI precisa da sua loja?

Um Pixel ID para o navegador, uma chave da Conversions API para o seu servidor, e eventos com os próprios nomes da OpenAI, com os valores como números inteiros na menor unidade da moeda. Os eventos padrão da Shopify correspondem assim:

• Pixel ID e chave. Os dois vêm de Tools → Conversions, no Ads Manager da OpenAI. A chave fica no seu servidor: a OpenAI diz para nunca chamar a Conversions API a partir de código de página (Measurement Pixel).
• Valores. Números inteiros na unidade menor padrão da moeda: 2599 para USD 25.99, 8900 para JPY 8,900. Os eventos da Shopify trazem decimais, então converta-os (supported events).
• Referências de clique e navegador. Um clique num anúncio do ChatGPT adiciona oppref ao endereço da sua página de destino. O pixel da OpenAI o guarda num cookie __oppref por 30 dias, renovado a cada novo clique, ao lado de uma referência de navegador, __obref, mantida por um ano (Measurement Pixel). A Conversions API não captura nenhuma das duas por você.
• Tempo. Um evento de servidor precisa ter uma data dos últimos 7 dias e no máximo 10 minutos à frente (Conversions API). A verificação de qualidade de eventos da OpenAI procura eventos de servidor enviados até uma hora depois da ação (event-quality check).
• Um ID por conversão. A OpenAI mantém o primeiro evento que recebe para cada Pixel ID, nome de evento e ID de evento, e ignora as cópias seguintes (Conversions API). Duas ferramentas que dão IDs diferentes a uma mesma compra fazem com que ela seja contada duas vezes.

Qual configuração você deve usar?

Escolha o app da OpenAI se sua loja é nos Estados Unidos e você quer campanhas e rastreamento num só lugar, ou um pixel personalizado se você programa em JavaScript e os eventos de navegador bastam. Escolha seu próprio servidor ou um app de rastreamento quando quiser que as compras sejam enviadas a partir do próprio pedido.

Seja qual for sua escolha, dê a cada Pixel ID um único remetente. Rodar o app da OpenAI e uma segunda ferramenta no mesmo pixel cria duas cópias de cada compra sob IDs diferentes.

Como você usa o app ChatGPT Ads da OpenAI?

Instale-o pela Shopify App Store, conecte sua conta do Ads Manager e selecione ou crie o pixel que ele chama de OpenAI Pixel for Shopify. A OpenAI criou o app e o lançou em 3 de setembro de 2026, grátis para instalar (App Store listing); por enquanto ele atende lojas dos Estados Unidos, com mais países a caminho (guia da OpenAI para a Shopify, verificado em 24 de setembro de 2026).

1. Na Shopify, instale ou abra o app ChatGPT Ads.
2. Selecione Connect Account e escolha sua conta do Ads Manager, ou crie uma com seu site, setor, país, moeda e fuso horário.
3. Selecione ou crie OpenAI Pixel for Shopify, e conecte-o para que os eventos de comércio elegíveis cheguem ao Ads Manager.
4. Espere seus produtos sincronizarem no seu feed de produtos do ChatGPT Ads. O tempo depende do tamanho do seu catálogo.
5. Crie uma campanha no app com Create Campaign, ou no Ads Manager, que tem mais opções.

O anúncio do app diz que ele pode editar os pixels web e de servidor da sua loja, mas o guia da OpenAI não diz se as compras também passam pela Conversions API. Se os produtos não aparecerem, a lista de verificação da OpenAI começa pela conta conectada, a sincronização do feed e a conexão do pixel, e pede para você usar Chrome ou Safari.

Como você adiciona o pixel da OpenAI como um pixel personalizado da Shopify?

Cole o código da OpenAI sem as tags <script> num pixel personalizado, depois assine os eventos da Shopify e envie cada um com o nome que a OpenAI usa. Um pixel personalizado não recebe nada até você assinar os eventos.

Não cole o trecho no theme.liquid. O layout do seu tema só se aplica a páginas fora do checkout (theme layouts) e incorporações de apps não podem carregar em páginas de checkout (app embeds), então o código do tema perde todo checkout e toda compra.

As assinaturas são onde configurações caseiras falham. Num tópico da comunidade Shopify de setembro de 2026, o trecho de um comerciante, colado com suas tags <script>, gerou um erro de código; sem elas, mostrava 0 eventos no Pixel Helper da Shopify. As respostas tiveram que corrigir o comando (measure, não track), os nomes dos eventos e os valores (tópico).

1. No seu admin da Shopify, vá em Settings → Customer events, dê um nome ao pixel e clique em Add pixel (managing custom pixels).
2. Em Customer privacy, deixe Permission em Required. Pixels novos exigem permissões de Marketing e Analytics por padrão (pixels overview).
3. Cole o código abaixo em Code com o seu Pixel ID, clique em Save, depois em Connect pixel.

// O loader e o init da OpenAI, do seu guia Measurement Pixel, sem as tags <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: "<YOUR-PIXEL-ID>",
  debug: true, // registra no console do navegador enquanto você testa; remova depois
});

// A Shopify envia preços decimais; a OpenAI quer inteiros na unidade menor da moeda
function minorUnits(money) {
  var digits = new Intl.NumberFormat("en", {
    style: "currency",
    currency: money.currencyCode,
  }).resolvedOptions().maximumFractionDigits;
  return Math.round(money.amount * Math.pow(10, digits));
}

function lineContents(lineItems) {
  return lineItems.map(function (item) {
    return {
      id: item.variant?.id,
      name: item.title,
      content_type: "product",
      quantity: item.quantity,
    };
  });
}

analytics.subscribe("page_viewed", function () {
  oaiq("measure", "page_viewed", { type: "contents" });
});

analytics.subscribe("product_viewed", function (event) {
  var variant = event.data.productVariant;
  oaiq("measure", "contents_viewed", {
    type: "contents",
    contents: [{ id: variant.id, name: variant.product.title, content_type: "product" }],
  });
});

analytics.subscribe("product_added_to_cart", function (event) {
  var line = event.data.cartLine;
  oaiq("measure", "items_added", {
    type: "contents",
    amount: minorUnits(line.cost.totalAmount),
    currency: line.cost.totalAmount.currencyCode,
    contents: [
      {
        id: line.merchandise.id,
        name: line.merchandise.product.title,
        content_type: "product",
        quantity: line.quantity,
      },
    ],
  });
});

analytics.subscribe("checkout_started", function (event) {
  var checkout = event.data.checkout;
  oaiq(
    "measure",
    "checkout_started",
    {
      type: "contents",
      amount: minorUnits(checkout.totalPrice),
      currency: checkout.totalPrice.currencyCode,
      contents: lineContents(checkout.lineItems),
    },
    { event_id: checkout.token } // a Shopify pode disparar isso de novo se o comprador reentrar no checkout
  );
});

analytics.subscribe("checkout_completed", function (event) {
  var checkout = event.data.checkout;
  oaiq(
    "measure",
    "order_created",
    {
      type: "contents",
      amount: minorUnits(checkout.totalPrice),
      currency: checkout.totalPrice.currencyCode,
      contents: lineContents(checkout.lineItems),
    },
    { event_id: checkout.order?.id } // uma cópia do servidor desta compra deve usar o mesmo valor que seu id
  );
});

O loader e a chamada init são o próprio trecho da OpenAI, e os campos dos eventos vêm da Web Pixels API da Shopify (Web Pixels API).

Importante: Um pixel personalizado roda num frame separado que não consegue ler sua página, e o endereço que ele vê é o do sandbox, não o do comprador (guia de pixels web da Shopify). O pixel da OpenAI normalmente lê o oppref do endereço da página de destino e, com a correspondência avançada automática ativada, os dados do comprador vindos de formulários; dentro do sandbox, pode não conseguir nenhum dos dois. Confira com debug: true, e envie as compras pela Conversions API com o oppref incluído se os cliques do ChatGPT importarem para você.

Para ver o padrão completo com qualquer fornecedor, leia como adicionar um pixel personalizado na Shopify.

Como você envia compras pela Conversions API?

A partir de um servidor, nunca do navegador: quando a Shopify avisa seu servidor sobre um pedido novo, envie um evento order_created à OpenAI com sua chave da Conversions API, o mesmo ID que o pixel usou e, se o comprador veio de um anúncio, o oppref. A solicitação abaixo segue o próprio exemplo da OpenAI (Conversions API).

curl -X POST "https://bzr.openai.com/v1/events?pid=<PIXEL-ID>" \
  -H "Authorization: Bearer <API-KEY>" \
  -H "Content-Type: application/json" \
  --data '{
    "validate_only": false,
    "events": [
      {
        "id": "<THE-VALUE-THE-PIXEL-SENT-AS-EVENT_ID>",
        "type": "order_created",
        "timestamp_ms": <ORDER-TIME-IN-MILLISECONDS>,
        "oppref": "<OPPREF-CAPTURED-ON-THE-STOREFRONT>",
        "source_url": "https://shop.example.com/checkout/confirmation",
        "action_source": "web",
        "user": {
          "obref": "<__obref-COOKIE-VALUE-CAPTURED-ON-THE-STOREFRONT>",
          "emails_sha256": ["<SHA-256-OF-THE-TRIMMED-LOWER-CASE-EMAIL>"],
          "ip_address": "203.0.113.1",
          "user_agent": "Mozilla/5.0"
        },
        "data": { "type": "contents", "amount": 2599, "currency": "USD" }
      }
    ]
  }'

• O pedido. Um app ou backend inscrito no webhook orders/create da Shopify (webhook) recebe cada pedido novo, tenha a página de agradecimento carregado ou não.
• O ID. Use exatamente a string que o pixel enviou como event_id, para que a OpenAI mantenha uma única cópia.
• oppref e obref. Capture-os na loja, a partir do endereço da página de destino e dos cookies da OpenAI, e leve-os até o pedido. Sem eles, a OpenAI depende de dados do comprador com hash e da sua própria modelagem.
• Testes. "validate_only": true confere uma solicitação sem salvá-la. Um lote aceita até 1.000 eventos, e um único evento inválido derruba o lote inteiro.

Mantenha a chave no servidor. Ela nunca deve estar num pixel personalizado, onde qualquer visitante poderia lê-la.

Como você configura isso com um app?

Instale um app de rastreamento que envie checkouts e compras do ChatGPT Ads a partir dos seus servidores, cole seu Pixel ID e sua chave da Conversions API, e confira os primeiros envios antes de confiar nos números.

O cPixel, que nós desenvolvemos, funciona assim. Ele envia checkout_started e order_created à OpenAI a partir dos seus servidores, reconstruindo cada compra a partir do pedido da Shopify, e envia page_viewed, contents_viewed e items_added a partir da sua loja pelo seu app embed, Rastreamento cPixel. Um evento da loja é enviado pelos servidores do cPixel em vez disso só quando ele nunca sai do navegador do comprador, por exemplo porque a tag da OpenAI foi bloqueada, então cada evento tem um único remetente. Os envios do servidor levam e-mail, telefone, e IDs de cliente e de dispositivo com hash, oppref e obref, e o endereço IP e o user agent do comprador. A OpenAI não recebe dele nenhum evento de dados de pagamento.

No cPixel, abra Destinos, clique em Conectar o OpenAI Ads, cole o ID do pixel e a Chave da Conversions API, depois rode Testar conexão. Para a OpenAI, o teste confirma que suas credenciais chegam à conta em vez de enviar um evento de teste, então inicie uma sessão em Ao vivo, faça um pedido real (o cPixel ignora pedidos de teste por padrão) e observe a resposta da OpenAI à compra. O passo a passo completo: conecte o OpenAI Ads ao cPixel.

Se o próprio app da OpenAI já enviar para esse Pixel ID, deixe o pixel com apenas um dos dois: um remetente por pixel. Mais sobre o cPixel, que envia compras da Shopify para sete plataformas de anúncios.

Como você confere se a OpenAI recebeu suas conversões?

Observe os eventos chegando no Ads Manager enquanto você testa, depois espere de 24 a 48 horas para que as conversões atribuídas cheguem aos seus relatórios.

• No navegador. Com debug: true, o SDK da OpenAI registra sua atividade no console; para um pixel personalizado, escolha o frame do pixel no console, como descreve o guia de testes da Shopify. O Pixel Helper da Shopify mostra se suas assinaturas disparam. Para ver as requisições da OpenAI ao lado dos seus outros pixels, verifique todos os pixels da página.
• No Ads Manager. Tools → Conversions → Event Stream lista os últimos eventos que sua fonte de dados recebeu. O endpoint de eventos recentes da OpenAI retorna uma amostra de aproximadamente os últimos 15 minutos e marca os eventos de navegador como pixel_sdk e os de servidor como server_to_server (conversion tracking).
• Nos relatórios. Um evento pode ser aceito e ainda assim contar 0 se não corresponder ao evento de conversão definido na campanha, e corrigir a configuração não recontabiliza o tráfego anterior (Measure Results).
• Qualidade dos eventos. O Ads Manager pontua cada fonte de dados diariamente ao longo de sete dias e lista avisos como falta de informação de clique ou eventos de servidor atrasados. A OpenAI diz que a pontuação não prevê os resultados da campanha (event quality).

Por que as conversões do ChatGPT Ads não batem com o GA4 ou a Shopify?

Porque eles contam coisas diferentes: o Ads Manager credita compras a cliques em anúncios do ChatGPT, e opcionalmente a visualizações, dentro das suas janelas de atribuição, e as data pela interação com o anúncio, enquanto a Shopify conta cada pedido no dia em que foi feito.

• Janelas. O Ads Manager credita conversões em até 7, 14 ou 30 dias após um clique, mais uma janela opcional de um dia por visualização, usando atribuição de último toque (Measure Results).
• Datas. Por padrão, uma conversão fica no dia do clique ou da impressão. Adicione a coluna Conversions (by conv. time) para alinhá-la com a Shopify.
• Modelagem. Os totais podem incluir conversões modeladas onde a OpenAI as oferece (conversion measurement).
• Reembolsos. A lista de eventos da OpenAI não tem um evento de reembolso ou cancelamento, então um pedido cancelado permanece na receita do Ads Manager.
• Sinais. Consentimento recusado, scripts bloqueados e cookies apagados removem a referência do clique e outros dados de correspondência.
• GA4. O GA4 conta sessões, que dependem da página carregar, do consentimento, de bloqueios e do tratamento de UTMs, então nunca serão iguais aos cliques em anúncios. O Ads Manager pode acrescentar parâmetros de consulta à página de destino com macros como {campaign_id}: adicione UTMs se quiser que o GA4 nomeie a campanha.

A própria OpenAI opina que “uma diferença não indica necessariamente um erro” (conversion measurement).

E o consentimento na Europa?

Deixe as configurações de consentimento da Shopify controlarem o pixel da OpenAI, e não envie nenhum evento de servidor para um comprador que recusou. O ChatGPT Ads chegou a 31 mercados europeus em agosto de 2026, com autoatendimento a partir de 31 de agosto (OpenAI), e a OpenAI pede aos anunciantes que obtenham consentimento onde a lei exigir (conversion measurement).

• Num pixel personalizado, a Shopify roda seu código só quando o comprador deu as permissões que ele exige, nos mercados onde sua loja pede consentimento, geralmente o EEE e o Reino Unido (pixels overview). Um banner de cookies de terceiros precisa passar as escolhas para a Customer Privacy API da Shopify, ou o pixel não vai disparar mesmo depois do consentimento.

• Fora de Customer events, por exemplo no código do tema, o pixel da OpenAI tem seu próprio interruptor. Eventos bloqueados enquanto o consentimento é false não são reproduzidos depois:

  oaiq("consent", false);
  oaiq("init", {
    pixelId: "<YOUR-PIXEL-ID>",
  });
  
  // Chame isso depois que o usuário conceder o consentimento de medição.
  oaiq("consent", true);

• No servidor, siga a mesma escolha: a OpenAI diz para parar de enviar a referência de navegador obref assim que um comprador revogar o consentimento (Conversions API).

Este guia não é aconselhamento jurídico. Consulte um advogado sobre o que seus mercados exigem.

Perguntas frequentes

Existe um canal de vendas da Shopify para o ChatGPT Ads?

O próprio app ChatGPT Ads da OpenAI, lançado em 3 de setembro de 2026, é o que mais se aproxima disso: ele sincroniza seu catálogo com o Ads Manager, roda campanhas a partir da Shopify e conecta o pixel da OpenAI. Comerciantes vinham pedindo um canal na comunidade Shopify desde julho de 2026 (tópico). Por enquanto o app atende lojas dos Estados Unidos; a OpenAI diz que vai seguir o ChatGPT Ads para seus outros mercados.

Eu preciso do pixel e da Conversions API ao mesmo tempo?

Não, mas a OpenAI recomenda os dois, com o mesmo ID de evento para a mesma conversão. Ela considera a Conversions API mais confiável que o pixel sozinho, e quando os dois enviam uma compra com um mesmo ID de evento, ela mantém uma única cópia. Uma configuração só de servidor ainda precisa de um Pixel ID para nomear a fonte de dados. As vantagens e desvantagens mais amplas estão em rastreamento pelo servidor na Shopify.

Em quais países o ChatGPT Ads pode rodar?

Em mais de 60 países desde 23 de setembro de 2026. O Ads Manager de autoatendimento depende de onde fica o negócio que paga, e a página de disponibilidade da OpenAI lista os países. Os marcos até agora:

• 9 de fevereiro de 2026: anúncios testados nos Estados Unidos (OpenAI).
• 5 de maio de 2026: um Ads Manager de autoatendimento em beta, com medição por pixel e Conversions API recém-lançada (OpenAI).
• 11 de agosto de 2026: lançamento no Reino Unido, México, Brasil, Japão e Coreia do Sul (OpenAI).
• 31 de agosto de 2026: autoatendimento em 31 mercados europeus, lançado na semana anterior (OpenAI).
• 23 de setembro de 2026: Indonésia, Malásia, Filipinas, Singapura, Tailândia, Vietnã e Taiwan (OpenAI).