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

Analysedashboard

Gebruik Overzicht- en Analysemodi, periodefilters, Apple vs. Google-verhoudingen en Pass Health-tips.

In deze gids

Interactieve UI-weergaven

Openen in onboardinggids (6 fasen)

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

Ingezoomde UI-focus1 / 2
Belangrijke UI-onderdelen

Werkruimte-dashboard — Live KPI's & trends (Ingezoomd)

Volg in productie direct Active in Wallets, Removed, Not Installed en de uitgifte- en registratiecurves.

Overzicht

Het Analytics-dashboard (/analytics, /analytics/passes, /analytics/downloads, /templates/:id/analytics op sjabloonniveau en aangepaste weergaven onder /dashboards) biedt realtime operationele telemetrie en historische tijdreeksaggregatie over uw gehele werkruimte zonder dat externe business intelligence-pijplijnen nodig zijn. Aangedreven door Dashboard Analytics API (/api/v1/dashboards/*) en Analytics API (/api/v1/analytics/*), presenteert de console multidimensionale statistieken over pasuitgifte, actieve apparaatregistraties, verdelingen van platforminstallaties en proactieve diagnostiek voor Pasgezondheid (Pass Health).

Operators kunnen schakelen tussen de Overzicht-modus op hoog niveau — geoptimaliseerd voor zakelijke KPI's, gezondheidswaarschuwingen en directe operationele status — en de diepgaande Analytics-modus voor cohortanalyses over specifieke sjablonen, distributiekanalen en tijdsintervallen.

Architectuur voor telemetrie-aggregatie

Passinstance scheidt live operationele tellers van historische tijdreeksaggregaties om een weergave van het dashboard binnen een fractie van een seconde te garanderen, zelfs in werkruimten met honderdduizenden actieve passen:

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
SYSTEEMARCHITECTUURSTROOM: ANALYTICS- & DASHBOARD-TELEMETRIEPIJPLIJN
FASE 01 INNAME & GEBEURTENISBRONNEN
Apple Web Service
/v1/devices/...
Google Wallet JWT
Save/Remove Callback
Scanner- & PassFlow-
runtimegebeurtenissen
FASE 02 ANALYTICS- & 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 (Tijdzone-genormaliseerd)
Dashboard Analytics API (/api/v1/dashboards)
/analytics & /analytics/range (Executive KPI's & periodevergelijking)
/metrics/realtime (Live actieve passen, wachtrijdoorvoer & scans)
/performance & /insights (Diagnostiek pasgezondheid & actiepunten)
FASE 03 PASSINSTANCE DASHBOARD-UI
KPI-overzichtskaarten &
Apple vs. Google-aandeel
Meerdelige trend-
grafieken (dag/wk/mnd)
Pasgezondheid &
knelpuntmeldingen

Belangrijk: Alle tijdreeksintervallen (day, week, month) worden uitgelijnd en geëvalueerd op basis van de geconfigureerde regionale tijdzone van uw werkruimte (GET /api/v1/customer/:customerId/regional-settings), zodat daggrenzen exact overeenkomen met de lokale openingstijden van uw vestigingen.

Modi Werkruimte-overzicht vs. Diepgaande analytics

DashboardweergaveOnderliggende API-eindpuntenPrimaire telemetrie en mogelijkheden
Werkruimte-overzicht (/analytics)GET /api/v1/dashboards/analyticsGET /api/v1/dashboards/metrics/realtimeGET /api/v1/dashboards/insightsRealtime teller voor actieve passen, groeiverschillen over 30 dagen, live scansnelheid, waarschuwingen voor verlopende certificaten en direct toepasbare aanbevelingen voor Pasgezondheid.
Diepgaande analytics (/analytics/passes & /analytics/downloads)GET /api/v1/analyticsGET /api/v1/analytics/overviewGET /api/v1/dashboards/analytics/rangeMeerdelige grafieken voor pasaanmaak versus wallet-installatie, netto platformwijzigingen (walletAppsChanges), vergelijkingen van aangepaste datumbereiken en entiteitsfiltering op scope.
SysteemprestatiesGET /api/v1/dashboards/performanceLatentie bij het verzenden van pushmeldingen, succesratio's van APNs/Google Wallet-synchronisatie en responstijden van scannerverificatie.

Filter-enumeraties: AnalyticsScope, AnalyticsRange en AnalyticsBucket

Bij het bevragen van GET /api/v1/analytics of GET /api/v1/analytics/overview (request payload) kunt u werkruimtetelemetrie uitsplitsen over drie orthogonale enumeraties:

  1. 1
    AnalyticsScope (scope):

- customer: Aggregeert alle sjablonen, passtromen en scannerconfiguraties binnen de geauthenticeerde werkruimte (automatisch afgeleid uit uw sessie/API-sleutel). - owner: Aggregeert werkruimte-overschrijdende statistieken voor organisatie-eigenaren die meerdere gekoppelde omgevingen beheren. - template: Isoleert uitgifte-, registratie- en verwijderingsstatistieken tot één enkele UUID templateId. - passFlow: Isoleert openbare instapbezoeken, formulierinzendingen en conversieratio's tot een specifieke UUID passFlowId.

  1. 2
    AnalyticsRange (range):

- Vooraf ingestelde vensters: last_7days, last_30days, last_12_months. - Aangepaste intervallen: custom gecombineerd met ISO YYYY-MM-DD from- en to-queryparameters (from=2026-10-15&to=2026-11-16).

  1. 3
    AnalyticsBucket (bucket):

- day: Dagelijkse datapunten (standaard voor vensters van 7 en 30 dagen). - week: ISO-weekaggregaties voor trendanalyses over meerdere maanden. - month: Kalendermaandaggregaties (standaard voor last_12_months).

Programmatische telemetrie API-referentie

Meerdelige werkruimte-analytics ophalen

Haal tijdreekscurven op voor gebeurtenissen in de paslevenscyclus, apparaatregistraties en distributie over wallet-ecosystemen:

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>

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

Realtime statistieken en inzichten in pasgezondheid opvragen

Om live tellerstatussen en diagnostische aanbevelingen op te vragen via Dashboard Analytics API:

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

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.