Medición de conversiones de OpenAI Ads para WooCommerce

Cómo debería funcionar la medición de compras de WooCommerce con OpenAI Ads, incluidos IDs de pedido, valores de conversión, eventos de navegador y servidor, consentimiento y la configuración prevista de PixelBridge.

Última actualización: 8 de septiembre de 2026. Escrito por PixelBridge team.

La medición de compras de WooCommerce para OpenAI Ads debería disparar un evento purchase después de que el pedido esté confirmado, no cuando un comprador abre el checkout o añade un producto al carrito. El evento debería llevar un identificador de pedido, un valor de conversión y una moneda donde esté permitido, y un event ID compartido si la misma conversión también se envía por la Conversions API. El consentimiento de medición debe estar concedido antes de que cualquier evento de navegador o servidor salga del sitio. PixelBridge está diseñado para hacerlo desde WordPress. El hook del plugin aún no está disponible.

Para qué sirve esta integración

WooCommerce ya registra pedidos, totales, datos del cliente y el estado del pedido. La medición de OpenAI Ads necesita un evento de conversión que represente esa compra, para que los informes publicitarios puedan conectar un pedido pagado o confirmado con la actividad de campaña.

PixelBridge es un plugin independiente de WordPress para esa capa de medición. No es un producto oficial de OpenAI ni de WooCommerce, y no crea campañas. El conector de WooCommerce es una de las primeras integraciones previstas. Hasta que se publique, nada de esta página es una función de plugin que funcione.

Para la configuración de la tienda en sí, empieza por la documentación oficial de WooCommerce. Para el contrato de medición publicitaria, usa la documentación del Measurement Pixel de OpenAI y la documentación de Conversions API. Los nombres de eventos y los campos obligatorios pueden cambiar. Confírmalos en la documentación oficial de OpenAI antes de tratar un payload como definitivo.

Cómo debería funcionar la medición de compras

Un evento de compra útil es una acción comercial completada. En WooCommerce eso suele significar que existe un pedido y ha alcanzado un estado que tu tienda trata como real, como processing o completed, según el método de pago.

La secuencia prevista es:

  1. El comprador completa el checkout.
  2. WooCommerce crea un pedido y asigna un identificador.
  3. Si se concede el consentimiento de medición, un evento purchase del navegador puede dispararse en el estado de pedido recibido o de agradecimiento.
  4. Si la Conversions API está activada, WordPress puede enviar un evento de servidor coincidente después de que el pedido se confirme en PHP.
  5. Ambos payloads comparten un event ID para que la medición de OpenAI Ads pueda tratarlos como una sola conversión.

No dispares purchase en:

  • Vistas de páginas de producto
  • Add to cart
  • Carga de la página de checkout
  • Pagos fallidos o cancelados
  • Pedidos en borrador creados en el administrador que un cliente nunca colocó

Una vista de página en una URL de producto o carrito sigue siendo un evento page_viewed si mides vistas de página. No es una compra. Consulta eventos de conversión para cómo difieren esos tipos de evento.

Identificadores de pedido

Cada evento de compra necesita un identificador de pedido estable. WooCommerce ya tiene uno: el order ID, y a menudo un número de pedido separado si usas un plugin de numeración personalizado.

El identificador es útil para tres trabajos:

  • Depuración: puedes emparejar un evento de medición con un pedido de WooCommerce.
  • Deduplicación: los eventos de navegador y de servidor pueden apuntar al mismo pedido.
  • Operaciones posteriores: si se añade el manejo de reembolsos, el pedido original es la clave de unión.

Usa el identificador que no cambiará después del checkout. Si tu tienda muestra a los clientes un número de pedido formateado, decide si la medición usa el ID interno o el número orientado al cliente, y mantén esa elección consistente en los eventos de navegador y de servidor.

No generes un ID aleatorio nuevo en la página de agradecimiento si un evento de servidor también enviará el order ID. Los dos lados ya no parecerían la misma conversión.

