> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.perkss.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.perkss.io/_mcp/server.

# Qué datos muestra el dashboard de tu CMS

> Tu dashboard muestra 4 KPIs de tu programa, un gráfico principal y un top-5 de tus mejores miembros. Los KPIs y el gráfico cambian según si tu programa es de cashback o de sellos.

> **Disponible en:** 🏬 Tienda física

Tu dashboard muestra 4 KPIs de tu programa, un gráfico principal y un top-5 de tus mejores miembros. Los KPIs y el gráfico cambian según si tu programa es de cashback o de sellos. Solo puede verlo el owner de la cuenta: un perfil admin no accede a estos datos. No hay comparativas de "este mes vs. el anterior" ni segmentos de clientes: todo lo que ves es el dato agregado, en bruto.

**TL;DR**

* Entra en tu CMS con tu cuenta de owner → revisa los 4 KPIs de tu tipo de programa → mira el gráfico principal → consulta el top-5 de miembros.
* Sin deltas mensuales, sin segmentos, sin sparklines.
* El gráfico de cashback acepta un rango de fechas; el de sellos es siempre de por vida.

***

## Antes de empezar

* Necesitas acceder al panel web del CMS con tu cuenta de **owner**. Un perfil admin no puede ver el dashboard: la resolución de compañía que alimenta estos datos está atada al owner, y un admin fallaría aunque su JWT sea válido.
* Tu programa debe estar configurado (cashback o sellos) para que el dashboard muestre datos coherentes con ese tipo.

El dashboard combina varias llamadas separadas (KPIs, gráfico, checklist de crecimiento) para construir la vista que ves en pantalla: no es una sola pantalla "cruda" de base de datos, sino un resumen ya preparado para ti.

## Pasos

Inicia sesión en el panel web con tu cuenta de owner. Si entras con un perfil admin, el dashboard no cargará los datos correctamente.

Los KPIs que ves dependen de tu tipo de programa.

**Si tu programa es de cashback, ves:**

| KPI              | Qué significa                                         |
| ---------------- | ----------------------------------------------------- |
| Miembros totales | número total de clientes dados de alta en tu programa |
| Visitas totales  | número total de visitas registradas                   |
| Cashback emitido | total de saldo generado a tus clientes                |
| Total canjeado   | total de saldo que tus clientes ya han gastado        |

**Si tu programa es de sellos, ves:**

| KPI                   | Qué significa                                                        |
| --------------------- | -------------------------------------------------------------------- |
| Miembros totales      | número total de clientes dados de alta en tu programa                |
| Visitas totales       | número total de visitas registradas                                  |
| Sellos emitidos       | total de sellos entregados                                           |
| Recompensas canjeadas | total de recompensas que tus clientes ya han desbloqueado y canjeado |

Cada tarjeta muestra icono, valor y etiqueta — no hay flecha de subida/bajada ni porcentaje de variación respecto al mes anterior.

<img src="https://files.buildwithfern.com/perkss.docs.buildwithfern.com/db9d338f4b5619acab0008941982881e420b8659ee3bc114d1264cfd417ea774/docs/assets/capturas/cms-dashboard-completo.png" alt="vista completa del dashboard con los 4 KPIs, el gráfico principal y el top-5 con datos reales" />

El gráfico también cambia según tu tipo de programa:

* **Cashback:** una línea con los ingresos diarios del rango de fechas que elijas. Los días sin actividad se muestran igualmente (a 0), no se saltan.
* **Sellos:** un histograma con 5 barras fijas de frecuencia de visitas ("1", "2", "3", "4", "5+" visitas → número de clientes en cada tramo). Este histograma es siempre de datos de por vida: aunque cambies el rango de fechas, el histograma de sellos no se ve afectado por ese filtro.

El gráfico de cashback acepta un rango `desde/hasta` que tú eliges — no está limitado a una ventana fija del servidor. \[VERIFICAR: si ese rango se elige mediante un selector de fechas visible en el CMS o solo está soportado a nivel de API; el fact pack confirma el parámetro `from/to` del endpoint pero no la existencia de un control de UI para el merchant]

\[VERIFICAR: si existe un filtro por Local en el dashboard; no aparece confirmado en el fact pack revisado]

Debajo del gráfico ves un top-5 de tus mejores miembros, con estos datos por cada uno: nombre y apellidos, email, visitas, gasto total y fecha de su última visita.

No verás una columna de "segmento" ni de "estado" en esta tabla: hoy todos los miembros se tratan igual, sin categorías de tipo VIP/en riesgo/inactivo.

Para ver el listado completo de tus clientes (no solo el top-5), ve a la sección Miembros de tu CMS. Desde ahí puedes exportar tus datos. \[VERIFICAR: formato exacto del archivo exportado]

***

## Preguntas frecuentes

No. Hoy las tarjetas muestran el valor agregado, sin comparativa "este mes vs. el anterior".

Porque tu programa no usa segmentación automática (tipo VIP/en riesgo) hoy: todos los miembros se muestran igual, sin columna de segmento ni de estado.

No. El histograma de frecuencia de visitas de sellos es siempre de por vida; el filtro de fechas solo aplica al gráfico de ingresos de cashback.

El dashboard no tiene una ficha individual con historial cronológico por cliente confirmada; lo que ves por miembro son datos agregados (saldo, visitas, gasto total, última transacción). \[VERIFICAR: si existe una vista de detalle por miembro con más información en la sección Miembros]

Sí. Los datos del dashboard están atados a la resolución de compañía del owner de la cuenta; un perfil admin no accede a esta vista aunque tenga sesión iniciada.

***

**Relacionados:** Qué KPIs deberías vigilar - Configura tu back-office (CMS) - Cómo exportar tus datos de miembros - Qué es el cashback