Skip to content
Guide du centre d'aidePhase d'intégration 6
4 min de lectureVérifié 2026-11-16

Analytique de distribution & engagement

Mesurez la délivrabilité, les rebonds SES, les conversions sur page de téléchargement et l'exécution des notifications.

Dans ce guide

Visites interactives de l'interface

Ouvrir dans le guide en 6 phases

Inspectez les écrans exacts du tableau de bord et les zooms annotés liés à ce guide.

Focus interface zoomé1 / 2
Éléments clés de l'interface

Analytiques du modèle — Cycle de vie & portée (Zoom)

Suivez cartes actives, non réclamées, appareils enregistrés et courbes de joignabilité dans le temps.

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

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
FLUX D'ARCHITECTURE SYSTÈME : ENTONNOIR DE CONVERSION DISTRIBUTION & ENGAGEMENT
ÉTAPE 01 ÉTAPE 1 : CANAUX SORTANTS ET ENTRANTS
Envoi campagne e-mail
track/:recipientId/..
Inscription PassFlow
visits & pageViews
Lien de télécharg.
GET/d/:slug
ÉTAPE 02 ÉTAPE 2 : COUCHE D'INTERACTION DES SURFACES PUBLIQUES
uniqueVisitors & visits (Session propriétaire & regroupement anonymisé)
DownloadEventType : PAGE_VIEW | QR_SCAN | BUTTON_CLICK | DOWNLOAD_STARTED
saveInitiations (Clic sur "Add to Apple Wallet" ou "Save to Google Wallet")
ÉTAPE 03 ÉTAPE 3 : INSTALLATION PORTEFEUILLE ET ENGAGEMENT PUSH
DOWNLOAD_COMPLETED / saveCompletions (conversionRate = comp / visits)
walletAppsShare (Répartition Apple iOS/watchOS vs Android Google Wallet)
GET/api/v1/analytics/passes/updates (Volume de mises à jour APNs & Google)

Important : Les métriques de visiteurs et de sessions (uniqueVisitors et visits) 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étriquePortée de surfaceDéfinition technique
uniqueVisitorsPage de téléchargement & PassFlowNavigateurs ou appareils distincts atteignant la surface publique pendant la période d'analyse.
visitsPage de téléchargement & PassFlowSessions de visiteurs distinctes atteignant la surface publique sélectionnée.
pageViewsSurfaces 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).
interactionsPage de téléchargement & PassFlowActions 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.
saveInitiationsPage de téléchargement uniquementClics suivis sur les boutons Add to Apple Wallet ou Save to Google Wallet (DOWNLOAD_STARTED).
saveCompletionsPage de téléchargement uniquementEnregistrements dans le portefeuille ou téléchargements de passes confirmés depuis une page publique de téléchargement (DOWNLOAD_COMPLETED).
submissionsPassFlow uniquementTentatives de soumission de formulaire client sur une page publique d'inscription PassFlow.
conversionsPassFlow uniquementGénérations de passes réussies à l'issue d'une soumission PassFlow.
conversionRatePage de téléchargement & PassFlowRatio 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. 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/open et GET /email-campaigns/track/:recipientId/click) afin d'attribuer les installations de portefeuille en aval à des lots d'envoi spécifiques.
  2. 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/ses et POST /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. 3
    Conformité du désabonnement en un clic : Les communications marketing intègrent des en-têtes RFC 8058 à jeton (POST /email/unsubscribe/:token et redirection sécurisée GET /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 :

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

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

Interrogation des performances de l'entonnoir 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
  }
}

Documentation connexe

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.