Guía
Cómo instalar el píxel de ChatGPT Ads en WooCommerce, paso a paso
ChatGPT Ads mide las ventas de WooCommerce a través de dos interfaces de OpenAI: el Measurement Pixel en el navegador del comprador y la Conversions API (API de conversiones) en tu servidor. Instalar el píxel consiste en conseguir un Pixel ID y una clave de API en Ads Manager y conectarlos a WooCommerce para que se envíen eventos reales de producto, carrito y pedido. Esta guía lo hace con el plugin Pixel for ChatGPT Ads y termina explicando cómo comprobar que funciona.
Actualizado
En esta página
Resumen: siete pasos y, en la práctica, una pantalla de ajustes
Antes de empezar
Cinco cosas que tener preparadas y una que quitar.
- WordPress con WooCommerce activo y servido por HTTPS.
- Acceso de administrador a WordPress, para subir y configurar un plugin.
- Acceso a tu cuenta de ChatGPT Ads en OpenAI Ads Manager.
- Una clave de licencia de Pixel for ChatGPT Ads. La recibes al completar la compra; los planes empiezan por un sitio.
- Un servidor que pueda hacer peticiones HTTPS salientes. Algunos alojamientos y cortafuegos las bloquean, y la compra server-side las necesita.
Comprueba esto
Paso 1 de 7
Consigue tu Pixel ID
El Pixel ID le indica al Measurement Pixel a qué cuenta de ChatGPT Ads pertenecen los eventos. La documentación de OpenAI indica que se crea un Pixel ID nuevo en la pestaña de conversiones de Ads Manager (documentación del Measurement Pixel; la documentación de OpenAI enlazada en esta guía está en inglés).
También necesitas el Pixel ID para el seguimiento server-side: el endpoint de la Conversions API se identifica con él.
Resultado esperado
Error frecuente
Paso 2 de 7
Consigue una clave de la Conversions API
La clave de la Conversions API autoriza a tu servidor a enviar eventos. OpenAI la genera en el mismo sitio: según su documentación, el Pixel ID y la clave de la Conversions API se obtienen en la pestaña de conversiones de Ads Manager (documentación de la Conversions API).
Trata la clave de API como una contraseña
OpenAI deja claro que los eventos de servidor deben enviarse únicamente desde tu servidor. El plugin guarda la clave para uso server-side y no la imprime en la página.
Resultado esperado
Error frecuente
Paso 3 de 7
Instala el plugin
- 1Descarga el ZIP del plugin desde la confirmación de tu compra, o desde la página de descarga (en inglés) con tu clave de licencia.
- 2En WordPress, ve a
Plugins → Añadir plugin → Subir plugin, elige el ZIP y pulsaInstalar ahora. - 3Activa el plugin con
Activar plugin.
Resultado esperado
Paso 4 de 7
Activa tu licencia
Abre la pestaña Licence del plugin, pega tu clave de licencia y actívala. No se envía ningún evento hasta que la licencia está activa.
Resultado esperado
Error frecuente
Paso 5 de 7
Conecta tus credenciales
En la pestaña Settings del plugin:
- Pega tu Pixel ID en
OpenAI Pixel ID. - Pega tu clave en
Conversions API key. - Deja activado el seguimiento en el navegador para enviar desde la página las vistas de producto, los añadidos al carrito, los inicios de pago y las compras.
- Deja activado el seguimiento server-side para enviar cada pedido pagado a través de la Conversions API.
- Si tu banner de cookies implementa la WordPress Consent API, activa la gestión del consentimiento para que el píxel espere al consentimiento de marketing.
Los ajustes de conexión del plugin en WordPress (interfaz en inglés).
- 1
OpenAI Pixel ID: el del paso 1. - 2
Conversions API key: la del paso 2. - 3Interruptores de seguimiento en el navegador y server-side: déjalos los dos activados.
Resultado esperado
Comprueba esto
Paso 6 de 7
Comprueba los eventos del navegador
- 1Abre la tienda en una ventana privada y acepta las cookies de marketing si aparece un banner.
- 2Abre las herramientas para desarrolladores del navegador y ve a la pestaña Red.
- 3Filtra las peticiones por
openai. Deberías ver cómo se carga el script del Measurement Pixel desde un dominio de openai.com. - 4Visita un producto, añádelo al carrito y ve a finalizar compra mientras observas las peticiones nuevas.
Resultado esperado
Error frecuente
Paso 7 de 7
Comprueba un pedido pagado
Haz un pedido que WooCommerce marque como pagado (un pedido real de poco importe o una pasarela de pruebas que marque los pedidos como pagados). Después abre la pestaña Diagnostics del plugin y busca el pedido.
| Estado de envío | Qué significa | Qué hacer |
|---|---|---|
| Accepted | OpenAI aceptó la compra. | Nada. El seguimiento funciona. |
| Pending | En cola o a la espera de otro intento. | Vuelve a mirarlo en un rato. |
| Not sent | La compra no se envió; normalmente, porque no hay consentimiento de marketing para ese pedido. | Abre el pedido para ver el motivo. |
| Failed | El último intento no se completó. | Mira el código HTTP, corrige la causa y reenvía si el pedido cumple los requisitos. |
Diagnostics muestra los pedidos pagados y qué pasó con cada evento de compra (interfaz en inglés).
- 1Busca tu pedido de prueba por su número.
- 2El event ID es el que comparten la compra del navegador y la del servidor.
Resultado esperado
Comprueba esto
Solución de problemas
Errores frecuentes
La mayoría de los problemas de instalación son uno de estos cinco.
| Síntoma | Causa probable | Solución |
|---|---|---|
| Las conversiones parecen duplicadas | El píxel también está instalado en el tema o en un gestor de etiquetas. | Quita la otra copia. |
| Failed con HTTP 401 | Se rechazó la clave de la Conversions API. | Pega una clave válida y reenvía desde Diagnostics. |
| Se queda en Pending, reintentando | El servidor no llega a la API. | Revisa las peticiones HTTPS salientes, el cortafuegos y las reglas del proxy. |
| No hay eventos del navegador | No se ha dado el consentimiento, el seguimiento está desactivado o hay una página en caché antigua. | Da el consentimiento, revisa los ajustes y vacía la caché. |
| Pedidos marcados como Not sent | No hay consentimiento de marketing registrado para esos pedidos. | Es lo esperado con la gestión del consentimiento activada. |
La sección de solución de problemas de la documentación recoge más casos.
Sin plugin
Instalarlo a mano
Puedes instalar el píxel sin un plugin. En WooCommerce, el fragmento de código es solo el principio.
Las instrucciones de OpenAI consisten en añadir su fragmento al <head> de todas las páginas en las que quieras registrar conversiones. A partir de ahí:
- Cada evento (vista de producto, añadido al carrito, inicio del pago, compra) hay que programarlo con los valores de WooCommerce.
- El evento de compra debe dispararse una vez por pedido, no una vez por cada carga de la página de pedido recibido.
- Una compra server-side necesita su propio cliente de la API, que se dispare cuando el pedido pase a pagado.
- Las compras del navegador y del servidor necesitan el mismo event ID para poder deduplicarse.
- Los fallos necesitan reintentos y un sitio donde verlos.
La guía de la API de conversiones de OpenAI para WooCommerce explica en detalle la parte del servidor.
Preguntas
¿Necesito el Pixel ID y también la clave de API?
El Pixel ID hace falta para todo. La clave de API hace falta para la compra server-side. Puedes desactivar por separado el seguimiento en el navegador y el server-side, pero con los dos activados la compra tiene una segunda vía que no depende del navegador.
¿El plugin necesita Google Tag Manager?
No. Carga el píxel y construye los eventos directamente a partir de WooCommerce.
¿Cambiar de tema rompe el seguimiento?
No se edita ninguna plantilla, así que cambiar de tema no elimina el píxel. Si tu página de pago está muy personalizada, conviene volver a probar con un pedido.
¿Funciona con HPOS?
Sí. Es compatible tanto con High-Performance Order Storage de WooCommerce como con el almacenamiento de pedidos antiguo.
¿Listo para instalarlo?
Pixel for ChatGPT Ads es una licencia anual para 1, 5 o 25 sitios, con las mismas funciones en todos los planes.
Guías relacionadas
- Píxel de ChatGPT Ads para WooCommerceQué envía el plugin a ChatGPT Ads desde una tienda WooCommerce, cómo se configura y qué no hace.
- API de conversiones de OpenAI en WooCommerce: compras server-sideCuándo y cómo se envía server-side una compra de WooCommerce, y qué no resuelve el seguimiento server-side.
- Píxel de ChatGPT Ads o API de conversiones: diferencias y cuál usarComparativa entre la medición en el navegador y en el servidor para ChatGPT Ads, y por qué una tienda usa las dos.