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
Importante: Le metriche su visitatori e sessioni (
uniqueVisitorsevisits) 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 metrica | Ambito di superficie | Definizione tecnica |
|---|---|---|
uniqueVisitors | Pagina di download e PassFlow | Browser o dispositivi distinti che raggiungono la superficie pubblica durante il periodo di analisi. |
visits | Pagina di download e PassFlow | Sessioni di visita distinte che accedono alla superficie pubblica selezionata. |
pageViews | Superfici pubbliche | Eventi di visualizzazione pagina HTML renderizzata (PAGE_VIEW; inferiore a visits quando lo streaming MIME diretto .pkpass su iOS Safari bypassa PassFlow). |
interactions | Pagina di download e PassFlow | Azioni utente tracciate, inclusi avvii salvataggio (BUTTON_CLICK), scansioni codice QR (QR_SCAN), condivisioni (SHARE_CLICK), verifiche OTP e invii modulo. |
saveInitiations | Solo Pagina di download | Clic tracciati sui pulsanti Aggiungi ad Apple Wallet o Salva su Google Wallet (DOWNLOAD_STARTED). |
saveCompletions | Solo Pagina di download | Salvataggi Wallet o completamenti download del pass confermati da una pagina di download pubblica (DOWNLOAD_COMPLETED). |
submissions | Solo PassFlow | Tentativi di invio del modulo da parte dei clienti su una pagina pubblica di iscrizione PassFlow. |
conversions | Solo PassFlow | Generazioni di pass andate a buon fine completate da un invio PassFlow. |
conversionRate | Pagina di download e PassFlow | Rapporto 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
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/openeGET /email-campaigns/track/:recipientId/click) per attribuire le successive installazioni Wallet a specifici batch di invio. -
2
Soppressione bounce e reclami: I webhook di hard bounce, soft bounce e segnalazione spam (
POST /api/v1/email-campaigns/webhooks/sesePOST /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
Conformità alla disiscrizione one-click: Le comunicazioni marketing incorporano header RFC 8058 con token (
POST /email/unsubscribe/:tokene redirect sicuroGET /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:
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)
{
"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
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
}
}
Documentazione correlata
-
Configuri domini mittente personalizzati in Branding personalizzato e opzioni white-label.
-
Esamini le definizioni dello stato dei pass in Metriche di emissione e utilizzo dei pass.
