Documentación completa

1. Introducción

iDealer Report es una aplicación web interna desarrollada para el seguimiento mensual y temporal del uso de la herramienta iDealer por parte de los comerciales de concesionarios Hyundai y otras marcas gestionadas desde INFOVA.

Su objetivo es centralizar, visualizar y analizar los datos exportados desde iDealer —accesos, argumentarios, botón dinámico— cruzándolos con información de tráfico de exposición del stock, para que el equipo SSC pueda tomar decisiones basadas en datos reales.

2. Módulos del sistema

3. Configurar una marca nueva

Antes de poder importar informes o ver dashboards de una marca, es necesario darla de alta en el sistema.

3.1 Crear la marca

1. Ve a Marcas → Nueva marca en el menú.
2. Rellena los campos:
   • Nombre: nombre completo visible (ej. «Hyundai España»).
   • Slug: identificador URL sin espacios ni acentos (ej. hyundai). Debe ser único.
   • KPI mínimo (%): porcentaje de comerciales activos que se considera el umbral de cumplimiento. Por defecto 50 %.
   • Color de marca: hex CSS para distinguir la marca en las gráficas.
3. Guarda. La marca aparecerá en el dropdown de Dashboard y en el asistente.

3.2 Configurar zonas y concesionarios

Las zonas y concesionarios se crean automáticamente al importar el primer informe mensual. El sistema extrae los valores únicos de las columnas Zona y Concesionario del CSV de iDealer.

Si necesitas renombrar o reorganizar zonas posteriormente, puedes hacerlo desde Marcas → [editar marca] → Zonas.

3.3 Archivos de entrada necesarios

4. Generar un informe mensual

El asistente (wizard) guía el proceso de importación de datos en varios pasos:

Errores frecuentes en la importación

• «Faltan columnas requeridas»: el archivo no contiene alguna de las columnas mínimas. Abre el CSV en Excel y comprueba que existan las columnas listadas en §3.3.
• «Informe duplicado»: ya existe un registro para esa marca y ese mes. Elimina el anterior desde Historial si quieres reimportarlo.
• «Encoding»: si los nombres propios aparecen con caracteres extraños, guarda el CSV en UTF-8 desde Excel (Guardar como → CSV UTF-8 con BOM).

5. Dashboard

El dashboard muestra el resumen de actividad de una marca para el período seleccionado (mes / trimestre / año). Se accede desde Dashboard → [nombre de marca].

5.1 KPI global

El KPI de actividad mide el porcentaje de comerciales que han accedido a iDealer al menos una vez en el período:

El semáforo de color indica el estado respecto al umbral configurado para la marca: verde ≥ umbral, ámbar ≥ 80 % del umbral, rojo < 80 % del umbral.

5.2 Gráficas de evolución mensual

Muestran la evolución de los indicadores clave a lo largo de los meses con datos importados. Cada punto es un mes. Pasa el cursor para ver el valor exacto y el % de variación respecto al mes anterior.

• Accesos iDealer: total de accesos a la herramienta en el período.
• % Comerciales activos: evolución del KPI en el tiempo.
• Argumentarios vistos y compartidos: uso de los materiales de venta.
• Botón dinámico: accesos a la CTA de contacto desde el argumentario.

5.3 Módulo de Comparativas entre períodos

Permite comparar métricas entre dos o más meses ya importados. Accede a él desde Análisis → Comparativa [marca] o haciendo clic en Comparar períodos dentro del dashboard.

• Selecciona la métrica y el nivel de agrupación (global, zona, concesionario).
• La gráfica muestra barras agrupadas para comparar los meses seleccionados en paralelo.
• La tabla de variación muestra el delta absoluto y porcentual entre el primer y último período seleccionado.

6. Análisis Temporal

El Módulo B — Análisis Temporal permite comparar la actividad iDealer a lo largo de múltiples períodos semanales sin necesidad de importar datos a la base de datos. Los datos se mantienen en sesión PHP y se borran al cerrar el navegador.

6.1 Archivos necesarios: el CSV semanal de iDealer

El archivo semanal que exporta iDealer tiene el siguiente nombre:

El sistema extrae automáticamente el rango de fechas del nombre del archivo.

6.2 Cargar períodos

1. Accede a Análisis → Con CSVs semanales iDealer.
2. Arrastra uno o varios archivos CSV al área de subida (o haz clic para seleccionarlos).
3. Puedes cargar hasta 8 períodos simultáneamente.
4. Los períodos se ordenan cronológicamente automáticamente.
5. Elimina períodos individualmente con el botón × de cada badge, o todos a la vez con Eliminar todos.

6.3 Métricas disponibles

6.4 Gráfica B1 — Evolución temporal

