Overzicht
Het aanmaken van een pasrecord is slechts de eerste stap in de klantreis. Distributie- en betrokkenheidsanalytics (/analytics/downloads in het Dashboard) volgt de volledige conversietrechter vanaf de eerste uitnodiging (e-mailcampagne, sms, QR-scan of openbaar PassFlow-aanmeldformulier) via de routering van slimme downloadlinks (/d/:slug, /s/:token) tot aan de bevestigde installatie in de systeemeigen wallet en de daaropvolgende betrokkenheid bij push-updates.
End-to-end distributie- en conversietrechter
Belangrijk: Bezoekers- en sessiestatistieken (
uniqueVisitorsenvisits) maken gebruik van privacyveilige first-party sessie-ID's met geanonimiseerde fallback-bucketing — wat volledige AVG-compliance garandeert zonder afhankelijk te zijn van cross-site trackingcookies van derden.
Telemetrie van downloadpagina's (DownloadEventType) en trechterstatistieken
Elke interactie op een openbare downloadpagina (/d/:slug, /download/:slug, /s/:token) wordt gecategoriseerd door de Passinstance database-enum DownloadEventType (PAGE_VIEW, DOWNLOAD_STARTED, DOWNLOAD_COMPLETED, DOWNLOAD_FAILED, QR_SCAN, SHARE_CLICK, BUTTON_HOVER, BUTTON_CLICK) en geaggregeerd in PASS_ANALYTICS_METRIC_DEFINITIONS naast de trechterstatistieken van PassFlow:
| Statistieksleutel | Oppervlakscope | Technische definitie |
|---|---|---|
uniqueVisitors | Downloadpagina & PassFlow | Unieke browsers of apparaten die het openbare oppervlak tijdens de rapportageperiode bereiken. |
visits | Downloadpagina & PassFlow | Unieke bezoekerssessies die het geselecteerde openbare oppervlak bereiken. |
pageViews | Openbare oppervlakken | Weergegeven HTML-paginaweergaven (PAGE_VIEW; specifieker dan visits wanneer directe .pkpass MIME-streaming op iOS Safari PassFlow overslaat). |
interactions | Downloadpagina & PassFlow | Gevolgde gebruikersacties waaronder opslaginitiaties (BUTTON_CLICK), QR-codescans (QR_SCAN), deelacties (SHARE_CLICK), OTP-verificaties en formulierinzendingen. |
saveInitiations | Alleen downloadpagina | Gevolgde klikken op de knoppen Add to Apple Wallet of Save to Google Wallet (DOWNLOAD_STARTED). |
saveCompletions | Alleen downloadpagina | Bevestigde voltooiingen van wallet-opslag of pasdownloads vanaf een openbare downloadpagina (DOWNLOAD_COMPLETED). |
submissions | Alleen PassFlow | Pogingen tot formulierinzending door klanten op een openbare PassFlow-inschrijfpagina. |
conversions | Alleen PassFlow | Succesvol gegenereerde passen voltooid vanuit een PassFlow-inzending. |
conversionRate | Downloadpagina & PassFlow | Verhouding van gevolgde voltooiingen (saveCompletions of conversions) gedeeld door visits. |
E-mailcampagnetracking en aflevergezondheid
Bij het verspreiden van passen via het Delivery Center volgt Passinstance de betrokkenheid op ontvangersniveau en de feedbackloops van managed email delivery:
-
1
Open- en kliktracking: Uitgaande campagne-e-mails bevatten prefixvrije pixel- en omleidingstelemetrie (
GET /email-campaigns/track/:recipientId/openenGET /email-campaigns/track/:recipientId/click) om latere wallet-installaties toe te schrijven aan specifieke verzendbatches. -
2
Onderdrukking van bounces en klachten: Webhooks voor harde bounces, zachte bounces en spamklachten (
POST /api/v1/email-campaigns/webhooks/sesenPOST /api/v1/webhooks/ses) van managed email delivery worden vastgelegd in de campagne-analytics en automatisch toegevoegd aan de onderdrukkingslijst van de werkruimte om de reputatie van uw aangepaste afzenderdomein (SPF/DKIM) te beschermen. -
3
Naleving van uitschrijven met één klik: Marketingcommunicatie bevat getokeniseerde RFC 8058-headers (
POST /email/unsubscribe/:tokenen veilige omleidingGET /email/unsubscribe/:token) naast zelfbedieningsportalen voor voorkeuren (/email/preferences/:token).
Volume van push-updates en platformaandeel (walletAppsShare)
Zodra passen zijn geïnstalleerd, wordt de doorlopende betrokkenheid gemeten aan de hand van hoe effectief push-updates het toegangsscherm van klanten bereiken en hoe uw doelgroep is verdeeld over mobiele ecosystemen.
Aflevervolume van push-updates opvragen
Gebruik GET /api/v1/analytics/passes/updates om het volume aan achtergrond-pasupdates te controleren dat is verzonden via de Apple Push Notification service (APNs HTTP/2) en de Google Wallet REST API:
GET /api/v1/analytics/passes/updates?range=last_30days&bucket=day HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Antwoordpayload (200 OK)
{
"range": "last_30days",
"bucket": "day",
"totals": {
"dispatchedUpdates": 18420,
"appleApnsDelivered": 12650,
"googleWalletPatched": 5690,
"failedOrUnregistered": 80
},
"series": [
{
"bucketStart": "2026-11-14",
"appleApnsDelivered": 410,
"googleWalletPatched": 195,
"failedOrUnregistered": 3
},
{
"bucketStart": "2026-11-15",
"appleApnsDelivered": 520,
"googleWalletPatched": 230,
"failedOrUnregistered": 2
}
]
}
Trechterprestaties van PassFlow opvragen
GET /api/v1/analytics/overview?scope=passFlow&passFlowId=9a1c4e22-7b11-4d90-8c34-12f908a7e311&range=last_30days HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
{
"scope": "passFlow",
"passFlowId": "9a1c4e22-7b11-4d90-8c34-12f908a7e311",
"metrics": {
"uniqueVisitors": 3420,
"visits": 3890,
"pageViews": 4120,
"interactions": 3150,
"submissions": 2840,
"conversions": 2795,
"conversionRate": 71.85,
"saveCompletions": 2410
},
"walletAppsShare": {
"apple": 1690,
"google": 720,
"total": 2410
}
}
Gerelateerde documentatie
-
Configureer aangepaste afzenderdomeinen in Aangepaste branding en white-label opties.
-
Bekijk definities van passtatussen in Statistieken over pasuitgifte en gebruik.
