Documentación sobre el píxel de Facebook de CC Meta
Documentación completa sobre el plug-in cc_facebook_pixel.Índice
1. introducción
2. instalación
3. activación de la licencia
4 Configuración básica
5. modos de seguimiento
6. seguimiento en el servidor
7 Cola de eventos
8 Eventos personalizados
9. Adaptación avanzada
10. depuración
11 Solución de problemas
12. PREGUNTAS FRECUENTES
1. introducción
CC Facebook Pixel es un plugin profesional para WordPress que permite la integración completa del sitio con la API de píxeles y conversiones de Facebook. Permite realizar un seguimiento de la actividad del usuario tanto en el navegador como en el servidor, lo que posibilita un seguimiento de las conversiones más preciso y fiable, incluso cuando los usuarios utilizan bloqueadores de anuncios.El plug-in permite un control total sobre:
- Integración con Facebook Pixel a través de JavaScript y/o Conversions API
- seguimiento de eventos estándar (PageView, ViewContent, etc.)
- creación y realización de eventos personalizados
- cotejo avanzado de los datos de los usuarios
- cola de eventos para un rendimiento óptimo
- depuración y pruebas de integración
2. instalación
Requisitos del sistema- WordPress 5.0 o superior
- PHP 7.0 o posterior
- Descargue el archivo ZIP del plug-in desde la tienda oficial
- Acceda al panel de administración de WordPress
- Ir a: Plug-ins > Añadir nuevo > Enviar plug-in
- Seleccione el archivo ZIP descargado y haga clic en "Instalar ahora".
- Una vez finalizada la instalación, haga clic en "Activar complemento".
3. activación de la licencia
Es necesario activar la licencia antes de utilizar el plug-in:- Tras la instalación, vaya a la página Configuración > Píxel de Facebook
- Haga clic en la pestaña Licencia
- Introduzca la clave de licencia recibida tras la compra
- Haga clic en "Activar licencia".
- Tras la activación, aparecerá un mensaje de confirmación.
Advertencia
Sin una licencia activa, el plug-in funcionará en modo restringido, sin posibilidad de editar los ajustes ni configurar el seguimiento.
4 Configuración básica
Para configurar los ajustes básicos del plug-in:- Ir a: Configuración > Píxel de Facebook
- En la sección "Configuración principal", introduce tu ID de píxel de Facebook
- Seleccione el modo de seguimiento (Sólo navegador, Sólo servidor, Híbrido)
- Activar o desactivar eventos estándar
- Haga clic en "Guardar cambios".
// Przykładowy Facebook Pixel ID
123456789012345Consejo
El ID del píxel de Facebook se puede encontrar en el administrador de eventos de Facebook, en la sección de configuración de píxeles.
5. modos de seguimiento
El plug-in ofrece tres modos de seguimiento que pueden seleccionarse en función de sus necesidades:Sólo navegador (píxel JavaScript)
En este modo, los eventos sólo se envían a través del píxel JavaScript en el navegador del usuario. Se trata de un método de seguimiento clásico que puede bloquearse mediante adblocks.
Sólo servidor (API de conversiones)
En este modo, el servidor sólo envía eventos a través de la API de conversiones de Facebook. Este es un modo de seguimiento más fiable que no está bloqueado por los adblockers, pero requiere una configuración adicional.
Híbrido (navegador + servidor con deduplicación)
En este modo, los eventos se envían tanto a través del píxel JavaScript como de la API de conversiones, con un mecanismo de deduplicación que evita el doble recuento de eventos. Este modo proporciona la mayor precisión de seguimiento.
Información
El modo híbrido se recomienda para la mayoría de los sitios, ya que combina las ventajas de ambos métodos de seguimiento, proporcionando una mayor precisión de los datos de conversión.
6. seguimiento en el servidor
Para configurar el seguimiento del lado del servidor (API de conversiones):- Asegúrese de que está seleccionado el modo "Sólo servidor" o "Híbrido".
- En la sección "Server-Side API Tracking", introduzca el token de acceso
- Opcionalmente, active el modo de prueba e introduzca el código de evento de prueba
Advertencia
La credencial de acceso es una clave confidencial que debe protegerse. No la compartas con terceros ni la coloques en lugares públicos.
- Ir a Responsable de eventos en business.facebook.com
- Seleccione "Fuentes de datos"
- Ir a "Ajustes"
- En la sección "Configurar la integración directa". seleccionar enlace "Generar token de acceso" generar un token de acceso a la API
7 Cola de eventos
La función de cola de eventos permite aplazar el procesamiento de eventos del lado del servidor, lo que mejora notablemente el rendimiento del sitio:- En la sección "Seguimiento de la API del lado del servidor", active la opción "Cola de eventos".
- Vaya a la pestaña "Cola de eventos" para configurar y supervisar la cola.
Para obtener un rendimiento óptimo, recomendamos configurar una tarea cron en el servidor:
- En "Event Queue", copie la URL a cron
- Añade una tarea cron en el servidor que llame a esta URL cada 5 minutos
// Przykładowa komenda cron dla wget
*/5 * * * * wget -q -O /dev/null https://demo.cocos.codes/cc_facebook_pixel?cc_facebook_pixel_cron=1&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX >/dev/null 2>&1
// Przykładowa komenda cron dla curl
*/5 * * * * curl -s https://demo.cocos.codes/cc_facebook_pixel?cc_facebook_pixel_cron=1&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX >/dev/null 2>&1
Nota
La cola de eventos también funciona sin una tarea cron externa, utilizando el mecanismo Cron integrado de WordPress, pero una tarea cron externa proporciona un procesamiento de eventos más fiable y puntual.
8 Eventos personalizados
El complemento permite añadir eventos JavaScript personalizados:- En la sección "Eventos personalizados", introduzca su propio código de evento
- Elija dónde insertar el código (cabecera o pie de página)
// Przykładowy kod niestandardowego zdarzenia
fbq('track', 'MojeZdarzenie', {
parametr1: 'wartosc1',
parametr2: 'wartosc2'
});Advertencia
En el modo "Solo servidor", no se enviarán eventos JavaScript personalizados, ya que el código del píxel de Facebook no se inyecta en la página en ese momento. Cambia el modo de seguimiento a "Híbrido" o "Solo navegador" si quieres utilizar eventos JavaScript personalizados.
9. Adaptación avanzada
La concordancia avanzada permite enviar datos adicionales del usuario a Facebook, lo que mejora la eficacia del seguimiento:- En la sección "Concordancia avanzada", active la opción "Activar concordancia avanzada".
- Marque las casillas de los datos de usuario que desea transferir:
- Correo electrónico
- Teléfono
- Nombre
- Nombre
- Ciudad
- Provincia
- Código postal
- País
Consejo
La concordancia avanzada funciona mejor cuando los usuarios han iniciado sesión en su sitio. Para los usuarios que no hayan iniciado sesión, el complemento intentará recuperar los datos de los formularios que rellenen.
10. depuración
El complemento ofrece amplias herramientas de depuración para ayudar a solucionar los problemas de integración del píxel de Facebook:- En la sección "Configuración de depuración", activa la opción "Activar el modo de depuración"
- Vaya a la pestaña "Depuración" para acceder a las herramientas de depuración
- Prueba de la API del servidor - envía un evento de prueba a través de la API de conversiones
- Prueba JavaScript Pixel - abre una página con JavaScript activo Pixel
- Registros API - muestra los registros de solicitudes y respuestas de la API
Consejo
En el modo de depuración, el complemento genera registros detallados que pueden utilizarse para diagnosticar problemas. Los registros se guardan en el directorio /wp-content/uploads/cc-facebook-pixel-logs/.
11 Solución de problemas
Los eventos no se envían- Comprueba que has introducido el ID de píxel de Facebook correcto
- Asegurarse de que la licencia está activa
- Compruebe que el modo de seguimiento elegido se adapta a sus necesidades
- En el caso del rastreo del lado del servidor, valide el Access Token
- Active el modo de depuración y compruebe los registros
- Asegúrese de que WordPress Cron funciona correctamente
- Considere la posibilidad de crear una tarea cron externa
- Compruebe que el servidor tiene los permisos correctos para enviar peticiones HTTP
- Compruebe que el código de acceso es correcto y está activo.
- Asegúrese de seleccionar la versión correcta de la API
- Active el modo de prueba y compruebe que los eventos de prueba se envían correctamente
- Compruebe los registros de la API para identificar posibles problemas
12. PREGUNTAS FRECUENTES
¿Qué es el píxel de Facebook?El píxel de Facebook es una herramienta de análisis que te permite realizar un seguimiento de la actividad de los usuarios en tu sitio web y utilizar estos datos para orientar los anuncios en Facebook, Instagram y la red publicitaria Audience Network.
¿Cuál es la diferencia entre el píxel JavaScript y la API de conversiones?
El píxel JavaScript se ejecuta en el navegador del usuario y puede ser bloqueado por los adblocks. La API de conversiones se ejecuta en el servidor y no puede ser bloqueada por los adblocks, lo que proporciona un seguimiento de conversiones más fiable.
¿Puedo utilizar el plug-in sin una licencia activa?
El plug-in funcionará en modo restringido sin una licencia activa, lo que le permitirá ver los ajustes, pero no podrá editar la configuración ni utilizar funciones avanzadas.
¿Ralentiza el plug-in la carga de la página?
Se ha optimizado el rendimiento del complemento. La función de cola de eventos del lado del servidor reduce significativamente el impacto en los tiempos de carga de la página.
¿Cumple el complemento con RODO/GDPR?
El plugin en sí no recopila datos personales, pero permite la transferencia de datos a Facebook. Es responsabilidad del propietario del sitio web garantizar el cumplimiento de RODO/GDPR, incluida la obtención de los consentimientos adecuados de los usuarios.
¿Puedo excluir a determinados usuarios del seguimiento?
Sí, en "Configuración de depuración" puede seleccionar los roles de usuario que se excluirán del seguimiento.
¿Cómo puedo comprobar que el píxel de Facebook funciona correctamente?
Active el modo de depuración y utilice las herramientas de depuración para probar la integración. También puede utilizar la extensión Ayudante de píxeles de Facebook para el navegador Chrome.
¿Qué ocurre si desactivo la cola de eventos?
Los eventos del lado del servidor se procesarán de forma sincrónica, lo que puede ralentizar la carga de la página, especialmente con mucho tráfico.
¿Dónde puedo obtener ayuda si tengo problemas con el plug-in?
Los titulares de licencias disponen de asistencia técnica. Póngase en contacto con nosotros a través de página de asistencia.
