Cómo configurar el píxel de anuncios de ChatGPT
Para configurar el píxel de anuncios de ChatGPT, crea una fuente de datos en el Ads Manager de OpenAI, copia tu ID de píxel, instala el JavaScript en las páginas donde ocurren las conversiones y configura los eventos de conversión por los que quieres optimizar. Después envía compras, leads o eventos personalizados con oaiq("measure", ...), deduplica las señales del navegador y del servidor con el mismo event_id y conserva la referencia de clic oppref en tus URLs de destino.
A fecha de septiembre de 2026, la medición de anuncios de OpenAI se apoya en dos canales: el píxel de medición del navegador y la Conversions API en el servidor. Esta guía cubre los dos, el código de instalación exacto, Google Tag Manager, WordPress y WooCommerce, consentimiento y una lista de solución de problemas para que tus datos de conversión lleguen limpios a Ads Manager.
Fuentes: OpenAI — Documentación del píxel de medición ↗ · Documentación de la Conversions API ↗ · Eventos admitidos ↗
Qué es el píxel de anuncios de ChatGPT
El píxel de medición de anuncios de ChatGPT es la tecnología de medición en JavaScript de OpenAI. Lo instalas en tu web para medir qué ocurre después de que alguien hace clic en una ficha patrocinada de ChatGPT Ads: compras, envíos de formularios, registros o cualquier otra conversión que te importe.
| Capa | Qué hace | Dónde se ejecuta |
|---|---|---|
| Píxel de OpenAI | SDK del navegador (var global oaiq) que captura eventos y señales de conversión. | El HTML de tu web |
| Conversions API de OpenAI | Endpoint servidor-a-servidor para eventos enviados desde tu backend. | Tu servidor, nunca el código de la página |
| Referencia de clic (oppref) | Un valor de la URL de destino que vincula la visita con la interacción del anuncio. | URL de destino + cookie de primera parte |
El proceso es simple: un usuario hace clic en una ficha patrocinada, llega a tu web con una referencia de clic en la URL, el píxel la captura y envía más tarde un evento de conversión, y ese evento aparece en el Ads Manager de OpenAI.
Anuncio en ChatGPT ↓ Usuario hace clic en el anuncio ↓ Tu web (la URL de destino lleva ?oppref=...) ↓ Píxel de OpenAI ↓ Evento de conversión ↓ Ads Manager de OpenAI → informe de conversiones
Píxel vs Conversions API
OpenAI ofrece dos formas de enviar datos de conversión, y cada una responde a una pregunta distinta:
| Método | Trayecto | Lo mejor para |
|---|---|---|
| Píxel de OpenAI | Usuario → Navegador → Píxel → OpenAI | Todo lo que ocurre en el navegador: productos vistos, carritos, checkout. |
| Conversions API | Usuario → Web → Servidor → CAPI → OpenAI | Eventos confirmados en el servidor: pedidos, pagos, y eventos de apps móviles. |
| Ambos (recomendado) | Navegador + Servidor → OpenAI (mismo event_id) | Medición resistente que sobrevive a bloqueadores y sesiones perdidas. |
Cuando envíes la misma conversión por los dos canales, reutiliza el mismo event_id para que OpenAI la reconozca como un solo evento y no la cuente dos veces.
Antes de empezar: qué necesitas
- Una cuenta de Ads Manager de OpenAI (autogestionada o gestionada por agencia) con acceso a la configuración de medición.
- Una fuente de datos (píxel) creada en Ads Manager — de ahí sale tu ID de píxel.
- Una web donde puedas añadir un script en el <head> (o un gestor de etiquetas / plugin / desarrollador).
- Los eventos de conversión que quieras medir, configurados en Ads Manager para que coincidan con lo que envía tu web.
- Si usas la Conversions API: acceso al servidor y una forma de mantener el token de acceso en secreto.
Paso 1 — Instalar el píxel en tu web
Crea una fuente de datos en Ads Manager, copia tu ID de píxel (pId_...) y añade el JavaScript a cada página donde pueda ocurrir una conversión. Una implementación básica es esta:
<script>
(function (w, d, s, u) {
if (w.oaiq) return;
var q = function () {
q.q.push(arguments);
};
q.q = [];
w.oaiq = q;
var js = d.createElement(s);
js.async = true;
js.src = u;
var f = d.getElementsByTagName(s)[0];
f.parentNode.insertBefore(js, f);
})(window, document, "script", "https://bzrcdn.openai.com/sdk/oaiq.min.js");
oaiq("init", {
pixelId: "TU_ID_DE_PIXEL"
});
</script>Dos detalles importan. La validación if (w.oaiq) returnevita cargar el SDK dos veces si el código aparece repetido. Y debes usar siempre el código actual de la documentación de OpenAI, porque el SDK evoluciona — verifica el código y los parámetros antes de llevarlo a producción.
Paso 2 — Configurar los eventos de conversión
Instalar el píxel no convierte automáticamente una acción en conversión. El evento que envía tu web debe coincidir con la conversión que configuras en Ads Manager.
Evento de la web: order_created Ads Manager: order_created Evento de la web: quote_requested Ads Manager: Personalizado → quote_requested
En los eventos personalizados el nombre debe coincidir exactamente: un nombre parecido no basta. Los nombres van en snake_case en minúsculas (order_created, no orderCreated).
Paso 3 — Medir compras
En ecommerce, el evento de compra es la conversión que más importa. Envíalo cuando el pedido se confirma:
oaiq("measure", "order_created", {
type: "contents",
amount: 2599,
currency: "USD",
contents: [
{
id: "SKU-123",
name: "Paquete inicial",
content_type: "product",
quantity: 1
}
]
}, {
event_id: "order_12345"
});order_created es el nombre del evento, amount y currency describen el valor, contents lleva los productos comprados y event_id es tu identificador único para la deduplicación. Consulta el esquema de eventos admitidos en la documentación de OpenAI para el contrato exacto de campos.
Paso 4 — Medir leads
Para sitios de generación de leads, envía un evento de lead cuando se envía el formulario:
oaiq("measure", "lead_created", {
type: "customer_action"
}, {
event_id: "lead_98765"
});Paso 5 — Eventos de conversión personalizados
No toda conversión es una compra o un lead. Solicitudes de demo, de presupuesto, calculadoras completadas, solicitudes de alta o consultas reservadas encajan en un evento personalizado:
oaiq("measure", "custom", {
type: "custom"
}, {
custom_event_name: "quote_requested"
});Configura en Ads Manager el mismo nombre de evento personalizado. Los nombres admiten letras, números, guiones bajos y guiones (de 1 a 64 caracteres) y no deben chocar con el nombre de un evento estándar.
Coincidencia Avanzada Automática
Cuando no hay un identificador de clic que conecte una conversión, el Coincidencia Avanzada Automática (AAM) puede mejorar la medición con información de cliente de primera parte elegible — por ejemplo, campos de formulario reconocibles. El píxel normaliza y cifra esa información con SHA-256 dentro del navegador.
No necesitas cifrar los correos a mano. En la configuración estándar del Coincidencia Avanzada Automática, la guía actual de OpenAI es que no hace falta ningún cambio adicional en el píxel, y la información de cliente en claro no se envía a OpenAI a través de AAM.
oppref: la referencia de clic que lo conecta todo
oppref es la señal de referencia de clic de OpenAI, que se añade a las URLs de destino de ChatGPT Ads:
https://example.com/producto?oppref=gAAAAAb123
El píxel guarda ese valor en una cookie de primera parte, de modo que las páginas posteriores y los eventos de conversión sigan conectados con la interacción original del anuncio. Cuando envíes eventos de la Conversions API, conservar oppref cuando esté disponible mejora la calidad de la medición.
Regla práctica: cuando crees redirecciones, routing de aterrizaje o un sistema de tracking propio, nunca elimines oppref de la URL.
Deduplicación con la Conversions API
Si usas los dos canales, un mismo pedido llega a OpenAI dos veces — una desde el píxel del navegador y otra desde tu servidor. OpenAI detecta los duplicados con el ID de píxel, el nombre del evento y el event_id:
Pedido ORD-10001 ├── Píxel del navegador ──→ event_id = ORD-10001 └── CAPI del servidor ────→ event_id = ORD-10001 OpenAI conserva el primero e ignora el duplicado.
Genera el event_id una sola vez (un ID de pedido real funciona muy bien) y reutiliza exactamente el mismo valor en la llamada del píxel y en la del servidor.
Configuración con Google Tag Manager
Google Tag Manager es una forma admitida de desplegar el píxel — siempre que el gestor no bloquee ni reordene la inicialización y las llamadas de evento. Organiza tu contenedor en torno a tres etiquetas:
- Etiqueta 1 — Base del píxel de OpenAI: la etiqueta de inicialización que se carga en todas las páginas (ejecuta el píxel con tu ID).
- Etiqueta 2 — Compra del píxel de OpenAI: se dispara en el evento de compra/pedido confirmado usando el data layer.
- Etiqueta 3 — Lead del píxel de OpenAI: se dispara al enviar el formulario de lead.
Mapea los eventos de tu data layer existente para que el píxel se dispare con los mismos triggers que el resto de tu analítica.
Configuración en WooCommerce
En WooCommerce el embudo de conversión suele ser: producto visto → añadir al carrito → checkout iniciado → pedido creado. El evento del pedido es la conversión de negocio.
WooCommerce
↓
Pedido creado
↓
Generar ID de pedido único
↓
Píxel del navegador ────┐
├── Anuncios de OpenAI (mismo event_id)
CAPI del servidor ──────┘Usa el ID del pedido de WooCommerce como event_id: un valor realmente único hace fiable la deduplicación. En WordPress, el plugin gratuito Ridoway Pixel se encarga del píxel, de la llamada de servidor y de la deduplicación con event_id automáticamente.
Consentimiento y privacidad
Antes de implementar el tracking, revisa los requisitos de consentimiento de tu país, de la jurisdicción de tus usuarios y de tu política de privacidad. La guía de OpenAI es clara: debes informar con claridad del dato que recopilas y, donde la ley lo exija, obtener el consentimiento adecuado antes de enviar datos de conversión.
- Publica una política de privacidad y una declaración de cookies/tracking.
- Conecta una gestión de consentimiento cuando sea necesario (RGPD, ePrivacy y equivalentes).
- Define la retención de datos y qué canales pueden recibir eventos.
- Recuerda que el SDK se inicializa con consentimiento activado por defecto y admite oaiq("consent", false) antes de init.
¿No aparecen las conversiones? Solución de problemas en orden
Que el píxel se dispare no significa que Ads Manager muestre una conversión de inmediato. Revisa en este orden:
- ¿Se inicializa el píxel? — Mira en DevTools/Redes si el SDK se carga desde bzrcdn.openai.com.
- ¿ID de píxel correcto? — Un ID equivocado envía eventos a otra fuente de datos y tu columna se queda vacía.
- ¿Coincide el nombre del evento? — El evento de la web debe coincidir exactamente con la conversión configurada (ortografía exacta para eventos personalizados).
- ¿Conversión asociada? — La campaña debe tener configurado un evento de conversión creado a partir de tus eventos.
- ¿Se conserva oppref? — Perder las referencias de clic empeora la calidad de la atribución.
- ¿Deduplicación correcta? — Los eventos del navegador y del servidor de una misma conversión deben compartir un solo event_id.
- Retraso de los informes — OpenAI indica que las conversiones atribuidas pueden tardar de 24 a 48 horas en aparecer en Ads Manager.
Una forma rápida de ver si el píxel se dispara es el comprobador gratuito ChatGPT Ads Pixel Checker; la extensión Pixel Helper muestra en vivo cada llamada init y measure.
Por qué Ads Manager y Google Analytics difieren
Que los totales de conversión no coincidan entre plataformas es normal. Los anuncios de OpenAI y Google Analytics no usan la misma metodología de atribución. Las diferencias vienen de las ventanas de atribución, las marcas de tiempo, las zonas horarias, el consentimiento, las restricciones del navegador, la disponibilidad de almacenamiento, la deduplicación, la configuración de campañas y la medición modelada.
Anuncios de OpenAI: 100 conversiones Google Analytics: 82 conversiones
Una brecha así no demuestra que el píxel esté roto. OpenAI admite que los totales pueden diferir entre plataformas de analítica.
Informes y ventanas de atribución actuales
En el Ads Manager actual (Beta), los anunciantes ven impresiones, clics, gasto, CTR, CPC medio, CPM medio y, cuando la medición está configurada, conversiones. Las conversiones por clic y las de vista elegibles se informan por separado. A fecha de septiembre de 2026, las combinaciones de ventana de atribución disponibles incluyen:
| Por clic | Ventanas de clic de 7, 14 y 30 días |
| Por vista | Ventanas de vista de 0 y 1 días |
Como los informes y la atribución siguen evolucionando con el Beta del Ads Manager, verifica las ventanas y métricas actuales en la documentación de OpenAI antes de tomar decisiones de optimización.
La arquitectura de medición completa
Un montaje moderno y resistente combina los dos canales en un solo flujo:
ANUNCIOS EN CHATGPT
│
▼
Clic en el anuncio
│
▼
Página de destino (oppref)
│
┌───────────┴───────────┐
▼ ▼
Píxel de OpenAI Web / Servidor
│ │
│ Evento de conversión
│ │
▼ ▼
Navegador Conversions API
│ │
└───────────┬───────────┘
│
Mismo event_id
│
▼
Medición de OpenAI
│
▼
Ads Manager
│
┌────────────┼────────────┐
▼ ▼ ▼
Clics Conversiones ROASEsa es la arquitectura completa en una imagen: un clic, dos canales de eventos, un event_id compartido y una única superficie de informes en Ads Manager.
Socios de medición
OpenAI también admite socios de medición externos si prefieres una capa de atribución, informes u optimización ajena. Ejemplos documentados a fecha de septiembre de 2026: Fospha, Hightouch, LiveRamp, Triple Whale y WorkMagic. Para medición móvil se documentan las integraciones con AppsFlyer, Adjust y Branch. Las capacidades varían según el socio.
Buenas prácticas
- Instala el píxel en todas las páginas donde importe la conversión, no solo en la portada.
- Nunca elimines oppref en redirecciones, routing o tracking propio.
- Combina píxel + Conversions API cuando sea técnicamente y de negocio apropiado.
- Reutiliza el mismo event_id para la misma conversión en el navegador y el servidor.
- Haz coincidir exactamente los nombres de los eventos de conversión — sobre todo los personalizados.
- Entiende el Coincidencia Avanzada Automática: en la configuración estándar no cifras datos a mano.
- Espera un retraso de informe de 24–48 horas antes de juzgar los números del fin de semana.
- No compares a ciegas Ads Manager, GA4 y otras plataformas — las metodologías de atribución difieren.
Preguntas frecuentes
¿Cómo consigo el píxel de anuncios de ChatGPT?
Abre el Ads Manager de OpenAI, entra en Medición y crea una fuente de datos. Ads Manager te dará un ID de píxel (empieza por pId_) y un código JavaScript. Instala ese código en las páginas donde ocurren las conversiones y configura después el evento de conversión que quieras medir.
¿Dónde instalo el código del píxel de OpenAI en mi web?
En el <head> de cada página donde quieras medir conversiones. El código oficial carga el SDK de forma asíncrona desde bzrcdn.openai.com y lo inicializa con tu ID de píxel, por lo que no bloquea la carga de la página. Si usas un gestor de etiquetas o un plugin, las etiquetas de inicialización van en todas las páginas.
¿Hace falta la Conversions API si ya uso el píxel?
No es obligatoria, pero es recomendable para los eventos que más importan. El píxel captura los eventos en el navegador; la Conversions API envía las mismas categorías desde tu servidor, lo que evita bloqueadores de anuncios y sesiones perdidas. Si usas ambas, reutiliza el mismo event_id en cada lado para que OpenAI los deduplique.
¿Por qué mis conversiones aparecen tarde o no aparecen en Ads Manager?
Los informes no son en tiempo real. OpenAI indica que las conversiones atribuidas pueden tardar de 24 a 48 horas en aparecer. Antes de sospechar del píxel, revisa: el píxel se inicializa con el ID correcto, el nombre del evento coincide con la conversión configurada, la campaña tiene una conversión asociada y se conserva oppref en la URL de destino.
¿Qué es oppref y debo mantenerlo en la URL?
oppref es la referencia de clic que OpenAI añade a la URL de destino de los anuncios de ChatGPT. El píxel la guarda en una cookie de primera parte para que los eventos de conversión posteriores sigan conectados con ese clic. No elimines oppref en redirecciones ni rutas personalizadas, o la calidad de la atribución empeorará.
¿Puedo enviar la misma conversión desde el navegador y desde el servidor?
Sí, y es la arquitectura recomendada para los eventos de dinero. Envía la compra desde el píxel y desde la Conversions API usando exactamente el mismo event_id (por ejemplo, el ID del pedido). OpenAI hace coincidir el ID de píxel, el nombre del evento y el event_id, y conserva la primera que recibe.
¿El Coincidencia Avanzada Automática obliga a cifrar los correos a mano?
No. En la implementación estándar, OpenAI indica que el Coincidencia Avanzada Automática (AAM) cifra en el navegador con SHA-256 la información de cliente admitida y la envía ya cifrada. No necesitas precifrar ni inyectar datos de cliente manualmente para que funcione.
¿Qué eventos conviene medir primero?
Empieza por los eventos que realmente optimizan tu campaña: order_created para compras de ecommerce, lead_created para generación de leads, registration_completed para registros, o un evento personalizado como quote_requested. Ads Manager debe estar configurado para contar el mismo nombre de evento que envías.
Olvídate de pegar código en WordPress
El plugin gratuito Ridoway Pixel instala el píxel en todo el sitio, envía los eventos de dinero desde el servidor y gestiona la deduplicación con event_id por ti.