OpenAI Ads Conversions API: guia de configuração no WordPress

Configure a Conversions API do OpenAI Ads no WordPress: eventos no servidor, comparação com o pixel, IDs de evento, deduplicação, WooCommerce, formulários e depuração.

Última atualização: 8 de setembro de 2026. Escrito por PixelBridge team.

No WordPress, isso costuma significar enviar um evento depois que um formulário, agendamento ou pedido é confirmado, em vez de depender só de um script no navegador. O PixelBridge foi pensado para enviar esses eventos e coordená-los com o pixel no navegador. A conexão da Conversions API faz parte do conjunto de recursos Pro planejado e ainda não está disponível publicamente.

O que é a Conversions API

A Conversions API é um caminho servidor a servidor. O WordPress, ou outro backend, envia um evento de conversão suportado depois que já sabe que a ação teve sucesso. O navegador não precisa ser o único mensageiro.

Não é uma segunda conta de anúncios e não é um substituto da configuração de campanhas. É um método de entrega para eventos de medição. Campos oficiais da requisição, autenticação e tipos de evento suportados estão na documentação para desenvolvedores da OpenAI. Confirme esses detalhes antes de construir um cliente personalizado.

O PixelBridge é independente da OpenAI. Usar a Conversions API pelo plugin não cria uma parceria oficial.

Por que a medição no servidor importa

Pixels no navegador falham em condições comuns:

• O visitante recusa cookies de medição
• Um navegador ou extensão bloqueia o script
• A Content Security Policy bloqueia o domínio do SDK
• O cliente fecha a página de agradecimento antes do pixel rodar
• Um page builder ou plugin de cache reordena scripts

Um evento de servidor ainda pode registrar a conversão depois que o WordPress armazenou o formulário, o agendamento ou o pedido. Essa resiliência é o motivo para adicionar a Conversions API. Não é um motivo para ignorar o pixel. Visualizações de página e contexto da landing page ainda vêm do navegador.

A entrega no servidor não contorna o consentimento. Se a permissão de medição for exigida, mantenha o evento de servidor atrás da mesma permissão. Veja consentimento.

Pixel versus Conversions API

Você pode começar só com o pixel. Adicione a Conversions API quando a entrega pelo navegador não for suficiente, ou quando compras e agendamentos precisarem de um sinal confirmado no backend. Usar os dois é uma escolha de resiliência, não uma tática de ranking.

O guia de instalação do pixel é OpenAI Ads Pixel para WordPress. Docs do produto: Conversions API.

Deduplicação

Quando a mesma conversão é enviada pelo navegador e pelo servidor, a medição precisa de um jeito de tratá-las como uma ação. Esse mecanismo é a deduplicação.

Sem ela, um checkout bem-sucedido pode virar duas compras. Com ela, os dois payloads carregam o mesmo ID de evento e o sistema de medição publicitária pode colapsar o par.

A deduplicação só é relevante quando as duas camadas enviam a mesma conversão. Um lead só no servidor não tem o que mesclar. Uma visualização de página só no navegador não deve inventar um gêmeo no servidor.

IDs de evento

Um ID de evento é a chave compartilhada de uma única ação do cliente.

O padrão previsto no WordPress:

1. No hook de sucesso, crie ou reutilize um ID de evento.
2. Envie o evento do navegador com esse ID, se o pixel puder rodar.
3. Envie o evento do servidor com o mesmo ID, se a Conversions API estiver ativa e o consentimento permitir.
4. Guarde o suficiente do ID em logs ou no diagnóstico para depurar um desencontro depois.

Se o evento do navegador usa um ID e o evento do servidor usa outro, você tem duplicatas. Se você tenta de novo uma chamada de servidor que falhou com um ID novo enquanto o evento original do navegador já teve sucesso, também pode ter duplicatas. Mantenha o ID estável para essa conversão.

O PixelBridge foi pensado para gerar ou reutilizar esse ID para que o par possa ser deduplicado.

Implementação no WordPress

