Skip to content
Guía del Centro de ayudaFase de incorporación 1
4 min de lecturaVerificado 2026-11-16

Panel de analítica

Navega entre Resumen y Analítica, selecciona rangos de fechas, compara iOS/Android y revisa Pass Health.

En esta guía

Recorridos visuales interactivos

Abrir en la guía de 6 fases

Inspecciona las pantallas reales del panel y las anotaciones ampliadas de esta guía.

Enfoque de interfaz ampliado1 / 2
Elementos clave de la interfaz

Panel Principal — KPIs y Tendencias en vivo (Ampliado)

Ya en marcha, monitoriza Active in Wallets, Removed, Not Installed y curvas de creación y registro.

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:

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
PIPELINE DE TELEMETRÍA DE ANALÍTICAS Y PANEL
ETAPA 01 FUENTES DE INGESTIÓN Y EVENTOS
Servicio Web Apple
/v1/devices/...
Callback Guardar/
Eliminar JWT Google
Eventos en Tiempo de
Ejecución Escáner/Flujo
ETAPA 02 MOTOR DE ANALÍTICAS Y PANEL (API)
Analytics API (/api/v1/analytics)
AnalyticsScope: customer | owner | template | passFlow
AnalyticsRange: last_7days | last_30days | last_12_months | custom
AnalyticsBucket: day | week | month (Resúmenes Normalizados por ZH)
Dashboard Analytics API (/api/v1/dashboards)
/analytics y /analytics/range (KPI Ejecutivos y Comparaciones)
/metrics/realtime (Pases Activos en Vivo, Rendimiento de Cola y Escaneos)
/performance e /insights (Diagnósticos de Salud de Pases y Acciones)
ETAPA 03 INTERFAZ DEL PANEL DE PASSINSTANCE
Tarjetas Resumen KPI y
Cuota Apple vs. Google
Gráficos de Tendencia
Multiserie (Día/Sem/M)
Salud de Pases y
Alertas de Cuello

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 PanelEndpoints de API SubyacentesTelemetría Principal y Capacidades
Descripción General del Espacio (/analytics)GET /api/v1/dashboards/analyticsGET /api/v1/dashboards/metrics/realtimeGET /api/v1/dashboards/insightsContador 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/rangeGrá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 SistemaGET /api/v1/dashboards/performanceLatencia 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. 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.

  1. 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).

  1. 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:

HTTP
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)

JSON
{
  "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:

HTTP
GET /api/v1/dashboards/insights HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
JSON
{
  "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

¿Listo para lanzar su primer programa de tarjetas Wallet?

Cree su espacio de trabajo, configure su plantilla y pruebe una tarjeta real en Apple Wallet y Google Wallet antes de escalar.