Pixel para ChatGPT Ads: configuración y ayuda

Requisitos

Requiere PrestaShop 1.6 o posterior y PHP 7.1 o posterior.

Necesitas un Pixel ID de sitio web de ChatGPT Ads. Los informes del servidor también requieren una Conversions API key y HTTPS saliente a bzr.openai.com. Los ajustes te remiten a la pestaña "Conversions" de ChatGPT Ads Manager y distinguen la Conversions API key de una Advertiser API key. Confirma los requisitos actuales de configuración de la cuenta en Ads Manager.

Si exiges el consentimiento de los visitantes, instala y activa MPR Cookies Revolution. Configura una categoría de marketing que conceda ad_storage y ad_user_data. Hazlo antes de activar el seguimiento.

Instala y abre el formulario

1. Sube el ZIP del módulo desde "Modules" > "Module Manager" > "Upload a module" e instálalo.
2. Haz clic en "Configure" para Pixel for ChatGPT Ads. Se abre el formulario de configuración titulado "ChatGPT Ads Pixel and Conversions API".
3. Introduce "Pixel ID" y "Conversions API key".
4. Revisa los ajustes de consentimiento y eventos, activa "Tracking enabled" y haz clic en "Save".

Los cambios de configuración requieren un empleado con permiso de edición. Una clave API guardada se muestra enmascarada. Deja su campo vacío para conservar la clave actual.

Ajustes de conexión

"Check test-mode availability" no envía compras ni eventos de prueba. Usa el indicador de preparación y una compra real autorizada en la tienda en producción para verificar el envío. Una copia de pruebas no envía eventos reales.

Interruptores de eventos

Los seis interruptores de eventos comerciales están activados inicialmente. Desactiva los eventos que no quieras comunicar.

Para comunicar solo compras, deja "Purchases" activado y desactiva los otros cinco interruptores. Desactivar "Browser Pixel" mantiene disponibles las compras del servidor. Mantén "Conversions API (server)" y "Purchases" activados para esa configuración.

Consentimiento y privacidad

Con el consentimiento obligatorio, la medición del servidor necesita ad_storage; el Pixel del navegador también necesita ad_user_data. El consentimiento desconocido o denegado impide el seguimiento correspondiente. La retirada bloquea el envío de los eventos pendientes cuando llega a la tienda. No puede recuperar un evento ya enviado.

Los eventos de pedido contienen valor, moneda, identificadores de producto y cantidades. Cuando esté permitido y activado, los datos de coincidencia pueden incluir email, teléfono, nombre, apellidos e identificador de cliente con hash SHA-256. Ciudad, región, código postal y país son campos de ubicación normalizados, no todos con hash. También pueden incluirse referencias de clic y navegador.

La cola actual de compras del servidor no añade deliberadamente la dirección IP ni el agente de usuario del proceso o del callback de pago como datos del cliente. Algunos campos salientes se envían sin hash. Refleja el uso real de los datos en tu información de privacidad.

Productos y valores

Los identificadores de combinación usan 42-7 para el producto 42 y la combinación 7. Un producto sin combinaciones conserva su ID de producto simple. Verifica la coincidencia con el feed en lugar de basarte solo en el ejemplo.

Señales opcionales de contacto e interacción

Estos controles están presentes además de los seis eventos comerciales. Todos están desactivados inicialmente.

Los valores predeterminados de interacción usan 3 vistas de galería, 1 cambio de variante, 1 clic en detalles o 45 segundos de permanencia, con una limitación de opciones de 1500 ms. La configuración suministrada también define selectores de galería, variantes y detalles, un nombre de evento y un comportamiento de un evento por sesión. Los intervalos numéricos permitidos son de 1 a 20 para umbrales de interacción, de 5 a 600 segundos de permanencia y de 250 a 60000 ms para la limitación de opciones. Guarda y repite las pruebas después de editar. Estos interruptores siguen dependiendo del consentimiento, la exclusión del personal y el control del seguimiento.

Envío inicial y reintentos

Al crear un pedido, el módulo guarda el pedido y el consentimiento del comprador y pone en cola una compra apta. Se omiten los pedidos creados en el estado de error o cancelación configurado. El consentimiento desconocido, el tráfico reconocido de empleados, la falta de datos del comprador, los ajustes del servidor inactivos u otro módulo que controle el Pixel ID también pueden dejar una compra fuera de la cola.

El módulo intenta enviar un lote pequeño cuando termina la solicitud de compra. Su tarea programada "Send ChatGPT Ads server-side conversion events" está prevista cada 300 segundos y procesa el trabajo restante. Configura tu ejecutor de tareas programadas instalado o el planificador del alojamiento para que se ejecute regularmente. No dependas solo de una solicitud de compra correcta para los reintentos de envío.

La tarea diaria "Delete ChatGPT Ads click references older than 35 days" limpia los datos de atribución. La limpieza de la cola también se ejecuta durante el procesamiento de conversiones. Supervisa las ejecuciones programadas y sus errores mediante la interfaz de programación disponible en tu instalación.

