> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/guides-animation/fr/engage-and-animate/benefit-templates.md).

# Modèles d’avantages

Créez des modèles d’avantages : avantages à usage unique, illimités et multi-utilisation affichés sur les Wallet Cartes, la page des avantages et Carte Scanner.

Un avantage est quelque chose qu'un titulaire de Carte peut utiliser : une boisson offerte, une remise membre, un pack de sessions d'atelier, un cadeau d'anniversaire. Un modèle d'avantage est la définition réutilisable qui se cache derrière. Il est configuré une fois dans la console d'administration, puis attribué à autant de Cartes que nécessaire, manuellement, par une automatisation, lorsqu'une carte à tampons est complète, ou via l'API.

Les avantages vivent à côté de la Carte plutôt qu'à l'intérieur de son modèle de Carte. Ils peuvent être attribués, utilisés, prolongés ou supprimés à tout moment sans émettre une nouvelle Carte, et chaque modification est envoyée à Apple Wallet et Google Wallet via le pipeline de mise à jour habituel. Cela fait des modèles d'avantages l'outil principal pour transformer une Carte ou un billet statique en un programme qui récompense, surprend et fait revenir les clients.

{% hint style="info" %}
Un avantage était autrefois appelé un *privilège*, et le mécanisme de masse appelé un *activation* est maintenant une [automatisation](https://docs.thewalletcrew.io/guides-animation/fr/engage-and-animate/automatisation.md) avec l' **action « Attribuer un avantage »** . Les intégrateurs trouvent le mappage complet dans [Migrer depuis l'API des privilèges](https://docs.thewalletcrew.io/developers-guides/fr/integration-guides/wallet/pass-lifecycle.md#migrate-from-the-privilege-api).
{% endhint %}

<details>

<summary><strong>Exemples concrets</strong></summary>

* **Café :** une carte à tampons offre une boisson offerte au choix lorsque le dixième tampon est collecté. Le barista l'utilise depuis Scanner de Carte.
* **Fidélité en magasin :** chaque membre dispose d'un avantage illimité « 10 % de réduction sur chaque commande », affiché au dos de la carte et sur la page des avantages.
* **Ateliers et cours :** un pack multi-usage « 5 ateliers barista » décompte un usage par session.
* **Programme d'anniversaire :** une automatisation attribue un « cadeau d'anniversaire » deux jours avant la date de naissance, valable 30 jours à partir du moment où il est reçu.
* **Événements :** un titulaire de billet VIP reçoit « 2 boissons au bar », utilisable uniquement pendant les dates de l'événement.
* **Promotion e-commerce :** un code promo partagé `SUMMER20` est affiché à chaque titulaire, avec un bouton d'appel à l'action vers la boutique en ligne.

</details>

## Comment fonctionnent les avantages

Un modèle d'avantage décrit les règles : ce que lit le titulaire, combien de fois l'avantage peut être utilisé, combien de temps il reste valable, où il est affiché et s'il comporte un code. Attribuer le modèle à une Carte crée un **avantage** sur cette Carte, qui est une copie du modèle à ce moment-là, avec son propre solde, ses propres dates de validité et son propre code.

Parce que chaque Carte possède sa propre copie, modifier un modèle ne réécrit pas silencieusement ce que les titulaires possèdent déjà. Les modifications s'appliquent aux avantages attribués à partir de ce moment. Pour atteindre les titulaires existants, utilisez [Enregistrer et mettre à jour les avantages](#edit-duplicate-deactivate-or-delete-a-template).

```mermaid
flowchart LR
    T["Modèle d'avantage<br/>(règles, contenu, validité, code)"]
    T -->|Console d'administration| B
    T -->|Automatisation : Attribuer un avantage| B
    T -->|Objectif de carte à tampons atteint| B
    T -->|API| B
    B["Avantage sur une Carte<br/>(solde, dates, code)"]
    B --> AW["Apple Wallet<br/>champ arrière, image de bande"]
    B --> GW["Google Wallet<br/>message, image principale"]
    B --> BP["Page des avantages<br/>de la Carte"]
    B --> PS["Scanner de Carte<br/>le personnel l'utilise"]
```

### Comportement : usage unique, illimité ou multi-usage

Le comportement détermine comment un avantage est consommé. Il est choisi lors de la création du modèle et **ne peut pas être modifié ensuite**, car les avantages déjà attribués en dépendent. Pour modifier le comportement, dupliquez le modèle et modifiez-le sur la copie.

| Comportement     | Ce que cela signifie                                                                                   | Usage typique                                                          |
| ---------------- | ------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------- |
| **Usage unique** | Utilisé une fois, puis consommé.                                                                       | Boisson offerte, cadeau de bienvenue, code de bon unique.              |
| **Illimité**     | Toujours disponible. Les utilisations sont comptabilisées pour les rapports mais ne s'épuisent jamais. | Remise membre, livraison gratuite, accès prioritaire.                  |
| **Multi-usage**  | Un nombre défini d'utilisations (**Nombre d'utilisations**, 1 ou plus), décomptées une par une.        | 5 sessions d'atelier, 10 entrées en salle de sport, 3 cartes invitées. |

