Descripción General
El Panel de Analíticas (/analytics, /analytics/passes, /analytics/downloads, /templates/:id/analytics a nivel de plantilla y vistas personalizadas en /dashboards) proporciona telemetría operativa en tiempo real y agregación histórica de series temporales en todo su espacio de trabajo sin requerir canalizaciones externas de inteligencia empresarial. Impulsada por Dashboard Analytics API (/api/v1/dashboards/*) y Analytics API (/api/v1/analytics/*), la consola presenta métricas multidimensionales que abarcan la emisión de pases, registros de dispositivos activos, desgloses de instalación por plataforma y diagnósticos proactivos de Salud de Pases.
Los operadores pueden alternar entre el modo de alto nivel Descripción General —optimizado para KPI ejecutivos, alertas de salud y estado operativo inmediato— y el modo profundo de Analíticas para desgloses de cohortes por plantillas específicas, canales de distribución e intervalos de tiempo.
Arquitectura de Agregación de Telemetría
Passinstance separa los contadores operativos en vivo de los resúmenes históricos de series temporales para garantizar una representación del panel en fracciones de segundo incluso en espacios de trabajo con cientos de miles de pases activos:
Importante: Todos los intervalos de series temporales (
day,week,month) se alinean y evalúan según la zona horaria regional configurada en su espacio de trabajo (GET /api/v1/customer/:customerId/regional-settings), lo que garantiza que los límites diarios coincidan con el horario comercial de su tienda local.
Modos de Descripción General del Espacio frente a Analíticas Profundas
| Vista del Panel | Endpoints de API Subyacentes | Telemetría Principal y Capacidades |
|---|---|---|
Descripción General del Espacio (/analytics) | GET /api/v1/dashboards/analyticsGET /api/v1/dashboards/metrics/realtimeGET /api/v1/dashboards/insights | Contador de pases activos en tiempo real, variaciones de crecimiento a 30 días, velocidad de escaneo en vivo, advertencias de vencimiento de certificados y recomendaciones prácticas de Salud de Pases. |
Analíticas Profundas (/analytics/passes y /analytics/downloads) | GET /api/v1/analyticsGET /api/v1/analytics/overviewGET /api/v1/dashboards/analytics/range | Gráficos multiserie de creación de pases frente a instalación en billetera, cambios netos por plataforma (walletAppsChanges), comparaciones de rangos de fechas personalizados y filtrado por entidad con alcance definido. |
| Rendimiento del Sistema | GET /api/v1/dashboards/performance | Latencia de envío de notificaciones push, tasas de éxito de sincronización con APNs/Google Wallet y tiempos de respuesta de verificación del escáner. |
Enumeraciones de Filtrado: AnalyticsScope, AnalyticsRange y AnalyticsBucket
Al consultar GET /api/v1/analytics o GET /api/v1/analytics/overview (request payload), puede segmentar la telemetría del espacio de trabajo mediante tres enumeraciones ortogonales:
-
1
AnalyticsScope(scope):
- customer: Agrega todas las plantillas, flujos de pases y configuraciones de escáner dentro del espacio de trabajo autenticado (derivado automáticamente de su sesión o clave de API). - owner: Agrega métricas entre espacios de trabajo para propietarios de organizaciones que gestionan múltiples entornos hermanos. - template: Aísla las métricas de emisión, registro y eliminación a un único UUID templateId. - passFlow: Aísla las visitas de captación pública, los envíos de formularios y las tasas de conversión a un UUID passFlowId específico.
-
2
AnalyticsRange(range):
- Ventanas predefinidas: last_7days, last_30days, last_12_months. - Intervalos personalizados: custom combinado con parámetros de consulta ISO YYYY-MM-DD from y to (from=2026-10-15&to=2026-11-16).
-
3
AnalyticsBucket(bucket):
- day: Puntos de datos diarios (valor predeterminado para ventanas de 7 y 30 días). - week: Resúmenes por semana ISO para análisis de tendencias de varios meses. - month: Resúmenes por mes natural (valor predeterminado para last_12_months).
Referencia de la API de Telemetría Programática
Recuperar Analíticas Multiserie del Espacio de Trabajo
Obtenga curvas de series temporales para eventos del ciclo de vida de los pases, registros de dispositivos y distribución por ecosistema de billetera:
GET /api/v1/analytics?range=last_30days&bucket=day&scope=template&templateId=b4f29c10-83e1-4a7b-9d12-56e8012a9c04 HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Carga Útil de Respuesta (200 OK)
{
"range": {
"preset": "last_30days",
"startDate": "2026-10-17T00:00:00.000Z",
"endDate": "2026-11-15T23:59:59.999Z",
"bucket": "day",
"timezone": "Europe/Berlin"
},
"scope": {
"type": "template",
"targetId": "b4f29c10-83e1-4a7b-9d12-56e8012a9c04"
},
"summary": {
"totalPasses": 4820,
"activePasses": 3915,
"inactivePasses": 245,
"unclaimedPasses": 660,
"installedDevices": 4380
},
"series": {
"passes": [
{ "bucketStart": "2026-11-14", "created": 145, "active": 3810, "deactivated": 8 },
{ "bucketStart": "2026-11-15", "created": 162, "active": 3915, "deactivated": 5 }
],
"registrations": [
{ "bucketStart": "2026-11-14", "active": 4260, "deactivated": 11 },
{ "bucketStart": "2026-11-15", "active": 4380, "deactivated": 6 }
],
"walletAppsChanges": [
{ "bucketStart": "2026-11-14", "appleNetChange": 84, "googleNetChange": 32 },
{ "bucketStart": "2026-11-15", "appleNetChange": 91, "googleNetChange": 29 }
]
},
"walletAppsShare": {
"apple": 2980,
"google": 1400,
"total": 4380,
"applePercentage": 68.04,
"googlePercentage": 31.96
}
}
Consultar Métricas en Tiempo Real e Información de Salud de Pases
Para consultar estados de contadores en vivo y recomendaciones de diagnóstico mediante Dashboard Analytics API:
GET /api/v1/dashboards/insights HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
{
"generatedAt": "2026-11-15T23:30:00.000Z",
"healthScore": 94,
"insights": [
{
"code": "HIGH_UNCLAIMED_RATIO",
"severity": "warning",
"templateId": "b4f29c10-83e1-4a7b-9d12-56e8012a9c04",
"message": "13.7% of issued passes remain unclaimed after 72 hours.",
"recommendedAction": "Enable automated 48-hour reminder sendouts in Delivery Center."
}
]
}
Documentación Relacionada
-
Revise las fórmulas exactas de los KPI en Métricas de Emisión y Uso de Pases.
-
Analice las tasas de conversión por canal en Analíticas de Distribución e Interacción.
-
Exporte los conjuntos de datos sin procesar subyacentes mediante Exportación de Datos e Informes.