Los eventos caducan localmente después de 6 días y 22 horas, con un margen de dos horas antes del límite de siete días. Reintentar un evento fallido no reinicia la hora original de compra.

Callbacks de pago retrasados

Un proveedor de pagos puede crear el pedido en un callback del servidor después de que el comprador se marche. El módulo usa entonces el consentimiento y los datos guardados para el comprador y el carrito, nunca los datos de navegador o red del callback. Prueba esta ruta de pago por separado si la usas.

Control por Marketing Revolution

Si otro módulo capaz controla el mismo Pixel ID, la página de configuración muestra un aviso de control y este módulo permanece inactivo para ese destino. Marketing Revolution puede asumir el control si se configura con el mismo Pixel ID. La cola compartida y la identidad de compra permiten la coordinación entre módulos. Comprueba el aviso y la cola después de cambiar cualquiera de ellos.

Todas las tiendas comparten el Pixel ID y los ajustes de este módulo. Los registros de compra y consentimiento siguen vinculados a su tienda. Elegir otra tienda en el back office no crea una configuración de seguimiento independiente.

Comprueba la preparación

Abre "Configuration" y lee "Tracking status". Confirma el Pixel ID, el interruptor de seguimiento, el estado del navegador, el estado del servidor, la integración del consentimiento y la fuente de los ID de artículo. Debajo, "Server-side purchases" muestra recuentos por estado y las diez últimas filas con "Order", "Event ID", "Status", "Attempts", "HTTP", "Queued" y "Last error".

Prueba el recorrido del cliente

1. Usa una sesión de navegador de cliente limpia para que la exclusión de empleados no suprima tu prueba.
2. Antes del consentimiento, verifica que el Pixel externo no se haya cargado. Concede el permiso de marketing configurado y verifica las solicitudes permitidas del navegador.
3. Visita un producto, añádelo al carrito, inicia la compra y crea una cuenta que no sea de invitado si activaste esos eventos.
4. Completa una compra real autorizada en la tienda en producción. Examina la fila del pedido en la cola, la respuesta y el "Event ID".
5. Deja que se ejecute la tarea programada y confirma un resultado de envío correcto. Comprueba por separado los diagnósticos propios del destino.
6. Prueba el rechazo y la retirada del consentimiento en una sesión distinta. Comprueba que se bloquee el envío de los eventos de los pedidos pendientes cuando se reciba la retirada.

Las compras del navegador y del servidor usan una identidad de compra común para la deduplicación. La plataforma publicitaria gestiona la atribución y los plazos de los informes. Los bloqueadores de anuncios, los scripts no disponibles, las credenciales rechazadas y el procesamiento de la plataforma pueden afectar al resultado.

En PrestaShop 1.6, verifica el comportamiento de añadir al carrito con el bloque de carrito clásico. Los temas personalizados, módulos de compra, formularios e integraciones de chat necesitan su propia comprobación funcional.

No se registra nada

Comprueba "Tracking enabled", "Pixel ID", los interruptores de eventos y "Tracking status". Lee cualquier aviso de control o de host de pruebas. Con el consentimiento obligatorio, comprueba la asignación de MPR Cookies Revolution a ad_storage y ad_user_data. Usa una sesión de cliente limpia.

Fallan las compras del servidor

Lee "Last error" y "HTTP". Comprueba que el HTTPS saliente a bzr.openai.com funciona y que la Conversions API key corresponde al Pixel ID y no es una Advertiser API key. Corrige primero la configuración, después usa "Retry failed events" y ejecuta la tarea programada. Los eventos caducados, bloqueados, retenidos o en un estado definitivo muestran un motivo; corrígelo y vuelve a revisar la cola tras el reintento.

Modo de pruebas o rechazo de la prueba de conexión

Una dirección de desarrollo o pruebas detectada bloquea el seguimiento saliente real. "Check test-mode availability" tampoco envía nada allí. No interpretes su rechazo como un fallo de comprobación de credenciales API.

Captura diagnósticos

Abre el panel "Troubleshooting" en "Configuration". Activa "Recording", elige "24 hours", pulsa "Save" y reproduce el problema. La grabación se desactiva después del periodo seleccionado. Usa "Integrity" para comprobaciones de infraestructura del módulo cuando esté disponible.

Detén el seguimiento

Desactiva "Tracking enabled" y guarda. Esto desactiva las rutas de navegador y servidor del módulo. Los eventos ya aceptados por la plataforma publicitaria quedan fuera del control de la tienda.

Desinstala

Haz una copia de los datos de cola o diagnóstico que necesites. Desinstala desde "Module Manager". La desinstalación elimina la configuración, el menú y las tareas programadas de este módulo. Las tablas compartidas de cola de conversiones y atribución solo se eliminan cuando ningún otro módulo instalado las necesita, y las demás tablas de seguimiento compartidas siguen sus propias reglas, así que algunos registros de seguimiento compartidos pueden quedar.