Privilège
Définissez et gérez les privilèges de Carte (avantages) dans The Wallet Crew : types, sources de création, règles de priorité et état de remboursement basé sur le mouvement.
A privilège Un privilège est un avantage rattaché à une seule carte numérique. Il définit ce que le détenteur peut faire, réclamer ou débloquer. Les privilèges sont distincts 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 car ils transforment une simple carte en un puissant outil d'engagement et de fidélisation. Une carte seule donne l'accès, mais un privilège donne aux clients une raison de s'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 car 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 créer des combinaisons d'avantages uniques, cibler différents segments de clientèle ou ajouter des récompenses à durée limitée, 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 fonctionnent les privilèges
Les privilèges ont un type comportemental :
Une seule fois: à utiliser une seule fois, puis il disparaît.
Illimité: toujours disponible tant qu'il est valide.
Multi-utilisation: nombre d'utilisations limité.
Déblocable: n'apparaît qu'une fois la progression terminée ou les conditions remplies.
Cela correspond directement à des avantages concrets. Boisson gratuite, remise de 10 %, 5 entrées, récompenses à débloquer en fonction des dépenses.
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 activations. Ils peuvent aussi être créés à l'externe via des connecteurs comme SFMC ou Bloomreach ou directement via API.
Une carte peut contenir jusqu'à 5 privilèges en même temps. En cas de conflit, on utilise la priorité, puis la mise à jour la plus récente comme critère 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/le statut.
Propriétés générales
privilegeId
Identifiant unique du privilège. Généré automatiquement par le système.
la 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 Une seule fois, Illimité, Multi-utilisation, Déblocable.
tags
Liste d'étiquettes utilisées pour le reporting.
origin.generator
(facultatif) Nom du processus générant le privilège. Utilisez interne 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.
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 Une seule fois le privilège peut être utilisé une seule fois. Une fois utilisé, il est consommé et ne peut plus être utilisé.
Cas d'utilisation concrets
Café : bon « Espresso gratuit », à utiliser une seule fois.
Événement : entrée au salon VIP pour un participant, 1 seul scan.
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'utilisation concrets
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'utilisation concrets
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éblocable le privilège devient disponible une fois la progression terminée. Il reste verrouillé jusqu'à ce que les étapes requises soient effectuées.
Cas d'utilisation concrets
Restaurant : « Achetez 10 pizzas, obtenez-en 1 gratuite » (la progression débloque la récompense).
Café : « Collectez 8 tampons, obtenez-en 1 gratuit » (chaque achat fait progresser le compteur).
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. Gardez-la lisible en petite taille.
thumbnail
(facultatif, localisable) Petite image pour les interfaces compactes. Utilisez un pictogramme simple ou un visuel de type logo.
backgroundColor
(facultatif) Remplacement de la couleur d'arrière-plan pour les éléments d'interface du privilège (lorsque pris en charge).
foregroundColor
(facultatif) Remplacement de la couleur de premier plan/du texte pour les éléments d'interface du privilège (lorsque pris en charge).
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, par défaut est utilisée.

