Descripción
WordPress · Gratuito · v0.1.0
Píxel de ChatGPT Ads y CAPI; compras pagadas de WooCommerce, producto, carrito y checkout; formularios AJAX de CF7, WPForms y Elementor Pro; clics de WhatsApp y teléfono.
¿Qué hace este plugin de ChatGPT Ads para WordPress?
La clave es de Conversions API: una clave para los modelos de OpenAI no sirve. Conserva oppref cuando procede de un clic publicitario. El importe de compra se expresa en unidades menores de la moneda. Pixel event_id y CAPI id comparten el identificador.
El pedido confirmado alimenta el envío de compra desde el servidor. Así se reduce la dependencia de que el cliente vuelva a la página de gracias después del pago.
Instalación y configuración paso a paso
- Descarga el ZIP desde tu cuenta y haz una copia de seguridad. En WordPress abre Plugins → Añadir plugin → Subir plugin, selecciona el ZIP y actívalo.
- Abre Ajustes → NDC ChatGPT Ads. Añade Pixel ID y clave de Conversions API de tu cuenta publicitaria de OpenAI. Guarda los secretos únicamente en el panel o en la constante de servidor documentada.
- Conecta el consentimiento publicitario. Para otra CMP usa
NDCChatGPT.setConsent(true)al aceptar yNDCChatGPT.setConsent(false)al rechazar o retirar el permiso. Comunica también la preferencia guardada en cada página. - Se instala desactivado y en validación. El botón de prueba utiliza validate_only: true y no registra conversiones. Comprueba después un evento real en tu cuenta con el modo Producción.
- Revisa que WP-Cron funcione. El servidor utiliza una cola para procesar los envíos y reintentar fallos temporales.
- Evita que otro plugin o GTM envíe la misma compra con un ID diferente. Configura los objetivos de la cuenta y compara ID, hora, importe y moneda del pedido.
Compatibilidad con WooCommerce, PayPal y pagos a plazos
| Caso | Qué debe ocurrir |
|---|---|
| WooCommerce clásico y bloques | El pedido debe conservar el contexto consentido y activar los hooks de pago. Se utiliza CRUD de pedidos compatible con HPOS. |
| PayPal, tarjeta e InstantPay | La pasarela debe notificar el cobro a WooCommerce y actualizar el pedido. Un pago externo que no crea ni confirma el pedido requiere adaptación. |
| Financiación o pago a plazos | Se cuenta una compra por pedido confirmado, con el importe del pedido; no una conversión por cuota. Comprueba el significado del estado que devuelve el proveedor. |
| Pagos pendientes, fallidos o cancelados | No deben convertirse en compras. Un evento ya enviado no se revierte automáticamente con un reembolso. |
Qué revisar antes de producción
- Sin consentimiento, no debe cargarse el píxel ni enviarse un evento publicitario.
- Una compra confirmada debe producir un único evento
order_created, también al recargar la página o repetirse el callback. - Repite la prueba cerrando el navegador antes del retorno desde la pasarela.
- Comprueba rechazo y retirada del consentimiento, fallos de API y funcionamiento de la cola.
- La recepción HTTP no demuestra atribución: revisa el evento y su diagnóstico dentro de ChatGPT Ads.
Preguntas frecuentes
¿Necesito Google Tag Manager o otro servidor?
La conexión del plugin se ejecuta en WordPress. Necesitas HTTPS, salida hacia la API y WP-Cron operativo. GTM no es obligatorio para esta integración.
¿Funciona si el comprador no vuelve del pago?
Puede enviar la compra cuando WooCommerce confirma el pago desde el servidor, siempre que antes se haya guardado el consentimiento y el contexto del visitante. Debe probarse el recorrido de pago exprés de cada proveedor.
¿Recupera todas las ventas perdidas?
No. La API mejora la continuidad del envío, pero no garantiza atribución. Influyen el consentimiento, los identificadores, las ventanas de la plataforma y el estado real del pedido.
¿El plugin está desarrollado por la plataforma publicitaria?
No. Es un desarrollo de Nivel de Calidad que utiliza la integración documentada por la plataforma.
Requisitos y documentación
WordPress 6.4 o posterior y PHP 7.4 o posterior como objetivo de compatibilidad. WooCommerce es necesario para compras. Los formularios y constructores requieren comprobar sus versiones concretas. No se afirma una certificación para todas las combinaciones.
Desarrollado por Nivel de Calidad. Revisión técnica y editorial: .
Documentación oficial de OpenAI Conversions API · Ver todos los módulos de WordPress
