Skip to content
Hilfecenter-AnleitungOnboarding-Phase 6
3 Min. LesezeitGeprüft 2026-11-16

Verteilungs- & Engagement-Analysen

Messen Sie Versandreichweite, SES-Bounce-Protokolle, Downloadseiten-Konversion und ausgeführte Push-Kampagnen.

In dieser Anleitung

Prüfen Sie passende Dashboard-Bereiche, Steuerelemente und Zoom-Hinweise zu diesem Thema.

Vergrößerter UI-Fokus1 / 2
Wichtige UI-Elemente

Template-Analytics — Lebenszyklus & Erreichbarkeit (Zoom)

Verfolgen Sie aktive, nicht abgeholte und registrierte Pässe sowie die Push-Erreichbarkeit über die Zeit.

Ü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

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
VERTEILUNGS- & ENGAGEMENT-KONVERSIONSTRICHTER
STUFE 01 STUFE 1: AUSGEHENDE & EINGEHENDE KANÄLE
E-Mail-Kampagnenversand
track/:recipientId/..
Öffentlicher PassFlow
visits & pageViews
Smart-Download-Link
GET/d/:slug
STUFE 02 STUFE 2: INTERAKTION AUF ÖFFENTLICHEN SEITEN
uniqueVisitors & visits (First-Party-Sitzung & datenschutzkonformes Bucketing)
DownloadEventType: PAGE_VIEW | QR_SCAN | BUTTON_CLICK | DOWNLOAD_STARTED
saveInitiations (Tippen auf „Zu Apple Wallet“ oder „In Google Wallet“)
STUFE 03 STUFE 3: WALLET-INSTALLATION & PUSH-ENGAGEMENT
DOWNLOAD_COMPLETED / saveCompletions (conversionRate = comp / visits)
walletAppsShare (Aufteilung Apple iOS/watchOS vs. Android Google Wallet)
GET/api/v1/analytics/passes/updates (APNs- & Google-Push-Update-Volumen)

Wichtig: Besucher- und Sitzungsmetriken (uniqueVisitors und visits) 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üsselOberflächenbereichTechnische Definition
uniqueVisitorsDownload-Seite & PassFlowEindeutige Browser oder Geräte, die während des Berichtszeitraums die öffentliche Oberfläche aufrufen.
visitsDownload-Seite & PassFlowEindeutige Besuchersitzungen, die die ausgewählte öffentliche Oberfläche erreichen.
pageViewsÖffentliche OberflächenGerenderte HTML-Seitenaufruf-Ereignisse (PAGE_VIEW; enger gefasst als visits, wenn direktes .pkpass-MIME-Streaming unter iOS Safari PassFlow überspringt).
interactionsDownload-Seite & PassFlowErfasste Nutzeraktionen wie Speicherstarts (BUTTON_CLICK), QR-Code-Scans (QR_SCAN), Teilen-Aktionen (SHARE_CLICK), OTP-Verifizierungen und Formularübermittlungen.
saveInitiationsNur Download-SeiteErfasste Klicks auf die Schaltflächen Zu Apple Wallet hinzufügen oder In Google Wallet speichern (DOWNLOAD_STARTED).
saveCompletionsNur Download-SeiteBestätigte Wallet-Speicherungen oder abgeschlossene Karten-Downloads von einer öffentlichen Download-Seite (DOWNLOAD_COMPLETED).
submissionsNur PassFlowVersuche von Kunden, das Formular auf einer öffentlichen PassFlow-Registrierungsseite abzusenden.
conversionsNur PassFlowErfolgreiche Kartengenerierungen infolge einer PassFlow-Formularübermittlung.
conversionRateDownload-Seite & PassFlowVerhä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. 1
    Öffnungs- & Klick-Tracking: Ausgehende Kampagnen-E-Mails betten präfixfreie Pixel- und Weiterleitungstelemetrie ein (GET /email-campaigns/track/:recipientId/open und GET /email-campaigns/track/:recipientId/click), um nachgelagerte Wallet-Installationen bestimmten Versand-Batches zuzuordnen.
  2. 2
    Unterdrückung von Bounces & Beschwerden: Hard Bounces, Soft Bounces und Spam-Beschwerde-Webhooks (POST /api/v1/email-campaigns/webhooks/ses und POST /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. 3
    Konforme Ein-Klick-Abmeldung: Marketingmitteilungen enthalten tokenisierte Header nach RFC 8058 (POST /email/unsubscribe/:token und die sichere Weiterleitung GET /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:

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

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
    }
  ]
}

Abfragen der PassFlow-Trichterleistung

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
  }
}

Weiterführende Dokumentation

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.