Documentación de Pixel for ChatGPT Ads

1. 1Descarga el ZIP del plugin desde la confirmación de tu compra.
2. 2En WordPress, ve a Plugins → Añadir plugin → Subir plugin, selecciona el ZIP y pulsa Instalar ahora.
3. 3Activa el plugin con Activar plugin.
4. 4Abre la pestaña Licence, pega tu clave de licencia y actívala.

Necesitas una licencia activa para que se envíen eventos de conversión. La pantalla de licencia muestra el plan, las activaciones que te quedan y la fecha hasta la que es válida la licencia.

• Un sitio WordPress con WooCommerce instalado y activo.
• La tienda servida por HTTPS.
• Peticiones HTTPS salientes permitidas desde tu servidor, para que los eventos de compra lleguen a la Conversions API.
• Un Pixel ID de OpenAI para la medición en el navegador.
• Una clave de la OpenAI Conversions API para los eventos de compra server-side.
• Una clave de licencia de Pixel for ChatGPT Ads.

El plugin es compatible tanto con High-Performance Order Storage de WooCommerce como con el almacenamiento de pedidos antiguo basado en entradas. No hace falta modificar el tema ni las plantillas de finalizar compra.

En la pestaña Settings, pega tu Pixel ID de OpenAI en el campo OpenAI Pixel ID y guarda. Con el seguimiento en el navegador activado, el OpenAI Measurement Pixel se carga en la tienda y los eventos del navegador empiezan a dispararse.

Si la gestión del consentimiento está activada, el píxel permanece bloqueado hasta que ese visitante concede el consentimiento de marketing; consulta Consentimiento.

En la misma pantalla, pega tu clave de la Conversions API en el campo Conversions API key. La clave se guarda solo para uso server-side: no se imprime en el código de la página y nunca se envía al navegador.

Con el seguimiento server-side activado, tu servidor envía order_created cuando un pedido de WooCommerce pasa a un estado pagado. Cada intento queda registrado en Diagnostics con su respuesta HTTP, así que una clave rechazada o un límite de peticiones quedan a la vista en lugar de pasar desapercibidos.

Estos eventos se envían desde la página:

• Producto vistocontents_viewed
• Añadido al carritoitems_added
• Inicio del pagocheckout_started
• Compraorder_created

Si desactivas el seguimiento en el navegador, se detienen los cuatro eventos del navegador. El seguimiento server-side de la compra no se ve afectado y sigue funcionando. La comparativa entre el píxel y la API de conversiones explica qué puede ver y qué no cada vía.

order_created es el evento que se envía a través de la Conversions API. Se dispara cuando WooCommerce pasa el pedido a un estado pagado, no al cargar una página, así que un cliente que cierra la pestaña antes de la página de pedido recibido genera igualmente un evento de compra. Los métodos de pago diferido funcionan igual.

El event ID se deriva del pedido, de modo que el evento del servidor y el del navegador para una misma compra llevan el mismo identificador y pueden resolverse en una sola conversión. Recargar la página de pedido recibido no crea un segundo identificador.

Los envíos fallidos se reintentan automáticamente. Lo que siga fallando después de los reintentos permanece en el registro y se puede reenviar a mano.

Para el contexto (por qué solo la compra se envía server-side, la regla de OpenAI de los 7 días para la marca de tiempo y lo que el envío server-side no puede arreglar), consulta la guía de la API de conversiones de OpenAI para WooCommerce.

El plugin lee el consentimiento de marketing a través de la WordPress Consent API. Si tu plugin de consentimiento implementa esa API, se usa sin más configuración.

• Los eventos del navegador permanecen bloqueados hasta que se concede el consentimiento de marketing.
• El evento de compra server-side usa el estado de consentimiento registrado para ese pedido, así que un cambio de preferencias posterior no reescribe los pedidos anteriores.
• Los pedidos sin consentimiento de marketing aparecen en Diagnostics como Not sent, no como un fallo.

Las herramientas de consentimiento que no implementan la WordPress Consent API no se detectan automáticamente. Tus obligaciones legales dependen de tu tienda, tu configuración y tu jurisdicción.

La pestaña Diagnostics muestra los pedidos pagados y qué pasó con su evento de compra. Sus columnas:

• Order: el pedido de WooCommerce al que pertenece el evento.
• WC paid: si el pedido ha llegado a un estado pagado.
• Consent: el estado del consentimiento de marketing registrado para el pedido.
• Delivery: enviado, reintentando, fallido o no enviado.
• Attempts: cuántas veces se ha intentado el envío.
• HTTP status: el código de respuesta devuelto en el último intento.

Un envío fallido se puede reenviar desde la misma pantalla una vez corregida la causa.

Las licencias son anuales y cubren un número fijo de activaciones, una por cada instalación de WordPress. Al desactivar un sitio, su activación queda libre para otra tienda.

Active

Seguimiento permitido. Se envían los eventos, llegan las actualizaciones y tienes soporte.

Expired

No se permite el seguimiento de nuevas conversiones. Renueva para recuperar el envío de eventos, las actualizaciones y el soporte.

Disabled

No se permite el seguimiento de nuevas conversiones. La licencia se ha desactivado y ya no se envían eventos nuevos.

Los nombres de estado aparecen así en el plugin, cuya interfaz está por ahora en inglés.

Las actualizaciones del plugin llegan por la pantalla de actualizaciones habitual de WordPress mientras la licencia esté activa. Consulta los precios y los límites de cada plan.

No hay eventos del navegador en la tienda

Comprueba que el seguimiento en el navegador está activado, que el Pixel ID está guardado y, si la gestión del consentimiento está activada, que se ha concedido el consentimiento de marketing. Una caché de página completa también puede servir una copia de la página anterior a la configuración del plugin.

Un pedido pagado aparece como Not sent

No se concedió el consentimiento de marketing para ese pedido, así que no se envió ningún evento de servidor. Es el comportamiento previsto de un seguimiento que respeta el consentimiento.

El envío falló con 401

Se rechazó la clave de la Conversions API. Actualiza la clave en la pestaña Settings y reenvía el evento desde Diagnostics.

El envío muestra 429

Se alcanzó el límite de peticiones. El envío se reintenta automáticamente; no tienes que hacer nada salvo que acabe en Failed.

Los envíos se quedan reintentando

Puede que tu servidor no llegue a la API. Revisa las peticiones HTTPS salientes, las reglas del cortafuegos y cualquier proxy que haya delante de WordPress.

Falta un pedido en el registro

El evento de compra se registra cuando el pedido llega a un estado pagado. Los pedidos pendientes de pago todavía no se han enviado.

Las conversiones parecen duplicadas

Comprueba que no haya un segundo píxel instalado en otro sitio. Un fragmento en el tema o un contenedor de un gestor de etiquetas se dispara sin el event ID que asigna el plugin, así que no se puede deduplicar frente al evento del servidor.

¿Sigues atascado? Envíanos el número de pedido y el código HTTP que aparece en Diagnostics: contacta con soporte.