Overview
Issuing a pass record is only the first step in the customer journey. Distribution & Engagement Analytics (/analytics/downloads in the Dashboard) tracks the complete conversion funnel from initial invitation (email campaign, SMS, QR scan, or public PassFlow intake form) through smart download link routing (/d/:slug, /s/:token) to confirmed native wallet installation and subsequent push update engagement.
End-to-End Distribution & Conversion Funnel
Important: Visitor and session metrics (
uniqueVisitorsandvisits) use privacy-safe first-party session identifiers with anonymized fallback bucketing—ensuring full GDPR compliance without relying on third-party cross-site tracking cookies.
Download Page Telemetry (DownloadEventType) & Funnel Metrics
Every interaction on a Public Download Page (/d/:slug, /download/:slug, /s/:token) is categorized by the Passinstance database DownloadEventType enum (PAGE_VIEW, DOWNLOAD_STARTED, DOWNLOAD_COMPLETED, DOWNLOAD_FAILED, QR_SCAN, SHARE_CLICK, BUTTON_HOVER, BUTTON_CLICK), rolling up into PASS_ANALYTICS_METRIC_DEFINITIONS alongside PassFlow funnel metrics:
| Metric Key | Surface Scope | Technical Definition |
|---|---|---|
uniqueVisitors | Download Page & PassFlow | Distinct browsers or devices reaching the public surface during the reporting period. |
visits | Download Page & PassFlow | Distinct visitor sessions reaching the selected public surface. |
pageViews | Public Surfaces | Rendered HTML page-view events (PAGE_VIEW; narrower than visits when direct .pkpass MIME streaming bypasses PassFlow on iOS Safari). |
interactions | Download Page & PassFlow | Tracked user actions including save initiations (BUTTON_CLICK), QR code scans (QR_SCAN), share actions (SHARE_CLICK), OTP verifications, and form submissions. |
saveInitiations | Download Page Only | Tracked clicks on Add to Apple Wallet or Save to Google Wallet buttons (DOWNLOAD_STARTED). |
saveCompletions | Download Page Only | Confirmed wallet save or pass download completions from a public download page (DOWNLOAD_COMPLETED). |
submissions | PassFlow Only | Customer form submission attempts on a public PassFlow enrollment page. |
conversions | PassFlow Only | Successful pass generations completed from a PassFlow submission. |
conversionRate | Download Page & PassFlow | Ratio of tracked completions (saveCompletions or conversions) divided by visits. |
Email Campaign Tracking & Deliverability Health
When distributing passes through the Delivery Center, Passinstance tracks recipient-level engagement and managed email delivery feedback loops:
-
1
Open & Click Tracking: Outbound campaign emails embed prefix-free pixel and redirect telemetry (
GET /email-campaigns/track/:recipientId/openandGET /email-campaigns/track/:recipientId/click) to attribute downstream wallet installations back to specific sendout batches. -
2
Bounce & Complaint Suppression: Hard bounces, soft bounces, and spam complaint webhooks (
POST /api/v1/email-campaigns/webhooks/sesandPOST /api/v1/webhooks/ses) from managed email delivery are logged in campaign analytics and automatically added to the workspace suppression list to protect your custom sender domain (SPF/DKIM) reputation. -
3
One-Click Unsubscribe Compliance: Marketing communications embed tokenized RFC 8058 headers (
POST /email/unsubscribe/:tokenand safe redirectGET /email/unsubscribe/:token) alongside self-service preference portals (/email/preferences/:token).
Push Update Volume & Platform Share (walletAppsShare)
Once passes are installed, ongoing engagement is measured by how effectively push updates reach customer lock screens and how your audience splits across mobile ecosystems.
Querying Push Update Delivery Volume
Use GET /api/v1/analytics/passes/updates to audit the volume of background pass updates dispatched via Apple Push Notification service (APNs HTTP/2) and the 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>
Response Payload (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
}
]
}
Querying PassFlow Funnel Performance
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
}
}
Related Documentation
-
Configure custom sender domains in Custom Branding & White-Label Options.
-
Review pass status definitions in Pass Issuance & Usage Metrics.
