Templates de pass
Un template de pass est le socle structurel et visuel d'une famille de pass. Il définit le type de pass que vous créez, les champs qui y figurent, son apparence et les données qu'il contient. Une fois votre template enregistré, vous pouvez émettre des centaines de pass individuels en quelques secondes. Chacun sera personnalisé et cohérent avec votre marque.
Les templates sont des objets vivants. Mettez à jour un template et propagez les modifications à tous les pass actifs en une seule opération, sans avoir à les réémettre.
Votre template est la première impression. Utilisez les couleurs de votre marque, votre logo et une image de fond percutante pour que vos pass s'inscrivent naturellement dans votre univers de marque.
Types de templates
Actito Wallet prend en charge sept types de pass distincts, chacun conçu pour correspondre à un schéma d'interaction spécifique. Sélectionnez le type qui représente le mieux votre cas d'usage. La mise en page, le style Apple Wallet et la classe Google Wallet seront configurés automatiquement.
Fidélité
⭐ Récompensez chaque visite. Fidélisez chaque client.
Les pass de fidélité sont l'évolution digitale de la carte de membre. Ils s'installent durablement dans le wallet de votre client, se mettent à jour en arrière-plan au fil de l'accumulation des points, des changements de niveau et du déblocage des récompenses. Parce que le pass est toujours là — sur l'écran de verrouillage, à la caisse, dans le bus — les clients s'identifient plus souvent, collectent plus régulièrement et s'engagent plus profondément dans votre programme.
Cas d'usage idéaux :
- Programmes de fidélité et de collecte de points en retail.
- Cartes de fidélité pour coffee shops et établissements hôteliers.
- Programmes de membership à niveaux (Argent, Or, Platine).
- Systèmes de récompenses pour abonnements et achats récurrents.
- Coalitions de fidélité partenaires et programmes multi-marques.
Offre
🏷️ Le coupon réinventé. Dynamique, traçable, et impossible à perdre.
Les pass d'offre remplacent les coupons papier et les bons de réduction statiques par des promotions digitales vivantes. Définissez des dates d'expiration, des limites de validation et des déclencheurs géolocalisés. Modifiez la valeur de l'offre, prolongez l'échéance ou remplacez entièrement l'offre... sans réémettre le pass.
Cas d'usage idéaux :
- Coupons de réduction et promotions en pourcentage.
- Ventes flash et campagnes saisonnières à durée limitée.
- Offres de bienvenue et incentives premier achat.
- Récompenses de parrainage et co-promotions partenaires.
- Offres en magasin déclenchées par géolocalisation.
Carte cadeau
🎁 Le cadeau qui va partout : brandé, digital, et toujours prêt à être utilisé.
Les pass carte cadeau vous permettent d'émettre des cartes brandées avec une valeur monétaire, qui s'installent dans le wallet du destinataire dès l'envoi. Affichez le solde disponible, mettez-le à jour après chaque utilisation partielle et faites apparaître la carte automatiquement au moment du paiement. Contrairement aux cartes cadeaux physiques, les pass carte cadeau digitaux ne traînent jamais dans un tiroir : ils sont toujours à portée d'un tap.
Cas d'usage idéaux :
- Cartes cadeaux retail et e-commerce.
- Crédits repas prépayés pour la restauration et l'hôtellerie.
- Programmes de cadeaux d'entreprise et récompenses collaborateurs.
- Crédits d'abonnement et bons de service.
- Rechargements promotionnels et remises en cashback.
Ticket
🎟️ Transformez l'accès en expérience — avant, pendant et après l'événement.
Les pass ticket sont conçus pour les moments qui comptent. Qu'il s'agisse d'un concert, d'une conférence, d'une rencontre sportive ou d'un dîner privé, ce type de template place toute la puissance de l'engagement digital derrière votre ticket. Affichez les détails du siège, le plan du lieu, des messages personnalisés et des codes-barres, puis utilisez les notifications push pour tenir les participants informés des changements de programme, des mises à jour de planning ou des offres exclusives sur place.
Cas d'usage idéaux :
- Billetterie de concerts et festivals.
- Événements sportifs et accès stade.
- Conférences, sommets et salons professionnels.
- Théâtre, cinéma et événements culturels.
- Événements membres privés et expériences exclusives.
Carte d'embarquement
✈️ Du check-in à l'atterrissage, une expérience d'embarquement fluide dans la poche de vos clients.
Les pass carte d'embarquement transportent l'expérience d'embarquement aérien à l'ère digitale. Structurés autour des données de départ et d'arrivée, ils s'affichent automatiquement à l'arrivée à l'aéroport, se mettent à jour en temps réel en cas de modification de vol, et affichent tout ce dont un voyageur a besoin sans ouvrir la moindre application. Numéro de siège, horaires d'embarquement, informations sur le terminal et codes-barres réunis dans une seule carte scannable.
Cas d'usage idéaux :
- Cartes d'embarquement pour vols réguliers et charters.
- Services d'aviation privée et de voyage d'affaires.
- Cartes d'accès aux salons et d'entrée rapide en aéroport.
- Affichage du niveau de fidélité pour les grands voyageurs.
Transport
🚆 Des trajets plus rapides, moins de files, des pass de transport digitaux qui vont aussi vite que vos clients.
Les pass transport sont spécialement conçus pour les transports publics et privés : bus, trains, ferries, métros et services de mobilité partagée. Optimisés pour un scan rapide aux points d'accès, ils peuvent être mis à jour dynamiquement. Parfaits pour les titres multi-trajets, les abonnements de saison ou les crédits de voyage en temps réel.
Cas d'usage idéaux :
- Abonnements bus, tramway et métro.
- Cartes d'embarquement ferry et passes journaliers.
- Billets de train interurbains et cartes de transport multimodal.
- Pass d'accès pour vélos en libre-service, trottinettes et autopartage.
Générique
📋 Quand votre cas d'usage ne rentre dans aucune case, construisez exactement ce dont vous avez besoin.
Le template Générique est votre page blanche. Il offre une mise en page flexible sans sémantique de champ prédéfinie, vous donnant un contrôle total sur ce qui apparaît sur le pass et la façon dont il est structuré. Idéal pour les cas d'usage qui ne correspondent pas naturellement à une catégorie spécifique — accréditations de membre, pass de contrôle d'accès, cartes étudiantes, cartes de santé, et bien plus encore.
Cas d'usage idéaux :
- Pass d'identité et d'accréditation de membres.
- Badges d'accès collaborateurs et identifiants professionnels.
- Cartes de bibliothèque, cartes étudiantes et pass institutionnels.
- Cartes d'assurance et pass d'accès aux soins de santé.
- Pass de contrôle d'accès et d'entrée sur site.
Structure des pass
Quel que soit le type de pass, tous partagent la même architecture de champs. Comprendre cette structure est essentiel pour concevoir des pass efficaces et lisibles sur tous les appareils.
Architecture des champs
- Apple Wallet
- Google Wallet
Apple Wallet organise le contenu des pass en zones de champs nommées et positionnées. Chaque zone a un rôle visuel fixe et des limites strictes quant au nombre de champs qu'elle peut contenir.
| Zone de champ | Visibilité | Rôle et recommandations d'usage |
|---|---|---|
| Champs d'en-tête | Toujours visibles, y compris lorsque les pass sont empilés | La zone la plus haute du pass. À réserver pour l'identifiant le plus critique : numéro de membre, classe de service, statut de niveau. Maximum 3 champs. |
| Champs principaux | Recto du pass | La zone visuellement la plus proéminente. La première chose que voit votre client : solde de points, nom de l'événement, ville de départ. 1 champ pour la plupart des types de pass, 2 pour les pass vol et transit (origine + destination). |
| Champs secondaires | Recto du pass | Informations complémentaires affichées sous le champ principal. Date, heure, numéro de siège, nom du titulaire. Maximum 4 champs. |
| Champs auxiliaires | Recto du pass | Détails utiles mais non essentiels : terminal, porte, numéro de confirmation. Maximum 4 champs. Affichés sur une seule ligne pour les pass offre et fidélité. |
| Champs verso | Verso du pass (appuyer sur l'icône ⓘ) | Affichés au dos du pass. Conditions générales, FAQ, coordonnées, liens web. Aucune limite en nombre ou en longueur de texte. |
| Code-barres | Recto du pass | L'élément scannable. QR Code, PDF417, Aztec ou Code128. Affiché en bas ou au centre du pass selon le type. |
Google Wallet n'utilise pas de zones de champs positionnées. Le contenu des pass est structuré selon deux mécanismes complémentaires : les propriétés de classe sémantiques propres à chaque type de pass, et les modules de contenu génériques partagés par tous les types. Le rendu visuel est géré automatiquement par Google en fonction de la classe du pass et des données fournies.
Propriétés de classe sémantiques
Chaque classe de pass Google Wallet expose des propriétés structurées et typées, spécifiques à son cas d'usage. Il ne s'agit pas de champs libres — ce sont des propriétés nommées avec des types de données définis, dont le placement visuel est déterminé par Google.
| Type de pass | Classe Google Wallet | Propriétés sémantiques clés |
|---|---|---|
| Vol | FlightObject / FlightClass | flightHeader.departureAirport.airportIataCode, flightHeader.arrivalAirport.airportIataCode, flightHeader.flightNumber, boardingAndSeatingInfo.seatNumber, boardingAndSeatingInfo.boardingTime, localScheduledDepartureDateTime |
| Transit | TransitObject / TransitClass | ticketHolder.name, tripType, ticketLeg.originName, ticketLeg.destinationName, ticketLeg.departureDateTime, ticketLeg.transitOperatorName |
| Billet d'événement | EventTicketObject / EventTicketClass | eventTicketClass.eventName, seatInfo.seat, seatInfo.row, seatInfo.section, reservationInfo.confirmationCode |
| Fidélité | LoyaltyObject / LoyaltyClass | loyaltyPoints.balance, loyaltyPoints.label, secondaryLoyaltyPoints, accountName, accountId |
| Carte cadeau | GiftCardObject / GiftCardClass | balance.micros, balance.currencyCode, cardNumber, pin, eventNumber |
| Offre | OfferObject / OfferClass | offerClass.title, offerClass.provider, offerClass.redemptionChannel, offerClass.localizedDetails |
| Générique | GenericObject / GenericClass | cardTitle, subheader, header, textModulesData, barcode |
Modules de contenu génériques
Tous les types de pass Google Wallet prennent en charge un ensemble de modules de contenu génériques pour les informations complémentaires.
| Module | Objectif | Recommandations d'usage |
|---|---|---|
textModulesData | Une ou plusieurs paires label/valeur affichées dans le corps du pass. | À utiliser pour toute information structurée non couverte par les propriétés sémantiques : numéros de confirmation, détails d'adhésion, règles du programme. Chaque entrée comporte un header (label) et un body (valeur). |
linksModuleData | Liens cliquables affichés dans la vue détail du pass. | À utiliser pour les URLs, numéros de téléphone et adresses e-mail. Prend en charge uri, description et kind (URL, PHONE, EMAIL). |
imageModulesData | Une ou plusieurs images affichées dans le corps du pass. | À utiliser pour des visuels complémentaires au-delà de l'image principale ou du logo. Chaque entrée référence une URL d'image HTTPS accessible publiquement. |
messages | Un message bannière sur le pass, optionnellement limité dans le temps. | À utiliser pour les communications temporaires : une promotion, un rappel, un avis urgent. Prend en charge header, body et un displayInterval optionnel. |
infoModuleData | Paires label/valeur historiques (versions anciennes de l'API). | Remplacé par textModulesData dans les implémentations actuelles. À éviter pour les nouveaux pass. |
textModulesData est votre module de référence pour tout ce qui ne correspond pas à une propriété sémantique. Considérez-le comme un bloc-notes structuré et flexible sur le pass — utilisez-le pour toute paire label/valeur que vous souhaitez afficher dans le corps du pass.
Images
- Apple Wallet
- Google Wallet
Les dimensions sont exprimées en points. Multipliez par 2 pour le @2x Retina et par 3 pour le @3x — téléversez toujours à la résolution la plus élevée requise.
| Image | Dimensions (points) | Usage et recommandations |
|---|---|---|
| Icône | 29 × 29 pt | Icône d'application visible dans les notifications système et les listes de pass. PNG avec fond transparent fortement recommandé. |
| Logo | 160 × 50 pt | Votre logo affiché dans le coin supérieur gauche de chaque pass. Fond transparent obligatoire pour s'adapter à toute couleur de fond. |
| Bande | 375 × 123 pt | Bande visuelle horizontale affichée sous les champs principaux. Utilisée pour les pass offre, fidélité et carte cadeau. (375 × 98 pt pour les pass billet d'événement.) |
| Fond | 180 × 220 pt | Image de fond couvrant l'intégralité du pass. Disponible pour les pass billet d'événement et générique. Privilégiez des images sombres pour garantir la lisibilité du texte. Incompatible avec la bande. |
| Vignette | 90 × 90 pt | Petite image carrée à droite des champs principaux. Idéale pour un visuel produit, une photo d'artiste ou un logo d'événement. |
| Pied de page | 286 × 15 pt | Fine bande en bas des pass transit et vol, au-dessus du code-barres. Souvent utilisée pour les logos partenaires ou les mentions réglementaires. |
Téléversez toujours les images à la résolution la plus élevée requise (de préférence @3x), en maintenant chaque fichier sous 1 Mo. Des images trop lourdes dégradent le temps de téléchargement du pass et l'expérience client.
Les images Google Wallet ne sont pas intégrées dans le fichier pass — elles sont référencées par des URLs HTTPS accessibles publiquement, définies dans la classe ou l'objet du pass. Les dimensions sont en pixels.
| Image | Propriété | Dimensions (pixels) | Usage et recommandations |
|---|---|---|---|
| Logo émetteur | logo (niveau classe) | 660 × 660 px | Affiché dans le coin supérieur gauche du pass. Format carré. PNG avec fond transparent recommandé. Identifie la marque émettrice en un coup d'œil. |
| Image principale | heroImage (niveau classe) | 1032 × 336 px | Large bandeau horizontal affiché de manière proéminente sur le pass. La zone d'impact visuel principal — utilisez-la pour votre visuel de marque ou d'événement le plus fort. Disponible pour tous les types de pass. |
| Logo large | wideLogo (niveau classe) | 1032 × 336 px | Disponible pour les pass vol et transit. Remplace l'image principale pour afficher le logo de l'opérateur ou de la compagnie aérienne en format large. Incompatible avec l'image principale sur ces types de pass. |
| Logo programme | programLogo (classe Fidélité) | 660 × 660 px | Spécifique aux pass de fidélité. Représente le programme de fidélité plutôt que la marque émettrice. |
| Vignette | thumbnail (niveau objet) | 246 × 246 px | Petite image affichée à côté du titre du pass sur certains types de pass. |
Les images doivent être hébergées sur une URL HTTPS accessible publiquement — elles sont récupérées au chargement du pass. Optimisez les fichiers pour un chargement rapide et maintenez-les sous 500 Ko dans la mesure du possible.
Pertinence
La pertinence est l'une des fonctionnalités les plus puissantes des pass digitaux. Elle permet à un pass d'apparaître automatiquement sur l'écran de verrouillage d'un client au bon endroit et au bon moment, sans aucune action de sa part.
- Apple Wallet
- Google Wallet
| Type de pertinence | Comportement | Configuration |
|---|---|---|
| Géolocalisation | Le pass apparaît sur l'écran de verrouillage lorsque le client entre dans un rayon défini autour d'une coordonnée GPS. | Coordonnées GPS (tableau locations : latitude, longitude, relevantText optionnel affiché sur l'écran de verrouillage). Rayon par défaut : 100 mètres. |
| Beacons BTLE | Déclenchement ultra-précis basé sur des beacons Bluetooth à courte portée déployés sur site. | Jusqu'à 10 beacons par pass (tableau beacons : proximityUUID requis, major et minor optionnels). Nécessite un matériel beacon physique. |
Combinez la pertinence géolocalisée avec une notification push pour créer le moment de marque idéal : lorsque votre client passe devant votre magasin, son pass de fidélité s'affiche sur son écran de verrouillage — et si vous venez d'ajouter des points, une notification lui annonce la bonne nouvelle au même instant.
Google Wallet affiche les pass via des suggestions de notifications pilotées par la couche Google Pay sur Android.
| Type de pertinence | Comportement | Configuration |
|---|---|---|
| Géolocalisation | Le pass est affiché en suggestion de notification lorsque l'appareil du client détecte une proximité avec un lieu défini. | Tableau locations au niveau classe (latitude, longitude, label optionnel). Déclenché par les services de localisation de Google — aucun matériel beacon requis. |
Google Wallet ne prend pas en charge la pertinence par beacon Bluetooth. Pour un déclenchement de proximité précis dans des espaces physiques, utilisez la pertinence géolocalisée avec un rayon bien défini, ou combinez-la avec une notification push côté serveur déclenchée par votre propre infrastructure de beacons ou de geofencing.
Personnalisations du template
Une fois votre template prêt, vous pouvez personnaliser ses champs à partir des attributs Actito. Pour ce faire, sélectionnez votre template et cliquez sur Personnalisations du template :
Dans le panneau de personnalisation, vous trouverez tous les champs de pass du template que vous pouvez personnaliser en utilisant toutes les personnalisations disponibles dans Actito :
Lors de l'émission d'un pass, celui-ci sera automatiquement personnalisé avec les données du profil du destinataire.
Distribuer les pass
Une fois votre modèle de pass créé et vos personnalisations de modèle configurées, vous pouvez distribuer des passes directement via une campagne e-mail.
Ajout du bloc Wallet à votre e-mail
Dans l'éditeur d'e-mail, ouvrez la bibliothèque de blocs et accédez à App/Wallet. Vous y trouverez les modules Wallet en différentes langues, que vous pouvez glisser-déposer dans la mise en page de votre e-mail.
Le module Wallet affiche deux boutons natifs — Ajouter à Apple Wallet et Voir dans Google Wallet — que vos destinataires utiliseront pour installer le pass directement depuis leur e-mail.
Liaison du bloc à votre modèle de pass
Derrière chaque bouton, vous pouvez ajouter une URL. Cette URL doit être définie comme une personnalisation, afin que chaque destinataire reçoive un lien vers son pass individuel.
Pour ce faire :
- Survolez le bouton et choisissez « Ajouter un nouveau lien »
- Ajoutez une personnalisation dans le champ « Lien » qui se réfère au lien du pass.
- Assurez-vous que la personnalisation correspondante est configurée dans vos personnalisations de modèle, afin que l'URL du pass correcte soit injectée pour chaque destinataire au moment de l'envoi.
Le lien du pass doit être généré à partir d'un modèle prêt à l'emploi. Assurez-vous que votre modèle est entièrement configuré — y compris la personnalisation, les champs, le design, la pertinence et le code-barres — avant de l'utiliser dans une campagne e-mail.