# Concevoir des pass Google Wallet dans le créateur de pass

Le créateur de pass Google Wallet est un concepteur visuel dans le Panneau de Contrôle. Vous choisissez un type de pass, remplissez l'image de marque, les champs et un code-barres, observez un aperçu en direct et créez le pass. Lorsque vous générez le pass, Pushwoosh crée l'objet pass dans Google Wallet et renvoie un lien de sauvegarde « Ajouter à Google Wallet ».

## Créer un pass

<Aside type="note" title="Configuration requise au préalable">
Le créateur n'est disponible qu'après la configuration de Google Wallet pour l'application (ID de l'émetteur et clé de compte de service). Si ce n'est pas encore configuré, configurez-le d'abord : [Configuration des pass Google Wallet pour Android](/fr/developer/first-steps/connect-messaging-services/android-configuration/android-google-wallet-configuration/).
</Aside> 

Dans le Panneau de Contrôle, allez dans **Campagnes → Pass Wallet**, ouvrez l'onglet **Google Wallet**, et cliquez sur **Créer un pass**.

<img src="/google-wallet-passes-pass-builder-1.webp" alt="Page des Pass Wallet avec l'onglet Google Wallet ouvert et le bouton Créer un pass visible"/>


## Configurer le pass

*   **Partir de zéro :** commencez avec un pass vide. Choisissez un type de pass, puis définissez vous-même les champs, l'apparence, un code-barres et d'autres options dans les sections ci-dessous.

*   **À partir d'un modèle :** cliquez sur **Charger un modèle**, choisissez un pass intégré dans **Sélectionner un modèle** (générique, offre, fidélité, billet d'événement, carte-cadeau, vol ou transport), et confirmez. Le formulaire pré-remplit le type de pass, les champs, les couleurs et le code-barres. Modifiez n'importe quelle valeur ou changez le type selon vos besoins.

### Choisir un type de pass

Sous **TYPE DE PASS**, choisissez l'un des sept types de pass Google Wallet. Le type contrôle la mise en page de la carte et les champs disponibles. Les pass typés utilisent la mise en page native de Google. Le pass générique est de forme libre.

*   **Générique :** carte de forme libre à partir de vos propres champs.
*   **Offre :** coupons et réductions.
*   **Carte de fidélité :** cartes de fidélité et d'adhésion.
*   **Billet d'événement :** billets pour des événements.
*   **Carte-cadeau :** cartes-cadeaux et prépayées.
*   **Vol :** cartes d'embarquement.
*   **Transport :** billets de train, de bus, de tramway et de ferry.



### Remplir les champs du pass

Les champs que vous voyez dépendent du type de pass. Les champs obligatoires sont marqués. Champs courants par type :

| Type de pass <div style="width:140px"></div> | Champs clés |
| :---- | :---- |
| **Générique** | Titre de la carte*, En-tête*, Sous-en-tête, champs de la carte |
| **Offre** | Titre*, Fournisseur*, Détails, Mentions légales, Canal d'utilisation (en magasin / en ligne / les deux), Nom de l'émetteur |
| **Fidélité** | Nom du programme*, Nom du membre, ID du membre, Solde de points, Libellé des points, Niveau de récompenses, Libellé du niveau, Nom de l'émetteur |
| **Billet d'événement** | Nom de l'événement*, Lieu, Adresse, Date et heure de début/fin, Titulaire du billet, Numéro de billet, Type, Section, Rangée, Siège, Porte |
| **Carte-cadeau** | Nom du marchand*, Numéro de la carte*, PIN, Solde + devise |
| **Vol** | Code IATA du transporteur*, Numéro de vol*, Origine*, Destination*, Départ*, Nom du passager*, Heure d'embarquement, Siège, Classe, Groupe d'embarquement, Code de confirmation |
| **Transport** | Type de transport* (bus / train / tramway / ferry / autre), Opérateur*, Passager*, Type de voyage, étapes du trajet (origine*, destination*, horaires, quai, voiture, siège) |

\* Requis par Google.

<Aside type="note" title="Dates et heures">
La plupart des types de pass utilisent la norme ISO 8601 avec un décalage UTC (par exemple, `2026-07-01T19:30:00+02:00`). Les pass de vol sont une exception : Google exige que les heures de départ, d'embarquement et d'arrivée soient indiquées dans l'heure **locale** de l'aéroport **sans** décalage (par exemple, `2026-09-01T06:30:00`).
</Aside>

#### Personnaliser le contenu du pass

Chaque pass est lié à un [ID utilisateur](/fr/product/pushwoosh-knowledge-hub/users-userids/). Utilisez des espaces réservés pour les tags afin d'afficher des données uniques à cet utilisateur, par exemple un solde de points sur une carte de fidélité ou le nom du destinataire sur une carte-cadeau. Émettez un pass par ID utilisateur pour que chaque destinataire reçoive ses propres valeurs.

Pour insérer un espace réservé pour un tag :