Un avantage multi-usage peut être recrédité, par exemple lorsqu'un usage est rendu après une erreur, mais jamais au-delà de son nombre initial d'utilisations.

### Catégorie

La catégorie facultative est utilisée pour les rapports. Elle ne modifie jamais le comportement de l'avantage.

| Catégorie      | Description                                                                                                                   |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| Remise         | Une réduction de prix appliquée à la caisse, par exemple -20 % sur la prochaine commande.                                     |
| Produit offert | Un article offert une seule fois, par exemple une crème pour les mains de 30 ml.                                              |
| Service        | Un service récurrent inclus avec l'abonnement, par exemple un emballage cadeau gratuit en magasin.                            |
| Accès          | Accès à un espace ou à un nombre défini de sessions, par exemple un salon réservé aux membres ou 5 sessions d'atelier.        |
| Carte-cadeau   | Un solde à dépenser sur plusieurs visites, par exemple une carte de 50 €. Disponible uniquement pour les modèles multi-usage. |
| Autre          | Tout ce qui ne correspond pas aux catégories ci-dessus. Un modèle sans catégorie est signalé comme Autre.                     |

### Statut d'un avantage

Chaque avantage sur une Carte a un statut calculé à partir de ses dates et de son solde. Le statut détermine ce que voit le titulaire et si le personnel peut utiliser l'avantage.

| Statut         | Signification                                                                                                  |
| -------------- | -------------------------------------------------------------------------------------------------------------- |
| **Planifié**   | Attribué, mais pas encore utilisable : sa **Utilisable à partir du** date est dans le futur.                   |
| **Disponible** | Utilisable maintenant.                                                                                         |
| **Utilisé**    | Il ne reste rien à utiliser. Un avantage illimité n'atteint jamais ce statut.                                  |
| **Expiré**     | Sa validité est terminée. Il reste visible sur la Carte, affiché comme expiré, jusqu'à ce qu'il soit supprimé. |
| **Supprimé**   | Retiré de la Carte. Il n'apparaît plus au titulaire, sur la page des avantages ni dans Scanner de Carte.       |

### Limites

Une Carte contient au maximum **20 avantages actifs**. Apple Wallet et Google Wallet n'offrent qu'un nombre fini de champs et de messages, donc cette limite garantit que chaque Carte reste lisible. Les avantages expirés comptent toujours jusqu'à leur suppression, d'où l'importance de choisir une règle de suppression pour les programmes de longue durée. Attribuer un modèle à une Carte qui contient déjà un avantage issu de ce modèle met à jour l'avantage existant au lieu d'en ajouter un second, et n'est jamais refusé à cause de la limite. Pour offrir deux fois le même avantage, utilisez un modèle multi-usage ou deux modèles.

## Où un avantage apparaît

Le même avantage peut être affiché à plusieurs endroits. Chaque endroit est activé ou désactivé dans le modèle, de sorte qu'un avantage peut être visible uniquement pour le titulaire, uniquement pour le personnel, ou les deux.

