Übersicht
Das Analyse-Dashboard (/analytics, /analytics/passes, /analytics/downloads, auf Vorlagenebene /templates/:id/analytics sowie benutzerdefinierte Ansichten unter /dashboards) bietet operative Echtzeit-Telemetrie und historische Zeitreihenaggregationen für Ihren gesamten Workspace, ohne dass externe Business-Intelligence-Pipelines erforderlich sind. Unterstützt durch den Dashboard Analytics API (/api/v1/dashboards/*) und den Analytics API (/api/v1/analytics/*) stellt die Konsole mehrdimensionale Metriken zu Kartenausgabe, aktiven Geräteregistrierungen, Plattform-Installationsanteilen und proaktiven Pass Health-Diagnosen (Kartenzustand) bereit.
Betreiber können zwischen dem übergeordneten Modus Übersicht (Overview) – optimiert für Management-KPIs, Zustandswarnungen und den unmittelbaren Betriebsstatus – und dem detaillierten Modus Analysen (Analytics) für Kohorten-Drilldowns über bestimmte Vorlagen, Verteilungskanäle und Zeitintervalle hinweg wechseln.
Architektur der Telemetrie-Aggregation
Passinstance trennt operative Echtzeitzähler von historischen Zeitreihen-Rollups, um selbst in Workspaces mit Hunderttausenden aktiven Karten Ladezeiten im Subsekundenbereich im Dashboard zu gewährleisten:
Wichtig: Alle Zeitreihenintervalle (
day,week,month) werden anhand der konfigurierten regionalen Zeitzone Ihres Workspaces (GET /api/v1/customer/:customerId/regional-settings) ausgerichtet und ausgewertet, sodass Tagesgrenzen exakt mit Ihren lokalen Geschäftszeiten übereinstimmen.
Workspace-Übersicht vs. detaillierte Analysemodi
| Dashboard-Ansicht | Zugrundeliegende API-Endpunkte | Primäre Telemetrie & Funktionen |
|---|---|---|
Workspace-Übersicht (/analytics) | GET /api/v1/dashboards/analyticsGET /api/v1/dashboards/metrics/realtimeGET /api/v1/dashboards/insights | Echtzeitzähler für aktive Karten, 30-Tage-Wachstumsdeltas, Live-Scanrate, Ablaufwarnungen für Zertifikate und umsetzbare Pass Health-Empfehlungen. |
Detaillierte Analysen (/analytics/passes & /analytics/downloads) | GET /api/v1/analyticsGET /api/v1/analytics/overviewGET /api/v1/dashboards/analytics/range | Mehrreihen-Diagramme für Kartenerstellung im Vergleich zur Wallet-Installation, Netto-Plattformänderungen (walletAppsChanges), Vergleiche benutzerdefinierter Datumsbereiche und bereichsbezogene Entitätsfilterung. |
| Systemleistung | GET /api/v1/dashboards/performance | Versandlatenz von Push-Benachrichtigungen, Erfolgsquoten der APNs-/Google-Wallet-Synchronisierung und Antwortzeiten bei der Scanner-Verifizierung. |
Filter-Enumerationen: AnalyticsScope, AnalyticsRange und AnalyticsBucket
Beim Abfragen von GET /api/v1/analytics oder GET /api/v1/analytics/overview (request payload) können Sie die Workspace-Telemetrie nach drei orthogonalen Enumerationen filtern:
-
1
AnalyticsScope(scope):
- customer: Aggregiert alle Vorlagen, PassFlows und Scanner-Konfigurationen innerhalb des authentifizierten Workspaces (wird automatisch aus Ihrer Sitzung bzw. Ihrem API-Schlüssel abgeleitet). - owner: Aggregiert workspace-übergreifende Metriken für Organisationsinhaber, die mehrere parallele Umgebungen verwalten. - template: Isoliert Ausgabe-, Registrierungs- und Entfernungsmetriken auf eine einzelne Vorlagen-UUID (templateId). - passFlow: Isoliert öffentliche Aufrufe von Registrierungsseiten, Formularübermittlungen und Konversionsraten auf eine bestimmte passFlowId-UUID.
-
2
AnalyticsRange(range):
- Voreingestellte Zeitfenster: last_7days, last_30days, last_12_months. - Benutzerdefinierte Intervalle: custom in Kombination mit den Abfrageparametern from und to im ISO-Format YYYY-MM-DD (from=2026-10-15&to=2026-11-16).
-
3
AnalyticsBucket(bucket):
- day: Tägliche Datenpunkte (Standard für 7-Tage- und 30-Tage-Fenster). - week: Aggregation nach ISO-Kalenderwochen für mehrwöchige und mehrmonatige Trendanalysen. - month: Aggregation nach Kalendermonaten (Standard für last_12_months).
Programmatische Telemetrie-API-Referenz
Mehrreihen-Workspace-Analysen abrufen
Rufen Sie Zeitreihenkurven für Ereignisse im Kartenlebenszyklus, Geräteregistrierungen und die Verteilung nach Wallet-Ökosystem ab:
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>
Antwort-Payload (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
}
}
Echtzeit-Metriken & Erkenntnisse zum Kartenzustand abfragen
So fragen Sie aktuelle Zählerstände und Diagnoseempfehlungen über den Dashboard Analytics API ab:
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."
}
]
}
Weiterführende Dokumentation
-
Prüfen Sie die exakten KPI-Formeln unter Kartenausgabe- & Nutzungsmetriken.
-
Analysieren Sie Kanalkonversionsraten unter Verteilungs- & Engagement-Analysen.
-
Exportieren Sie zugrunde liegende Rohdatensätze über Datenexporte & Berichte.