Valores de conversión

Una conversión de compra es mucho más útil cuando incluye un valor y una moneda. Las fuentes típicas en WooCommerce son el total del pedido y la moneda de la tienda.

Planifica el valor con cuidado:

  • Decide si el valor incluye impuestos, envío y recargos.
  • Usa la misma regla en los eventos de navegador y de servidor.
  • Envía la moneda de la tienda, no un fallback hardcodeado, salvo que el pedido en sí esté en otra moneda.
  • No envíes un valor para un pedido impagado o fallido.

El valor no es lo mismo que los ingresos en los informes de tu tienda. Los totales de WooCommerce pueden incluir descuentos, reembolsos posteriores o ajustes multi-moneda. La medición de OpenAI Ads solo verá lo que envíes. Mantén el mapeo simple y documéntalo para tu equipo.

Si el consentimiento o tu política de privacidad no permiten enviar el valor, omítelo en lugar de adivinar. Un evento de compra sin valor sigue siendo una conversión. Un valor inventado es peor que ningún valor.

Eventos del navegador

El evento del navegador es la llamada purchase del cliente después de que el pixel se haya cargado. En WooCommerce, el lugar natural es la página de pedido recibido, después de que WooCommerce haya mostrado un pedido correcto.

Un evento del navegador previsto debería esperar a:

  1. Que el OpenAI Ads Pixel se inicialice con tu Pixel ID.
  2. El consentimiento de medición, si tu sitio lo exige.
  3. Prueba de que esta página pertenece a un pedido real, no a una plantilla genérica de agradecimiento sin objeto de pedido.

Las páginas de agradecimiento son fáciles de equivocar. Algunos temas cargan la misma plantilla para pagos fallidos. Algunos plugins de checkout sustituyen el endpoint central de pedido recibido. Algunas cachés sirven una página de agradecimiento sin contexto de pedido. La integración debería leer el objeto de pedido de WooCommerce, no asumir que cualquier visita a /checkout/order-received/ es una compra.

Los eventos del navegador pueden bloquearse por extensiones, navegadores estrictos, reglas de Content Security Policy o un banner de consentimiento que nunca concede medición. Por eso un evento de servidor forma parte del diseño. Es un complemento, no una forma de ignorar el consentimiento. Consulta la guía OpenAI Ads Pixel para WordPress para cómo debe cargar el pixel en sí.

Eventos server-side

La Conversions API envía la misma conversión desde WordPress después de que el pedido se confirme en PHP. Eso es útil cuando la página de agradecimiento nunca carga, el comprador cierra la pestaña, o el pixel del navegador está bloqueado.

Un evento de servidor de WooCommerce previsto debería dispararse desde un hook del ciclo de vida del pedido, no desde un callback genérico de wp_footer. El hook debería representar un pedido confirmado. Los métodos de pago difieren: algunos marcan el pedido como processing de inmediato, otros esperan un webhook. La integración debería seguir el estado que significa "esta compra es real" para esa pasarela.

Los eventos de servidor siguen necesitando:

  • El Pixel ID
  • El nombre del evento (purchase)
  • El identificador de pedido
  • Valor y moneda donde esté permitido
  • El event ID compartido
  • Datos de atribución como oppref cuando estén disponibles
  • La misma regla de consentimiento que el evento del navegador

La conexión de Conversions API del plugin forma parte del conjunto previsto de funciones Pro y aún no está disponible públicamente. Lee Conversions API y la documentación oficial de Conversions API para el contrato actual de campos.

Deduplicación

Si envías un evento del navegador y un evento del servidor para un pedido de WooCommerce, la medición de OpenAI Ads necesita una forma de ver que son la misma acción. Eso es un event ID compartido.

El modelo previsto es:

  1. WordPress genera o guarda un event ID para el pedido.
  2. El evento del navegador incluye ese ID.
  3. El evento del servidor incluye el mismo ID.
  4. Ambos eventos usan el mismo Pixel ID y el mismo nombre de evento.