| Surface                | Ce qui est affiché                                                                                                                                                        | Contrôlé par                                                                                         |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| **Page des avantages** | La page de la Carte qui répertorie tous les avantages du titulaire : visuel, titre, description, code, liens et, lorsqu'il est configuré, un **Ajouter à Wallet** bouton. | **Afficher sur la page des avantages**                                                               |
| **Apple Wallet**       | Un champ arrière dont le libellé est le titre et dont la valeur est la description. Le visuel peut remplacer l'image de bande de la Carte.                                | **Ajouter la description au dos de la Carte**, **Utiliser le visuel comme illustration de la Carte** |
| **Google Wallet**      | Un message sur la Carte, avec le titre comme en-tête et la description comme corps. Le visuel peut remplacer l'image principale.                                          | **Ajouter la description au dos de la Carte**, **Utiliser le visuel comme illustration de la Carte** |
| **Scanner de Carte**   | L'avantage dans la liste que le personnel voit lorsqu'il scanne la Carte du titulaire, avec un bouton pour l'utiliser.                                                    | **Afficher dans Scanner de Carte**, **Utiliser automatiquement au scan**                             |
| **Carte liée**         | Une Carte Wallet séparée créée à partir d'un modèle de Carte d'offre, que le titulaire enregistre depuis la page des avantages.                                           | **Afficher un bouton « Ajouter à Wallet »**                                                          |

{% hint style="warning" %}
Un avantage n'est pas spécifique à un appareil. Chaque avantage attribué à une Carte est rendu à la fois dans Apple Wallet et Google Wallet. Utilisez un avantage par campagne, avec un contenu traduit, plutôt qu'un avantage par langue ou par Wallet.
{% endhint %}

## Créer un modèle d'avantage

Les modèles d'avantages sont gérés depuis **Engagement → Modèles d'avantages**.

{% hint style="info" %}
**Engagement → Modèles d'avantages** est une fonctionnalité bêta. L'entrée de menu s'affiche lorsque **Fonctionnalités bêta** est activé dans le menu de profil de la console d'administration.
{% endhint %}

La galerie affiche chaque modèle avec son visuel, son titre, son comportement, ses tags et le nombre de Cartes auxquelles il est lié. Les **Actif**, **Inactif** et **Terminé** filtres séparent les modèles qui peuvent être attribués aujourd'hui de ceux qui sont désactivés ou dont la date de fin est passée.

<figure><img src="https://3130570494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F97ZAXMtqOjhvBBCfpmcE%2Fuploads%2Fgit-blob-6f778d257bc89e8dee233b054ab3e6c0a8fbd23d%2Fbenefit-templates-gallery-native.png?alt=media" alt="The Benefit templates gallery shows each template&#x27;s visual, behavior, tags and number of linked passes."><figcaption><p>La galerie des modèles d'avantages affiche le visuel, le comportement, les tags et le nombre de Cartes liées de chaque modèle.</p></figcaption></figure>

Pour en créer un, cliquez sur **Ajouter nouveau**, cliquez sur **Nommer ce modèle d'avantage** pour lui donner un nom interne, choisissez le comportement, puis parcourez les sections ci-dessous de haut en bas et cliquez sur **Enregistrer**Le modèle est **Actif** actif par défaut et peut être attribué immédiatement.

<p align="center"><a href="https://admin.thewalletcrew.io/tenant/~/engagement/benefit-templates" class="button secondary" data-icon="chevrons-right">Ouvrir les modèles d'avantages dans la console d'administration</a></p>

La consultation des modèles d'avantages nécessite l'autorisation `tenant.configuration.benefitTemplate:read`; leur création et leur modification nécessitent `tenant.configuration.benefitTemplate:write`.

<figure><img src="https://3130570494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F97ZAXMtqOjhvBBCfpmcE%2Fuploads%2Fgit-blob-afac19648bade9048ecf661eb815af89b98f1aba%2Fbenefit-template-editor-behavior-content-native.png?alt=media" alt="The top of the editor sets the name, tags, behavior, category and the content the holder reads."><figcaption><p>Le haut de l'éditeur définit le nom, les tags, le comportement, la catégorie et le contenu que lit le titulaire.</p></figcaption></figure>

### Nom, tags et statut

Le nom est interne : les titulaires ne le voient jamais. Il est utilisé dans la console d'administration, dans les automatisations et dans les profils de Scanner de Carte. L'identifiant du modèle est dérivé du nom lors de la première sauvegarde. Il peut contenir des lettres, des chiffres, des tirets et des underscores, doit commencer par une lettre ou un chiffre, est limité à 128 caractères et ne peut pas être modifié ensuite.

