Prueba de Eventos de Facebook Pixel y CAPI Usando Facebook Events Manager
Introducción
Probar tus eventos de Facebook Pixel y API de Conversiones (CAPI) usando la herramienta de Eventos de Prueba en Events Manager es una forma efectiva de validar que tu tienda PrestaShop esté enviando tanto eventos del navegador como del lado del servidor (CAPI) correctamente.
Este método es particularmente útil para probar eventos complejos que pueden no aparecer siempre en Pixel Helper, tales como:
- Initiate Checkout
- Add Payment Info
- Retrasos en el Seguimiento de Eventos Purchase
Esta guía te mostrará el proceso paso a paso para habilitar el modo de prueba y analizar eventos en la herramienta de Eventos de Prueba de Meta.
Paso 1: Obtener el Código de Evento de Prueba de Events Manager
Para comenzar las pruebas, primero necesitas obtener el Código de Evento de Prueba de Events Manager de Facebook.
📌 Cómo Obtener el Código de Prueba
- Ve a Meta Business Suite: Inicia sesión en Meta Business Manager.
- Abre Events Manager: Navega a Events Manager.
- Selecciona Tu Pixel: Elige el ID del Pixel usado en tu tienda PrestaShop.
- Ve a la Pestaña "Eventos de Prueba": Haz clic en la sección Eventos de Prueba.
- Copia el Código de Evento de Prueba:
- Verás un código de prueba único, generalmente formateado como
TESTXXXXXXXXXX(dondeXXXXXXXXXXes un número aleatorio). - Haz clic en Copiar.
- Verás un código de prueba único, generalmente formateado como
📌 Nota: Este código es temporal y solo funciona mientras la herramienta de Eventos de Prueba esté abierta.
Paso 2: Habilitar el Modo de Prueba en el Módulo Pixel Plus
Ahora que tienes el Código de Evento de Prueba, necesitas ingresarlo en el módulo Pixel Plus para PrestaShop.
📌 Cómo Habilitar el Modo de Prueba en el Módulo
- Ve al Back Office de PrestaShop.
- Navega a Módulos > Pixel Plus > Configuración de API de Conversiones (CAPI).
- Encuentra el Campo de Eventos de Prueba:
- Desplázate hacia abajo para encontrar una configuración etiquetada como "Código de Eventos de Prueba" (o similar).
- Pega el Código de Evento de Prueba que copiaste de Events Manager.
- Restringe las Pruebas a Tu IP:
- Localiza el cuadro "Limitar Registro a IPs Específicas".
- Haz clic en "Añadir Mi IP" para agregar automáticamente tu dirección IP actual.
- Esto asegura que solo tus acciones sean registradas, evitando datos innecesarios.
- Habilita el Modo de Prueba en el Módulo:
- Debajo del cuadro de IP, encuentra la opción que permite habilitar el modo de prueba.
- Configúrala en "Sí" para activar el registro de eventos de prueba.
- Haz Clic en Guardar para aplicar los cambios.
🔍 ¿Por Qué Restringir las Pruebas a Tu IP?
- Evita que los registros de eventos se llenen con acciones de clientes reales.
- Asegura que solo tus acciones sean registradas para análisis.
Paso 3: Activar Eventos de Prueba desde Tu Tienda
Ahora que el Modo de Prueba está habilitado, es momento de simular acciones de clientes en tu tienda PrestaShop.
📌 Cómo Abrir Tu Tienda en Modo de Prueba
- Regresa a Events Manager en Meta Business Suite.
- Busca la URL de Eventos de Prueba:
- Meta sugerirá el dominio de tu tienda (ej.,
https://tutienda.com). - Haz clic en la URL de tu tienda.
- Meta sugerirá el dominio de tu tienda (ej.,
- Se Abrirá una Nueva Pestaña: Esta pestaña ahora está vinculada a la herramienta de Eventos de Prueba.
- Realiza Acciones en Tu Tienda:
- Ver un producto.
- Añadir un producto al carrito.
- Iniciar el proceso de pago.
- Simular una compra.
Paso 4: Analizar los Eventos en Events Manager
Una vez que hayas realizado acciones en tu tienda PrestaShop, regresa a Events Manager para analizar los datos entrantes.
📌 Cómo Aparecen los Eventos en la Herramienta de Prueba
- Eventos del Navegador (basados en Pixel) → Aparecen casi instantáneamente.
- Eventos del Servidor (basados en CAPI) → Toman unos segundos a un minuto para aparecer.
Identificar Eventos Deduplicados
Facebook agrupa automáticamente eventos del navegador y del servidor coincidentes. Puedes identificar fácilmente:
- Evento del Navegador (enviado vía Pixel).
- Evento del Servidor (enviado vía CAPI).
- ID del Evento (usado para deduplicación).
Verificar Datos Adicionales
Haz clic en un evento para expandir los detalles. Verás:
- ID del Evento → Asegura que las versiones del navegador y del servidor estén correctamente vinculadas.
- Datos del Usuario → Detalles hasheados enviados para mejor seguimiento.
- Parámetros Personalizados → Ejemplo: ID del producto, precio, categoría.
Paso 4: Verificar si Facebook Recibió el Evento a través de CAPI
Después de un tiempo, deberías ver el evento de dos fuentes, el pixel y el servidor. Si el segundo no aparece incluso después de esperar unos minutos, una configuración de rendimiento en el módulo podría ser el "culpable".
El módulo usa un nuevo sistema para enviar los eventos de forma asíncrona. Este sistema funciona bien en el 95% de los servidores, pero en algunos los eventos no pasan.
Si no ves el evento en Events Manager, hay una alta probabilidad de que esta configuración te esté afectando. Para desactivar su uso solo necesitas un minuto.
Desactivar Multi-cURL
- Ve a la página de configuración del módulo.
- Abre la sección CAPI y desplázate hasta el final.
- Habilita la opción para desactivar el uso de multi-cURL.
- Guarda los cambios y vuelve a intentar enviar los eventos.
Paso 5: Confirmar que los Eventos Son Enviados por Pixel Plus
Al verificar cualquier evento (navegador o servidor), Pixel Plus siempre incluye un parámetro específico:
"event_trigger": "Pixel Plus"
✅ Si ves el campo
event_trigger: "Pixel Plus"en los detalles del evento, confirma que el evento fue activado por el módulo Pixel Plus.
Si este campo falta, es posible que:
- Otro módulo
- Código JavaScript manual (ej., llamadas
fbq()) - Administradores de etiquetas como GTM
estén enviando eventos independientemente.
Esta verificación es crítica para evitar seguimiento duplicado y asegurar datos limpios.
También ayuda a identificar eventos potencialmente duplicados o eventos enviados desde fuentes externas que pueden causar problemas con el seguimiento. Consulta nuestra guía Detectar Fuentes Externas que Envían Eventos para más información.
Paso 6: Algunos Eventos Solo Son Visibles en la Herramienta de Eventos de Prueba
Ciertos eventos — como "Initiate Checkout" y "Add Payment Info" — pueden no aparecer siempre en Meta Pixel Helper.
Esto sucede porque:
- Se activan del lado del servidor (vía CAPI).
- Algunos navegadores o configuraciones de privacidad bloquean el seguimiento del lado del cliente.
✅ Sin embargo, estos eventos aparecerán correctamente en la herramienta de Eventos de Prueba dentro de Facebook Events Manager.
🔍 Importante: Si no ves un evento en Pixel Helper, siempre verifica la herramienta de Eventos de Prueba antes de asumir que algo está mal.
Paso 7: Qué Hacer Si No Aparecen Eventos del Servidor
Si, después de realizar acciones en tu tienda, no ves eventos del lado del servidor apareciendo en la herramienta de Eventos de Prueba, sigue estos pasos para solucionar problemas:
📋 Lista de Verificación a Revisar
-
Verifica tu configuración de Pixel Plus:
- Asegúrate de que el Código de Prueba esté correctamente pegado en el campo "Código de Eventos de Prueba".
- Confirma que "Habilitar Eventos de Código de Prueba" esté configurado en Sí.
-
Asegúrate de haber guardado la configuración:
- Después de pegar el código y habilitar la opción, siempre haz clic en Guardar para aplicar los cambios.
-
Verifica la Configuración de Restricción de IP:
- Si agregaste tu IP en "Limitar Pruebas por IP", confirma que esté correctamente detectada.
- Esta restricción ayuda a evitar mezclar tus pruebas con el tráfico de clientes.
-
Considera las Diferencias de IP entre Servidor y Usuario:
- En algunas configuraciones (ej., proxies inversos, balanceadores de carga, Cloudflare), la dirección IP que ve Facebook podría no coincidir con tu IP real.
- Si sospechas que este es el caso:
- Desactiva temporalmente la restricción de IP.
- Realiza tu prueba rápidamente.
- Ten en cuenta que sin restricción, podrían aparecer eventos externos adicionales en el registro.
🚨 Importante: Solo desactiva la restricción de IP temporalmente durante las pruebas. Vuelve a habilitarla después para mantener datos de prueba limpios.
📈 Por Qué Podrían Faltar Eventos del Servidor
Si faltan eventos del servidor, generalmente significa:
- El Modo de Prueba no se activó completamente.
- El Código de Prueba faltaba o no se guardó correctamente.
- La restricción de IP estaba evitando que el evento se registrara.
Después de corregir la configuración, repite las acciones de tu tienda (ej., ver un producto, añadir al carrito, iniciar pago) y verifica nuevamente en la herramienta de Eventos de Prueba.
Conclusión
Siguiendo esta guía, puedes probar y depurar eventos de Facebook Pixel y CAPI en PrestaShop usando la Herramienta de Eventos de Prueba de Events Manager.
🎯 Lo Que Lograste:
✔ Obtuviste el Código de Evento de Prueba de Facebook ✔ Habilitaste el Modo de Prueba en el módulo Pixel Plus ✔ Abriste tu tienda PrestaShop en modo de prueba ✔ Verificaste eventos en la herramienta de Eventos de Prueba de Facebook ✔ Confirmaste que los eventos estén correctamente atribuidos a Pixel Plus ✔ Comparaste eventos del navegador y del servidor para deduplicación ✔ Identificaste eventos difíciles de rastrear más allá de la detección de Pixel Helper
🚀 Consejo Final: Recuerda desactivar la opción de código de prueba después de completar tus pruebas para evitar falsos positivos o alertas engañosas de Facebook.