1.  À côté d'un champ de texte pris en charge (par exemple, **Marchand**, **Titre de la carte** ou **En-tête**), cliquez sur `{}` pour insérer un tag.
2.  Dans **TAG**, sélectionnez le [tag](/fr/product/audience-data-and-segmentation/user-data-tags/tags/) à insérer dans le champ.
3.  Dans **FORMAT**, choisissez comment afficher la valeur du tag : **Tel quel** (utiliser la valeur stockée), **Entier** (arrondir à un nombre entier), **Prix (0,00)** (afficher deux décimales) ou **Mettre la première lettre en majuscule** (mettre la première lettre en majuscule).
4.  Dans **VALEUR PAR DÉFAUT**, saisissez éventuellement un texte à afficher lorsque le destinataire n'a pas de valeur pour le tag.
5.  Cliquez sur **Insérer**.

<img src="/google-wallet-passes-pass-builder-2.webp" alt="Champ de pass avec la boîte de dialogue Insérer un tag ouverte, montrant les options Tag, Format et Valeur par défaut"/>

Pushwoosh remplit les valeurs des tags lorsque vous créez le pass et les rafraîchit à chaque mise à jour.


### Définir l'apparence

Sous **APPARENCE**, configurez les couleurs, les images, qui peut enregistrer le pass et l'expiration.

#### Couleurs

Saisissez un code hexadécimal dans **Couleur de fond**, par exemple `#FFFFFF` pour le blanc. Incluez le `#` de début et six caractères.

#### Images

<Aside type="caution" title="Hébergez les images sur une URL HTTPS publique">
Google Wallet ne stocke pas votre logo ou votre image principale. Hébergez chaque fichier sur une **URL HTTPS publique** qui reste en ligne et accessible, puis collez le lien dans le créateur de pass. Si l'URL est rompue ou si le fichier est supprimé, l'image cesse de se charger sur le pass.
</Aside>

Collez un lien HTTPS public dans **URL du logo**. Requis pour les pass de fidélité et de transport.

Collez éventuellement un lien dans **URL de l'image principale** pour une large bannière sous les détails de la carte au recto du pass. La taille recommandée est de 1032×336 px.

<img src="/google-wallet-passes-pass-builder-3.webp" alt="Section APPARENCE avec les champs couleur de fond, URL du logo, URL de l'image principale, Qui peut enregistrer le pass et Date d'expiration"/>

<Aside type="tip" title="URL du Media store">
Vous pouvez coller une URL d'image publique depuis le [Media store](/fr/product/content/media-store/), y compris une [variante](/fr/product/content/media-store/#create-image-variants) dimensionnée pour l'emplacement.

**Remarque :** Si vous supprimez l'image dans le Media store, elle cesse de se charger sur le pass.
</Aside>

#### Qui peut enregistrer le pass

Dans **Qui peut enregistrer le pass**, sélectionnez qui peut ajouter le pass à Google Wallet :

*   **Un utilisateur, tous ses appareils** (par défaut) : le pass est lié à un seul compte Google et se synchronise sur tous les appareils de ce compte.
*   **Un utilisateur, un appareil :** le pass est enregistré sur un seul appareil uniquement.
*   **Toute personne ayant le lien :** chaque compte Google qui ouvre le lien de sauvegarde obtient le même objet de pass partagé. Lorsque vous mettez à jour le pass, Google distribue automatiquement la modification à tous les détenteurs.

<Aside type="note" title="Toute personne ayant le lien">
Utilisez cette option pour les pass où tous les détenteurs voient le même contenu, par exemple une offre valable dans tout le magasin ou un billet d'événement public sans siège attribué. Évitez-la pour les cartes de fidélité, les cartes-cadeaux ou tout pass dont le contenu doit être personnalisé par utilisateur. Pushwoosh ne suit qu'un seul appareil pour l'objet partagé, de sorte que les détenteurs individuels ne sont pas visibles et ne peuvent pas être ciblés séparément.
</Aside>

#### Expiration

Définissez la **Date d'expiration** à laquelle Google doit faire expirer le pass, ou laissez-la vide pour aucune expiration.

### Ajouter un code-barres

Sous **CODE-BARRES**, choisissez un format et saisissez la valeur à encoder :

1.  **Format :** choisissez l'apparence du code-barres et le type de scanner qui peut le lire.
    *   **QR_CODE :** code carré que la plupart des téléphones et scanners lisent facilement. Idéal pour la plupart des pass.
    *   **PDF_417 :** code-barres large composé de plusieurs rangées de lignes. Souvent requis pour les cartes d'embarquement.
    *   **AZTEC :** code carré compact, similaire au QR. Courant sur les billets d'événements et de transport.
    *   **CODE_128** / **EAN_13 :** codes-barres 1D. Choisissez-les uniquement si votre scanner ou votre système de point de vente l'exige.