Les tags sont des libellés libres utilisés pour filtrer les rapports et créer des [profils de Scanner de Carte](https://docs.thewalletcrew.io/guides-scan/fr/scanner/pass-scanner/pass-scanner-profiles.md). Ils ne sont jamais affichés au titulaire.

L' **Actif** interrupteur contrôle si le modèle peut être attribué. Un modèle inactif ne peut plus être attribué, mais les titulaires qui ont déjà son avantage le conservent.

### Comment cela fonctionne

Choisissez le **Comportement** (voir [Comportement](#behavior-one-time-unlimited-or-multi-use)), le **Nombre d'utilisations** pour un modèle multi-usage, et une option facultative **Catégorie** (voir [Catégorie](#category)).

### Ce que voit le client

| Paramètre       | Description                                                                                                                                    |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Titre**       | Obligatoire. Ce que lit le titulaire en premier, jusqu'à 200 caractères, par exemple "Boisson offerte de votre choix".                         |
| **Description** | Texte d'appui facultatif, jusqu'à 2 000 caractères. Utilisez-le pour les conditions : où, quand, comment.                                      |
| **Langue**      | Passe du texte par défaut à chaque langue du tenant. Un champ laissé vide dans une langue revient à la version par défaut.                     |
| **Visuel**      | Image facultative, téléchargée (PNG, JPEG, GIF ou WebP) ou référencée par une `https://` adresse. La taille recommandée est **1200 × 400 px**. |

Sur Google Wallet, le visuel devient l'image principale et est recadré pour s'adapter à la zone principale, donc gardez le contenu important centré. Le contenu traduit est utilisé dans Apple Wallet et Google Wallet selon la langue du téléphone du titulaire.

### Validité

La validité définit quand l'avantage peut être utilisé. Toutes les heures sont saisies dans le fuseau horaire de l'ordinateur utilisé dans la console d'administration.

| Paramètre                  | Options                                                                                                                                                                                                                                                                                             |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Utilisable à partir du** | Vide signifie immédiatement. Une date future rend les avantages attribués **Planifié** jusque-là.                                                                                                                                                                                                   |
| **Jusqu'au**               | **Pas de fin**: utilisable tant qu'il est actif. **Une date**: la même date de fin pour chaque titulaire, quelle que soit la date de réception. **Une durée**: comptée à partir du moment où chaque titulaire le reçoit, par exemple 30 jours, afin que tout le monde bénéficie de la même période. |

<figure><img src="https://3130570494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F97ZAXMtqOjhvBBCfpmcE%2Fuploads%2Fgit-blob-52b3dfe009a7ea628aabd050f6e8d57aeaa83654%2Fbenefit-template-validity-card-native.png?alt=media" alt="The Validity card with a duration of 30 days, which gives every holder the same window from the moment they receive the benefit"><figcaption><p>Une date de fin passée est acceptée, mais tout ce qui est attribué à partir du modèle arrive alors déjà expiré. L'éditeur l'indique par un avertissement.</p></figcaption></figure>

{% hint style="info" %}
Où le client le trouve
{% endhint %}

### Répertorie l'avantage sur la page de la Carte qui affiche tous les avantages du titulaire. Activé par défaut.

| Paramètre                                   | Description                                                                                                                                                                                                                                            |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Afficher sur la page des avantages**      | Permet au titulaire d'enregistrer l'avantage comme une Carte autonome, créée à partir d'un                                                                                                                                                             |
| **Afficher un bouton « Ajouter à Wallet »** | offre **modèle de Carte choisi dans l'éditeur. Utile pour les cartes-cadeaux ou les invitations qui doivent rester séparées dans le Wallet. Dans Google Wallet, la Carte liée est rattachée à la Carte principale.** Comment votre personnel l'utilise |

### Le personnel trouve l'avantage et l'utilise lorsqu'il scanne la Carte du titulaire. Activé par défaut.

| Paramètre                            | Description                                                                                                                                                   |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Afficher dans Scanner de Carte**   | Chaque scan de la Carte utilise l'avantage immédiatement, sans tap. Un second scan dans le bloc de scans répétés du profil ne consomme aucun usage. Nécessite |
| **Utiliser automatiquement au scan** | Paramètres avancés **Afficher dans Scanner de Carte**.                                                                                                        |

### Sur la Carte

#### Remplace l'image de bande sur Apple Wallet et l'image principale sur Google Wallet par le visuel de l'avantage. Lorsque plusieurs avantages le demandent, la priorité la plus élevée l'emporte.

| Paramètre                                                                                                                           | Description                                                                                                     |
| ----------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Utiliser le visuel comme illustration de la Carte**                                                                               | Ajoute le titre et la description sous forme de champ arrière sur Apple Wallet et de message sur Google Wallet. |
| **Ajouter la description au dos de la Carte**                                                                                       | Priorité                                                                                                        |
| **Un nombre entier. Les valeurs les plus élevées sont affichées en premier sur la Carte et remportent l'illustration de la Carte.** | Suppression de la Carte                                                                                         |

#### La suppression décide quand un avantage quitte la Carte. Le supprimer libère l'un des 20 emplacements de la Carte et le retire de la page des avantages ainsi que de Scanner de Carte.

Option

| Jamais — supprimé manuellement                                                                                                                                       | Comportement                           |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
| **Il reste sur la Carte une fois qu'il ne fonctionne plus, affiché comme expiré, jusqu'à ce que quelqu'un le supprime.**                                             | À la fin de la validité                |
| **Il quitte la Carte dès qu'il cesse d'être utilisable.**                                                                                                            | Quelque temps après la fin de validité |
| **Il reste visible, expiré, pendant un certain nombre de jours (1 à 3 650), suffisamment longtemps pour que le titulaire comprenne pourquoi il ne fonctionne plus.** | À sa propre date                       |
| **Il quitte chaque Carte à une date choisie, qui doit être égale ou postérieure à la fin de la validité. Utile pour clôturer une campagne à une date choisie.**      | Code                                   |

#### Attribuer un code à chaque avantage

**ajoute une valeur à afficher à la caisse ou à saisir en ligne.** Format

| Paramètre                                                                                                                                                                                                                                           | Description                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Code QR**                                                                                                                                                                                                                                         | **Code 128**, **EAN-13**, **PDF417**, **Aztec**, **Data Matrix**, **Code 39**, **Brut**, **(texte uniquement, sans code-barres), ou** Aucun code-barres **Attribution**.                                                                                                                                                                                                                                                                           |
| **Partagé**                                                                                                                                                                                                                                         | **: une même valeur pour chaque titulaire, ce qui convient à un code promo e-commerce mais jamais à un bon de valeur faciale.**&#x47;énéré automatiquement **: une valeur différente pour chaque avantage attribué, tirée d'un modèle ; le seul choix acceptable pour un bon de valeur faciale.**&#x53;cript personnalisé **: une valeur unique renvoyée par un script, par exemple un code réservé dans un système partenaire.**&#x43;ode partagé |
| **La valeur affichée à chaque titulaire lorsque l'attribution est Partagé.**                                                                                                                                                                        | Longueur                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **Jeu de caractères**, **Préfixe**, **Suffixe**, **Générer les codes en majuscules**, **Le modèle des codes générés automatiquement. Le préfixe et le suffixe se trouvent en dehors de la partie générée, donc une longueur de 10 avec le préfixe** | GIFT- `donne` suivi de 10 caractères. `donne` Caractères                                                                                                                                                                                                                                                                                                                                                                                           |

| Préfixe  | Longueur minimale                                                                                                                                                                                                                                            | Alphanumérique (par défaut) |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------- |
| A–Z, 0–9 | Numérique                                                                                                                                                                                                                                                    | 6                           |
| 0–9      | Lettres uniquement                                                                                                                                                                                                                                           | 9                           |
| A–Z      | Hex                                                                                                                                                                                                                                                          | 7                           |
| 0–9, A–F | Les codes générés automatiquement font au plus 64 caractères. Un code EAN-13 généré automatiquement n'utilise que des chiffres et doit comporter exactement 12 chiffres, préfixe et suffixe inclus ; un code EAN-13 partagé doit contenir 12 ou 13 chiffres. | 8                           |

Paramètres avancés : chaque avantage reçoit son propre code généré automatiquement, ici un EAN-13 à 12 chiffres.

<figure><img src="https://3130570494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F97ZAXMtqOjhvBBCfpmcE%2Fuploads%2Fgit-blob-5fb1d9b2b6476b7e2f01cbbc158b4dc845d0296b%2Fbenefit-template-advanced-code-retake.png?alt=media" alt="Advanced settings: the Code card gives each benefit an auto-generated EAN-13 code of 12 digits"><figcaption><p>Liens</p></figcaption></figure>

#### Les liens sont affichés uniquement sur la page des avantages.

Appel à l'action

| Paramètre                                                                                                                       | Description                |
| ------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |
| **Un bouton sur l'avantage qui ouvre une page de la marque. Donnez une étiquette au bouton : sans elle, il n'est pas affiché.** | Lien vers les conditions   |
| **Un lien vers les conditions, en petits caractères sous le bouton.**                                                           | Les liens doivent être des |

adresses complètes, et les libellés sont limités à 100 caractères. `https://` Modifier, dupliquer, désactiver ou supprimer un modèle

## La modification d'un modèle change les avantages attribués à partir de ce moment. Les titulaires conservent la copie qui leur a été donnée, y compris le nombre d'utilisations, jusqu'à ce que le modèle leur soit attribué à nouveau. Pour répercuter une modification sur les titulaires existants, utilisez

: chaque avantage attribué est réécrit à partir du modèle, les usages déjà consommés et les codes déjà émis sont conservés, et les dates de validité sont recalculées, si bien qu'une validité plus courte peut mettre fin à certains avantages immédiatement. Les avantages déjà utilisés ou expirés restent tels quels, et les Cartes sont mises à jour progressivement en arrière-plan. L'option n'est pas disponible lorsque le modèle de Carte lié a changé. **Enregistrer et mettre à jour les avantages**Choisir

ouvre une confirmation qui affiche combien d'avantages ont été attribués à partir du modèle et l'effet de la mise à jour sur eux. **Enregistrer et mettre à jour les avantages** Enregistrer et mettre à jour **confirme ;** Annuler **revient à l'éditeur sans enregistrer.** L'enregistrement d'un modèle déjà attribué propose de réécrire les avantages que les titulaires possèdent déjà.

<figure><img src="https://3130570494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F97ZAXMtqOjhvBBCfpmcE%2Fuploads%2Fgit-blob-c29c854ef1297839d27ba2fa044537ebcde3ab07%2Fbenefit-template-update-granted-dialog-native.png?alt=media" alt="Saving a template that is already granted offers to rewrite the benefits holders already have."><figcaption><p>Avantages attribués</p></figcaption></figure>

L' **L'onglet d'un modèle affiche les avantages attribués à partir de celui-ci, ce qui aide à vérifier l'impact d'une modification avant l'enregistrement.** Dupliquer

**crée une copie nommée « (copy) », ce qui est le moyen le plus rapide de modifier un comportement verrouillé sur l'original.** Basculer un modèle vers

arrête les nouvelles attributions sans toucher aux avantages existants. Un modèle ne peut être **Inactif** supprimé **lorsqu'aucun avantage actif n'en provient et qu'aucune automatisation activée ne l'attribue : supprimez les avantages ou laissez-les expirer, puis désactivez ou modifiez d'abord ces automatisations. La suppression d'un modèle supprime aussi ses images.** Vérifier la configuration

## Avant d'attribuer un modèle à de vrais titulaires, un test rapide sur une Carte QA évite la plupart des demandes d'assistance :

Attribuez le modèle à une Carte de test depuis la page de la Carte (voir

1. Attribuer et utiliser des avantages [Ouvrez la Carte sur un iPhone et un téléphone Android : vérifiez le champ arrière ou le message, l'illustration et les textes traduits.](https://docs.thewalletcrew.io/guides-animation/fr/engage-and-animate/benefit-templates/grant-and-use-benefits.md)).
2. Ouvrez la page des avantages depuis la Carte et vérifiez le visuel, le code et les liens.
3. Scannez la Carte avec Scanner de Carte et utilisez l'avantage une fois. Vérifiez que le statut et les usages restants se mettent à jour sur la page de la Carte.
4. Vérifiez que les dates de validité affichées sur la page de la Carte correspondent à la fenêtre attendue.
5. FAQ

## Un avantage peut-il afficher une image différente selon la langue ?

<details>

<summary><strong>Oui. Ajoutez un visuel traduit pour chaque langue. Apple Wallet choisit l'image correspondant à la langue du téléphone et revient à l'image par défaut ; Google Wallet utilise l'image par défaut.</strong></summary>

Pourquoi l'avantage n'apparaît-il pas sur la Carte ?

</details>

<details>

<summary><strong>Vérifiez que le modèle est</strong></summary>

, que l'avantage n'est pas **Actif**ou **Planifié** sur la page de la Carte, et qu'au moins une surface dans **Supprimé** est activée. Un avantage dont toutes les surfaces sont désactivées n'est visible nulle part. [Où un avantage apparaît](#where-a-benefit-appears) Est une fonctionnalité bêta. L'entrée de menu s'affiche lorsque

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.thewalletcrew.io/guides-animation/fr/engage-and-animate/benefit-templates.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