thumbnail n'est pas disponible pour Apple.
Affiché comme visuel du privilège lorsque le modèle de carte le prend en charge.
Google Wallet utilise une seule image non localisée. Seule la valeur par défaut de mainImage / thumbnail est utilisée, quelle que soit la langue du téléphone. Les images localisées par langue ne sont pas prises en charge sur Google aujourd'hui en raison d'une contrainte de webhook Google. Si des images localisées sont définies pour Apple et qu'une image par défaut existe dans le même privilège, Google utilise l'image par défaut.
Affiché comme image principale du privilège dans l'interface d'aperçu.
L'interface d'aperçu affiche le privilège mainImage. Lorsque des valeurs localisées existent, l'aperçu suit la même règle qu'Apple. Il affiche l'image de la langue sélectionnée et revient à la valeur par défaut lorsqu'aucune version localisée n'existe.
TODO — confirmer avec le produit si Crew check affiche l'image du privilège et, le cas échéant, s'il utilise la valeur localisée ou la valeur par défaut.
Un privilège n'est pas ciblé sur un appareil. Chaque privilège appliqué est ajouté à la carte pour Apple et Google. L'application de deux privilèges, par exemple un « localisé » et un « générique », entraîne l'affichage des deux sur chaque carte, et leurs descriptions s'empilent au dos. Utilisez un seul privilège par campagne, en combinant les images localisées et par défaut.
Contenu
titre
(facultatif, localisable) Libellé court du privilège. Exemple : Accès au salon VIP, -10%, Boisson gratuite.
description
(facultatif, localisable) Texte d'appui 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. Il s'agit généralement d'un libellé + une URL.
callToAction
(facultatif, localisable) Action principale du privilège. Il s'agit généralement d'un libellé + une URL.
Affiché comme action principale du privilège lorsque pris en charge.
Affiché comme action principale du privilège lorsque pris en charge.
Affiché comme bouton principal.
Affiché comme bouton d'action pour les opérateurs.
Données
Utilisez data lorsque le privilège contient un solde échangeable, une progression ou un code.
valeur
décimal
Valeur calculée. Somme de tous les movements[].value.
mouvements
movement[]
Liste des mouvements de valeur (crédits/débits).
contenu
chaîne
Valeur libre. Exemple : code promotionnel.
Mouvement
movementId
identifiant unique
Généré par la plateforme.
date
date et heure
Date à laquelle ce mouvement a eu lieu.
remarques
chaîne
Remarque libre (audit/débogage).
valeur
décimal
Peut être négatif lorsque le privilège est utilisé. Peut être fractionnaire pour la progression (Déblocable).
Exemples
Cas d'utilisation
Concert : « 1 boisson de bienvenue gratuite » pour les billets VIP.
Commerce : « 1 emballage cadeau gratuit » à l'achat suivant.
Musée : « 1 entrée pour une 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'utilisation
Palier de fidélité : « 10 % de réduction » à chaque fois, tant que le palier 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'utilisation
Salle de sport : pack prépayé « 10 entrées ».
Festival : « 5 jetons boisson » liés à la carte.
Parking : pack « 20 sorties » pour une carte de parking d'entreprise.
Chronologie des mouvements (exemple : pack salle de sport 10 entrées) :
2025-01-12
10
achat de la carte 10 entrées
10
2025-01-15
-1
consommation de 1 entrée
9
2025-01-17
-4
consommation de 4 entrées (avec des amis)
5
2025-01-17
1
1 entrée offerte
6
Cas d'utilisation
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-en 1 gratuite) :
2025-01-12
0.2
achat de 2 pizzas
0.2
2025-01-15
0.5
achat de 5 pizzas
0.7
2025-01-17
0.4
achat de 4 pizzas
1.1
2025-01-17
-1
utilisation d'1 pizza
0.1
Cas d'utilisation réel
Utilisez des privilèges lorsque vous avez besoin d'avantages avec état sur une carte. L'application native de portefeuille 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 vivant. Conservez une carte pour l'entrée, puis ajoutez des avantages au fil du déroulement de l'événement. Utilisez Une seule fois 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éblocable pour les avantages qui apparaissent après progression.
Exemple : tout le monde entre avec la même carte, mais un Déblocable privilège « Accès after-party » apparaît après le troisième scan. Un Multi-utilisation privilège « 5 jetons boisson » est ajouté à l'ouverture des portes et décrémenté au bar.
Carte de fidélité
Lancez des promotions et des avantages de palier sans modifier la carte. Laissez le CRM, la CDP ou le POS mettre à jour les avantages au fur et à mesure que les clients progressent.
Utilisez Illimité pour les droits permanents (réductions de palier, livraison gratuite, assistance prioritaire). Utilisez Déblocable pour les déclencheurs liés aux dépenses, Multi-utilisation pour les compteurs (tampons, entrées), et Une seule fois pour les récompenses à usage unique (anniversaire, récupération).
Exemple : offrez aux clients VIP un Illimité privilège « 15 % de réduction » avec un la priorité supérieur à celui des remises de campagne. Lorsque le client dépense 200 € en un mois, votre CDP ajoute un Déblocable privilège « bon de 20 € », et le POS l'utilise une seule fois.
Carte cadeau
Utilisez des privilèges lorsque la carte a besoin de valeur utilisable, un code, ou les deux.
Stockez un solde sous forme de Multi-utilisation et décrémentez-le au moyen de mouvements à chaque dépense. Stockez un code promotionnel sous forme de Une seule fois et consommez-le dès la première utilisation.
Exemple : démarrez une carte cadeau à +50. Un achat de 12 € ajoute un -12 mouvement et laisse 38. Une promotion de fin d'année ajoute un +10 mouvement de rechargement. Si cet achat est remboursé, ajoutez un +12 mouvement d'annulation plutôt que de modifier l'historique.
L'utilisation est imposé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 évolutifs.
Utilisez Illimité pour l'accès continu, Multi-utilisation pour les quotas mensuels, Une seule fois pour les réclamations uniques, et Déblocable pour les récompenses d'étape.
Exemple : une carte de coworking a Illimité « accès premium » plus Multi-utilisation « 5 cartes journalières » qui se réinitialisent chaque mois. Une fois l'intégration terminée, un Déblocable privilège « session 1:1 » devient utilisable dans le parcours de réservation.


Comment l'état d'utilisation est-il stocké pour les privilèges MultiUse et OneTime ?
Utilisez des mouvements pour suivre les crédits et les débits. La plateforme stocke l'historique des mouvements et calcule le
valeur, mais votre système consommateur (POS, scanners, application) applique les règles d'utilisation.