Skip to content
Hilfecenter-AnleitungOnboarding-Phase 6
4 Min. LesezeitGeprüft 2026-11-16

Ausgabe- & Nutzungskennzahlen

Verstehen Sie Erstellte Pässe, Aktiv in Wallets, Nicht installiert, Entfernt sowie Apples Mehrfachgeräte-Zählweise.

In dieser Anleitung

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

Vergrößerter UI-Fokus
Wichtige UI-Elemente

Pass-Zustand & Empfohlene Aktionen (Zoom)

Verfolgen Sie das Verhältnis aktiver zu nicht installierten Pässen unter Pass health und nutzen Sie automatische Empfehlungen zur Nachverfolgung offener Installationen.

Übersicht

Eine präzise Interpretation der Wallet-Telemetrie erfordert eine strikte architektonische Trennung zwischen Karteninstanzen (logischen Ausweisdatensätzen, die in der Datenbank ausgestellt und über die UUID id, die serialNumber sowie eine optionale vorgelagerte externalId identifiziert werden) und Geräteregistrierungen (physischen Smartphones oder Wearables, die diese Ausweise aktiv unter der Apple-bundleId / dem passTypeIdentifier der Vorlage oder der Google-Wallet-Objekt-ID gespeichert haben).

Passinstance setzt diese Trennung in metric-definitions.ts (PASS_ANALYTICS_METRIC_DEFINITIONS und WALLET_INSTALLATION_METRIC_DEFINITIONS) durch und stellt sie im Dashboard unter Analysen -> Karten (/analytics/passes) sowie über /api/v1/analytics/* visuell dar, damit Marketingteams und Abrechnungsadministratoren generierte Links niemals mit tatsächlich installierten Wallet-Karten verwechseln.

Architektonische Trennung: Karteninstanzen vs. Geräteregistrierungen

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
TAXONOMIE VON KARTENINSTANZ VS. GERÄTEREGISTRIERUNG
STUFE 01
1
LOGISCHE KARTENINSTANZ-SCHICHT (1 Kartendatensatz = 1 eindeutige serialNumber) [ Karte erstellt ]+[ Nicht abgerufen (unclaimedPasses) ] (0 Reg.) (totalPasses)
+[ Aktiv (activePasses) ] (>= 1 aktive Reg.) +[ Entfernt (inactivePasses) ] (Alle Reg. entfernt) +[ Endgültig (expiredPasses / voidedPasses) ]
STUFE 02
Apple-Wallet-Ökosystem (APNs)
iPhone des Kunden (Reg. #1)
Gekoppelte Apple Watch (Reg. #2)
1 aktive Karte = 2 Gerätereg.
Google-Wallet-Ökosystem (REST)
PassObject verknüpft mit Google
Save-/Remove-Callback-Sync
1 aktive Karte = 1 Objektreg.
2
PHYSISCHE GERÄTEREGISTRIERUNGS-SCHICHT (installedDevices über uniqueDevices hinweg)

Wichtig: In GET /api/v1/analytics/wallet-installations zählt eine einzelne Karte, die sowohl auf dem iPhone als auch auf der Apple Watch eines Kunden installiert ist, in der Karteninstanz-Übersicht als 1 activePasses, während in der Geräteregistrierungs-Übersicht 2 installedDevices erfasst werden, da APNs Push-Benachrichtigungen unabhängig an jedes einzelne Geräte-Token zustellt.

Kanonische Metrikdefinitionen (metric-definitions.ts)

Metriken zu Karteninstanzen

MetrikschlüsselBezeichnung im DashboardTechnische Definition & Berechnungsgrundlage
totalPassesInsgesamt ausgestellte KartenGesamtzahl der zum Zeitpunkt des Snapshots ausgestellten und nicht gelöschten Kartendatensätze.
activePassesAktive KartenAktive Karteninstanzen, die derzeit über mindestens eine erreichbare Geräteregistrierung verfügen (schließt abgelaufene und entwertete Karten in der Standard-Kartenübersicht aus).
inactivePassesEntfernte KartenAktive Karteninstanzen, die zuvor in einer Wallet gespeichert waren, aber über keine erreichbaren Geräteregistrierungen mehr verfügen (removedPasses in Installationsberichten).
unclaimedPassesNicht abgerufene KartenAktive Karteninstanzen, die per API, CSV oder PassFlow ausgestellt, aber noch nie in einer Geräte-Wallet gespeichert wurden (noRegistrationPasses).
expiredPassesAbgelaufene KartenKarteninstanzen, deren expirationDate überschritten wurde oder deren Status als EXPIRED markiert ist.
voidedPassesEntwertete KartenKarteninstanzen, die serverseitig über das Dashboard, einen Workflow oder VOIDED_AFTER_SCAN scan mode widerrufen bzw. ungültig gemacht wurden.

Metriken zu Geräteregistrierungen

MetrikschlüsselBezeichnung im DashboardTechnische Definition & Berechnungsgrundlage
installedDevicesAktive GeräteregistrierungenGesamtzahl der erreichbaren Registrierungen gespeicherter Karten über alle physischen Geräte hinweg (1 Karte auf 2 Geräten = 2).
inactiveDeviceRegistrationsEntfernte GeräteregistrierungenRegistrierungen gespeicherter Karten, die vom Gerät abgemeldet oder aufgrund eines dauerhaften APNs-Push-Fehlers als ungültig markiert wurden.
totalDeviceRegistrationsGesamte GeräteregistrierungenKumulierte Registrierungen gespeicherter Karten über aktive und entfernte Status hinweg.
uniqueDevicesEindeutige GeräteEindeutige Hardwarekennungen physischer Geräte, die derzeit mindestens eine aktive Kartenregistrierung halten.
devicePlatformDistributionGeräteplattform-VerteilungAufschlüsselung aktiver Geräteregistrierungen nach Wallet-Ökosystem (APPLE_WALLET vs. GOOGLE_WALLET) und Betriebssystemfamilie.

Feinheiten der Wallet-Telemetrie & Sonderfälle

Zusätzlich zu bestätigten Status verfolgt der Bericht GET /api/v1/analytics/wallet-installations Statusübergänge auf Ereignisebene und Grenzfälle:

  • installEvents (Wallet-Installationen): Während des Berichtszeitraums erstellte Geräteregistrierungen, die einmal pro eindeutigem Karten-und-Geräte-Paar gezählt werden. Die Neuinstallation einer bereits registrierten Karte auf demselben Gerät erhöht den Installationszähler nicht künstlich.
  • removalEvents (Wallet-Entfernungen): Werden erfasst, wenn Apple Wallet DELETE /v1/devices/:deviceLibraryIdentifier/registrations/:passTypeIdentifier/:serialNumber aufruft oder Google Wallet einen Entfernungs-Callback sendet, zuzüglich abgeleiteter Entfernungen, wenn APNs 410 Unregistered zurückgibt.
  • otherStatePasses (Ungeklärte Registrierungen): Karten, deren einzige Registrierungen ausstehend, ausgesetzt oder in einem unbestimmten Zustand sind, der weder eine aktive Installation noch eine bestätigte Entfernung belegt.
  • noRegistrationPasses (Keine bestätigte Installation): Karten ohne jegliche Registrierungsdatensätze. Bei Apple Wallet löst die Installation immer sofort einen Geräteregistrierungsaufruf aus; bei Google Wallet basiert die Erfassung auf Speicher-Callbacks.

Zentrale API-Endpunkte für Ausgabe & Registrierung

EndpunktHTTP-VerbBeschreibung
/api/v1/analytics/passes/overviewGETMomentaufnahme von totalPasses, activePasses, inactivePasses, unclaimedPasses, expiredPasses und voidedPasses.
/api/v1/analytics/passes/createdGETZeitreihe neu erstellter Karteninstanzen, gruppiert nach day, week oder month.
/api/v1/analytics/registrationsGETZeitreihe aktiver und deaktivierter Geräteregistrierungen über das ausgewählte Zeitfenster.
/api/v1/analytics/wallet-installationsGETUmfassende Matrix, die Installationsstatus auf Kartenebene von Registrierungsereignissen auf Geräteebene trennt.

Beispiel: Detaillierte Wallet-Installationsmatrix

HTTP
GET /api/v1/analytics/wallet-installations?range=last_30days&templateId=b4f29c10-83e1-4a7b-9d12-56e8012a9c04 HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
JSON
{
  "snapshotAt": "2026-11-15T23:59:59.999Z",
  "passes": {
    "totalPasses": 5000,
    "activePasses": 3850,
    "removedPasses": 310,
    "otherStatePasses": 15,
    "noRegistrationPasses": 825
  },
  "registrations": {
    "installedDevices": 4290,
    "inactiveDeviceRegistrations": 365,
    "totalDeviceRegistrations": 4655,
    "uniqueDevices": 4180,
    "devicePlatformDistribution": {
      "apple": 2910,
      "google": 1380
    }
  },
  "periodEvents": {
    "passesCreated": 640,
    "installEvents": 595,
    "removalEvents": 42
  }
}

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.