← Blog

Guia25 jul 20266 min de leitura

Como instalar o pixel do OpenAI Ads na Shopify (passo a passo)

Rastrear o OpenAI Ads na Shopify usa o pixel de navegador, a Conversions API ou os dois. Como instalar de forma manual ou com um app, e como confirmar que funciona.

Em resumo

  • Rastrear o OpenAI Ads na Shopify usa duas peças: o pixel de navegador e a Conversions API (do lado do servidor). A OpenAI aceita as duas juntas ou só a Conversions API, que precisa de um Pixel ID, mas não do pixel de navegador.
  • Você pode instalá-las de forma manual (um pixel personalizado mais uma integração de servidor que você constrói e mantém) ou usar um app que cuida disso por você.
  • A Reach captura os eventos pelo app embed da Shopify e os envia só do lado do servidor, em uns 30 segundos, sem código e sem editar o tema. Ela não carrega o pixel de navegador da OpenAI.
  • De qualquer forma, termine confirmando que seus eventos estão realmente sendo entregues.

Instalar o pixel do OpenAI Ads na Shopify envolve duas peças: o pixel de navegador que dispara na sua loja e a Conversions API que envia os eventos do lado do servidor para que menos conversões se percam. Você pode usar as duas ou só a do servidor, e pode fazer isso na mão ou deixar um app cuidar disso. Aqui está exatamente o que você precisa, onde ficam seus IDs e as duas formas de instalar.

O que você precisa antes de começar

  • Uma conta do OpenAI Ads com o seu pixel (a fonte de dados de conversões) já criado.
  • Seu Pixel ID do OpenAI Ads.
  • Sua chave da Conversions API, para a parte do lado do servidor.
  • Acesso de administrador à sua loja Shopify.

Onde encontrar seu Pixel ID e sua chave da Conversions API

Os dois ficam no seu Ads Manager da OpenAI, em Tools e depois Conversions: abra o seu pixel para copiar o Pixel ID e crie a chave da Conversions API em Conversion keys (o ícone de chave). Trate essa chave como uma senha: é o que autoriza os eventos do lado do servidor, então mantenha-a privada. Você vai colar os dois onde instalar o pixel.

Opção 1: instalar manualmente (a forma difícil)

Fazer na mão são, na verdade, dois trabalhos:

  1. O pixel. Adicione um pixel personalizado à sua loja (na Shopify, em Configurações e depois Eventos de cliente, ou pelo seu tema) e configure-o para disparar os eventos padrão: visualização de página, visualização de produto, adicionar ao carrinho, checkout e compra.
  2. A Conversions API. Construa uma integração do lado do servidor que receba seus eventos da Shopify, aplique hash aos dados do cliente, os envie à Conversions API da OpenAI com um ID de evento compartilhado para que sejam deduplicados contra o pixel, e cuide de novas tentativas e mudanças de versão da API.

A parte 1 é gerenciável. A parte 2 é trabalho de engenharia de verdade, e precisa de manutenção contínua toda vez que um evento ou a API muda. Para a maioria das lojas sem um desenvolvedor à mão, é aqui que o projeto empaca, e um pixel sem backup do lado do servidor é justamente a configuração que subconta suas conversões. (Mais sobre o porquê em como rastrear as conversões do OpenAI Ads na Shopify.)

Opção 2: instalar com a Reach (a forma de 30 segundos)

  1. Instale a Reach pela Shopify App Store.
  2. Cole seu Pixel ID do OpenAI Ads e sua chave da Conversions API no app.
  3. A Reach captura os eventos da loja pelo app embed da Shopify (sem editar o tema) e começa a encaminhar cada evento do lado do servidor pela Conversions API. Ela não carrega o pixel de navegador da OpenAI, então há um único remetente, e cada evento mantém o mesmo ID nas novas tentativas, para nunca ser contado duas vezes.
  4. Confirme que seus eventos estão fluindo no app.

Essa é toda a configuração. Sem código, sem editar o tema, e a parte do lado do servidor que empaca a maioria das instalações manuais fica feita e mantida para você.

A OpenAI também tem um app próprio e gratuito para a Shopify, o ChatGPT Ads, que envia os eventos pelo OpenAI Pixel for Shopify; por enquanto ele está disponível para lojas nos EUA. Escolha um único remetente por Pixel ID: rodar a Reach e o app da OpenAI no mesmo Pixel ID hoje conta as compras em dobro.

Como confirmar que o pixel realmente funciona

Não presuma que deu certo. Verifique:

  • Faça um pedido de teste ou dispare um evento de teste.
  • Confirme que o evento aparece na Reach em poucos minutos. Nos relatórios de conversão do OpenAI Ads, conte de 24 a 48 horas.
  • Verifique que a qualidade de correspondência e entrega parece saudável, com poucos eventos rejeitados.
  • Confirme que os eventos de compra especificamente disparam, já que são com eles que suas campanhas otimizam.
  • Crie um evento de conversão no Ads Manager e selecione-o na campanha. Os relatórios dessa meta só contam a partir daí e não são retroativos.

Manual vs Reach, lado a lado

ManualReach
Tempo de configuraçãoDe horas a diasUns 30 segundos
Requer códigoSimNão
Requer um desenvolvedorSim (para a parte da API)Não
Lado do servidor (Conversions API)Você constróiIncluído
Deduplicação de eventosVocê implementaNão é necessária (um único remetente)
Edição do temaMuitas vezesNenhuma
Manutenção contínuaPor sua contaResolvida

Instale o pixel do OpenAI Ads pela via fácil. Pegue a Reach na Shopify App Store e tenha o rastreamento do lado do servidor rodando em uns 30 segundos, sem código.

Perguntas frequentes

O OpenAI Ads tem um pixel para a Shopify?
Sim. O OpenAI Ads tem um pixel para os eventos de navegador e uma Conversions API para os eventos do lado do servidor. A OpenAI aceita os dois juntos ou só a Conversions API, que usa o mesmo Pixel ID. O importante é ter o envio do lado do servidor.
Onde encontro meu Pixel ID do OpenAI Ads?
No seu Ads Manager da OpenAI, em Tools e depois Conversions: abra o seu pixel para copiar o Pixel ID. A chave da Conversions API é criada na mesma área, em Conversion keys.
Preciso editar meu tema da Shopify para instalar o pixel?
Com um app, não. A Reach usa o sistema de app embed da Shopify, então nada do seu tema muda. Uma instalação totalmente manual às vezes exige editar o tema.
Dá para instalar o pixel do OpenAI Ads sem um desenvolvedor?
Sim, com um app como a Reach. Instalar totalmente na mão, sobretudo a parte da Conversions API, geralmente precisa de um desenvolvedor.
O pixel basta sozinho ou preciso também da Conversions API?
Você quer a Conversions API. Um pixel de navegador sozinho perde conversões por bloqueadores, proteção de rastreamento e compras entre dispositivos. A Conversions API preenche essas lacunas, sozinha ou junto com o pixel, desde que o mesmo evento leve o mesmo ID nos dois.
Como sei que o pixel está funcionando?
Dispare um evento de teste e confirme que ele chega com boa qualidade de entrega (na Reach, você vê isso em poucos minutos). Nos relatórios de conversão do OpenAI Ads, conte de 24 a 48 horas.

Veja o que seus ChatGPT Ads realmente vendem.

Comece no plano gratuito. Configure em 30 segundos.