Panoramica
La Dashboard Analytics (/analytics, /analytics/passes, /analytics/downloads, a livello di modello /templates/:id/analytics e le viste personalizzate sotto /dashboards) fornisce telemetria operativa in tempo reale e aggregazione storica delle serie temporali sull'intero workspace, senza richiedere pipeline di business intelligence esterne. Alimentata da Dashboard Analytics API (/api/v1/dashboards/*) e Analytics API (/api/v1/analytics/*), la console espone metriche multidimensionali che coprono emissione dei pass, registrazioni attive dei dispositivi, quote di installazione per piattaforma e diagnostica proattiva su Stato di salute dei pass.
Gli operatori possono alternare tra la modalità ad alto livello Panoramica — ottimizzata per KPI direzionali, avvisi di stato e controllo operativo immediato — e la modalità approfondita Analytics per analisi per coorti su modelli specifici, canali di distribuzione e intervalli temporali.
Architettura di aggregazione della telemetria
Passinstance separa i contatori operativi in tempo reale dai rollup storici delle serie temporali per garantire il rendering della dashboard in frazioni di secondo anche su workspace con centinaia di migliaia di pass attivi:
Importante: Tutti i bucket delle serie temporali (
day,week,month) sono allineati e valutati rispetto al fuso orario regionale configurato sul workspace (GET /api/v1/customer/:customerId/regional-settings), assicurando che i confini giornalieri corrispondano agli orari di apertura locali dei punti vendita.
Modalità Panoramica del workspace rispetto ad Analytics approfondite
| Vista Dashboard | Endpoint API sottostanti | Telemetria e funzionalità principali |
|---|---|---|
Panoramica Workspace (/analytics) | GET /api/v1/dashboards/analyticsGET /api/v1/dashboards/metrics/realtimeGET /api/v1/dashboards/insights | Contatore in tempo reale dei pass attivi, variazioni su 30 giorni, velocità di scansione live, avvisi di scadenza certificati e raccomandazioni operative Pass Health. |
Analytics approfondite (/analytics/passes e /analytics/downloads) | GET /api/v1/analyticsGET /api/v1/analytics/overviewGET /api/v1/dashboards/analytics/range | Grafici multiserie per creazione pass vs. installazione Wallet, variazioni nette per piattaforma (walletAppsChanges), confronti su intervalli personalizzati e filtri per entità. |
| Prestazioni di sistema | GET /api/v1/dashboards/performance | Latenza di invio delle notifiche push, tassi di successo della sincronizzazione APNs/Google Wallet e tempi di risposta delle verifiche scanner. |
Enum di filtro: AnalyticsScope, AnalyticsRange e AnalyticsBucket
Quando si interroga GET /api/v1/analytics o GET /api/v1/analytics/overview (request payload), è possibile segmentare la telemetria del workspace su tre enumerazioni ortogonali:
-
1
AnalyticsScope(scope):
- customer: Aggrega tutti i modelli, i PassFlow e le configurazioni scanner all'interno del workspace autenticato (ricavato automaticamente dalla sessione o chiave API). - owner: Aggrega le metriche tra più workspace per i titolari di organizzazione che gestiscono più ambienti fratelli. - template: Isola le metriche di emissione, registrazione e rimozione a un singolo UUID templateId. - passFlow: Isola visite pubbliche, invii modulo e tassi di conversione su uno specifico UUID passFlowId.
-
2
AnalyticsRange(range):
- Finestre preimpostate: last_7days, last_30days, last_12_months. - Intervalli personalizzati: custom abbinato ai parametri query ISO YYYY-MM-DD from e to (from=2026-10-15&to=2026-11-16).
-
3
AnalyticsBucket(bucket):
- day: Punti dati giornalieri (predefinito per le finestre a 7 e 30 giorni). - week: Aggregazioni settimanali ISO per analisi di trend su più mesi. - month: Aggregazioni per mese di calendario (predefinito per last_12_months).
Riferimento API programmatico per la telemetria
Recuperare analytics multiserie del workspace
Ottenga le curve temporali per gli eventi del ciclo di vita dei pass, le registrazioni dei dispositivi e la distribuzione negli ecosistemi Wallet:
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>
Payload di risposta (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
}
}
Interrogare metriche in tempo reale e suggerimenti Pass Health
Per interrogare i contatori in tempo reale e le raccomandazioni diagnostiche tramite 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."
}
]
}
Documentazione correlata
-
Esamini le formule esatte dei KPI in Metriche di emissione e utilizzo dei pass.
-
Analizzi i tassi di conversione per canale in Analytics di distribuzione e coinvolgimento.
-
Esporti i dataset grezzi sottostanti tramite Esportazione dati e reportistica.
