Présentation
L'émission d'un enregistrement de pass n'est que la première étape du parcours client. L'Analytique de distribution et d'engagement (/analytics/downloads dans le tableau de bord) suit l'entonnoir de conversion complet, depuis l'invitation initiale (campagne e-mail, SMS, scan de code QR ou formulaire d'inscription public PassFlow), en passant par le routage du lien de téléchargement intelligent (/d/:slug, /s/:token), jusqu'à l'installation confirmée dans le portefeuille natif et l'engagement ultérieur via les mises à jour push.
Entonnoir de distribution et de conversion de bout en bout
Important : Les métriques de visiteurs et de sessions (
uniqueVisitorsetvisits) utilisent des identifiants de session propriétaires respectueux de la vie privée avec regroupement anonymisé de repli — garantissant ainsi une conformité totale au RGPD sans recourir à des cookies de suivi intersites tiers.
Télémétrie de la page de téléchargement (DownloadEventType) et métriques de l'entonnoir
Chaque interaction sur une page publique de téléchargement (/d/:slug, /download/:slug, /s/:token) est catégorisée par l'énumération Passinstance database DownloadEventType (PAGE_VIEW, DOWNLOAD_STARTED, DOWNLOAD_COMPLETED, DOWNLOAD_FAILED, QR_SCAN, SHARE_CLICK, BUTTON_HOVER, BUTTON_CLICK), et agrégée dans PASS_ANALYTICS_METRIC_DEFINITIONS aux côtés des métriques d'entonnoir PassFlow :
| Clé de métrique | Portée de surface | Définition technique |
|---|---|---|
uniqueVisitors | Page de téléchargement & PassFlow | Navigateurs ou appareils distincts atteignant la surface publique pendant la période d'analyse. |
visits | Page de téléchargement & PassFlow | Sessions de visiteurs distinctes atteignant la surface publique sélectionnée. |
pageViews | Surfaces publiques | Événements de vue de page HTML affichée (PAGE_VIEW ; inférieur à visits lorsque le flux MIME direct .pkpass contourne PassFlow sur Safari iOS). |
interactions | Page de téléchargement & PassFlow | Actions utilisateur suivies incluant les initiations d'enregistrement (BUTTON_CLICK), les scans de code QR (QR_SCAN), les partages (SHARE_CLICK), les vérifications OTP et les soumissions de formulaires. |
saveInitiations | Page de téléchargement uniquement | Clics suivis sur les boutons Add to Apple Wallet ou Save to Google Wallet (DOWNLOAD_STARTED). |
saveCompletions | Page de téléchargement uniquement | Enregistrements dans le portefeuille ou téléchargements de passes confirmés depuis une page publique de téléchargement (DOWNLOAD_COMPLETED). |
submissions | PassFlow uniquement | Tentatives de soumission de formulaire client sur une page publique d'inscription PassFlow. |
conversions | PassFlow uniquement | Générations de passes réussies à l'issue d'une soumission PassFlow. |
conversionRate | Page de téléchargement & PassFlow | Ratio des finalisations suivies (saveCompletions ou conversions) divisé par visits. |
Suivi des campagnes d'e-mailing et santé de la délivrabilité
Lors de la distribution de passes via le Centre de diffusion (Delivery Center), Passinstance suit l'engagement au niveau du destinataire ainsi que les boucles de rétroaction managed email delivery :
-
1
Suivi des ouvertures et des clics : Les e-mails de campagne sortants intègrent une télémétrie par pixel et redirection sans préfixe (
GET /email-campaigns/track/:recipientId/openetGET /email-campaigns/track/:recipientId/click) afin d'attribuer les installations de portefeuille en aval à des lots d'envoi spécifiques. -
2
Suppression des rebonds et des plaintes : Les rebonds permanents (hard bounces), les rebonds temporaires (soft bounces) et les webhooks de plaintes pour spam (
POST /api/v1/email-campaigns/webhooks/sesetPOST /api/v1/webhooks/ses) provenant d'managed email delivery sont consignés dans l'analytique de campagne et automatiquement ajoutés à la liste de suppression de l'espace de travail pour protéger la réputation de votre domaine d'expéditeur personnalisé (SPF/DKIM). -
3
Conformité du désabonnement en un clic : Les communications marketing intègrent des en-têtes RFC 8058 à jeton (
POST /email/unsubscribe/:tokenet redirection sécuriséeGET /email/unsubscribe/:token) ainsi que des portails de préférences en libre-service (/email/preferences/:token).
Volume de mises à jour push et part des plateformes (walletAppsShare)
Une fois les passes installés, l'engagement continu se mesure à l'efficacité avec laquelle les mises à jour push atteignent les écrans verrouillés des clients et à la répartition de votre audience entre les écosystèmes mobiles.
Interrogation du volume de diffusion des mises à jour push
Utilisez GET /api/v1/analytics/passes/updates pour auditer le volume des mises à jour de passes en arrière-plan envoyées via Apple Push Notification service (APNs HTTP/2) et l'API REST Google Wallet :
GET /api/v1/analytics/passes/updates?range=last_30days&bucket=day HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Charge utile de réponse (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
}
]
}
Interrogation des performances de l'entonnoir 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
}
}
Documentation connexe
-
Configurez des domaines d'expéditeur personnalisés dans Personnalisation de marque et options en marque blanche.
-
Consultez les définitions des statuts de passes dans Métriques d'émission et d'utilisation des passes.
