Skip to content
Hilfecenter-Anleitung · Dashboard-ÜbersichtOnboarding-Phase 1
3 Min. LesezeitGeprüft 2026-11-16

Im Dashboard navigieren

Finden Sie Vorlagen, Pässe, Wallet Experiences, Delivery Center, Scanner, Stapelaktionen und Einstellungen schnell in der Seitenleiste.

In dieser Anleitung

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

Vergrößerter UI-Fokus
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.

Zentrale Workspace-Navigation

Das administrative Dashboard von Passinstance bietet eine einheitliche Oberfläche für Betriebsmonitoring, Karten-Design-Studio, Massenverarbeitung und Entwicklerkonfiguration. Die linke Navigationsleiste strukturiert Ihre täglichen Arbeitsabläufe in spezialisierte Funktionsbereiche:

Workspace-Seitenleistennavigation
Workspace-Seitenleistennavigation
Navigationsbereich & RouteHauptaufgabenZugrunde liegende Backend-Funktionen & Entitäten
Dashboard (/dashboard)Live-Workspace-KPIs, Echtzeit-Ereignis-Telemetrie und Pass-Health-KennzahlenUnterstützt durch Dashboard Analytics API (/api/v1/dashboards/analytics), mehrzeilige Widgets und Echtzeit-Event-Streams.
Vorlagen (Templates) (/templates)Visuelles Pass-Studio mit 7 Detail-Tabs (Overview, Passes, Distribution, Scanner, Analytics, Activity log, Settings)Bietet Single-Table-Versionierung (Template), Vorab-Risikoprüfungen, benutzerdefinierte ID-Regex-Regeln und Bundle-Einstellungen.
Pässe (Passes) (/passes)Verzeichnis aller ausgegebenen Pässe, externalId-Suche, bundleId-Gruppierung, Verlaufs-Timelines und Drawer-BearbeitungLeistungsstarkes Verzeichnis auf Basis von structured JSON-Attributen, Lebenszyklusübergängen (PassLifecycleStatus) und sofortiger Deaktivierung/Entwertung.
Verteilung (Distribution) (/templates/download-pages, /delivery-center, /pass-flows)Bündelt Download-Seiten (DownloadPage), Delivery Center (EmailSendCampaign) und PassFlows (PassFlow)Verwaltet öffentliche Abrufseiten (/d/:slug), E-Mail-/SMS-Versandkampagnen und mehrstufige Registrierungs-/Zahlungsstrecken (/f/:url).
Automationen (/automations, /workflows)Ereignisgesteuerte und E-Commerce-AutomatisierungsregelnWertet UniversalAutomation-Regeln und Workflow-Trigger (workflow trigger type, workflow action type) aus.
Scanner (/scanner/configs)Kassenvalidierung, Einlass-Check-in, Validation Places und Einrichtung von Hardware-LesegerätenVerwaltet ValidationPlace, ScannerConfiguration, mobile Scanner-Kopplungen (ScannerKey) sowie NFC-/POS-Adapter.
Stapelverarbeitung (Batch) (/batch-processing, /batch-notifications)Asynchroner CSV-Massenausgabe-Assistent und geplante Wallet-BenachrichtigungenSteuert Batch Jobs API (/api/v1/batch-processing) und Batch Notifications API (/api/v1/batch-notifications).
Wallet Experiences (/wallet-experiences / /pass-projects)Multi-Karten-Projektzentrale (Overview, Cards, Audience, Automations, Distribution, Analytics, Settings)Verwaltet PassProject, PassProjectTemplateRole, .pkpasses-Bundles und vorlagenübergreifende Automationen.
Integrationen & Analysen (/settings/workspace/integrations, /analytics)Verbundene CRM-/POS-Konnektoren, Webhooks, API-Schlüssel und Reporting-SuitenVerwaltet Webhooks (/api/v1/webhooks/*), berechtigungsbegrenzte API-Schlüssel und /api/v1/analytics/*-Berichte.

Dashboard-Architektur & Telemetrie-Endpunkte

Die Metrik-Engine des Dashboards basiert auf einer modularen Widget- und Caching-Architektur (Dashboard, Row, Widget und SharedDashboard in Passinstance database). Das Backend arbeitet mit Cache Manager zusammen, um reaktionsschnelle Analysen ohne Abfragelast auf transaktionalen Pass-Tabellen bereitzustellen:

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
DASHBOARD-TELEMETRIE-PIPELINE
STUFE 01 Client-Dashboard
(React / Vite)
STUFE 02 Dashboard Analytics API
(/api/v1/dashboards/analytics
/metrics/realtime)
STUFE 03 Cache Manager
(RBAC-isolierter Cache mit Event-Invalidierung
STUFE 02 database-Aggregate
Pass- & Gerätezahlen

Wichtige Telemetrie-Endpunkte

Entwickler und Datenplattformen können diese Analyse-Endpunkte per Bearer-Token oder Session-Cookie abfragen:

  • GET /api/v1/dashboards/analytics: Liefert aggregierte Workspace-Metriken über Dashboard Analytics Engine.getDashboardAnalytics und Cache Manager.
  • GET /api/v1/dashboards/metrics/realtime: Liefert hochfrequente Aktivitätszahlen sowie aktuelle Installations- und Scan-Telemetrie.
  • GET /api/v1/dashboards/analytics/range?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD: Liefert Zeitreihen-Kohorten über einen frei wählbaren Zeitraum.
  • GET /api/v1/dashboards/performance: Überwacht die operative Performance von Scans und Pass-Auslieferungen.
  • GET /api/v1/dashboards/insights: Zeigt automatisierte operative Empfehlungen für Ihren Workspace an.
  • GET /api/v1/dashboards/export?format=csv|json|pdf: Exportiert Dashboard-Kennzahlentabellen für BI-Systeme und Abstimmungen.

Funktionsbereiche & Workspace-Ansichten

1. Vorlagen-Studio (/templates/:id/*)

Erstellen und bearbeiten Sie visuelle Vorlagen in 7 Tabs (Overview, Passes, Distribution, Scanner, Analytics, Activity log, Settings). Konfigurieren Sie image asset slot-Slots, prüfen Sie WCAG-Farbkontraste, definieren Sie benutzerdefinierte ID-Regeln und testen Sie Änderungen isoliert im Zustand DRAFT, bevor Sie veröffentlichen.

2. Pass-Verzeichnis & Timeline (/passes)

Durchsuchen Sie ausgegebene Pässe per Volltextsuche und Filterkriterien (status, templateId, externalId, bundleId). Öffnen Sie jeden Pass im Pass Details panel, um die chronologische Timeline (GET /api/v1/passes/:id/history und /timeline) und gekoppelte Geräte einzusehen oder Push-Updates auszulösen.

3. Stapelverarbeitungs-Zentrale (/batch-processing)

Folgen Sie den Assistenten-Schritten (Vorlage -> CSV hochladen -> Felder zuordnen -> Versandoptionen -> Verarbeiten), um Pässe per CSV-Datei massenhaft auszugeben oder zu aktualisieren. Laden Sie Beispielschemata herunter (GET /api/v1/batch-processing/templates/:templateId/sample-csv), nutzen Sie Empfehlungen zur Feldzuordnung (POST /api/v1/batch-processing/templates/:templateId/field-mapping-recommendations) und laden Sie /result.csv mit allen erzeugten Pass-URLs und externalId-Werten herunter.

Wichtig: Alle Dashboard-Telemetrie- und Suchabfragen sind strikt auf Ihren aktiven Workspace-Mandanten (customerId) beschränkt. Schwester-Workspaces innerhalb derselben Organisation bleiben vollständig getrennt.

Erkunden Sie jede Ansicht interaktiv in unserer interaktiven Workspace-Tour.

Weiterführende Produkt- & Entwicklerdoku

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.