OpenAI Ads Conversions API: guía de configuración en WordPress
Configura la OpenAI Ads Conversions API en WordPress: eventos server-side, comparación con el pixel, event IDs, deduplicación, WooCommerce, formularios y depuración.
Última actualización: 8 de septiembre de 2026. Escrito por PixelBridge team.
La OpenAI Ads Conversions API ofrece un método server-side para enviar eventos de conversión compatibles a los sistemas de medición publicitaria de OpenAI.
En WordPress, eso suele significar enviar un evento después de que se confirme un formulario, una reserva o un pedido, en lugar de depender solo de un script en el navegador. PixelBridge está diseñado para enviar esos eventos y coordinarlos con el pixel del navegador. La conexión de Conversions API forma parte del conjunto previsto de funciones Pro y aún no está disponible públicamente.
Qué es la Conversions API
La Conversions API es un camino de servidor a servidor. WordPress, u otro backend, envía un evento de conversión compatible después de saber ya que la acción acertó. El navegador no tiene que ser el único mensajero.
No es una segunda cuenta publicitaria, y no sustituye la configuración de campañas. Es un método de entrega de eventos de medición. Los campos oficiales de la petición, la autenticación y los tipos de evento compatibles están en la documentación para desarrolladores de OpenAI. Confirma esos detalles antes de construir un cliente a medida.
PixelBridge es independiente de OpenAI. Usar la Conversions API a través del plugin no crea una asociación oficial.
Por qué importa la medición server-side
Los pixels del navegador fallan en condiciones ordinarias:
- El visitante rechaza las cookies de medición
- Un navegador o una extensión bloquea el script
- Content Security Policy bloquea el dominio del SDK
- El cliente cierra la página de agradecimiento antes de que el pixel se ejecute
- Un maquetador o un plugin de caché reordena scripts
Un evento de servidor puede registrar igual la conversión después de que WordPress haya guardado el formulario, la reserva o el pedido. Esa resiliencia es el motivo para añadir la Conversions API. No es un motivo para ignorar el pixel. Las vistas de página y el contexto de aterrizaje siguen viniendo del navegador.
La entrega server-side no se salta el consentimiento. Si se exige permiso de medición, mantén el evento de servidor detrás del mismo permiso. Consulta consentimiento.
Pixel frente a Conversions API
| Browser Pixel | Conversions API | |
|---|---|---|
| Dónde se ejecuta | Navegador del visitante | WordPress / servidor |
| Eventos típicos | Vistas de página, conversiones del cliente | Leads, reservas y compras confirmadas |
| Fortaleza | Velocidad y contexto de página | Confirmación después de que WordPress confirma la acción |
| Debilidad | Fácil de bloquear | Necesita credenciales, IDs y manejo de errores |
| Consentimiento | Debe esperar cuando se exige | Debe esperar cuando se exige |
Puedes empezar solo con el pixel. Añade la Conversions API cuando la entrega en el navegador no baste, o cuando las compras y reservas necesiten una señal confirmada del backend. Usar ambas es una elección de resiliencia, no una táctica de ranking.
La guía de instalación del pixel es OpenAI Ads Pixel para WordPress. Documentación del producto: Conversions API.
Deduplicación
Cuando la misma conversión se envía desde el navegador y desde el servidor, la medición necesita una forma de tratarlas como una sola acción. Ese mecanismo es la deduplicación.
Sin él, un checkout correcto puede convertirse en dos compras. Con él, ambos payloads llevan el mismo event ID y el sistema de medición publicitaria puede colapsar el par.
La deduplicación solo es relevante cuando ambas capas envían la misma conversión. Un lead solo de servidor no tiene nada que fusionar. Una vista de página solo del navegador no debería inventar un gemelo de servidor.
Event IDs
Un event ID es la clave compartida de una sola acción del cliente.
El patrón previsto en WordPress:
- En el hook de éxito, crea o reutiliza un event ID.
- Envía el evento del navegador con ese ID, si el pixel tiene permiso para ejecutarse.
- Envía el evento del servidor con el mismo ID, si la Conversions API está activada y el consentimiento lo permite.
- Guarda suficiente del ID en logs o diagnóstico para depurar un desajuste más tarde.
Si el evento del navegador usa un ID y el del servidor usa otro, obtienes duplicados. Si reintentas una llamada de servidor fallida con un ID nuevo mientras el evento original del navegador ya acertó, también puedes obtener duplicados. Mantén el ID estable para esa conversión.
PixelBridge está diseñado para generar o reutilizar ese ID de modo que el par pueda deduplicarse.
Implementación en WordPress
Una configuración de Conversions API en WordPress es un trabajo de backend:
- Guarda las credenciales de API en los ajustes del plugin o en la configuración del entorno, no en un archivo JavaScript público.
- Escucha hooks confirmados de WordPress, no clics de botones.
- Construye un payload que coincida con la especificación oficial actual de eventos.
- Incluye el event ID que usó el evento del navegador.
- Respeta el consentimiento antes de que la petición salga del servidor.
- Registra el éxito y el fallo en lugar de reintentar a ciegas.
Fuentes típicas:
- Un hook de envío de formulario confirmado
- Un hook de confirmación de reserva
- Un estado de pedido de WooCommerce que significa que la compra es real
No envíes eventos de servidor desde wp_footer en cada página. Eso recrea las peores partes de un pixel sin el valor de las vistas de página.
La documentación de WordPress cubre hooks y arquitectura de plugins. No define los campos de eventos de OpenAI.
WooCommerce
WooCommerce es una fuente natural de Conversions API porque el pedido existe en el servidor aunque el cliente nunca vea el pixel de agradecimiento.
Cuando se publique la medición de compras, el evento debería:
- Dispararse en el estado de pedido que trates como conversión
- Incluir un identificador de pedido
- Incluir un valor de conversión donde esté permitido
- Compartir un event ID con cualquier evento
purchasedel navegador
La integración de WooCommerce está próximamente. No está publicada. No esperes que los pedidos envíen eventos de OpenAI Ads hasta que exista ese conector o construyas un hook a medida tú mismo.
Envíos de formularios
Los formularios son la otra fuente server-side habitual. Un hook de éxito en PHP puede enviar lead_created después de que se guarde el mensaje, lo cual es más fiable que un listener de JavaScript en el botón de envío.
Los conectores de formularios previstos (Elementor Forms, Contact Form 7, WPForms, Gravity Forms, Fluent Forms) están próximamente. Hasta entonces, una implementación a medida debería dispararse una vez por envío correcto y saltarse los fallos de validación.
Si el formulario también dispara un evento del navegador, usa el mismo event ID en ambos.
Depuración
Depura navegador y servidor como un par.
- Confirma que el camino del pixel sigue funcionando. Un pixel roto más una API rota parece "CAPI está caída" cuando el problema real es el consentimiento o un desajuste de Pixel ID.
- Dispara una conversión.
- Comprueba si se envió un evento del navegador.
- Comprueba si se envió un evento del servidor.
- Compara los event IDs.
- Inspecciona la respuesta del servidor. Deja los fallos visibles.
El diagnóstico de PixelBridge está diseñado para mostrar el estado de conexión de Conversions API y el estado de envío de eventos recientes. Un aviso previsto es "el evento del navegador se envió, pero el del servidor falló". Esa comprobación está prevista, no se reclama como publicada. Consulta diagnóstico y solución de problemas.
Errores habituales
| Error | Qué suele significar |
|---|---|
| Ningún evento de servidor | CAPI no configurada, o el hook de WordPress nunca se ejecutó |
| 401 / fallo de autenticación | Credenciales ausentes, rotadas o guardadas en el lugar equivocado |
| Evento rechazado | Los campos del payload no coinciden con la especificación oficial actual |
| Conversiones duplicadas | Event IDs ausentes o desajustados |
| Evento de servidor después de denegar el consentimiento | El consentimiento no se aplicó al camino del backend |
| Eventos de staging en una propiedad de producción | Pixel ID o destino de API equivocado |
Los nombres de eventos y los campos obligatorios pueden cambiar. Cuando se rechaza un payload, consulta la documentación oficial de OpenAI antes de cambiar hooks de WordPress.
Configuración en PixelBridge
PixelBridge está diseñado para enviar eventos de Conversions API desde WordPress y coordinarlos con eventos del navegador. Esa configuración está prevista, no lanzada.
Configuración prevista, cuando Pro esté disponible:
- Introduce el Pixel ID y completa primero la medición en el navegador.
- Añade las credenciales de Conversions API en los ajustes del plugin.
- Activa solo las conversiones que ya confías en el navegador, o que existen solo en el servidor.
- Confirma que el diagnóstico muestra una conexión y un solo envío por acción de prueba.
Hasta el lanzamiento, únete al early access desde la página de inicio. Lee funciones y precios para la división prevista Free, Pro y Agency. Pro es el hogar previsto de Conversions API, deduplicación, WooCommerce e integraciones de reservas.
Para el modelo de medición más amplio, continúa con Medición de conversiones de OpenAI Ads.