Skip to content
Guida del Centro assistenzaFase di onboarding 1
3 min di letturaVerificato 2026-11-16

Dashboard analitica

Usa viste Panoramica e Analisi, selettori periodo, confronto iOS/Android e suggerimenti Pass Health.

In questa guida

Guide visive interattive UI

Apri nella guida in 6 fasi

Esplora schermate reali della dashboard e dettagli ingranditi collegati a questa guida.

Focus UI ingrandito1 / 2
Elementi chiave dell'interfaccia

Dashboard Workspace — KPI e Trend live (Ingrandito)

A sistema avviato, monitora Active in Wallets, Removed, Not Installed insieme alle curve di creazione e registrazione.

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:

FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
PIPELINE TELEMETRIA ANALYTICS E DASHBOARD
FASE 01 SORGENTI DI INGESTION ED EVENTI
Apple Web Service
/v1/devices/...
Google Wallet JWT
Callback Save/Remove
Eventi runtime
Scanner e PassFlow
FASE 02 MOTORE ANALYTICS E DASHBOARD (API)
Analytics API (/api/v1/analytics)
AnalyticsScope: customer | owner | template | passFlow
AnalyticsRange: last_7days | last_30days | last_12_months | custom
AnalyticsBucket: day | week | month (Rollup normalizzati per fuso)
Dashboard Analytics API (/api/v1/dashboards)
/analytics e /analytics/range (KPI direzionali e confronti periodo)
/metrics/realtime (Pass attivi live, throughput code e scansioni)
/performance e /insights (Diagnostica Pass Health e azioni consigliate)
FASE 03 INTERFACCIA DASHBOARD PASSINSTANCE
Schede riepilogo KPI e
quota Apple vs. Google
Grafici trend
multiserie (G/S/M)
Stato salute pass
e avvisi colli bott.

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 DashboardEndpoint API sottostantiTelemetria e funzionalità principali
Panoramica Workspace (/analytics)GET /api/v1/dashboards/analyticsGET /api/v1/dashboards/metrics/realtimeGET /api/v1/dashboards/insightsContatore 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/rangeGrafici multiserie per creazione pass vs. installazione Wallet, variazioni nette per piattaforma (walletAppsChanges), confronti su intervalli personalizzati e filtri per entità.
Prestazioni di sistemaGET /api/v1/dashboards/performanceLatenza 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. 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.

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

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

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>

Payload di risposta (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
  }
}

Interrogare metriche in tempo reale e suggerimenti Pass Health

Per interrogare i contatori in tempo reale e le raccomandazioni diagnostiche tramite 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."
    }
  ]
}

Documentazione correlata

Pronto a lanciare il tuo primo programma di carte Wallet?

Crea il tuo workspace, configura il modello e testa una carta reale in Apple Wallet e Google Wallet prima di scalare.