Présentation
Le Tableau de bord analytique (/analytics, /analytics/passes, /analytics/downloads, /templates/:id/analytics au niveau du modèle et les vues personnalisées sous /dashboards) fournit une télémétrie opérationnelle en temps réel et une agrégation de séries temporelles historiques sur l'ensemble de votre espace de travail, sans nécessiter de pipelines de Business Intelligence externes. Propulsée par Dashboard Analytics API (/api/v1/dashboards/*) et Analytics API (/api/v1/analytics/*), la console présente des métriques multidimensionnelles couvrant l'émission de passes, les enregistrements d'appareils actifs, la répartition des installations par plateforme et des diagnostics proactifs de santé des passes (Pass Health).
Les opérateurs peuvent basculer entre le mode Vue d'ensemble (Overview) de haut niveau — optimisé pour les KPI exécutifs, les alertes de santé et l'état opérationnel immédiat — et le mode Analytique (Analytics) approfondi pour des analyses détaillées par cohorte sur des modèles spécifiques, des canaux de distribution et des intervalles de temps.
Architecture d'agrégation de la télémétrie
Passinstance sépare les compteurs opérationnels en direct des cumuls de séries temporelles historiques afin de garantir un affichage du tableau de bord en moins d'une seconde, même sur des espaces de travail comptant des centaines de milliers de passes actifs :
Important : Tous les intervalles de séries temporelles (
day,week,month) sont alignés et évalués selon le fuseau horaire régional configuré pour votre espace de travail (GET /api/v1/customer/:customerId/regional-settings), garantissant ainsi que les limites quotidiennes correspondent aux heures d'ouverture locales de vos points de vente.
Mode Vue d'ensemble vs Mode Analytique approfondie
| Vue du tableau de bord | Points de terminaison API sous-jacents | Télémétrie principale et fonctionnalités |
|---|---|---|
Vue d'ensemble de l'espace de travail (/analytics) | GET /api/v1/dashboards/analyticsGET /api/v1/dashboards/metrics/realtimeGET /api/v1/dashboards/insights | Compteur de passes actifs en temps réel, variations de croissance sur 30 jours, vélocité de scan en direct, avertissements d'expiration de certificats et recommandations exploitables sur la santé des passes. |
Analytique approfondie (/analytics/passes & /analytics/downloads) | GET /api/v1/analyticsGET /api/v1/analytics/overviewGET /api/v1/dashboards/analytics/range | Graphiques multi-séries comparant la création de passes et l'installation dans le portefeuille, variations nettes par plateforme (walletAppsChanges), comparaisons de plages de dates personnalisées et filtrage par entité ciblée. |
| Performance du système | GET /api/v1/dashboards/performance | Latence d'envoi des notifications push, taux de réussite de synchronisation APNs/Google Wallet et temps de réponse de vérification du scanner. |
Énumérations de filtrage : AnalyticsScope, AnalyticsRange et AnalyticsBucket
Lorsque vous interrogez GET /api/v1/analytics ou GET /api/v1/analytics/overview (request payload), vous pouvez découper la télémétrie de l'espace de travail selon trois énumérations orthogonales :
-
1
AnalyticsScope(scope) :
- customer : Agrège tous les modèles, flux de passes et configurations de scanner au sein de l'espace de travail authentifié (déduit automatiquement de votre session ou clé API). - owner : Agrège les métriques inter-espaces de travail pour les propriétaires d'organisation gérant plusieurs environnements affiliés. - template : Isole les métriques d'émission, d'enregistrement et de suppression pour un UUID templateId unique. - passFlow : Isole les visites publiques d'inscription, les soumissions de formulaires et les taux de conversion pour un UUID passFlowId spécifique.
-
2
AnalyticsRange(range) :
- Fenêtres prédéfinies : last_7days, last_30days, last_12_months. - Intervalles personnalisés : custom associé aux paramètres de requête ISO YYYY-MM-DD from et to (from=2026-10-15&to=2026-11-16).
-
3
AnalyticsBucket(bucket) :
- day : Points de données quotidiens (par défaut pour les fenêtres de 7 jours et 30 jours). - week : Cumuls par semaine ISO pour l'analyse des tendances sur plusieurs mois. - month : Cumuls par mois civil (par défaut pour last_12_months).
Référence de l'API de télémétrie programmatique
Récupérer les analyses multi-séries de l'espace de travail
Récupérez les courbes de séries temporelles pour les événements du cycle de vie des passes, les enregistrements d'appareils et la répartition par écosystème de portefeuille :
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>
Charge utile de réponse (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
}
}
Interroger les métriques en temps réel et les diagnostics de santé des passes
Pour interroger l'état des compteurs en direct et les recommandations de diagnostic via 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."
}
]
}
Documentation connexe
-
Consultez les formules exactes des KPI dans Métriques d'émission et d'utilisation des passes.
-
Analysez les taux de conversion par canal dans Analytique de distribution et d'engagement.
-
Exportez les jeux de données brutes sous-jacents via Exportations de données et rapports.
