Traffic Radar — Guía completa

Traffic Radar muestra en tiempo real quién visita tu tienda PrestaShop y separa a los visitantes reales de los bots y los rastreadores de IA. El módulo instala un panel dedicado en Estadísticas → Traffic Radar: contador en línea instantáneo (humanos contra bots), gráficos de evolución, mapa de calor de afluencia, top de rastreadores de IA, flujo de actividad en directo, control de rastreadores de IA mediante robots.txt y exportación CSV. Esta guía cubre la instalación, los ajustes, el funcionamiento de la detección, cada vista del panel, la privacidad y la resolución de problemas.

Instalación

1. Descarga el archivo dftrafficradar.zip desde tu cuenta DataFirefly.
2. Back-office de PrestaShop → Módulos → Subir un módulo → envía el ZIP.
3. Al instalarse, el módulo crea sus dos tablas (df_traffic_visit y df_traffic_online), registra sus hooks y añade la pestaña Estadísticas → Traffic Radar.

Configuración

Ve a Módulos → DataFirefly Traffic Radar → Configurar.

• Activar el seguimiento: interruptor principal. Desactivado, no se registra ninguna visita.
• Registrar bots / rastreadores de IA: desactívalo para seguir solo las visitas humanas.
• Anonimizar las direcciones IP (RGPD): las IP siempre se cifran; esta opción enmascara además el último octeto antes del hash.
• Conservación de datos (días): las visitas más antiguas se eliminan automáticamente. 0 = conservar indefinidamente. Por defecto: 90.
• Intervalo del heartbeat (segundos): frecuencia con la que un visitante en línea envía una señal para seguir contado. Por defecto: 15.
• Ventana «en línea» (segundos): un visitante se considera «en línea ahora» si se ha visto dentro de esta ventana. Por defecto: 90.
• Direcciones IP excluidas: una por línea (o separadas por comas). Ideal para ignorar tu propio tráfico y el de tu equipo.

Cómo funciona la detección

Traffic Radar combina dos señales complementarias, lo que le permite separar realmente a los humanos de los rastreadores.

Detección en el servidor

En cada página vista, mediante el hook actionFrontControllerSetMedia, el módulo clasifica el User-Agent contra una base de más de 40 firmas (IA, motores de búsqueda, SEO, social, monitorización) y le asigna un tipo. Esto es lo que permite capturar los rastreadores de IA, que casi nunca ejecutan JavaScript.

Heartbeat en el cliente

Un pequeño script (tracker.js) envía periódicamente una señal al controlador front track para mantener a los visitantes reales contados como «en línea» entre páginas. Como los bots no disparan ese latido, el contador de humanos en tiempo real se mantiene limpio.

El panel

La pestaña Estadísticas → Traffic Radar reúne todas las vistas, filtrables por periodo (hoy, 24 h, 7 / 30 / 90 días, personalizado) y por audiencia (todo el tráfico, humanos, todos los bots, o un tipo de bot concreto).

• En línea ahora: contador en tiempo real separado en humanos y bots, actualizado a la cadencia del heartbeat.
• KPI: visitas, sesiones únicas, visitas humanas, visitas de bots y hits IA / LLM. Cada KPI muestra su variación (▲ / ▼ en porcentaje) respecto al periodo anterior de la misma duración.
• Visitas en el tiempo: gráfico de humanos contra bots, con granularidad automática (horaria o diaria según el periodo).
• Reparto de la audiencia: donut por tipo (humano, IA, motores, SEO, social, monitorización, otros).
• Top rastreadores de IA: barras horizontales de los rastreadores de IA más activos (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, Bytespider…).
• Mapa de calor de afluencia: cuadrícula hora × día de la semana.
• Top páginas, referrers y países: clasificaciones en barras.
• Flujo de actividad en directo: últimas visitas con tipo, identidad, página, dispositivo y país.

El contador en tiempo real

El bloque «En línea ahora» se apoya en la tabla df_traffic_online, actualizada en cada página vista y en cada heartbeat. Un visitante desaparece del contador en cuanto no se le ha visto durante el tiempo definido por la ventana «en línea».