Sin ese ID compartido, una página de agradecimiento correcta más un hook de servidor correcto pueden parecer dos compras. Con él, un evento del navegador bloqueado puede dejar igual una conversión de servidor válida.

No reutilices un event ID entre pedidos distintos. No crees un ID nuevo en cada refresco de la página de agradecimiento. El pedido es la unidad de conversión.

Consentimiento

La medición de compras sigue siendo medición publicitaria. Si tu configuración legal la trata como opcional, la integración de WooCommerce no debería cargar el pixel, disparar una compra del navegador ni enviar un evento de Conversions API hasta que exista el permiso requerido.

El consentimiento no es un ajuste de WooCommerce. Suele venir de un banner de cookies o un plugin de consentimiento. PixelBridge está diseñado para leer ese estado en lugar de añadir un segundo banner. Consulta consentimiento.

Algunas trampas específicas de WooCommerce:

  • El checkout puede completarse mientras el banner sigue sin responderse.
  • Algunas tiendas conceden consentimiento de estadísticas pero no de marketing o medición.
  • Los eventos de servidor deben seguir el mismo permiso que los del navegador. Un hook de PHP no es un atajo.

Esta página es orientación de implementación, no asesoramiento legal.

Reembolsos

WooCommerce puede reembolsar un pedido total o parcialmente. Los eventos de reembolso o ajuste de OpenAI Ads aún no están soportados por PixelBridge.

Hasta que exista soporte de reembolsos:

  • No envíes un segundo purchase con un valor negativo como workaround.
  • No borres el evento de compra original de tus propios logs y asumas que los informes publicitarios lo seguirán.
  • Trata la compra original como la conversión que se envió, y espera a un mapeo de reembolsos documentado.

Si más adelante se añaden eventos de reembolso, deberían referenciar el identificador original del pedido y seguir las reglas oficiales de medición de OpenAI Ads. Ese trabajo no está publicado.

Configuración prevista

Cuando se publique la integración de WooCommerce, el camino previsto en WordPress es:

  1. Instala PixelBridge cuando el plugin esté disponible. El listado público aún no está en vivo. Consulta instalación.
  2. Introduce tu OpenAI Ads Pixel ID.
  3. Activa la medición de compras de WooCommerce en los ajustes del plugin.
  4. Elige el estado de pedido que debe contar como compra para tus métodos de pago.
  5. Decide si deben dispararse eventos del navegador, del servidor, o ambos.
  6. Confirma las reglas de consentimiento antes de permitir cualquier evento.
  7. Haz un pedido de prueba en un sitio de staging y revisa el diagnóstico.

Hasta que se publique, no pegues JavaScript de compra en una plantilla de agradecimiento de WooCommerce y asumas que coincidirá con el plugin futuro. Una prueba manual temporal es posible, pero no es la integración soportada.

Solución de problemas

Si una compra de WooCommerce no aparece en la medición de OpenAI Ads, recorre el problema en este orden:

  1. Confirma que la integración está realmente publicada. Si esta página sigue diciendo próximamente, el hook no está en vivo.
  2. Confirma que el Pixel ID coincide con la cuenta publicitaria.
  3. Confirma que el comprador alcanzó un pedido confirmado, no una pantalla de checkout o de pago fallido.
  4. Concede el consentimiento de medición y reintenta.
  5. Comprueba si la página de agradecimiento está cacheada sin contexto de pedido.
  6. Comprueba si un plugin de checkout personalizado sustituyó el flujo central de pedido recibido.
  7. Si están previstos eventos de navegador y de servidor, confirma que comparten un event ID.
  8. Inspecciona el diagnóstico y la guía de solución de problemas.

Un valor oppref ausente no siempre significa que el tracking falló. Puede significar que la visita no vino de un anuncio de OpenAI. Consulta atribución oppref.

Relacionado

Guías relacionadas