Como integrar o OpenAI ADS

🛍️ Seus produtos nos anúncios do ChatGPT
O feed envia o catálogo da sua loja para o OpenAI Ads, com nome, preço e disponibilidade.

🔄 Catálogo sempre atualizado
O OpenAI Ads busca os produtos direto no endereço do feed gerado pela Irroba, sem planilha e sem envio manual.

📊 Resultados medidos
Com o Pixel e a API de Conversões ativos, as visitas e vendas que vieram dos anúncios são registradas na sua conta de anunciante.

Antes de começar

Uma conta de anunciante no OpenAI Ads.
A permissão do feed OpenAI Ads habilitada no seu usuário da Irroba. Se você não tiver essa permissão, entre em contato com o suporte.
Os produtos com a opção do OpenAI Ads habilitada na aba SEO do cadastro do produto.

1. Instale e ative o feed na Irroba

No painel da Irroba, acesse Configurações > Feeds.
Localize OpenAI Ads na lista e clique em Instalar.

Depois de instalar, clique no ícone de lápis (Editar) na linha do OpenAI Ads.

Habilite a opção Status e clique em Salvar.
Volte ao feed do OpenAI Ads e clique em Atualizar Feed, para que ele carregue as informações e os produtos da sua loja.

✅ Resultado esperado: o feed do OpenAI Ads fica com o Status habilitado e o campo URL do feed aparece preenchido no fim da tela.

2. Ajuste as opções do feed

Esta etapa é opcional. As opções abaixo definem quais produtos e quais informações são enviados para os anúncios.

Substituir ID pelo código do produto: envia o código (SKU) no lugar do ID do produto.
Utilizar preço à vista: envia o preço à vista do produto como preço promocional.
Remover preço promocional: não envia o preço promocional no anúncio.
Exibir promoções exclusivas por método de pagamento: se o produto tiver promoção exclusiva para uma forma de pagamento, essa informação é enviada para o anúncio.
Enviar produtos sob encomenda: inclui no feed os produtos que só podem ser comprados sob encomenda.
Enviar variações do produto: envia as variações da grade de estoque, como cores e numerações.
Enviar preço da caixa: envia para o anúncio o preço da caixa com desconto.
Exibir produtos com estoque zerado: inclui no feed também os produtos sem estoque.

Mais abaixo, na mesma tela, ficam os campos de configuração.

Estoque mínimo do produto: quantidade mínima em estoque para o produto ser enviado ao anúncio.
Descrição exibida no feed: escolha qual descrição usar, caso o produto tenha mais de uma cadastrada.
Categoria padrão dos produtos: categoria usada para os produtos que não têm categoria cadastrada. Utilize a taxonomia de categorias do Google.
Prefixo para o ID do produto: texto colocado antes do ID para identificar os produtos deste feed. Exemplo: openai-
Quantidade máxima de produtos: limite de produtos enviados no feed.
URL do feed: endereço que o OpenAI Ads usa para buscar os produtos. Você vai precisar dele na próxima etapa.

Depois de ajustar o que precisar, clique em Salvar.
Copie o endereço do campo URL do feed.

✅ Resultado esperado: as configurações ficam salvas e você tem a URL do feed copiada.

3. Conecte o feed no OpenAI Ads

No Ads Manager do OpenAI Ads, acesse Ferramentas > Feeds.
Clique em Criar feed.

Em Nome de exibição, digite um nome para identificar o feed. Exemplo: o nome da sua loja.
Em Como você enviará os produtos?, selecione URL hospedada.
Clique em Criar.

No painel de configuração que se abre, cole a URL do feed copiada na Irroba e confirme.

✅ Resultado esperado: o feed aparece na lista com o status Carregado e a quantidade de produtos na coluna Produtos. Ele já pode ser usado para criar campanhas.

Para conferir os produtos ou corrigir o endereço, clique nos três pontos no fim da linha do feed e escolha Ver produtos ou Editar URL hospedada.