Radar de nuevos rastreadores

El panel «Nuevos rastreadores detectados» destaca los bots cuya primerísima visita registrada cae dentro del periodo analizado. Es la herramienta ideal para detectar de inmediato la llegada de un nuevo rastreador de IA a tu catálogo: nombre del bot, tipo, fecha de primera aparición y número de hits.

Control de rastreadores de IA (robots.txt)

El centro de control enumera 25 rastreadores de IA conocidos con su token robots.txt oficial. Para cada uno eliges «autorizado» o «bloqueado» mediante una casilla; los rastreadores de entrenamiento vienen premarcados como bloqueados por defecto, mientras que los agentes que responden a una petición del usuario se dejan pasar.

• Los rastreadores realmente vistos en tu tienda se señalan con una insignia.
• Dos preajustes en un clic: «Bloquear todo» y «Restablecer recomendado».
• El módulo genera en directo un bloque robots.txt listo para pegar, con un botón Copiar.

Widget en el panel de inicio del back-office

El módulo añade una tarjeta «Traffic Radar» en la columna derecha del panel de inicio del back-office (hook dashboardZoneTwo): un contador en línea en directo (humanos / bots) y los contadores del día (visitas, humanos, bots, IA / LLM), con un acceso directo al panel completo.

Exportación CSV

El botón CSV de la barra de herramientas exporta todo el tráfico que coincide con los filtros activos (periodo y audiencia). El archivo está codificado en UTF-8 con BOM para abrirse correctamente en Excel, y contiene una fila por visita: fecha, tipo, nombre del bot, dispositivo, página, referrer, país, etc.

Privacidad y RGPD

• No se almacena ninguna dirección IP en bruto: solo hashes SHA-1 con sal.
• La anonimización opcional enmascara el último octeto (IPv4) o los últimos grupos (IPv6) antes del hash.
• La conservación es configurable, con purga automática probabilística: no se requiere cron.
• La lista de IP excluidas permite ignorar tu propio tráfico.

Compatibilidad y notas técnicas

• PrestaShop 8.0 a 9.x, multitienda y multilingüe.
• Arquitectura PSR-4 bajo el namespace DataFirefly/TrafficRadar (separador barra invertida) con autoloader incluido, sin Composer.
• Controlador de administración legacy (ModuleAdminController) para la compatibilidad PS8 / PS9.
• Endpoints AJAX de back-office mediante el 4.º argumento de getAdminLink(); respuestas JSON emitidas por un método dedicado.
• Hooks usados: actionFrontControllerSetMedia, displayHeader, dashboardZoneTwo.
• Dos tablas utf8mb4 indexadas: df_traffic_visit (registro de visitas) y df_traffic_online (presencia, clave única por sesión).
• Chart.js incluido en local, sin llamada a CDN.

FAQ y resolución de problemas

«En línea ahora» permanece en cero. Asegúrate de estar en la versión 1.1.1 o superior (corrección de zona horaria entre PHP y MySQL). Comprueba también que el seguimiento está activado y que tu propia IP no está en la lista de excluidas.

Aparecían entradas «module-…» en el flujo. Corregido en 1.1.1: las peticiones AJAX y subpeticiones de módulos ya no se cuentan como páginas vistas.

¿Se detectan realmente los rastreadores de IA? Sí. La detección en el servidor los captura incluso sin JavaScript. Las firmas cubren OpenAI, Anthropic, Google-Extended, Perplexity, ByteDance, Meta, Mistral, Cohere, Amazon, Common Crawl y más.

¿Ralentiza el módulo la tienda? No. La clasificación del User-Agent es una simple comparación de cadenas en memoria, y el seguimiento se reduce a un insert y un upsert indexados por página vista.

¿Una caché de página completa falsea las cifras? Las páginas servidas desde una caché de página completa no pasan por PHP y, por tanto, no se recuentan en el servidor. El heartbeat JavaScript sigue manteniendo a los visitantes humanos contados como en línea.

¿Compatible con PrestaShop 1.7? No, solo PrestaShop 8.0 a 9.x.