Privilège
Définir et gérer les privilèges de Carte (avantages) dans The Wallet Crew : types, sources de création, règles de priorité et état de redemption basé sur le mouvement.
A privilège est un avantage attaché à une seule Carte numérique. Il définit ce que le détenteur peut faire, réclamer ou débloquer. Les privilèges sont séparés de la Carte elle-même. Vous pouvez les ajouter, les mettre à jour ou les supprimer sans réémettre la Carte.
Pourquoi les privilèges sont importants
Les privilèges sont importants parce qu’ils transforment une simple Carte en un outil puissant d’engagement et de fidélisation. Une Carte seule donne accès, mais un privilège ajoute une raison pour les clients de s’y intéresser, d’interagir et de revenir. C’est la différence entre un billet standard et une expérience qui paraît personnelle, gratifiante et mémorable.
Ils sont importants pour le marketing parce qu’ils créent des occasions de ravir les clients, de générer des revenus incrémentaux et d’encourager des comportements bénéfiques pour la marque. En proposant des extras comme des remises, des articles gratuits ou des avantages exclusifs, les privilèges rendent chaque interaction plus précieuse et renforcent la relation entre le client et la marque.
Enfin, les privilèges apportent de la flexibilité et de la créativité aux campagnes. Les marques peuvent concevoir des combinaisons d’avantages uniques, cibler différents segments de clientèle ou ajouter des récompenses limitées dans le temps, le tout sans modifier la Carte principale. Cela facilite l’innovation, les tests d’idées et la création de moments qui transforment un accès ordinaire en expériences significatives.
Comment les privilèges se comportent
Les privilèges ont un type comportemental :
Usage unique : utilisable une seule fois, puis il disparaît.
Illimité : toujours disponible tant qu’il est valide.
Multi-utilisation : nombre d’utilisations limité.
Débloquable : apparaît uniquement après l’atteinte d’une progression ou de conditions.
Cela correspond directement à des avantages réels. Boisson gratuite, remise de 10 %, 5 entrées, récompenses à débloquer en dépensant.
Comment les privilèges sont ajoutés à une Carte
Les privilèges sont créés de différentes façons. Ils peuvent être générés en interne par la plateforme via des activations. Ils peuvent aussi être créés en externe via des connecteurs comme SFMC ou Bloomreach ou directement via l’ API.
Une Carte peut contenir jusqu’à 5 privilèges en même temps. En cas de conflit, la prioritépuis la mise à jour la plus récente sert de départage.
Définition du privilège
Un privilège est un objet structuré. Il regroupe les métadonnées, l’apparence, le contenu, les liens et la valeur/l’état.
Propriétés générales
privilegeId
Identifiant unique du privilège. Généré automatiquement par le système.
priorité
Entier utilisé pour résoudre les conflits lorsque plusieurs privilèges modifient la même propriété. La valeur la plus élevée l’emporte. En cas d’égalité, la dernière mise à jour l’emporte.
type
L’un des Usage unique, Illimité, Multi-utilisation, Débloquable.
tags
Liste des tags utilisés pour les rapports.
origin.generator
(facultatif) Nom du processus générant le privilège. Utilisez internal pour les activations de la plateforme.
origin.activationId
(facultatif) Identifiant du processus générateur. Exemple : identifiant d’activation interne, ou un journeyId (SFMC).
origin.externalId
(facultatif) Identifiant unique de ce privilège dans un système externe.
deletionDate
Date à laquelle le privilège sera supprimé du système. Une fois supprimé, il n’affecte plus le rendu de la Carte.
Gardez des priorités simples. Utilisez une petite plage comme 0–100.
Type
La plateforme prend en charge quatre types de privilèges. Chaque type définit comment et quand un privilège peut être utilisé.
A Usage unique le privilège peut être utilisé une seule fois. Une fois utilisé, il est consommé et ne peut plus être réutilisé.
Cas d’usage réels
Café : bon « espresso gratuit », utilisable une seule fois.
Événement : « entrée au salon VIP » pour un seul participant, 1 scan uniquement.
Commerce : code « 15 $ de réduction sur votre prochaine commande », utilisable une seule fois.
Un Illimité le privilège peut être utilisé autant de fois que nécessaire tant qu’il est valide. Il n’est jamais consommé.
Cas d’usage réels
Adhésion : « livraison gratuite » sur chaque commande en ligne.
Commerce : « 10 % de réduction sur tous les achats » pendant toute la saison.
Service : « assistance prioritaire » disponible pour chaque ticket soumis.
A Multi-utilisation le privilège peut être utilisé un nombre limité de fois. Chaque utilisation réduit le nombre restant jusqu’à ce que le privilège soit consommé.
Cas d’usage réels
Salle de sport : pack « 10 entrées », chaque enregistrement en consomme 1.
Lieu : « 3 Cartes invité », chaque scan d’invité en consomme 1.
Lavage auto : « 5 lavages », chaque lavage en consomme 1.
Un Débloquable le privilège devient disponible une fois la progression terminée. Il est verrouillé jusqu’à ce que les étapes requises soient effectuées.
Cas d’usage réels
Restaurant : « Achetez 10 pizzas, obtenez 1 gratuite » (la progression débloque la récompense).
Café : « Collectez 8 tampons, obtenez 1 boisson gratuite » (chaque achat fait progresser l’indicateur).
Formation : « Terminez 3 modules, débloquez un bon d’examen » (progression issue des événements du LMS).
Apparence
mainImage
(facultatif, localisable) Image principale du privilège. Utilisez-la pour expliquer visuellement l’avantage. Veillez à ce qu’elle reste lisible en petite taille.
thumbnail
(facultatif, localisable) Petite image pour les interfaces compactes. Utilisez un pictogramme simple ou un élément de type logo.
backgroundColor
(facultatif) Remplacement de la couleur de fond pour les éléments d’interface du privilège (si pris en charge).
foregroundColor
(facultatif) Remplacement de la couleur de premier plan/texte pour les éléments d’interface du privilège (si pris en charge).
Les images sont automatiquement redimensionnées pour respecter les contraintes d’Apple Wallet et de Google Wallet. Utilisez une image large. Taille recommandée : 1200 px × 400 px.
Remplacera l’image principale de la Carte.
Si la propriété contient des valeurs localisées, la langue du téléphone sélectionne la version localisée. Si aucune version localisée n’existe, la valeur par défaut est utilisée.
Les billets d’événements au format affiche peuvent associer les images différemment selon votre modèle. Si vous avez besoin d’un mappage exact des emplacements, vérifiez la configuration de votre modèle de Carte.
thumbnail n’est pas disponible pour Apple.
Affichée comme visuel du privilège lorsque le modèle de Carte le prend en charge.
TODO
Affichée comme image principale du privilège dans l’interface d’aperçu.
TODO
TODO
Contenu
title
(facultatif, localisable) Libellé court pour le privilège. Exemple : Accès au salon VIP, -10%, Boisson gratuite.
description
(facultatif, localisable) Texte d’accompagnement pour les utilisateurs et les opérateurs. Utilisez-le pour les conditions et les contraintes.
TODO
TODO
TODO
TODO
Liens
legalInformation
(facultatif, localisable) Conditions générales liées au privilège. Généralement un libellé + une URL.
callToAction
(facultatif, localisable) Action principale du privilège. Généralement un libellé + une URL.
Les liens sont généralement modélisés comme { "label": "...", "url": "https://..." }. Le rendu exact dépend du modèle de Carte.
Affiché comme action principale du privilège quand cette fonctionnalité est prise en charge.
Affiché comme action principale du privilège quand cette fonctionnalité est prise en charge.
Affiché comme bouton principal.
Affiché comme bouton d’action pour les opérateurs.
Données
Utilisez data lorsque le privilège comporte un solde à utiliser, une progression ou un code.
value
decimal
Valeur calculée. Somme de toutes les movements[].value.
movements
movement[]
Liste des mouvements de valeur (crédits/débits).
content
string
Valeur libre. Exemple : code promotionnel.
La logique d’utilisation est appliquée par le système consommateur (POS, scanners, applications). La plateforme stocke les mouvements et calcule le movementValue.
Mouvement
movementId
identifiant unique
Généré par la plateforme.
date
dateTime
Date à laquelle ce mouvement a eu lieu.
remarques
string
Remarque libre (audit/débogage).
value
decimal
Peut être négatif lorsque le privilège est utilisé. Peut être fractionnaire pour la progression (Débloquable).
Votre application doit vérifier movementValue avant l’utilisation. Évitez les utilisations concurrentes sur la même Carte/privilège.
Exemples
Cas d’usage
Concert : « 1 boisson de bienvenue gratuite » pour les billets VIP.
Commerce : « 1 emballage cadeau offert » sur le prochain achat.
Musée : « 1 entrée pour visite guidée » pour une date précise.
Chronologie des mouvements (exemple : boisson de bienvenue VIP) :
2025-01-12
1
privilège appliqué
1
2025-01-15
-1
privilège utilisé
0
2025-01-15
1
annulation
1
Cas d’usage
Niveau de fidélité : « 10 % de réduction » à chaque fois, tant que le niveau est actif.
Compagnie aérienne : « 1 bagage enregistré gratuit » sur chaque segment de vol.
Abonnement : « accès illimité » au contenu premium.
Pour les privilèges illimités, les mouvements sont souvent omis, car rien n’est « consommé ». Si vous stockez quand même des mouvements pour l’audit (facultatif), cela peut ressembler à ceci :
2025-01-12
-1
privilège utilisé
-1
2025-01-15
-2
privilège utilisé deux fois
-3
Cas d’usage
Salle de sport : pack prépayé « 10 entrées ».
Festival : « 5 jetons boisson » liés au billet.
Parking : pack « 20 sorties » pour une carte de stationnement d’entreprise.
Chronologie des mouvements (exemple : pack de salle de sport 10 entrées) :
2025-01-12
10
achat de la carte 10 entrées
10
2025-01-15
-1
consommer 1 entrée
9
2025-01-17
-4
consommer 4 entrées (avec des amis)
5
2025-01-17
1
1 entrée offerte
6
Cas d’usage
Restaurant : achetez 10 pizzas, débloquez 1 pizza gratuite.
Café : collectez 8 tampons, débloquez 1 boisson gratuite.
Commerce : dépensez 200 $ en un mois, débloquez un bon de 20 $.
Chronologie des mouvements (exemple : achetez 10 pizzas, débloquez 1 gratuite) :
2025-01-12
0.2
acheter 2 pizzas
0.2
2025-01-15
0.5
acheter 5 pizzas
0.7
2025-01-17
0.4
acheter 4 pizzas
1.1
2025-01-17
-1
réclamer 1 pizza
0.1
Cas d’usage réel
Utilisez les privilèges lorsque vous avez besoin de avantages avec état sur une Carte. L’application native Wallet affichera automatiquement les informations du privilège. Pour une meilleure expérience, il est également possible d’utiliser notre Crew Check application pour scanner les Cartes, lister et utiliser les privilèges.
Billet d’événement
Transformez un billet statique en support de campagne dynamique. Conservez une seule Carte pour l’entrée, puis ajoutez des avantages au fil de l’événement. Utilisez Usage unique pour les avantages à réclamation unique (entrée au salon VIP, accès coupe-file, boisson de bienvenue), Multi-utilisation pour les packs de jetons (jetons boisson, crédits vestiaire), et Débloquable pour les avantages qui apparaissent après progression.
Exemple : tout le monde entre avec la même Carte, mais un Débloquable « accès à l’afterparty » apparaît après le troisième scan. Un Multi-utilisation privilège « 5 jetons boisson » est ajouté à l’ouverture des portes et diminué au bar.
Carte de fidélité
Lancez des promotions et des avantages de niveau sans modifier la Carte. Laissez le CRM, le CDP ou le POS mettre à jour les avantages à mesure que les clients progressent.
Utilisez Illimité pour les droits toujours actifs (réductions de niveau, livraison gratuite, assistance prioritaire). Utilisez Débloquable pour les déclencheurs de dépenses, Multi-utilisation pour les compteurs (tampons, entrées), et Usage unique pour les récompenses ponctuelles (anniversaire, récupération).
Exemple : donnez aux clients VIP un privilège « 15 % de réduction » avec une priorité supérieure Illimité aux remises de campagne. priorité Lorsque le client dépense 200 € en un mois, votre CDP ajoute un privilège « bon de 20 € », Débloquable et le POS l’utilise une seule fois.
Carte cadeau
Utilisez les privilèges lorsque la Carte a besoin de valeur utilisable, d’un code, ou des deux.
Stockez un solde en Multi-utilisation et diminuez-le avec des mouvements à chaque dépense. Stockez un code promotionnel en Usage unique et utilisez-le dès la première utilisation.
Exemple : initialisez une Carte cadeau avec +50. -12 Une dépense de 12 € ajoute un 38mouvement et laisse +10 mouvement de rechargement. Si cet achat est remboursé, ajoutez un +12 mouvement d’annulation au lieu de modifier l’historique.
L’utilisation est appliquée par votre POS ou votre caisse. La plateforme stocke l’état et les mouvements à des fins de reporting.
Adhésion
Utilisez une Carte comme support d’adhésion avec des droits d’accès changeants.
Utilisez Illimité pour l’accès continu, Multi-utilisation pour les quotas mensuels, Usage unique pour les réclamations uniques, et Débloquable pour les récompenses d’étape.
Exemple : une Carte de coworking comprend Illimité un « accès premium » plus Multi-utilisation « 5 Cartes journalières » qui se réinitialisent chaque mois. Une fois l’intégration terminée, un privilège Débloquable « session individuelle » devient utilisable dans le flux de réservation.
FAQ
Combien de privilèges une Carte peut-elle avoir en même temps ?
Vous pouvez attacher jusqu’à 5 privilèges à une seule Carte en même temps. Si vous avez besoin de plus d’avantages, regroupez-les dans moins de privilèges, ou faites-les tourner dans le temps.
Que se passe-t-il lorsque plusieurs privilèges entrent en conflit ?
Lorsque plusieurs privilèges essaient de modifier la même propriété, la priorité détermine le gagnant. Si les priorités sont égales, c’est le privilège mis à jour le plus récemment qui l’emporte.
Dois-je réémettre la Carte lorsqu’un privilège change ?
Non. Les privilèges sont séparés des données de base de la Carte. Vous pouvez ajouter, mettre à jour ou supprimer un privilège sans réémettre la Carte.
Que se passe-t-il aux privilèges lorsqu’une Carte est désinstallée puis réinstallée ?
La désinstallation ou la réinstallation d’une Carte ne modifie pas ses privilèges. Les privilèges restent attachés à la Carte sur les serveurs The Wallet Crew.
D’où viennent les privilèges ?
Vous pouvez créer des privilèges en interne à l’aide d’activations, ou en externe via des connecteurs (par exemple SFMC ou Bloomreach). Vous pouvez aussi les créer et les mettre à jour directement via l’API.
Comment l’état d’utilisation est-il stocké pour les privilèges à utilisation multiple et à usage unique ?
Utilisez des mouvements pour suivre les crédits et les débits. La plateforme stocke l’historique des mouvements et calcule le
valuemais votre système consommateur (POS, scanners, application) applique les règles d’utilisation.