Muestra cómo evoluciona la métrica seleccionada eje Y a lo largo de los períodos cargados eje X. Dispone de vista de línea (tendencias) y barras (comparación directa). Puede agruparse en global, por zona o por concesionario. Cada agrupación genera un dataset por serie (zona o concesionario).

6.5 Gráfica B4 — Radar de perfil de actividad

Compara el rendimiento relativo de cinco indicadores (accesos, argumentarios vistos, compartidos, botón dinámico, comerciales activos) entre los períodos cargados. Cada eje corresponde a una métrica y los valores se normalizan al 100 % del máximo para que sean comparables entre sí aunque tengan escalas muy distintas.

• Polígono grande → período de alto rendimiento global.
• Asimetría → el período tiene fortalezas en unas métricas y debilidades en otras.
• Compara dos períodos buscando en qué métricas retrocedió o avanzó.

6.6 Gráfica B5 — Pirámide de actividad (barras apiladas)

Muestra la composición de la actividad total en cada período apilando cuatro capas: accesos iDealer (base), argumentarios vistos, compartidos y accesos al botón dinámico. Permite responder:

• ¿El volumen total crece o decrece período a período?
• ¿Qué tipo de actividad domina? (muchos accesos pero pocos compartidos = uso pasivo).
• ¿Hay cambios en la distribución aunque el volumen total sea similar?

6.7 Gráfica B6 — Mapa de actividad por concesionario (Treemap)

Cada rectángulo representa un concesionario.

• Tamaño del rectángulo: proporcional al n.º de accesos a iDealer en el período seleccionado. Un rectángulo grande = muchos accesos.
• Color: va de verde (alta % de comerciales activos) a naranja/rojo (baja actividad). Un rectángulo grande y verde es el caso ideal.
• Usa el selector de período para cambiar qué período visualiza el mapa.
• Pasa el cursor sobre un rectángulo para ver el nombre del concesionario, n.º de accesos y % de activos.

6.8 Tabla de variación (B2)

Compara el valor de la métrica seleccionada entre el primer y el último período cargado. Las celdas en verde indican mejora respecto al período inicial; en rojo, descenso.

6.9 Tabla resumen (B3)

Vista en tabla de todos los indicadores clave para cada período. Útil para exportar (seleccionar todo → copiar en Excel) o para una revisión rápida sin necesidad de generar gráficas.

7. Cruce con tráfico de exposición

El módulo de cruce permite correlacionar los datos de actividad iDealer (de los CSVs semanales) con el archivo mensual de tráfico de exposición del stock, que registra las visitas web que ha recibido cada oferta/vehículo.

7.1 ¿Qué es el archivo de tráfico?

Es el informe mensual que exporta el sistema de gestión de stock / portal de vehículos y que contiene una fila por oferta publicada. Incluye cuántas visitas ha recibido cada ficha de vehículo, en qué fecha y en qué concesionario está asignada.

7.2 Formato esperado

• Formato de fecha soportado: DD/MM/YYYY, YYYY-MM-DD, DD-MM-YYYY.
• Separador CSV: punto y coma (;) o coma (,).
• Tamaño máximo: 20 MB.
• El archivo cubre un mes completo; el sistema filtrará por las fechas de cada período iDealer cargado.

7.3 Cómo cargarlo

1. Carga primero los CSVs semanales de iDealer (sección 6.2).
2. En la sección Tráfico de exposición (tarjeta verde), arrastra el CSV mensual de tráfico o haz clic para seleccionarlo.
3. El sistema auto-detecta las columnas y muestra un resumen: n.º de filas, columna de tráfico detectada, rango de fechas.
4. Si la detección es incorrecta, renombra las columnas del CSV para que coincidan con los nombres listados en §7.2 y vuelve a subir.
5. Haz clic en Analizar. Las gráficas B7 y B8 aparecerán automáticamente.

7.4 Gráfica B7 — Evolución: tráfico vs. accesos iDealer

Muestra en un mismo gráfico de líneas la evolución temporal de:

• Tráfico de exposición (línea verde, eje izquierdo): total de visitas al stock web en el período, filtrado por las mismas fechas del CSV iDealer.
• Accesos iDealer (línea violeta punteada, eje derecho): total de accesos a la herramienta.

Interpretación: Si ambas líneas suben y bajan a la vez, hay correlación positiva; a más visibilidad del stock, más uso de iDealer. Si el tráfico sube pero los accesos bajan (o viceversa), hay un desacoplamiento que merece investigarse.

7.5 Gráfica B8 — Correlación por concesionario (Scatter)

Diagrama de dispersión donde cada punto representa un concesionario en el período más reciente cargado:

• Eje X: tráfico de exposición recibido.
• Eje Y: accesos a iDealer.

8. Glosario de métricas

9. Preguntas frecuentes