Skip to content
Guida del Centro assistenzaFase di onboarding 6
4 min di letturaVerificato 2026-11-16

Analisi distribuzione e coinvolgimento

Misura raggiungibilità canali, log bounce SES, conversioni download page ed esecuzioni notifiche push.

In questa guida

Guide visive interattive UI

Apri nella guida in 6 fasi

Esplora schermate reali della dashboard e dettagli ingranditi collegati a questa guida.

Focus UI ingrandito1 / 2
Elementi chiave dell'interfaccia

Analytics Template — Ciclo di vita e raggiungibilità (Ingrandito)

Monitora pass attivi, non reclamati, registrazioni dispositivi e copertura push nel tempo.

Panoramica

L'emissione di un record pass è soltanto il primo passo nel percorso del cliente. Analytics di distribuzione e coinvolgimento (/analytics/downloads nella Dashboard) traccia l'intero funnel di conversione dall'invito iniziale (campagna e-mail, SMS, scansione QR o modulo pubblico PassFlow) attraverso il routing dello smart link di download (/d/:slug, /s/:token) fino all'installazione confermata nel Wallet nativo e al successivo coinvolgimento tramite aggiornamenti push.

Funnel end-to-end di distribuzione e conversione

FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
FUNNEL DI CONVERSIONE DISTRIBUZIONE E COINVOLGIMENTO
FASE 01 FASE 1: CANALI IN USCITA E IN INGRESSO
Invio campagna e-mail
track/:recipientId/..
Modulo pubblico
PassFlow (visits)
Smart Download Link
GET/d/:slug
FASE 02 FASE 2: LIVELLO DI INTERAZIONE PUBBLICA
uniqueVisitors e visits (Sessione first-party e bucketing privacy-safe)
DownloadEventType: PAGE_VIEW | QR_SCAN | BUTTON_CLICK | DOWNLOAD_STARTED
saveInitiations (Tocco su "Aggiungi ad Apple Wallet" o "Salva in Google W.")
FASE 03 FASE 3: INSTALLAZIONE WALLET E ENGAGEMENT PUSH
DOWNLOAD_COMPLETED / saveCompletions (conversionRate = comp / visits)
walletAppsShare (Ripartizione Apple iOS/watchOS vs. Google Wallet Android)
GET/api/v1/analytics/passes/updates (Volume aggiornamenti push APNs/Google)

Importante: Le metriche su visitatori e sessioni (uniqueVisitors e visits) utilizzano identificativi di sessione first-party rispettosi della privacy con bucketing anonimizzato di fallback — garantendo la piena conformità al GDPR senza dipendere da cookie di tracciamento cross-site di terze parti.

Telemetria della pagina di download (DownloadEventType) e metriche di funnel

Ogni interazione su una Pagina pubblica di download (/d/:slug, /download/:slug, /s/:token) viene classificata dall'enum Passinstance database DownloadEventType (PAGE_VIEW, DOWNLOAD_STARTED, DOWNLOAD_COMPLETED, DOWNLOAD_FAILED, QR_SCAN, SHARE_CLICK, BUTTON_HOVER, BUTTON_CLICK), confluendo in PASS_ANALYTICS_METRIC_DEFINITIONS insieme alle metriche di funnel PassFlow:

Chiave metricaAmbito di superficieDefinizione tecnica
uniqueVisitorsPagina di download e PassFlowBrowser o dispositivi distinti che raggiungono la superficie pubblica durante il periodo di analisi.
visitsPagina di download e PassFlowSessioni di visita distinte che accedono alla superficie pubblica selezionata.
pageViewsSuperfici pubblicheEventi di visualizzazione pagina HTML renderizzata (PAGE_VIEW; inferiore a visits quando lo streaming MIME diretto .pkpass su iOS Safari bypassa PassFlow).
interactionsPagina di download e PassFlowAzioni utente tracciate, inclusi avvii salvataggio (BUTTON_CLICK), scansioni codice QR (QR_SCAN), condivisioni (SHARE_CLICK), verifiche OTP e invii modulo.
saveInitiationsSolo Pagina di downloadClic tracciati sui pulsanti Aggiungi ad Apple Wallet o Salva su Google Wallet (DOWNLOAD_STARTED).
saveCompletionsSolo Pagina di downloadSalvataggi Wallet o completamenti download del pass confermati da una pagina di download pubblica (DOWNLOAD_COMPLETED).
submissionsSolo PassFlowTentativi di invio del modulo da parte dei clienti su una pagina pubblica di iscrizione PassFlow.
conversionsSolo PassFlowGenerazioni di pass andate a buon fine completate da un invio PassFlow.
conversionRatePagina di download e PassFlowRapporto tra completamenti tracciati (saveCompletions o conversions) diviso per visits.

Tracciamento delle campagne e-mail e stato di recapito

Quando distribuisce i pass attraverso il Centro consegne, Passinstance traccia il coinvolgimento a livello di singolo destinatario e i cicli di feedback managed email delivery:

  1. 1
    Tracciamento aperture e clic: Le e-mail di campagna in uscita incorporano telemetria pixel e di reindirizzamento priva di prefisso (GET /email-campaigns/track/:recipientId/open e GET /email-campaigns/track/:recipientId/click) per attribuire le successive installazioni Wallet a specifici batch di invio.
  2. 2
    Soppressione bounce e reclami: I webhook di hard bounce, soft bounce e segnalazione spam (POST /api/v1/email-campaigns/webhooks/ses e POST /api/v1/webhooks/ses) provenienti da managed email delivery vengono registrati nelle analytics di campagna e aggiunti automaticamente alla lista di soppressione del workspace per proteggere la reputazione del dominio mittente personalizzato (SPF/DKIM).
  3. 3
    Conformità alla disiscrizione one-click: Le comunicazioni marketing incorporano header RFC 8058 con token (POST /email/unsubscribe/:token e redirect sicuro GET /email/unsubscribe/:token) insieme a portali self-service delle preferenze (/email/preferences/:token).

Volume degli aggiornamenti push e quota per piattaforma (walletAppsShare)

Una volta installati i pass, il coinvolgimento continuativo si misura verificando l'efficacia con cui gli aggiornamenti push raggiungono le schermate di blocco dei clienti e come il pubblico si suddivide tra gli ecosistemi mobili.

Interrogare il volume di consegna degli aggiornamenti push

Utilizzi GET /api/v1/analytics/passes/updates per verificare il volume degli aggiornamenti pass in background inviati tramite Apple Push Notification service (APNs HTTP/2) e la REST API di Google Wallet:

HTTP
GET /api/v1/analytics/passes/updates?range=last_30days&bucket=day HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>

Payload di risposta (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
    }
  ]
}

Interrogare le prestazioni del funnel PassFlow

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

Documentazione correlata

Pronto a lanciare il tuo primo programma di carte Wallet?

Crea il tuo workspace, configura il modello e testa una carta reale in Apple Wallet e Google Wallet prima di scalare.