Skip to content
Hilfecenter-AnleitungOnboarding-Phase 1
3 Min. LesezeitGeprüft 2026-11-16

Analyse-Dashboard

Nutzen Sie Übersichts- und Analyseansichten, Zeitraumfilter, Apple/Google-Vergleiche und Pass-Health-Empfehlungen.

In dieser Anleitung

Prüfen Sie passende Dashboard-Bereiche, Steuerelemente und Zoom-Hinweise zu diesem Thema.

Vergrößerter UI-Fokus1 / 2
Wichtige UI-Elemente

Workspace-Dashboard — Live-KPIs & Trends (Zoom)

Nach dem Go-live „Active in Wallets“, „Removed from Wallets“, „Not Installed“ sowie Erstellungs- und Registrierungstrends verfolgen.

Ü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:

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
ANALYSE- & DASHBOARD-TELEMETRIE-PIPELINE
STUFE 01 ERFASSUNGS- & EREIGNISQUELLEN
Apple Web Service
/v1/devices/...
Google Wallet JWT
Save/Remove Callback
Scanner- & PassFlow-
Laufzeitereignisse
STUFE 02 ANALYSE- & DASHBOARD-ENGINE (API)
Analytics API (/api/v1/analytics)
AnalyticsScope: customer | owner | template | passFlow
AnalyticsRange: last_7days | last_30days | last_12_months | custom
AnalyticsBucket: day | week | month (Zeitzonennormierte Rollups)
Dashboard Analytics API (/api/v1/dashboards)
/analytics & /analytics/range (Executive-KPIs & Periodenvergleiche)
/metrics/realtime (Aktive Live-Karten, Queue-Durchsatz & Scans)
/performance & /insights (Pass-Health-Diagnosen & Handlungsempfehlungen
STUFE 03 PASSINSTANCE DASHBOARD-UI
KPI-Übersichtskarten &
Apple-vs.-Google-Anteil
Mehrreihen-Trend-
Diagramme (Tag/Wo/Mo)
Kartenzustand &
Engpass-Warnungen

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-AnsichtZugrundeliegende API-EndpunktePrimäre Telemetrie & Funktionen
Workspace-Übersicht (/analytics)GET /api/v1/dashboards/analyticsGET /api/v1/dashboards/metrics/realtimeGET /api/v1/dashboards/insightsEchtzeitzä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/rangeMehrreihen-Diagramme für Kartenerstellung im Vergleich zur Wallet-Installation, Netto-Plattformänderungen (walletAppsChanges), Vergleiche benutzerdefinierter Datumsbereiche und bereichsbezogene Entitätsfilterung.
SystemleistungGET /api/v1/dashboards/performanceVersandlatenz 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. 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.

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

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

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>

Antwort-Payload (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
  }
}

Echtzeit-Metriken & Erkenntnisse zum Kartenzustand abfragen

So fragen Sie aktuelle Zählerstände und Diagnoseempfehlungen über den Dashboard Analytics API ab:

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

Weiterführende Dokumentation

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.