> 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/configure/fr/advanced-configuration/wallet/template-configuration/google-tab.md).

# Onglet Google

Configurez l’apparence et le comportement des cartes d’un modèle dans Google Wallet : classe, code-barres, sécurité, couleurs, images, mise en page, liens, Smart Tap et messages.

L’onglet Google définit tout ce que Google Wallet affiche pour les cartes du modèle. Google Wallet organise les cartes en classes, chacune avec ses propres informations obligatoires et sa propre mise en page, de sorte qu’une partie de l’onglet est commune à tous les types et qu’une autre dépend du type de modèle. Le type détermine la classe Google Wallet ; le mappage se trouve dans [Paramètres par type](https://docs.thewalletcrew.io/configure/fr/advanced-configuration/wallet/template-configuration.md#settings-by-type).

<figure><img src="https://1373324539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2Fgit-blob-0fbcc84ba67bc22e725c35cb39b0cfe0dd0e4c21%2Ftemplate-editor-google-tab-retake.png?alt=media" alt="Google tab of a stamp card template with its sections and the Google Wallet preview of the loyalty pass"><figcaption><p>L’onglet Google, avec ses sections à gauche et l’aperçu Google Wallet à droite.</p></figcaption></figure>

## Paramètres communs à tous les types

### Général

**État** définit l’état de la carte dans Google Wallet : Active, Terminée, Expirée ou Inactive. Les cartes Expirée, Inactive et Terminée vont directement dans les cartes archivées du titulaire : elles quittent la liste des cartes et l’écran d’accueil. La section General contient également les textes principaux de chaque type (voir [Paramètres par type](#settings-by-type)).

Valeurs dynamiques, par exemple `{{ firstName }}`, vont dans des champs dynamiques dédiés. Les champs de libellé sont réservés au texte statique uniquement.

### Code-barres

Le code-barres est ce qu’un scanner lit. La section définit son **type**, son **valeur**, généralement un identifiant de la carte (une valeur vide signifie qu’il n’y a pas de code-barres), ainsi qu’un **texte alternatif** affiché en dessous ; sans texte alternatif, Google affiche l’identifiant du membre ou le numéro de carte, sinon la valeur du code-barres.

Les types pris en charge sont AZTEC, CODE\_39, CODE\_128, CODABAR, DATA\_MATRIX, EAN\_8, EAN\_13, ITF\_14, PDF\_417, QR\_CODE, UPC\_A et TEXT\_ONLY. TEXT\_ONLY affiche la valeur sous forme de texte sans code-barres et ne peut pas avoir de texte alternatif.

Un **Code-barres rotatif** demande à Google Wallet de recalculer le code à intervalles réguliers à partir d’un mot de passe à usage unique, afin qu’une capture d’écran devienne rapidement obsolète. Cela fonctionne uniquement avec les codes QR et PDF417 ; sa valeur doit contenir `{totp_value_0}`, et les codes-barres rotatifs doivent d’abord être configurés pour le tenant dans **Paramètres → Wallet → Google**, dans l’onglet **Code-barres rotatif** l’onglet.

Lorsque la valeur du code-barres est utilisée pour retrouver la carte avec Carte Scanner, activez [Conserver les données scannables](https://docs.thewalletcrew.io/configure/fr/advanced-configuration/wallet/template-configuration/general-tab.md#scannable-data) dans l’onglet General.

### Sécurité

Les paramètres de sécurité limitent la façon dont la carte peut être partagée ou copiée, ce qui est important pour les billets et les cartes de valeur :

* **Plusieurs appareils et titulaires**: Plusieurs titulaires (la carte peut être partagée), Un utilisateur, tous les appareils, ou Un utilisateur, un appareil. Avec Un utilisateur, un appareil, la carte ne peut être ajoutée qu’à partir de l’application Google Wallet sur un téléphone Android, et non depuis le Web.
* **Animation de sécurité**: Google dessine un cadre irisé autour du code-barres qui se déplace lorsque le téléphone bouge, afin qu’une photo ou une copie soit facilement repérable.
* **Exigence de déverrouillage de l’affichage**: lorsqu’elle est définie sur Obligatoire, le téléphone doit être déverrouillé à chaque ouverture de la carte, et la carte ne peut être ajoutée qu’à partir de l’application Google Wallet sur Android, et non depuis le Web.
* **Captures d’écran**: Autorisées ou bloquées. Lorsqu’elles sont bloquées, les captures d’écran de la carte ouverte sont noires ; les anciennes versions de Google Wallet peuvent toutefois encore les autoriser.

### Couleurs et images

**Couleur de fond** s’applique à la carte. Lorsqu’elle n’est pas définie, Google utilise la couleur dominante de la bannière, ou du logo lorsqu’il n’y a pas de bannière.

**Images** dépendent du type : une **Bannière** (image principale) affichée en pleine largeur sur le recto, ainsi que les logos de la classe : **Logo** et **Logo large** (Billet d’événement, Générique), **Logo du programme** et **Logo de programme large** (Carte client, Carte à tampons, Carte-cadeau), **Image de titre** et **Image de titre large** (Offre). Un logo large remplace le logo en haut à gauche de la carte, et nécessite également le logo.

### Textes

Les textes ajoutent des informations affichées dans les détails de la carte, après les messages. Chaque texte comporte un **En-tête** (moins de 35 caractères) et un **Corps** (moins de 500 caractères ; un corps vide masque le texte). Un texte utilisé par la mise en page ne peut pas être supprimé tant qu’il n’a pas été retiré de la mise en page.

### Mise en page

Google Wallet décide par défaut quelles informations apparaissent à quel endroit. La **Mise en page** section modifie cela, zone par zone :

* **Lignes de carte** (recto de la carte) : jusqu’à 3 lignes sous le titre de la carte, chacune avec 1 à 3 valeurs ;
* **Détails du code-barres** (autour du code-barres) : jusqu’à 3 valeurs courtes, deux au-dessus du code-barres et une en dessous, sans libellés ;
* **Liste des détails** (verso de la carte) : la liste des détails, dans l’ordre choisi ;
* **Liste des cartes** (écran d’accueil de Wallet) : deux lignes décrivant la carte dans la liste des cartes du titulaire.

Chaque zone est soit **Valeur par défaut de Google** ou **Personnalisée**. Une valeur vide sur une carte est masquée, et des valeurs de repli peuvent être ajoutées pour les cartes dont un champ est vide. Une mise en page peut être copiée et collée dans un autre modèle (**Copier la mise en page**, **Coller la mise en page**), modifiée en **JSON**, et chaque zone peut revenir à la mise en page de Google avec **Retour à la valeur par défaut de Google**.

<figure><img src="https://1373324539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2Fgit-blob-9afedcfeb15ac4c061bfdefa878a58a3ba99d517%2Ftemplate-editor-google-layout-retake.png?alt=media" alt="Layout section of the Google tab with the four zones Card rows, Barcode details, Details list and Passes list, and the Card rows zone open"><figcaption><p>La section Mise en page : les quatre zones, avec l’éditeur des lignes de carte ouvert.</p></figcaption></figure>

### Autres sections communes

* **Liens supplémentaires**: liens affichés dans les détails de la carte.
* **Smart Tap**: permet aux lecteurs NFC de lire la carte. Cela nécessite que Smart Tap soit configuré pour le tenant ; **NFC lorsque la carte est ouverte** peut empêcher le téléphone de présenter également une carte de paiement ou de transport en boucle fermée lors du même contact.
* **Intervalle de validité**: début et fin de validité de la carte.
* **Messages**: chaque message comporte un en-tête et un texte, affichés dans les détails. Avec une **Période d’affichage** ou **Notifier lors de la mise à jour**, un message devient une bannière de nouveau message sur la carte ; Notifier lors de la mise à jour envoie également une notification au titulaire lorsque le message est ajouté ou modifié. Dans la plupart des cas, une automatisation avec notification est préférable.
* **Liens vers l’application**: liens vers les applications de la marque.
* **Emplacements**: lieux à proximité desquels Google notifie le titulaire ; ils ne sont pas affichés sur la carte.
* **Opportunités à valeur ajoutée**: modules avec un en-tête, un court texte, un lien et un logo, chacun affiché pendant sa propre période d’affichage.
* **Image dans les détails**: une image affichée en pleine largeur dans les détails, avec une description lue par les lecteurs d’écran.
* **Regroupement**: les cartes du même groupe sont empilées ensemble dans Google Wallet, par exemple les billets d’une même commande.

## Paramètres par type

### Carte client et carte à tampons (fidélité)

**Émetteur**, **Nom du programme**, **Points de fidélité** et **Récompenses** (un second solde), **Niveau de récompenses** et **Niveau de récompenses secondaire**, **Compte** (nom et identifiant), **Page d’accueil**. Le compte est facultatif, et une valeur dynamique ne peut pas être utilisée dans son champ de libellé. Un **Logo du programme** est requis : Google refuse le modèle en son absence, sauf si le thème de la carte en fournit un.

Les modèles de carte à tampons ont aussi **Images des tampons**: une **Hero Google** par nombre de tampons. Les règles concernant les images, ainsi que la manière d’afficher le nombre sous forme de texte avec les variables de tampons, se trouvent sur la [Carte à tampons](https://docs.thewalletcrew.io/guides-design/fr/conception/stamp-card.md) page.

### Billet d’événement

**Émetteur**, **Nom de l’événement**, **ID de l’événement**, **Nom du titulaire du billet**, **Numéro du billet**, **Type de billet**, dates de l’événement (**Date de début**, **Date de fin**, **Ouverture des portes** avec son libellé : Ouverture des portes, Ouverture des accès ou un libellé personnalisé), **Petits caractères**, **Lieu**, **Emplacements** (porte, section, rangée, siège), **Code de confirmation**, **Valeur faciale**, **Page d’accueil**.

### Carte cadeau

**Émetteur**, **Nom du commerçant**, **Numéro de carte** (requis par Google ; affiché sous le code-barres lorsqu’il n’y a pas de texte alternatif), **Numéro de l’événement**, **Solde et code PIN**, **Utilisation par code-barres acceptée** (indique à Google que le commerçant accepte la carte-cadeau par code-barres ; rien ne change sur la carte), **Page d’accueil**.

### Offre

**Titre** et **Titre court**, **Émetteur**, **Fournisseur**, **Détails**, **Canal d’utilisation** (Non spécifié, En magasin, En ligne, Les deux, ou Réduction temporaire ; chaque valeur s’affiche de la même manière sur la carte), **Petits caractères**, **Aide** lien, **Page d’accueil**.

### Générique

**Titre**, **En-tête**, **Sous-titre**, **Notification d’expiration** (envoyée 48 heures avant la fin de l’intervalle de validité, qui doit être défini) et **Notification à venir** (envoyée 24 heures avant son début). Lorsque les deux notifications sont activées, seule la notification d’expiration est envoyée.

## FAQ

<details>

<summary><strong>Pourquoi la carte apparaît-elle dans les cartes archivées ?</strong></summary>

Parce que son **État** est Expired, Inactive ou Completed. Google Wallet envoie les cartes dans ces états directement dans les cartes archivées du titulaire, elles quittent donc la liste des cartes et l’écran d’accueil.

</details>

<details>

<summary><strong>Pourquoi Google Wallet refuse-t-il une carte-cadeau ?</strong></summary>

Google Wallet exige un numéro de carte pour chaque carte-cadeau. Renseignez le **Numéro de carte** champ dans la section General ; l’aperçu l’indique comme bloquant (« Google Wallet refusera cette carte ») lorsqu’il est vide.

</details>

<details>

<summary><strong>Pourquoi la carte de fidélité affiche-t-elle une vérification bloquante concernant le logo ?</strong></summary>

Une carte de fidélité (carte client ou carte à tampons) a besoin d’un logo de programme. Ajoutez-le dans la section Images, ou appliquez un thème qui en fournit un.

</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/configure/fr/advanced-configuration/wallet/template-configuration/google-tab.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.
