Documentação
Conversions API
Use a Conversions API quando os eventos do navegador não forem suficientes e compartilhe IDs de evento para que a mesma conversão não seja contada duas vezes.
Última atualização: 2026-09-08. Escrito por PixelBridge team.
A Conversions API do OpenAI Ads oferece um método server-side para enviar eventos de conversão suportados aos sistemas de medição publicitária da OpenAI. O PixelBridge foi pensado para enviar esses eventos a partir do WordPress e coordená-los com os eventos do navegador.
Por que a medição no servidor existe
Pixels no navegador podem ser bloqueados por escolhas de consentimento, navegadores, extensões ou regras de Content Security Policy. Um evento de servidor ainda pode registrar uma conversão suportada depois que o WordPress confirmou a ação.
A medição server-side não é um jeito de contornar o consentimento. Se o consentimento de medição for exigido, o evento de servidor deve seguir a mesma permissão.
Pixel versus Conversions API
| Camada | Ponto forte | Limitação |
|---|---|---|
| Pixel no navegador | Visualização de página rápida e contexto do cliente | Pode ser bloqueado no navegador |
| Conversions API | Roda depois que o WordPress confirma uma ação | Precisa de credenciais, IDs de evento e tratamento de erros |
Usar os dois pode ser mais resiliente. Não é obrigatório para todo site.
IDs de evento
Quando a mesma conversão é enviada duas vezes, os dois payloads devem compartilhar um ID de evento. O PixelBridge foi pensado para gerar ou reutilizar esse ID para que a medição do OpenAI Ads possa deduplicar o par.
Implementação no WordPress
Eventos de servidor típicos vêm de:
- 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.
A conexão da Conversions API no plugin faz parte do conjunto de recursos Pro planejado e ainda não está disponível publicamente.
Depuração
Confira o diagnóstico para o status da conexão e depois inspecione os eventos mais recentes. Se um evento do navegador for bem-sucedido e o evento do servidor falhar, mantenha a falha visível em vez de tentar de novo às cegas. Veja Resolução de problemas e o guia da Conversions API.