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:
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
| Dashboardweergave | Onderliggende API-eindpunten | Primaire telemetrie en mogelijkheden |
|---|---|---|
Werkruimte-overzicht (/analytics) | GET /api/v1/dashboards/analyticsGET /api/v1/dashboards/metrics/realtimeGET /api/v1/dashboards/insights | Realtime 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/range | Meerdelige grafieken voor pasaanmaak versus wallet-installatie, netto platformwijzigingen (walletAppsChanges), vergelijkingen van aangepaste datumbereiken en entiteitsfiltering op scope. |
| Systeemprestaties | GET /api/v1/dashboards/performance | Latentie 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
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.
-
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).
-
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:
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)
{
"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:
GET /api/v1/dashboards/insights HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
{
"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
-
Bekijk exacte KPI-formules in Statistieken over pasuitgifte en gebruik.
-
Analyseer conversieratio's per kanaal in Distributie- en betrokkenheidsanalytics.
-
Exporteer onderliggende ruwe datasets via Gegevensexport en rapportage.
