Skip to content
Help Center GuideOnboarding Phase 6
3 min readVerified 2026-11-16

Distribution & Engagement Analytics

Measure delivery channel reachability, SES bounce/complaint logs, download page conversions, and push notification execution.

In This Guide

Interactive UI Walkthroughs

Open in 6-Phase Onboarding Guide

Inspect exact dashboard panels, controls, and zoomed callouts related to this guide.

Zoomed UI focus1 / 2
Key UI elements

Template Analytics — Lifecycle & reachability (Zoomed)

Track Active passes, Unclaimed passes, Active device registrations, Pass lifecycle metrics, and Device registration reachability.

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

SYSTEM ARCHITECTURE FLOW
INTERACTIVE ARCHITECTURE
DISTRIBUTION & ENGAGEMENT CONVERSION FUNNEL
STAGE 01 STAGE 1: OUTBOUND & INBOUND CHANNELS
Email Campaign Sendout
track/:recipientId/..
Public PassFlow Intake
visits & pageViews
Smart Download Link
GET/d/:slug
STAGE 02 STAGE 2: PUBLIC SURFACE INTERACTION LAYER
uniqueVisitors & visits (First-Party Session & Privacy-Safe Bucketing)
DownloadEventType: PAGE_VIEW | QR_SCAN | BUTTON_CLICK | DOWNLOAD_STARTED
saveInitiations (Tap on "Add to Apple Wallet" or "Save to Google Wallet")
STAGE 03 STAGE 3: WALLET INSTALLATION & PUSH ENGAGEMENT
DOWNLOAD_COMPLETED / saveCompletions (conversionRate = comp / visits)
walletAppsShare (Apple iOS/watchOS vs. Android Google Wallet Split)
GET/api/v1/analytics/passes/updates (APNs & Google Push Update Volume)

Important: Visitor and session metrics (uniqueVisitors and visits) 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 KeySurface ScopeTechnical Definition
uniqueVisitorsDownload Page & PassFlowDistinct browsers or devices reaching the public surface during the reporting period.
visitsDownload Page & PassFlowDistinct visitor sessions reaching the selected public surface.
pageViewsPublic SurfacesRendered HTML page-view events (PAGE_VIEW; narrower than visits when direct .pkpass MIME streaming bypasses PassFlow on iOS Safari).
interactionsDownload Page & PassFlowTracked user actions including save initiations (BUTTON_CLICK), QR code scans (QR_SCAN), share actions (SHARE_CLICK), OTP verifications, and form submissions.
saveInitiationsDownload Page OnlyTracked clicks on Add to Apple Wallet or Save to Google Wallet buttons (DOWNLOAD_STARTED).
saveCompletionsDownload Page OnlyConfirmed wallet save or pass download completions from a public download page (DOWNLOAD_COMPLETED).
submissionsPassFlow OnlyCustomer form submission attempts on a public PassFlow enrollment page.
conversionsPassFlow OnlySuccessful pass generations completed from a PassFlow submission.
conversionRateDownload Page & PassFlowRatio 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. 1
    Open & Click Tracking: Outbound campaign emails embed prefix-free pixel and redirect telemetry (GET /email-campaigns/track/:recipientId/open and GET /email-campaigns/track/:recipientId/click) to attribute downstream wallet installations back to specific sendout batches.
  2. 2
    Bounce & Complaint Suppression: Hard bounces, soft bounces, and spam complaint webhooks (POST /api/v1/email-campaigns/webhooks/ses and POST /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. 3
    One-Click Unsubscribe Compliance: Marketing communications embed tokenized RFC 8058 headers (POST /email/unsubscribe/:token and safe redirect GET /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:

HTTP
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)

JSON
{
  "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

HTTP
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>
JSON
{
  "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
  }
}

Ready to launch your first pass program?

Create your workspace, configure your pass template, and test a real pass in Apple Wallet and Google Wallet before you scale.