2.  **Valeur :** les données encodées dans le code-barres (par exemple, un numéro de billet ou d'adhésion). Pour utiliser une valeur unique par utilisateur, cliquez sur `{}` à côté du champ et insérez un [espace réservé pour un tag](#personnaliser-le-contenu-du-pass).
3.  **Texte alternatif :** texte affiché sous le code-barres sur le pass.

<img src="/google-wallet-passes-pass-builder-5.webp" alt="Section CODE-BARRES avec les champs Format, Valeur et Texte alternatif"/>

### Ajouter des champs de détails et des liens

Au recto du pass, les utilisateurs voient la carte principale. Lorsqu'ils ouvrent les détails du pass (le verso), ils peuvent lire des sections supplémentaires et appuyer sur les liens que vous ajoutez ici.

*   **Modules de texte :** blocs de texte supplémentaires au verso du pass. Définissez un **en-tête** (le titre de la section) et un **corps** (le texte). Utilisez-les pour les conditions, les instructions ou d'autres informations qui ne tiennent pas au recto.
*   **Liens :** liens cliquables au verso du pass. Définissez une **URL** et une courte **description** (par exemple, « Localisateur de magasin » ou « Conditions générales »).

<img src="/google-wallet-passes-pass-builder-6.webp" alt="Sections MODULES DE TEXTE et LIENS avec les champs en-tête, corps, URL et description"/>

### Ajouter un lien vers l'application *(facultatif)*

Sous **LIEN VERS L'APPLICATION**, ajoutez un bouton au recto du pass qui ouvre une page web ou votre application Android lorsqu'on appuie dessus. Vous pouvez définir une **URL**, un **nom de package Android**, ou les deux.

Si vous ne définissez que l'URL, le bouton ouvre cette adresse web sur n'importe quel appareil. Si vous ne définissez qu'un nom de package, le bouton fonctionne sur les appareils Android qui ont l'application installée, sans solution de repli web.

<img src="/google-wallet-passes-pass-builder-4.webp" alt="Section LIEN VERS L'APPLICATION avec les champs URL et Nom du package Android"/>

### Ajouter des emplacements *(facultatif)*

Sous **Pertinence basée sur la localisation**, ajoutez des points d'intérêt. Google affiche une notification géolocalisée lorsque l'utilisateur se trouve à proximité d'un emplacement que vous ajoutez. Par exemple, faites apparaître une carte de fidélité près de votre magasin, un billet d'événement près du lieu, ou une carte d'embarquement près de l'aéroport.

Vous pouvez ajouter jusqu'à **10** emplacements, chacun défini par sa latitude et sa longitude.

<img
  src="/google-wallet-passes-pass-builder-7.webp"
  alt="Section EMPLACEMENTS avec les champs latitude et longitude pour ajouter des points d'intérêt"
  style={{ maxWidth: "480px", width: "100%", height: "auto" }}
/>

<Aside type="note" title="Emplacements sur Google Wallet">
Google contrôle le rayon de géorepérage et décide quand faire apparaître la notification. Vous ne pouvez pas définir une distance maximale par emplacement.
</Aside>

### Saisir un ID utilisateur

Saisissez l'[ID utilisateur](/fr/product/pushwoosh-knowledge-hub/users-userids/#how-are-users-and-devices-related) Pushwoosh de la personne qui recevra ce pass.

Pushwoosh émet le pass pour cet utilisateur et le liste sous **UTILISATEUR** sur [**Tous les pass**](/fr/product/messaging-channels/google-wallet-passes/#view-and-manage-existing-passes).

### Aperçu et validation

Un **aperçu en direct** se met à jour au fur et à mesure de vos modifications, vous pouvez donc voir approximativement à quoi ressemblera le pass dans Google Wallet.

<Aside type="note" title="L'aperçu peut différer sur un appareil">
L'aperçu est une approximation. Les pass typés utilisent la mise en page native de Google, donc le pass peut avoir un aspect différent sur un appareil réel. Le code-barres affiché est un espace réservé.
</Aside>

Pour vérifier le pass par rapport aux exigences de Google sans le créer, cliquez sur **Valider**. Le créateur signale les champs obligatoires manquants et d'autres problèmes.

## Générer le pass

Cliquez sur **Générer**. Pushwoosh vérifie le pass et le crée dans Google Wallet. Vous obtenez un lien de sauvegarde **Ajouter à Google Wallet** à partager avec les utilisateurs. En quelques secondes, le pass apparaît dans [**Tous les pass**](/fr/product/messaging-channels/google-wallet-passes/#view-and-manage-existing-passes).

Pour modifier, obtenir le lien de sauvegarde, invalider et supprimer des pass après leur création, consultez [Gérer les pass existants](/fr/product/messaging-channels/google-wallet-passes/#view-and-manage-existing-passes).

## Gérer les pass via l'API

Tout ce que fait le créateur de pass est également disponible via l'[API Google Wallet](/fr/developer/api-reference/google-wallet-api/) : créer, mettre à jour, lister, obtenir un lien de sauvegarde, définir l'état et supprimer des pass.

<LinkCard title="API Google Wallet" href="/developer/api-reference/google-wallet-api/" />