Übersicht
Das Ausstellen eines Kartendatensatzes ist nur der erste Schritt auf der Customer Journey. Verteilungs- & Engagement-Analysen (/analytics/downloads im Dashboard) verfolgen den gesamten Konversionstrichter von der ersten Einladung (E-Mail-Kampagne, SMS, QR-Scan oder öffentliches PassFlow-Registrierungsformular) über das Routing intelligenter Download-Links (/d/:slug, /s/:token) bis hin zur bestätigten nativen Wallet-Installation und der anschließenden Interaktion durch Push-Updates.
Durchgängiger Verteilungs- & Konversionstrichter
Wichtig: Besucher- und Sitzungsmetriken (
uniqueVisitorsundvisits) verwenden datenschutzfreundliche First-Party-Sitzungskennungen mit anonymisiertem Fallback-Bucketing – dies gewährleistet vollständige DSGVO-Konformität ohne den Einsatz von seitenübergreifenden Drittanbieter-Tracking-Cookies.
Telemetrie der Download-Seite (DownloadEventType) & Trichtermetriken
Jede Interaktion auf einer öffentlichen Download-Seite (/d/:slug, /download/:slug, /s/:token) wird durch das Passinstance database-Enum DownloadEventType (PAGE_VIEW, DOWNLOAD_STARTED, DOWNLOAD_COMPLETED, DOWNLOAD_FAILED, QR_SCAN, SHARE_CLICK, BUTTON_HOVER, BUTTON_CLICK) kategorisiert und neben den PassFlow-Trichtermetriken in PASS_ANALYTICS_METRIC_DEFINITIONS aggregiert:
| Metrikschlüssel | Oberflächenbereich | Technische Definition |
|---|---|---|
uniqueVisitors | Download-Seite & PassFlow | Eindeutige Browser oder Geräte, die während des Berichtszeitraums die öffentliche Oberfläche aufrufen. |
visits | Download-Seite & PassFlow | Eindeutige Besuchersitzungen, die die ausgewählte öffentliche Oberfläche erreichen. |
pageViews | Öffentliche Oberflächen | Gerenderte HTML-Seitenaufruf-Ereignisse (PAGE_VIEW; enger gefasst als visits, wenn direktes .pkpass-MIME-Streaming unter iOS Safari PassFlow überspringt). |
interactions | Download-Seite & PassFlow | Erfasste Nutzeraktionen wie Speicherstarts (BUTTON_CLICK), QR-Code-Scans (QR_SCAN), Teilen-Aktionen (SHARE_CLICK), OTP-Verifizierungen und Formularübermittlungen. |
saveInitiations | Nur Download-Seite | Erfasste Klicks auf die Schaltflächen Zu Apple Wallet hinzufügen oder In Google Wallet speichern (DOWNLOAD_STARTED). |
saveCompletions | Nur Download-Seite | Bestätigte Wallet-Speicherungen oder abgeschlossene Karten-Downloads von einer öffentlichen Download-Seite (DOWNLOAD_COMPLETED). |
submissions | Nur PassFlow | Versuche von Kunden, das Formular auf einer öffentlichen PassFlow-Registrierungsseite abzusenden. |
conversions | Nur PassFlow | Erfolgreiche Kartengenerierungen infolge einer PassFlow-Formularübermittlung. |
conversionRate | Download-Seite & PassFlow | Verhältnis der erfassten Abschlüsse (saveCompletions oder conversions) geteilt durch visits. |
Tracking von E-Mail-Kampagnen & Zustellbarkeitsstatus
Bei der Verteilung von Karten über das Delivery Center verfolgt Passinstance das Engagement auf Empfängerebene sowie die Feedback-Schleifen von managed email delivery:
-
1
Öffnungs- & Klick-Tracking: Ausgehende Kampagnen-E-Mails betten präfixfreie Pixel- und Weiterleitungstelemetrie ein (
GET /email-campaigns/track/:recipientId/openundGET /email-campaigns/track/:recipientId/click), um nachgelagerte Wallet-Installationen bestimmten Versand-Batches zuzuordnen. -
2
Unterdrückung von Bounces & Beschwerden: Hard Bounces, Soft Bounces und Spam-Beschwerde-Webhooks (
POST /api/v1/email-campaigns/webhooks/sesundPOST /api/v1/webhooks/ses) von managed email delivery werden in den Kampagnenanalysen protokolliert und automatisch in die Sperrliste (Suppression List) des Workspaces aufgenommen, um die Reputation Ihrer eigenen Absenderdomain (SPF/DKIM) zu schützen. -
3
Konforme Ein-Klick-Abmeldung: Marketingmitteilungen enthalten tokenisierte Header nach RFC 8058 (
POST /email/unsubscribe/:tokenund die sichere WeiterleitungGET /email/unsubscribe/:token) sowie Self-Service-Präferenzportale (/email/preferences/:token).
Push-Update-Volumen & Plattformanteil (walletAppsShare)
Sobald Karten installiert sind, wird das laufende Engagement daran gemessen, wie zuverlässig Push-Updates die Sperrbildschirme der Kunden erreichen und wie sich Ihre Zielgruppe auf die mobilen Ökosysteme verteilt.
Abfragen des Zustellvolumens von Push-Updates
Verwenden Sie GET /api/v1/analytics/passes/updates, um das Volumen der Hintergrund-Kartenupdates zu prüfen, die über den Apple Push Notification service (APNs HTTP/2) und die Google Wallet REST API versendet wurden:
GET /api/v1/analytics/passes/updates?range=last_30days&bucket=day HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Antwort-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
}
]
}
Abfragen der PassFlow-Trichterleistung
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
}
}
Weiterführende Dokumentation
-
Konfigurieren Sie eigene Absenderdomains unter Individuelles Branding & White-Label-Optionen.
-
Prüfen Sie die Definitionen der Kartenstatus unter Kartenausgabe- & Nutzungsmetriken.
