Saltar al contenido principal

Prueba de Eventos de Facebook Pixel y CAPI en PrestaShop

Introducción​

Probar tus eventos de Facebook Pixel y API de Conversiones (CAPI) es crucial para asegurar un seguimiento adecuado de eventos y deduplicación en tu tienda PrestaShop. Esta guía te mostrará dos métodos:

  1. Usar la Extensión Pixel Helper de Google Chrome para verificar eventos del navegador.
  2. Usar la Función de Registro de PrestaShop dentro de la sección CAPI del módulo Pixel Plus para registrar eventos del lado del servidor.

Siguiendo esta guía, puedes confirmar que:

✅ Los eventos se activan correctamente en el navegador. ✅ Los eventos del lado del servidor se registran y procesan. ✅ La deduplicación funciona como se espera.

Paso 1: Instalar la Extensión Facebook Pixel Helper​

Para probar eventos del navegador, necesitas instalar Meta Pixel Helper, una extensión de Google Chrome.

Instrucciones de Instalación:​

  1. Abre Google Chrome.
  2. Visita la extensión Meta Pixel Helper.
  3. Haz clic en "Añadir a Chrome", luego en "Añadir Extensión".
  4. Una vez instalada, verás el icono de Pixel Helper en la barra de herramientas de Chrome.

💡 Consejo: Si no ves el icono de Pixel Helper, haz clic en el menú de extensiones (icono de puzzle) y fíjalo.

Paso 2: Activar el Registro de Eventos CAPI en PrestaShop​

Para verificar eventos del lado del servidor (CAPI), usa la función de registro en el módulo Pixel Plus.

Cómo Activar el Registro CAPI:​

  1. Ve al Back Office de PrestaShop.
  2. Navega a Módulos > Pixel Plus > Configuración de API de Conversiones.
  3. Encuentra la opción "Activar Registro de Eventos."
  4. Configúrala en "Sí".
  5. (Recomendado) Restringir el Registro 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.
    • Esto asegura que los registros solo se guarden para tus pruebas, evitando la recopilación innecesaria de datos.
  6. Guarda la configuración.

Funciones Adicionales de Registro:​

  • Ver Eventos Registrados en PrestaShop: Una vez activado, los eventos se almacenarán en la sección de registros de PrestaShop, ayudándote a analizar lo que se envía a Facebook.
  • Campos Clave a Verificar:
    • events_received → Indica cuántos eventos ha recibido Facebook exitosamente.
    • fbtrace → Un token de seguimiento único de Facebook. Esto confirma que Facebook procesó el evento.

🛑 Si estos campos faltan en los registros, ¡Facebook no está recibiendo tus eventos! Verifica tu configuración CAPI.

Paso 3: Comenzar a Generar Eventos​

Ahora que la extensión Pixel Helper está instalada y el registro CAPI está activado, sigue estos pasos para probar tus eventos Pixel del navegador.

  1. Abre tu tienda PrestaShop en Chrome.
  2. Haz clic en el icono de Pixel Helper en la barra de herramientas.
  3. El Pixel Helper mostrará todos los eventos de Facebook Pixel activados en la página.
  4. Haz clic en cada evento para verificar:
    • Nombre del Evento (ej., PageView, AddToCart, Purchase).
    • ID del Pixel (Debe coincidir con el configurado en el módulo Pixel Plus).
    • Advertencias o errores (si los hay).

📌 Expandir Detalles del Evento para Más Información​

Haz clic en el triángulo negro (▸) junto a un evento para expandir sus detalles. Esto revela:

  • ID del Evento (usado para deduplicación con eventos CAPI).
  • Parámetros de datos del usuario (ej., email, número de teléfono, hasheados por privacidad).
  • Parámetros personalizados (ej., ID del producto, precio).
  • Diagnósticos (advertencias sobre parámetros faltantes o mal configurados).

⚠️ Problema Común: Si Pixel Helper no muestra eventos, asegúrate de que:

  • El ID del Facebook Pixel esté correctamente configurado.
  • Ningún bloqueador de anuncios esté bloqueando el script.
  • El Pixel se active en la página.
  • El módulo no esté siendo bloqueado por un módulo/sistema de gestión de consentimiento

🛑 Consejo de Solución de Problemas: Si los eventos desaparecen después de poco tiempo, intenta activar un evento, cambiar a otra pestaña, y luego volver a revisar el registro de Pixel Helper.

Paso 4: Verificar Si Facebook Recibió el Evento (CAPI)​

Facebook proporciona parámetros de confirmación que indican si el evento fue recibido.

📌 Campos Importantes a Verificar en los Registros de PrestaShop​

  • events_received → Indica cuántos eventos recibió Facebook.
  • fbtrace → Un token de seguimiento único de Facebook que confirma el procesamiento del evento.

⚠️ Si events_received falta:

  • Multi-cURL podría estar causando problemas.
  • Desactiva multi-cURL dentro de las opciones CAPI (última opción en la configuración).
  • Guarda los cambios y vuelve a intentar enviar los eventos.

Paso 5: Comparar Eventos del Navegador y del Servidor para Deduplicación​

Ahora que Pixel Helper (navegador) y registros CAPI (servidor) están activos, compara los resultados.

✅ Qué Buscar:​

  • El mismo evento (ej., Purchase) debería aparecer en ambos:
    • Pixel Helper (navegador)
    • Registros CAPI (servidor)

Esto conducirá a la deduplicación de eventos, lo que significa que solo el evento más significativo será conservado por Facebook. Para que esto ocurra, es necesario que:

  • El ID del Evento en Pixel Helper y los registros CAPI coincidan.

Cómo Verificar la Deduplicación:​

  1. Abre Pixel Helper y expande los detalles del evento.
  2. Busca el ID del Evento.
  3. Abre los registros CAPI de PrestaShop y encuentra el mismo evento.
  4. Compara el ID del Evento en ambos lugares.
  5. Si coinciden, Facebook deduplicará el evento y optimizará según la fuente más confiable.

⚠️ ¡Pixel Helper Puede Ocultar Eventos con el Tiempo! Si el evento desaparece:

  • Activa el evento nuevamente (ej., añade un producto al carrito).
  • Cambia a otra pestaña.
  • Regresa a Pixel Helper para verificar si los registros de eventos aún están disponibles.

Conclusión​

Siguiendo esta guía, puedes probar y depurar tus eventos de Facebook Pixel y API de Conversiones en PrestaShop.

Lo Que Lograste:​

✔ Verificaste que los eventos del navegador se activen usando Pixel Helper. ✔ Activaste el registro de eventos CAPI y lo restringiste a tu IP. ✔ Comparaste eventos del navegador y del servidor para confirmar la deduplicación.

🚀 Siguiente Paso: Si aún experimentas problemas, verifica las Herramientas de Depuración de Facebook o revisa las configuraciones de CAPI y Pixel dentro del módulo Pixel Plus.

Para más detalles, visita la Guía Oficial de Depuración de Eventos de Facebook.