# Privilège A **privilège** est un avantage associé à une seule carte numérique. Il définit ce que le détenteur peut faire, réclamer ou déverrouiller. 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 parce qu’ils transforment une simple carte en un puissant outil d’engagement et de fidélisation. Une carte seule donne accès, mais un privilège donne une raison aux clients de s’intéresser, d’interagir et de revenir. C’est la différence entre un billet standard et une expérience qui semble 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 qui लाभifient 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 offrent de la flexibilité et de la créativité aux campagnes. Les marques peuvent concevoir des combinaisons uniques d’avantages, cibler différents segments de clientèle ou ajouter des récompenses limitées dans le temps, tout cela 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. * **Multiutilisation**: nombre d’utilisations limité. * **Déverrouillable**: n’apparaît qu’une fois la progression ou les conditions remplies. Cela correspond directement à des avantages concrets : boisson gratuite, remise de 10 %, 5 entrées, récompenses à déverrouiller après dépense. ### Comment les privilèges arrivent sur 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](/guides-animation/fr/engager-et-animer/privilege-and-activation/activation.md). Ils peuvent aussi être créés **en externe** via des connecteurs comme [SFMC](https://github.com/TheWalletCrew/docs/blob/main/guides/connect/marketing-automation/salesforce-marketing-cloud/README.md) ou [Bloomreach](https://github.com/TheWalletCrew/docs/blob/main/guides/connect/marketing-automation/bloomreach/README.md) ou directement via l’ [API](broken://pages/d38ee1192d756b10bd1854bdd3ed007bd1038e0c). 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 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 | Propriété | Description | | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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 `Une seule fois`, `Illimité`, `Multiutilisation`, `Déverrouillable`. | | `tags` | Liste de tags utilisée 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` externe (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. | {% hint style="info" %} Gardez des priorités simples. Utilisez une petite plage comme `0–100`. {% endhint %} ### Type La plateforme prend en charge quatre types de privilèges. Chaque type définit comment et quand un privilège peut être utilisé. {% tabs %} {% tab title="Une seule fois" %} 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é. {% hint style="success" %} **Cas d’utilisation réels** * Café : bon « espresso gratuit », à utiliser une seule fois. * Événement : entrée au « VIP lounge » pour un participant, 1 scan uniquement. * Commerce : code « 15 $ de réduction sur votre prochaine commande », utilisable une seule fois. {% endhint %} {% endtab %} {% tab title="Illimité" %} Un **Illimité** le privilège peut être utilisé **autant de fois que nécessaire** tant qu’il est valide. Il n’est jamais consommé. {% hint style="success" %} **Cas d’utilisation réels** * Abonnement : « livraison gratuite » sur chaque commande en ligne. * Commerce : « 10 % de réduction sur tous les achats » pendant toute la saison. * Service : « support prioritaire » disponible pour chaque ticket soumis. {% endhint %} {% endtab %} {% tab title="Multiutilisation" %} A **Multiutilisation** le privilège peut être utilisé **un nombre limité de fois**. Chaque utilisation réduit le compteur restant jusqu’à ce que le privilège soit consommé. {% hint style="success" %} **Cas d’utilisation réels** * Salle de sport : pack de « 10 entrées », chaque enregistrement en consomme 1. * Lieu : « 3 passes invités », chaque scan d’invité en consomme 1. * Lavage auto : « 5 lavages », chaque lavage en consomme 1. {% endhint %} {% endtab %} {% tab title="Déverrouillable" %} Un **Déverrouillable** le privilège devient disponible **une fois la progression terminée**. Il est verrouillé jusqu’à ce que les étapes requises soient effectuées. {% hint style="success" %} **Cas d’utilisation réels** * Restaurant : « Achetez 10 pizzas, obtenez-en 1 gratuite » (la progression déverrouille la récompense). * Café : « Collectez 8 tampons, obtenez-en 1 gratuit » (chaque achat incrémente la progression). * Éducation : « Terminez 3 modules, déverrouillez le bon d’examen » (progression issue des événements LMS). {% endhint %} {% endtab %} {% endtabs %} ### Apparence | Propriété | Description | | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | `mainImage` | *(facultatif, localisable)* Image principale du privilège. Utilisez-la pour expliquer visuellement l’avantage. Gardez-la lisible à petite taille. | | `miniature` | *(facultatif, localisable)* Petite image pour les interfaces compactes. Utilisez un pictogramme simple ou un visuel de type logo. | | `backgroundColor` | *(facultatif)* Remplacement de la couleur de fond pour les éléments UI du privilège (si pris en charge). | | `foregroundColor` | *(facultatif)* Remplacement de la couleur de premier plan/du texte pour les éléments UI du privilège (si pris en charge). | {% hint style="info" %} 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`. {% endhint %} {% tabs fullWidth="false" %} {% tab title="Apple Wallet" %} 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 version par défaut` est utilisée. {% hint style="info" %} Les billets d’événement au style affiche peuvent mapper 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. {% endhint %} {% hint style="warning" %} `miniature` n’est pas disponible pour Apple. {% endhint %} {% endtab %} {% tab title="Google Wallet" %} Affiché comme le visuel du privilège lorsque le modèle de carte le prend en charge. {% hint style="danger" %} TODO {% endhint %} {% endtab %} {% tab title="Aperçu de la Carte" %} Affiché comme image principale du privilège dans l’interface d’aperçu. {% hint style="danger" %} TODO {% endhint %} {% endtab %} {% tab title="Crew check" %} {% hint style="danger" %} TODO {% endhint %} {% endtab %} {% endtabs %} ### Contenu | Propriété | Description | | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | `titre` | *(facultatif, localisable)* Libellé court du 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. | {% tabs %} {% tab title="Apple Wallet" %} {% hint style="danger" %} TODO {% endhint %} {% endtab %} {% tab title="Google Wallet" %} {% hint style="danger" %} TODO {% endhint %} {% endtab %} {% tab title="Aperçu de la Carte" %} {% hint style="danger" %} TODO {% endhint %} {% endtab %} {% tab title="Crew check" %} {% hint style="danger" %} TODO {% endhint %} {% endtab %} {% endtabs %} ### Liens | Propriété | Description | | ------------------ | ----------------------------------------------------------------------------------------------------------- | | `legalInformation` | *(facultatif, localisable)* Conditions générales relatives 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. | {% hint style="info" %} Les liens sont généralement modélisés comme `{ "label": "...", "url": "https://..." }`. Le rendu exact dépend du modèle de carte. {% endhint %} {% tabs %} {% tab title="Apple Wallet" %} Affiché comme l’action principale du privilège lorsqu’elle est prise en charge. {% endtab %} {% tab title="Google Wallet" %} Affiché comme l’action principale du privilège lorsqu’elle est prise en charge. {% endtab %} {% tab title="Aperçu de la Carte" %} Affiché comme un bouton principal. {% endtab %} {% tab title="Crew check" %} Affiché comme un bouton d’action pour les opérateurs. {% endtab %} {% endtabs %} ### Données Utilisez les **données** lorsque le privilège comporte un solde utilisable, une progression ou un code. | Propriété | Type | Description | | ------------ | ------------ | ------------------------------------------------------- | | `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 promo. | {% hint style="info" %} La logique d’utilisation est appliquée par le système consommateur (POS, scanners, applications). La plateforme stocke les mouvements et calcule `movementValue`. {% endhint %} #### Mouvement | Propriété | Type | Description | | ------------ | ------------------ | ------------------------------------------------------------------------------------------------------------------ | | `movementId` | identifiant unique | Généré par la plateforme. | | `date` | `dateTime` | 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éverrouillable). | {% hint style="info" %} Votre application doit vérifier `movementValue` avant de procéder à l’utilisation. Évitez les utilisations concurrentes sur la même carte/le même privilège. {% endhint %} #### Exemples {% tabs %} {% tab title="Une seule fois" %} **Cas d’utilisation** * Concert : « 1 boisson de bienvenue gratuite » pour les billets VIP. * Commerce : « 1 emballage cadeau gratuit » sur le prochain achat. * Musée : « 1 entrée pour visite guidée » pour une date spécifique. Chronologie des mouvements (exemple : boisson de bienvenue VIP) :
datevaleurremarquestotal
2025-01-121privilège appliqué1
2025-01-15-1privilège utilisé0
2025-01-151annulation1
{% endtab %} {% tab title="Illimité" %} **Cas d’utilisation** * 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 parce que rien n’est « consommé ».\ Si vous stockez quand même les mouvements pour l’audit (facultatif), cela peut ressembler à ceci :
datevaleurremarquestotal
2025-01-12-1privilège utilisé-1
2025-01-15-2privilège utilisé deux fois-3
{% endtab %} {% tab title="Multiutilisation" %} **Cas d’utilisation** * Salle de sport : pack prépayé de « 10 entrées ». * Festival : « 5 jetons boisson » liés au billet. * Parking : pack de « 20 sorties » pour une carte de stationnement d’entreprise. Chronologie des mouvements (exemple : pack salle de sport de 10 entrées) :
datevaleurremarquestotal
2025-01-1210acheter une carte 10 entrées10
2025-01-15-1consommer 1 entrée9
2025-01-17-4consommer 4 entrées (avec des amis)5
2025-01-1711 entrée offerte6
{% endtab %} {% tab title="Déverrouillable" %} **Cas d’utilisation** * Restaurant : achetez 10 pizzas, déverrouillez 1 pizza gratuite. * Café : collectez 8 tampons, déverrouillez 1 boisson gratuite. * Commerce : dépensez 200 $ en un mois, déverrouillez un bon de 20 $. Chronologie des mouvements (exemple : achetez 10 pizzas, déverrouillez 1 gratuite) :
datevaleurremarquestotal
2025-01-120.2acheter 2 pizzas0.2
2025-01-150.5acheter 5 pizzas0.7
2025-01-170.4acheter 4 pizzas1.1
2025-01-17-1utiliser 1 pizza0.1
{% endtab %} {% endtabs %} ## Cas d’utilisation réel Utilisez les privilèges lorsque vous avez besoin de **avantages avec état** sur une carte. L’application Wallet native affichera automatiquement les informations du privilège. Pour une meilleure expérience, il est également possible d’utiliser notre [Crew Check](https://github.com/TheWalletCrew/docs/blob/main/guides/scan/crew-check.md) application pour scanner les cartes et répertorier et utiliser les privilèges. ### Billet d’événement Transformez un billet statique en surface de campagne vivante. Conservez une carte pour l’entrée, puis ajoutez des avantages au fur et à mesure que l’événement se déroule. Utilisez **Une seule fois** pour les avantages à usage unique (entrée au salon VIP, accès coupe-file, boisson de bienvenue), **Multiutilisation** pour les packs de jetons (jetons boisson, crédits vestiaire), et **Déverrouillable** pour les avantages qui apparaissent après la progression. Exemple : tout le monde entre avec la même carte, mais un **Déverrouillable** privilège « Accès afterparty » apparaît après le troisième scan. Un **Multiutilisation** 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 niveau sans modifier la carte. Laissez le CRM, le CDP ou le POS mettre à jour les avantages au fur et à mesure que les clients progressent. Utilisez les **Illimité** pour les droits permanents (réductions de niveau, livraison gratuite, support prioritaire). Utilisez **Déverrouillable** pour les déclencheurs liés aux dépenses, **Multiutilisation** pour les compteurs (tampons, entrées), et **Une seule fois** pour les récompenses ponctuelles (anniversaire, récupération). Exemple : offrez aux clients VIP un **Illimité** privilège « 15 % de réduction » avec une priorité plus élevée **priorité** que les remises de campagne. Lorsque le client dépense 200 € en un mois, votre CDP ajoute un **Déverrouillable** privilège « bon de 20 € », et le POS l’utilise une fois. ### Carte cadeau Utilisez les privilèges lorsque la carte a besoin de **valeur utilisable**, **un code**ou les deux. Stockez un solde sous forme de **Multiutilisation** et décrémentez-le avec des mouvements à chaque dépense. Stockez un code promo sous forme de **Une seule fois** et consommez-le à la première utilisation. Exemple : démarrez une carte cadeau à `+50`25 €. `-12` Un achat de 12 € ajoute un `38`et laisse `+10` mouvement de rechargement. Si cet achat est remboursé, ajoutez un `+12` mouvement de rollback plutôt que 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 surface d’adhésion avec des droits évolutifs. Utilisez les **Illimité** pour un accès continu, **Multiutilisation** pour des quotas mensuels, **Une seule fois** pour des demandes ponctuelles, et **Déverrouillable** pour des récompenses d’étape. Exemple : une carte de coworking comprend **Illimité** « accès premium » plus **Multiutilisation** « 5 passes journalières » qui se réinitialisent chaque mois. Une fois l’onboarding terminé, un **Déverrouillable** privilège « session 1:1 » devient utilisable dans le parcours 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 en 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 tentent 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.
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 également les créer et les mettre à jour directement via l’API.
Comment l’état d’utilisation est-il stocké pour les privilèges Multiutilisation et Une seule fois ? Utilisez des mouvements pour suivre les crédits et les débits. La plateforme stocke l’historique des mouvements et calcule le `valeur`courant, mais votre système consommateur (POS, scanners, application) applique les règles d’utilisation.
Puis-je « annuler » une utilisation ? Oui, si votre processus le permet. Au lieu de modifier l’historique, ajoutez un nouveau mouvement qui compense le débit précédent (un crédit de rollback) afin que la piste d’audit reste intacte.
Que deletionDate fait-il ? Il planifie le moment où le privilège est supprimé du système. Après suppression, il n’affecte plus le rendu de la carte et ne doit plus être pris en compte lors des scans et de l’utilisation.
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.thewalletcrew.io/guides-animation/fr/engager-et-animer/privilege-and-activation/privilege.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.