Skip to content
Helpcentrum-gidsOnboardingfase 6
3 min leestijdGecontroleerd 2026-11-16

Uitgifte- & gebruiksstatistieken

Begrijp Aangemaakt, Actief in Wallets, Niet geïnstalleerd, Verwijderd en Apple-apparaattelling per gebruiker.

In deze gids

Interactieve UI-weergaven

Openen in onboardinggids (6 fasen)

Bekijk de exacte dashboardpanelen, knoppen en ingezoomde toelichtingen bij deze gids.

Ingezoomde UI-focus
Belangrijke UI-onderdelen

Pasgezondheid & aanbevolen acties (Ingesneden)

Volg de verhouding tussen actieve en niet-geïnstalleerde passen onder Pass health en onderneem actie op automatische aanbevelingen voor passen die wachten op installatie.

Overzicht

Voor een nauwkeurige interpretatie van Wallet-telemetrie is een strikt architectonisch onderscheid nodig tussen Pasinstanties (logische pasrecords in de database met UUID id, serialNumber en optionele externe externalId) en Apparaatregistraties (fysieke mobiele of draagbare apparaten waarop die passen actief zijn opgeslagen onder het Apple bundleId / passTypeIdentifier of het Google Wallet Object-ID van het sjabloon).

Passinstance handhaaft deze scheiding in metric-definitions.ts (PASS_ANALYTICS_METRIC_DEFINITIONS en WALLET_INSTALLATION_METRIC_DEFINITIONS), visueel getoond in Dashboard Analytics -> Passen (/analytics/passes) en via /api/v1/analytics/*, zodat marketingteams en facturatiebeheerders gegenereerde downloadlinks nooit verwarren met geïnstalleerde Wallet-kaarten.

Architectonische scheiding: Pasinstanties versus apparaatregistraties

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
TAXONOMIE PASINSTANTIE VS. APPARAATREGISTRATIE
FASE 01
1
LOGISCHE PASINSTANTIELAAG (1 Pasrecord = 1 Uniek serialNumber) [ Pas aangemaakt ]+[ Niet geclaimd (unclaimedPasses) ] (0 registraties) (totalPasses)
+[ Actief (activePasses) ] (>= 1 actieve registr.) +[ Verwijderd (inactivePasses) ] (Alle reg. gewist) +[ Beëindigd (expiredPasses / voidedPasses) ]
FASE 02
Apple Wallet-ecosysteem (APNs)
iPhone van pashouder (Reg #1)
Gekoppelde Apple Watch (Reg #2)
1 Actieve pas = 2 Apparaatreg.
Google Wallet-ecosysteem (REST)
PassObject aan Google-ID gekop.
Save/Remove Callback-sync
1 Actieve pas = 1 Objectreg.
2
FYSIEKE APPARAATREGISTRATIELAAG (installedDevices over uniqueDevices)

Belangrijk: In GET /api/v1/analytics/wallet-installations telt één pas die zowel op de iPhone als op de Apple Watch van een klant is geïnstalleerd als 1 activePasses in het pasoverzicht, terwijl 2 installedDevices worden vastgelegd bij de apparaatregistraties omdat APNs pushmeldingen afzonderlijk naar elk apparaattoken verstuurt.

Canonieke statistiekdefinities (metric-definitions.ts)

Pasinstantie-statistieken

StatistieksleutelDashboardlabelTechnische definitie & berekeningsgrondslag
totalPassesTotaal uitgegeven passenTotaal aantal uitgegeven en niet-verwijderde pasrecords op het momentopname-tijdstip.
activePassesActieve passenLive pasinstanties met momenteel ten minste één bereikbare apparaatregistratie (exclusief verlopen en ongeldige passen in het standaard pasoverzicht).
inactivePassesVerwijderde passenLive pasinstanties die eerder in een Wallet waren opgeslagen maar geen bereikbare apparaatregistraties meer hebben (removedPasses in installatierapporten).
unclaimedPassesNiet-geclaimde passenLive pasinstanties uitgegeven via API, CSV of PassFlow die nog nooit in een apparaat-Wallet zijn opgeslagen (noRegistrationPasses).
expiredPassesVerlopen passenPasinstanties waarvan de expirationDate is verstreken of met status EXPIRED.
voidedPassesOngeldig verklaarde passenPasinstanties die aan de serverzijde zijn ingetrokken of ongeldig verklaard via dashboard, workflow of VOIDED_AFTER_SCAN scan mode.

Apparaatregistratie-statistieken

StatistieksleutelDashboardlabelTechnische definitie & berekeningsgrondslag
installedDevicesActieve apparaatregistratiesTotaal aantal bereikbare opgeslagen pasregistraties verdeeld over alle fysieke toestellen (1 pas op 2 toestellen = 2).
inactiveDeviceRegistrationsVerwijderde apparaatregistratiesOpgeslagen pasregistraties die door het apparaat zijn afgemeld of door permanente APNs-pushfouten ongeldig zijn geworden.
totalDeviceRegistrationsTotaal apparaatregistratiesCumulatieve opgeslagen pasregistraties over zowel actieve als verwijderde toestanden.
uniqueDevicesUnieke apparatenOnderscheiden fysieke apparaat-identificaties die momenteel minstens één actieve pasregistratie bevatten.
devicePlatformDistributionApparaatplatformverdelingUitsplitsing van actieve apparaatregistraties per Wallet-ecosysteem (APPLE_WALLET vs. GOOGLE_WALLET) en besturingssysteem.

Nuances & randgevallen bij Wallet-telemetrie

Naast bevestigde toestanden volgt GET /api/v1/analytics/wallet-installations overgangen op gebeurtenisniveau:

  • installEvents (Wallet-installaties): Apparaatregistraties aangemaakt in de rapportageperiode, éénmaal geteld per unieke combinatie van pas en apparaat. Herinstalleren op hetzelfde toestel verhoogt dit cijfer niet kunstmatig.
  • removalEvents (Wallet-verwijderingen): Vastgelegd zodra Apple Wallet DELETE /v1/devices/:deviceLibraryIdentifier/registrations/:passTypeIdentifier/:serialNumber aanroept of Google Wallet een verwijderingscallback stuurt, aangevuld met afgeleide verwijderingen wanneer APNs 410 Unregistered teruggeeft.
  • otherStatePasses (Onbesliste registraties): Passen waarvan alle registraties nog in behandeling, opgeschort of in een tussenstatus verkeren die noch een actieve installatie noch een definitieve verwijdering bewijst.
  • noRegistrationPasses (Geen bevestigde installatie): Passen met nul registratierecords. Bij Apple Wallet leidt installatie altijd tot directe apparaatregistratie; bij Google Wallet is registratie afhankelijk van opslagcallbacks.

Belangrijkste API-endpoints voor uitgifte & registraties

EndpointHTTP-methodeBeschrijving
/api/v1/analytics/passes/overviewGETMomentopname van totalPasses, activePasses, inactivePasses, unclaimedPasses, expiredPasses en voidedPasses.
/api/v1/analytics/passes/createdGETTijdreeks van nieuw aangemaakte pasinstanties gegroepeerd op day, week of month.
/api/v1/analytics/registrationsGETTijdreeks van actieve en gedeactiveerde apparaatregistraties in het gekozen venster.
/api/v1/analytics/wallet-installationsGETVolledige matrix die installatietoestanden op pasniveau scheidt van apparaatregistraties.

Voorbeeld: Gedetailleerde Wallet-installatiematrix

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
  }
}

Gerelateerde documentatie

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.