Skip to content
Guide du centre d'aidePhase d'intégration 1
4 min de lectureVérifié 2026-11-16

Tableau de bord analytique

Utilisez les vues Vue d'ensemble et Analytique, sélecteurs de période, part iOS/Android et recommandations Pass Health.

Dans ce guide

Visites interactives de l'interface

Ouvrir dans le guide en 6 phases

Inspectez les écrans exacts du tableau de bord et les zooms annotés liés à ce guide.

Focus interface zoomé1 / 2
Éléments clés de l'interface

Tableau de bord — KPI & tendances d'inscription (Zoom)

Une fois en production, surveillez Active in Wallets, Removed, Not Installed ainsi que les tendances de création et d'enregistrement.

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 :

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
FLUX D'ARCHITECTURE SYSTÈME : PIPELINE DE TÉLÉMÉTRIE ANALYTIQUE ET TABLEAU DE BORD
ÉTAPE 01 SOURCES D'INGESTION ET D'ÉVÉNEMENTS
Web Service Apple
/v1/devices/...
Callback JWT Google
Ajout / Suppression
Événements d'exécution
Scanner et PassFlow
ÉTAPE 02 MOTEUR ANALYTIQUE ET TABLEAU DE BORD (API)
Analytics API (/api/v1/analytics)
AnalyticsScope : customer | owner | template | passFlow
AnalyticsRange : last_7days | last_30days | last_12_months | custom
AnalyticsBucket : day | week | month (Cumuls normalisés par fuseau)
Dashboard Analytics API (/api/v1/dashboards)
/analytics & /analytics/range (KPI exécutifs et comparaisons)
/metrics/realtime (Passes actifs en direct, débit de file et scans)
/performance & /insights (Diagnostics de santé et actions requises)
ÉTAPE 03 INTERFACE DU TABLEAU DE BORD PASSINSTANCE
Cartes de synthèse KPI &
Part Apple vs Google
Graphiques de tendance
multi-séries (J/S/M)
Santé des passes &
Alertes de goulots

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 bordPoints de terminaison API sous-jacentsTé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/insightsCompteur 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/rangeGraphiques 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èmeGET /api/v1/dashboards/performanceLatence 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. 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.

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

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

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>

Charge utile de réponse (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
  }
}

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 :

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."
    }
  ]
}

Documentation connexe

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.