Saltar al contenido principal

Configuración de la API de Conversiones (CAPI) para PrestaShop

Introducción​

La API de Conversiones de Facebook (CAPI) permite el seguimiento de eventos de servidor a servidor, asegurando que todas las interacciones clave de los clientes en tu tienda PrestaShop se capturen con precisión, incluso cuando el seguimiento del navegador es limitado. Esta guía explica cómo configurar el módulo Pixel Plus para PrestaShop para enviar eventos usando la API de Conversiones.

Habilitar la API de Conversiones​

El primer paso para configurar la API de Conversiones (CAPI) es habilitarla en el módulo Pixel Plus para PrestaShop.

  1. Navega a la configuración del módulo en tu back office de PrestaShop.
  2. Localiza la opción "Habilitar API de Conversiones".
  3. Selecciona "Sí" para activar CAPI.
  4. Guarda la configuración.

Nota: Si esta opción está deshabilitada, no se enviarán eventos a través de la API de Conversiones de Facebook, y todo el seguimiento dependerá únicamente del Pixel de Facebook basado en el navegador.

Agregar el Token de Acceso de la API de Conversiones​

Cómo Obtener el Token de Acceso de Facebook​

Para enviar eventos a través de CAPI, Facebook requiere un Token de Acceso. Sigue estos pasos para obtener tu token:

  1. Ve a Facebook Business Manager: Inicia sesión en Facebook Business Manager.
  2. Abre el Administrador de Eventos: Navega a la sección Administrador de Eventos.
  3. Selecciona tu Pixel: Elige el Pixel que deseas configurar.
  4. Ve a Configuración: Desplázate hacia abajo hasta la sección API de Conversiones.
  5. Genera el Token de Acceso:
    • Haz clic en el enlace "Generar Token de Acceso".
    • Haz clic una vez para generar el token.
    • Haz clic nuevamente para copiar el token.
  6. Pega el Token en PrestaShop:
    • Regresa a tu back office de PrestaShop.
    • En el módulo Pixel Plus, pega el Token de Acceso en el campo correspondiente.
    • Guarda la configuración.

Importante: Si no se proporciona un token de acceso, no se enviarán eventos de la API de Conversiones.

Código de Prueba para Depuración​

Facebook permite probar eventos de la API de Conversiones antes de ponerlos en producción. La herramienta de prueba ayuda a verificar que los eventos estén configurados correctamente.

Cómo Obtener el Código de Prueba de Facebook:​

  1. Abre el Administrador de Eventos de Facebook.
  2. Navega a la sección "Eventos de Prueba".
  3. Haz clic en "Código de Prueba para la API de Conversiones".
  4. Copia el Código de Prueba generado.
  5. Pega el Código de Prueba en el módulo Pixel Plus bajo el campo "Código de Prueba".
  6. Guarda la configuración.

Para deshabilitar el modo de prueba, deja el campo vacío.

Recordatorio: Este código es solo para propósitos de prueba y debe eliminarse antes de ponerlo en producción.

Opciones de Coincidencia Avanzada​

La función de Coincidencia Avanzada mejora el seguimiento de eventos al ayudar a Facebook a emparejar con precisión las interacciones de los usuarios. Ayuda a prevenir eventos duplicados cuando se usan tanto el Pixel de Facebook como la API de Conversiones.

Cómo Funciona:​

  • Cuando está habilitado, los eventos del Pixel de Facebook y CAPI se emparejan usando datos hash adicionales.
  • Esto reduce el seguimiento de eventos duplicados y mejora la precisión de los informes.
  • Recomendado para tiendas PrestaShop que ejecutan múltiples configuraciones de seguimiento.

Consideraciones de Privacidad:​

  • Si está habilitado, menciónalo en tu Política de Privacidad para cumplir con las regulaciones de datos.

Elegir Datos para la Coincidencia Avanzada​

El módulo Pixel Plus para PrestaShop te permite especificar qué datos de usuario deben enviarse a Facebook para la Coincidencia Avanzada.

Opciones de Datos Disponibles:​

✔ Datos de Contacto del Usuario (Correo electrónico, Teléfono) ✔ Datos Personales del Usuario (Nombre, Apellido, Género, Fecha de nacimiento) ✔ Datos de Dirección del Usuario (Ciudad, Estado, País, Código Postal)

Cómo Configurar en PrestaShop:

  1. En la configuración del módulo Pixel Plus, localiza la sección "Datos de Opciones Avanzadas".
  2. Selecciona los tipos de datos de usuario a enviar.
  3. Guarda la configuración.

Nota: El módulo solo enviará los datos disponibles. Si el usuario no ha iniciado sesión o no ha ingresado ciertos detalles, esos campos no se enviarán.

Comprender el Sistema de Puntuación de Facebook​

Facebook (Meta) usa un sistema de puntuación para medir la calidad de los eventos recibidos. El módulo Pixel Plus para PrestaShop busca lograr la mejor calidad de coincidencia posible.

  • Eventos no relacionados con pedidos con una puntuación de 4+ ya se consideran buenos.
  • Eventos relacionados con pedidos deben tener una puntuación de 8 o superior.
  • Las puntuaciones rara vez superan 9.5, incluso con configuraciones óptimas.

Conclusión​

La integración de la API de Conversiones (CAPI) en el módulo Pixel Plus para PrestaShop garantiza un seguimiento preciso de eventos, incluso cuando falla el seguimiento del navegador. Al configurar la Coincidencia Avanzada, agregar el Token de Acceso y usar el Código de Prueba, puedes optimizar el rendimiento de tus anuncios de Facebook y prevenir eventos duplicados.

Para más detalles, visita la Documentación Oficial de la API de Conversiones de Facebook.

¿Qué es la API de Conversiones y por qué debo usarla?

La API de Conversiones envía datos de eventos directamente desde tu servidor a Meta, evitando las limitaciones del navegador y los bloqueadores de anuncios. Esto garantiza que eventos como Purchase sean rastreados incluso cuando el Pixel del navegador falla o está bloqueado.

¿Dónde obtengo el Token de Acceso de CAPI?

Inicia sesión en Facebook Business Manager, abre el Administrador de Eventos, selecciona tu Pixel, ve a Configuración y desplázate hasta la sección API de Conversiones. Haz clic en Generar Token de Acceso y copia el resultado en el módulo Pixel Plus.

¿Qué ocurre si dejo el Token de Acceso vacío?

Si no hay Token de Acceso configurado, Pixel Plus no enviará ningún evento a través de la API de Conversiones. Todo el seguimiento dependerá únicamente del Pixel del navegador, que puede ser bloqueado por extensiones de privacidad o bloqueadores de anuncios.

¿Para qué sirve el campo Código de Prueba?

El campo Código de Prueba vincula tus eventos de CAPI con la herramienta Test Events de Facebook para que puedas verificar que los eventos llegan correctamente antes de activarlos en producción. Déjalo vacío en producción para evitar datos falsos en tus informes.

¿Activar la Coincidencia Avanzada ayuda con la deduplicación?

Sí. Cuando tanto el Pixel del navegador como la CAPI envían el mismo evento con datos de usuario coincidentes, Meta puede deduplicarlos y contar solo una conversión. La Coincidencia Avanzada mejora la precisión de este proceso.