Skip to content
Guide du centre d'aide · Vue d'ensemble du tableau de bordPhase d'intégration 1
4 min de lectureVérifié 2026-11-16

Naviguer dans le tableau de bord

Repérez rapidement Modèles, Passes, Wallet Experiences, Centre d'envoi, Scanner, Opérations en lot et Paramètres.

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é
Éléments clés de l'interface

Tableau de bord — KPI & tendances d'inscription (Zoom)

Une fois en production, surveillez Active in Wallets, Removed, Not Installed ainsi que les tendances de création et d'enregistrement.

Le tableau de bord d'administration Passinstance offre une interface unifiée regroupant le suivi opérationnel, le studio de conception des cartes, les traitements par lot à grand volume et la configuration développeur. La barre latérale gauche organise les workflows quotidiens par pôles fonctionnels :

Navigation de la barre latérale de l'espace de travail
Navigation de la barre latérale de l'espace de travail
Pôle de navigation & routeResponsabilités principalesCapacités & entités backend associées
Tableau de bord (/dashboard)KPI en direct de l'espace de travail, télémétrie événementielle temps réel et santé des passesAppuyé sur Dashboard Analytics API (/api/v1/dashboards/analytics), lignes multi-widgets et flux d'événements temps réel.
Modèles (/templates)Studio visuel de cartes avec 7 onglets détaillés (Overview, Passes, Distribution, Scanner, Analytics, Activity log, Settings)Met en œuvre le versionnage en table unique (Template), l'analyse de risque avant publication, les règles regex d'identifiants personnalisés et le regroupement en lots.
Passes (/passes)Répertoire de tous les passes émis, recherche par externalId, regroupement par bundleId, chronologie et panneau d'éditionRépertoire haute concurrence appuyé sur des attributs structured JSON, les transitions de cycle de vie (PassLifecycleStatus) et l'annulation/désactivation instantanée.
Distribution (/templates/download-pages, /delivery-center, /pass-flows)Regroupe Pages de téléchargement (DownloadPage), Centre d'envoi (EmailSendCampaign) et Pass Flows (PassFlow)Gère les pages publiques de retrait (/d/:slug), les campagnes e-mail/SMS et les formulaires multi-étapes d'inscription et de paiement (/f/:url).
Automatisations (/automations, /workflows)Règles d'automatisation événementielles et e-commerceÉvalue les règles UniversalAutomation et déclencheurs Workflow (workflow trigger type, workflow action type).
Scanner (/scanner/configs)Validation au comptoir, contrôle d'entrée, lieux de validation et configuration des lecteurs matérielsGère ValidationPlace, ScannerConfiguration, les appairages mobiles (ScannerKey) et les adaptateurs NFC/POS.
Traitements en lot (/batch-processing, /batch-notifications)Assistant d'émission CSV asynchrone à fort volume et notifications Wallet planifiéesPilote Batch Jobs API (/api/v1/batch-processing) et Batch Notifications API (/api/v1/batch-notifications).
Wallet Experiences (/wallet-experiences / /pass-projects)Hub de projets multi-cartes (Overview, Cards, Audience, Automations, Distribution, Analytics, Settings)Gère PassProject, PassProjectTemplateRole, les lots .pkpasses et les automatisations inter-passes.
Intégrations & Analytique (/settings/workspace/integrations, /analytics)Connecteurs CRM/POS, webhooks, clés API et suites de rapportsGère les webhooks (/api/v1/webhooks/*), clés API cloisonnées et rapports /api/v1/analytics/*.

Architecture du tableau de bord & endpoints de télémétrie

Le moteur de métriques du tableau de bord repose sur une architecture modulaire de widgets et de cache (entités Passinstance database Dashboard, Row, Widget et SharedDashboard). Le backend s'appuie sur Cache Manager pour fournir des analyses réactives sans surcharger les tables transactionnelles des passes :

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
FLUX D'ARCHITECTURE SYSTÈME : PIPELINE DE TÉLÉMÉTRIE DU TABLEAU DE BORD
ÉTAPE 01 Tableau de bord
client (React / Vite)
ÉTAPE 02 Dashboard Analytics API
(/api/v1/dashboards/analytics
/metrics/realtime)
ÉTAPE 03 | Cache Manager
(Cache cloisonné RBAC avec inval. sur évèn.)
ÉTAPE 02 Agrégats database
Compteurs passes/app.

Principaux endpoints de télémétrie

Les développeurs et plateformes data peuvent interroger ces endpoints analytiques avec une authentification Bearer ou par cookie de session :

  • GET /api/v1/dashboards/analytics : retourne les métriques agrégées de l'espace de travail via Dashboard Analytics Engine.getDashboardAnalytics et Cache Manager.
  • GET /api/v1/dashboards/metrics/realtime : fournit les compteurs d'activité haute fréquence de l'espace de travail ainsi que la télémétrie récente d'installation et de scan.
  • GET /api/v1/dashboards/analytics/range?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD : retourne les séries chronologiques par cohorte sur une période personnalisée.
  • GET /api/v1/dashboards/performance : suit les indicateurs opérationnels de performance des scans et de livraison des passes.
  • GET /api/v1/dashboards/insights : fait ressortir des recommandations opérationnelles automatisées pour votre espace de travail.
  • GET /api/v1/dashboards/export?format=csv|json|pdf : exporte les tableaux de métriques brutes du tableau de bord pour vos outils BI ou rapprochements.

Pôles fonctionnels & vues de l'espace de travail

1. Studio de modèles (/templates/:id/*)

Créez et éditez vos modèles visuels à travers 7 onglets (Overview, Passes, Distribution, Scanner, Analytics, Activity log, Settings). Configurez les emplacements image asset slot, vérifiez le contraste WCAG, gérez les règles d'identifiants personnalisés et itérez dans un état DRAFT isolé avant publication.

2. Répertoire des passes & chronologie (/passes)

Recherchez parmi les passes émis via la recherche plein texte et les filtres (status, templateId, externalId, bundleId). Ouvrez n'importe quelle ligne dans Pass Details panel pour inspecter sa chronologie (GET /api/v1/passes/:id/history et /timeline), consulter les appareils appairés ou déclencher des mises à jour push.

3. Centre des opérations en lot (/batch-processing)

Suivez les étapes de l'assistant (Modèle -> Importer CSV -> Mapper les champs -> Options d'envoi -> Traiter) pour émettre ou actualiser des passes en masse depuis des fichiers CSV. Téléchargez des schémas d'exemple (GET /api/v1/batch-processing/templates/:templateId/sample-csv), consultez les suggestions de correspondance (POST /api/v1/batch-processing/templates/:templateId/field-mapping-recommendations) et récupérez /result.csv contenant chaque URL de passe générée et son externalId.

Important : Toutes les requêtes de télémétrie et de recherche du tableau de bord sont strictement cloisonnées à votre locataire d'espace de travail actif (customerId). Les espaces frères au sein d'une même organisation restent totalement isolés.

Explorez chaque vue de manière interactive dans notre Visite interactive de l'espace de travail.

Documentation produit et développeur associée

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.