Uma configuração da Conversions API no WordPress é um trabalho de backend:

1. Guarde as credenciais da API nas configurações do plugin ou na configuração do ambiente, não em um arquivo JavaScript público.
2. Escute hooks confirmados do WordPress, não cliques em botão.
3. Monte um payload que corresponda à especificação oficial atual do evento.
4. Inclua o ID de evento usado pelo evento do navegador.
5. Respeite o consentimento antes que a requisição saia do servidor.
6. Registre sucesso e falha em vez de tentar de novo às cegas.

Fontes típicas:

• Um hook de envio de formulário confirmado
• Um hook de confirmação de agendamento
• Um status de pedido WooCommerce que significa que a compra é real

Não envie eventos de servidor a partir de wp_footer em cada página. Isso recria as piores partes de um pixel sem o valor da visualização de página.

A documentação do WordPress cobre hooks e arquitetura de plugins. Ela não define os campos de evento da OpenAI.

WooCommerce

O WooCommerce é uma fonte natural da Conversions API porque o pedido existe no servidor mesmo se o cliente nunca vir o pixel da página de agradecimento.

Quando o rastreamento de compras for lançado, o evento deve:

• Disparar no status de pedido que você trata como conversão
• Incluir um identificador de pedido
• Incluir um valor de conversão quando permitido
• Compartilhar um ID de evento com qualquer evento purchase do navegador

A integração WooCommerce está em breve. Não foi lançada. Não espere que os pedidos enviem eventos do OpenAI Ads até esse conector existir ou você construir um hook personalizado.

Envios de formulário

Formulários são a outra fonte comum no servidor. Um hook de sucesso em PHP pode enviar lead_created depois que a mensagem é armazenada, o que é mais confiável do que um listener JavaScript no botão de envio.

Conectores de formulário planejados (Elementor Forms, Contact Form 7, WPForms, Gravity Forms, Fluent Forms) estão em breve. Até lá, uma implementação personalizada deve disparar uma vez por envio bem-sucedido e pular falhas de validação.

Se o formulário também dispara um evento no navegador, use o mesmo ID de evento nos dois.

Depuração

Depure navegador e servidor como um par.

1. Confirme que o caminho do pixel ainda funciona. Um pixel quebrado mais uma API quebrada parece "a CAPI está fora" quando o problema real é consentimento ou um Pixel ID diferente.
2. Dispare uma conversão.
3. Confira se um evento do navegador foi enviado.
4. Confira se um evento do servidor foi enviado.
5. Compare os IDs de evento.
6. Inspecione a resposta do servidor. Mantenha as falhas visíveis.

O diagnóstico do PixelBridge foi pensado para mostrar o status da conexão da Conversions API e o status de envio dos eventos recentes. Um alerta planejado é "o evento do navegador foi enviado, mas o evento do servidor falhou". Essa checagem está planejada, não reivindicada como já disponível. Veja diagnóstico e resolução de problemas.

Erros comuns

Nomes de eventos e campos obrigatórios podem mudar. Quando um payload for rejeitado, confira a documentação oficial da OpenAI antes de mudar hooks do WordPress.

Configuração no PixelBridge

O PixelBridge foi pensado para enviar eventos da Conversions API a partir do WordPress e coordená-los com os eventos do navegador. Essa configuração está planejada, não lançada.

Configuração prevista, quando o Pro estiver disponível:

1. Informe o Pixel ID e complete a medição no navegador primeiro.
2. Adicione as credenciais da Conversions API nas configurações do plugin.
3. Ative apenas as conversões em que você já confia no navegador, ou que existem só no servidor.
4. Confirme no diagnóstico uma conexão e um único envio por ação de teste.

Até o lançamento, entre no acesso antecipado pela página inicial. Leia recursos e preços para a divisão prevista Free, Pro e Agency. O Pro é o destino previsto da Conversions API, da deduplicação, do WooCommerce e das integrações de agendamento.

Para o modelo mais amplo de medição, continue com Rastreamento de conversões do OpenAI Ads.