4. Crie o Pixel no OpenAI Ads

No Ads Manager, clique em Conversões.
Clique em Criar e selecione Fonte de dados.

Em Nome da fonte de dados, digite um nome para o Pixel. Exemplo: Pixel-Irroba.
Clique em Criar.

Na janela Configure sua fonte de dados, clique no ícone de copiar ao lado do ID do Pixel e guarde esse número.

⚠️ Atenção: copie apenas o ID do Pixel. Você não precisa instalar o Código de configuração na loja, porque o aplicativo da Irroba faz essa instalação.

✅ Resultado esperado: a fonte de dados aparece na aba Fonte de dados da tela Conversões, e você tem o ID do Pixel copiado.

5. Crie a chave da API de Conversões

Ainda na tela Conversões, clique no ícone de chave, ao lado do botão Criar.

Na janela Chaves de conversão, clique em Criar nova chave.

Em Nome, digite um nome para a chave. Exemplo: chave-api-irroba.
Clique em Criar.

Na janela Salve sua chave, clique em Copiar. Clique também em Baixar para guardar uma cópia de segurança.

⚠️ Atenção: a chave dá acesso total de leitura e gravação aos eventos de conversão. Guarde em local seguro e não compartilhe.

✅ Resultado esperado: você tem o ID do Pixel e a chave da API em mãos para informar na Irroba.

6. Ative o Pixel e a API de Conversões na Irroba

No painel da Irroba, clique em Aplicativos.
No campo de busca, digite OpenAI Ads.
Clique no aplicativo OpenAI Ads, na categoria Marketing.

Habilite Ativar Pixel de Mensuração e cole o ID no campo Pixel ID.
Habilite Ativar API de Conversões e cole a chave no campo Chave da API de Conversões.
Clique em Validar conexão e aguarde a mensagem de confirmação.
Clique em Salvar.

✅ Resultado esperado: a mensagem Conexão validada com sucesso é exibida abaixo do botão Validar conexão. Depois de salvar, a integração da sua loja com o OpenAI Ads está concluída.

Erros comuns

O OpenAI Ads não aparece na lista de feeds

Causa provável: o seu usuário da Irroba não tem a permissão desse feed.

Como resolver: entre em contato com o suporte e peça a liberação da permissão do feed OpenAI Ads.

Um produto não aparece no feed

Causa provável: o produto está sem a opção do OpenAI Ads na aba SEO, está sem estoque ou está abaixo do Estoque mínimo do produto definido no feed.

Como resolver: habilite a opção na aba SEO do produto e confira as opções Exibir produtos com estoque zerado, Estoque mínimo do produto e Quantidade máxima de produtos. Depois, clique em Atualizar Feed.

A URL do feed foi informada errada no OpenAI Ads

Causa provável: o endereço foi colado incompleto ou copiado de outro feed.

Como resolver: em Ferramentas > Feeds, clique nos três pontos na linha do feed, escolha Editar URL hospedada e cole novamente a URL do feed da Irroba.

Perguntas frequentes

Onde encontro a URL do feed?

Em Configurações > Feeds, clique no lápis do OpenAI Ads. O campo URL do feed é o último da tela.

Posso limitar quais produtos vão para os anúncios?

Sim. Só entram no feed os produtos com a opção do OpenAI Ads habilitada na aba SEO. Você também pode usar os campos Estoque mínimo do produto e Quantidade máxima de produtos.

Por que o Pixel e a API de Conversões usam o mesmo Pixel ID?

Para eliminar eventos duplicados. Com o mesmo ID, o OpenAI Ads reconhece quando o Pixel e a API registraram a mesma ação e conta apenas uma vez.

Com a integração pronta, os anúncios já começam a rodar?

Não. Os anúncios só são veiculados depois que você configurar o faturamento e enviar o logotipo da conta no Ads Manager, pela opção Concluir configuração, e criar uma campanha.