Thèmes de Cartes Wallet

Créez des thèmes de Cartes Apple Wallet et Google Wallet réutilisables. Appliquez les couleurs, images et traductions de la campagne sans modifier le modèle de Carte.

Un thème de carte Wallet est une couche visuelle réutilisable pour les cartes Apple Wallet et Google Wallet. Il applique les couleurs de campagne, les images et un texte facultatif. Il ne modifie pas les champs de la carte, les codes-barres ni les modèles.

Utilisez les thèmes pour les campagnes saisonnières, le co-branding et les variantes du programme. Un seul thème peut s’appliquer à de nombreuses cartes. La mise à jour du thème met à jour son design partagé.

Thèmes de carte Wallet : ce qu’ils sont et quand les utiliser

Un thème est un ensemble nommé de couleurs, d’images et de contenu traduit facultatif. Il donne à une saison, une campagne ou un partenariat une identité visuelle cohérente.

Un thème se superpose à un modèle de carte. Le modèle contrôle les champs, les codes-barres et la structure de la carte. Le thème contrôle l’identité visuelle. Cette séparation évite de dupliquer les modèles pour chaque campagne.

Exemples concrets

• Un détaillant de mode habille ses cartes de fidélité des visuels de la collection été en juin, et de ceux de la collection hiver en novembre, tandis que la carte elle-même ne change jamais.

• Un organisateur de spectacle donne à chaque carte pour une tournée l’identité visuelle de cette tournée, par-dessus le modèle de carte utilisé pour tous les spectacles.

• Une marque menant un partenariat de trois mois applique un thème co-brandé aux cartes des clients concernés, puis le supprime lorsque le partenariat prend fin.

• Une carte de personnel ou une carte VIP est volontairement maintenue distincte du reste du programme grâce à son propre thème.

Fonctionnement des thèmes

Quatre règles expliquent le comportement des thèmes :

1. Une carte a un seul thème ou aucun. Les thèmes ne s’empilent pas.

2. Les cartes font référence à un thème. Elles ne copient pas ses paramètres. Les modifications apparaissent lorsque les cartes se rafraîchissent.

3. Un thème ne modifie que l’apparence. La validité, le stock et l’utilisation appartiennent à une offre.

4. Les paramètres vides héritent du modèle. Cela inclut les couleurs et les positions des images.

Ce qu’un thème de carte Wallet modifie

Un thème peut définir des images, des couleurs et un texte facultatif. Les images ont le plus grand impact visuel.

Quoi	Détails
Image par défaut	Une bannière saisonnière pour les deux plateformes. Elle n’occupe que deux emplacements, le bandeau Apple et le hero Google, et uniquement lorsque le thème ne possède pas de remplacement spécifique pour eux. Le bandeau est plus court sur les cartes événementielles que sur les autres cartes, et une image par défaut sert pour chaque type de carte ; tout ce qui est important doit donc se trouver au centre de l’image.
Remplacements d’image	Remplacez les logos, icônes, vignettes ou arrière-plans individuellement. Chaque remplacement est intentionnel. Chaque emplacement que le thème ne remplace pas conserve l’image du modèle de carte.
Couleurs	Définissez la couleur d’arrière-plan de la carte, les valeurs des champs et les libellés des champs. La couleur des libellés s’applique uniquement à Apple Wallet. Les couleurs ne varient pas selon la langue.
Titre et description	Ajoutez deux textes courts traduisibles. Le modèle doit être configuré pour les afficher. Sinon, ils n’apparaissent pas sur la carte. Le fait qu’ils suivent la langue de l’appareil dépend de la façon dont le modèle les place, comme expliqué dans Langues.

Ce qu’un thème ne modifie jamais

Les thèmes ne modifient pas les champs, la disposition des champs, les codes-barres, les liens, le contenu au verso de la carte ni le comportement de la carte. Ces paramètres restent dans le modèle. Une carte rethématisée affiche de nouveaux visuels sur la même carte.

Langues

Apple Wallet prend en charge des images spécifiques à chaque langue. Google Wallet stocke une image par emplacement et utilise toujours la langue par défaut.

Les titres et descriptions des thèmes suivent une règle différente, car le modèle de carte décide de la façon dont ils sont rendus. {{ theme.title }} et {{ theme.description }} ne suivent la langue de l’appareil que lorsqu’ils sont placés dans les valeurs traduites du modèle, c’est-à-dire les valeurs d’un champ propres à chaque langue. Un champ de modèle écrit une seule fois est rendu une seule fois, dans une seule langue, quelles que soient les traductions contenues dans le thème. Un thème traduit en français n’affichera donc son titre français sur un appareil français que lorsque le champ du modèle qui l’affiche dispose de valeurs par langue.

Images de carte Wallet qu’un thème peut remplacer

L’image par défaut fournit la bannière principale sur les deux plateformes : le bandeau Apple et le hero Google, sauf si le thème en remplace un des deux. Les autres images sont remplacées par emplacement, car Apple Wallet et Google Wallet utilisent des dispositions différentes. Quinze emplacements sont disponibles. Un emplacement que le thème ne remplace pas conserve l’image de son modèle.

Dans les deux tableaux ci-dessous, le schéma montre où l’emplacement se situe sur la carte, la zone remplacée étant mise en évidence.

Pourquoi seuls deux emplacements utilisent l’image par défaut. Le bandeau Apple et le hero Google sont tous deux de larges bannières. Les logos, icônes et arrière-plans nécessitent des proportions différentes. Chacun de ces emplacements a besoin de son propre fichier.

Apple Wallet

Chaque emplacement peut afficher une image différente selon la langue.

Où il se place	Emplacement	Taille	Ce que c’est
	Bandeau	1125 × 294 px sur les cartes événementielles, 1125 × 432 px sur les cartes cadeaux et les offres, 1125 × 369 px sur les cartes de fidélité et de tampons. Ce sont les tailles d’Apple en @3x. tailles d’Apple en @3x.	Non affiché sur les cartes génériques ni sur les mises en page poster. Sur une carte événementielle, un bandeau masque l’arrière-plan et la vignette. Utilise l’image par défaut sauf si le thème la remplace.
	Visuel	1074 × 1344 px	Cartes événementielles poster à partir d’iOS 18, cartes génériques poster à partir d’iOS 27.
	Arrière-plan	540 × 660 px	Cartes événementielles uniquement, et seulement lorsque la carte n’a pas de bandeau.
	Vignette	270 × 270 px	Cartes génériques et cartes événementielles sans bandeau.
	Logo	480 × 150 px (maximum)	En haut à gauche de chaque style, à côté du nom de la carte. Un PNG transparent laisse apparaître la couleur de la carte.
	Icône	87 × 87 px	Notifications, écran de verrouillage et cartes envoyées par e-mail. Il n’apparaît jamais sur la carte elle-même.
	Logo principal	378 × 90 px	Le logo des mises en page poster, qui utilisent le leur plutôt que le logo standard.
	Logo secondaire	405 × 36 px	Une seconde marque plus large, intégrée dans le pied de page du poster — généralement un lieu ou un partenaire.

Google Wallet

Une image par emplacement, toujours dans la langue par défaut.

Où il se place	Emplacement	Taille	Ce que c’est
	Bannière principale	1032 × 336 px	La large bannière sur l’avant de la carte, sur les cartes de fidélité, événementielles, cadeaux et offres. L’image la plus visible qu’un thème peut définir sur Google Wallet. Utilise l’image par défaut sauf si le thème la remplace.
	Logo	660 × 660 px	Le logo carré en haut à gauche de la carte, à côté du nom de la marque. Il s’applique aux cartes événementielles et aux cartes génériques. Google le recadre en cercle, alors gardez le contenu à l’intérieur des 70 % centraux.
	Logo large	1280 × 400 px	Utilisé à la place du logo dans l’en-tête de la carte, lorsque la marque se lit mieux en largeur qu’en carré. Il s’applique aux cartes événementielles et aux cartes génériques.
	Logo du programme	660 × 660 px	Le logo du programme de fidélité ou de la carte cadeau, affiché à la fois dans la liste et dans la vue détaillée. Il s’applique aux cartes de fidélité, aux cartes de tampons et aux cartes cadeaux. Google le recadre en cercle, alors gardez le contenu à l’intérieur des 70 % centraux.
	Logo du programme large	1280 × 400 px	Utilisé à la place du logo du programme dans l’en-tête de la carte.
	Image de titre	660 × 660 px	L’image de titre d’une offre, affichée à la fois dans la liste et dans la vue détaillée. Elle s’applique aux offres.
	Image de titre large	1280 × 400 px	Utilisée à la place de l’image de titre dans l’en-tête de la carte.

Un remplacement de logo carré masque la version large du modèle. Google Wallet affiche la version large d’un logo dès qu’une version carrée et une version large existent toutes les deux. Un thème qui ne remplace qu’un logo carré — le logo, le logo du programme ou l’image de titre — resterait sinon masqué derrière la version large du modèle. Pour cette raison, la version large du logo du modèle n’est pas affichée sur les cartes portant un tel thème, et c’est le logo carré du thème qui s’affiche à la place.

Les tailles correspondent aux dimensions maximales rendues par chaque plateforme. Les fichiers plus grands sont réduits. Les images sont intégrées dans la carte exactement telles qu’elles sont stockées dans le thème, sans conversion de format ; seul le bandeau et le hero peuvent être recadrés, comme décrit ci-dessous. Utilisez des fichiers PNG transparents pour les logos afin que la couleur de la carte reste visible.

Comment le bandeau et le hero sont recadrés

Le fait que l’image par défaut soit recadrée dépend du modèle de carte, et non du thème. Lorsque l’optimisation des images est activée dans le modèle, l’image est recadrée aux tailles exactes du bandeau Apple et du hero Google. Sans cela, l’image est envoyée telle qu’elle a été téléversée et Apple Wallet ou Google Wallet l’ajuste à l’espace disponible.

Dans les deux cas, une seule image par défaut sert à chaque type de carte, et le bandeau est plus court sur les cartes événementielles que sur les autres cartes. Un visuel dont le sujet est au centre et les bords unis se lit bien quelle que soit la façon dont il est finalement cadré.

Quels emplacements s’appliquent à quel type de carte

Cette matrice montre quels emplacements d’image utilise chaque type de carte. Un emplacement non affiché ici n’apparaît pas sur cette carte.

Emplacement	Fidélité	Carte de tampons	Carte cadeau	Offre	Carte événementielle	Générique	Poster
Bandeau Apple / image par défaut	Oui	Oui	Oui	Oui	Oui — masque l’arrière-plan et la vignette	Non	Non
Arrière-plan Apple	—	—	—	—	Oui	—	—
Vignette Apple	—	—	—	—	Oui, sans bandeau	Oui	—
Visuel Apple	—	—	—	—	—	—	Oui
Logo principal Apple	—	—	—	—	—	—	Oui
Logo secondaire Apple	—	—	—	—	—	—	Oui
Hero Google	Oui	Oui	Oui	Oui	Oui	Oui	Oui
Logo Google	—	—	—	—	Oui	Oui	—
Logo du programme Google	Oui	Oui	Oui	—	—	—	—
Image de titre Google	—	—	—	Oui	—	—	—

Un thème appliqué à des cartes de plusieurs types doit inclure les emplacements du logo, du logo du programme et de l’image de titre, sinon le logo ne change que sur certaines cartes.

Créer un thème de carte Wallet

Les thèmes se trouvent sous Wallet → Thèmes. Recherchez par nom et passez de l’affichage en carte à l’affichage en tableau. Les deux vues montrent les mêmes thèmes.

L’affichage en carte montre l’image par défaut, les couleurs, le nom et l’identifiant. C’est le mieux pour choisir un thème visuellement.

Affichage en carte. Vérifiez que chaque tuile affiche le visuel attendu pour la campagne — ici, un thème se reconnaît à son image plutôt qu’à son nom.

L’affichage en tableau liste chaque thème sous forme de ligne. Utilisez-le pour vérifier l’utilisation, les changements récents et les traductions. Les colonnes peuvent être triées, filtrées et masquées.

Affichage en tableau. La colonne Cartes est celle à lire avant de modifier ou supprimer un thème : elle indique combien de cartes sont concernées.

Colonne	Ce qu’elle affiche
Identifiant	La référence fixe utilisée par les cartes, les automatismes et les systèmes externes. Elle est générée lorsque le thème est créé et ne change jamais.
Étiquettes	Étiquettes en texte libre utilisées pour rechercher et filtrer les thèmes. Utilisez des étiquettes cohérentes pour les saisons, les campagnes et les programmes.
Couleurs	Nuanciers de couleurs du thème. Une valeur vide hérite de la couleur du modèle.
Emplacements	Le nombre de remplacements d’image. 0 signifie que toutes les images proviennent du modèle, à l’exception du bandeau Apple et du hero Google, qui utilisent l’image par défaut.
Langues	Langues avec texte ou images traduits. — signifie langue par défaut uniquement.
Cartes	Le nombre de cartes utilisant le thème. Un thème porté par des cartes ne peut pas être supprimé ; voir Supprimer un thème de carte Wallet.
Créé / Modifié	Date de création et dernière sauvegarde. Un thème actif récemment modifié peut avoir changé l’apparence de la carte.

Le … menu dans chaque ligne ou carte propose trois actions : modifier le thème, lister les cartes assignées ou le supprimer. La suppression n’est pas possible tant que des cartes portent le thème ou qu’un automatisme activé l’applique.

En créer un

Créez d’abord les images. Ajoutez ensuite les couleurs et le contenu facultatif. Cet ordre accélère la validation du design.

1. Accédez à Wallet → Thèmes et sélectionnez Créer un thème.

2. Nommez-le. Le nom de la campagne convient bien — Summer 2026, Black Friday. Le nom est ce que tout le monde verra plus tard dans le sélecteur de thèmes, et l’identifiant en est dérivé à la création et ne change jamais ; il vaut donc la peine de choisir le bon nom dès maintenant.

3. Ajoutez des étiquettes. Les étiquettes facilitent la recherche ultérieure des thèmes. Utilisez des libellés courts et cohérents tels que saisonnier, été-2026, et fidélité.

4. Ajoutez l’image par défaut. C’est la bannière qui couvre le bandeau Apple et le hero Google, sauf si un remplacement en remplace l’un des deux. Concevez-la en 1125 × 432 px, gardez le sujet au centre et laissez les bords unis : le bandeau est plus court sur les cartes événementielles que sur les autres cartes, et les champs se superposent à lui.

5. Ajoutez des remplacements du modèle pour tout ce que l’image par défaut ne couvre pas : sélectionnez Ajouter un remplacement, choisissez l’emplacement, téléversez le fichier et répétez l’opération pour chacun.

6. Définissez les couleurs. Couleur d’arrière-plan, de premier plan et de libellé pour Apple Wallet. Toute valeur laissée vide conserve celle du modèle.

7. Rédigez le contenu, si le thème doit afficher un titre ou une description. Le sélecteur de langue dans l’en-tête de la carte ajoute des traductions.

8. Enregistrez. Pour un thème qu’aucune carte n’utilise encore, c’est tout. Pour un thème déjà porté par des cartes, l’enregistrement pose d’abord une question.

L’éditeur. L’en-tête compte les cartes portant le thème et indique quand elles prendront en compte un changement — vérifiez-le avant d’enregistrer.

Le sélecteur de remplacements. Chaque emplacement indique sa taille et les types de cartes auxquels il s’applique ; les emplacements déjà présents dans le thème sont marqués Ajouté.

Quatre emplacements remplacés — le logo Apple, la vignette et l’icône, plus le logo du programme Google. Vérifiez que chaque emplacement dont dépend une campagne apparaît ici ; tout ce qui manque provient encore du modèle ou de l’image par défaut.

Il n’existe pas d’état brouillon. Un thème est mis en ligne dès son enregistrement. Pour tester un design en toute sécurité, il faut créer un second thème et déplacer une carte de test dessus.

Enregistrer un thème déjà utilisé par des cartes

Modifier un thème change son design partagé. Les cartes Wallet existantes conservent leur version actuelle jusqu’à leur rafraîchissement. La boîte de dialogue d’enregistrement contrôle si ce rafraîchissement se produit immédiatement.

Lorsque aucune carte n’utilise le thème, l’enregistrement ne fait que stocker les modifications. Lorsque des cartes l’utilisent, le Enregistrer le thème boîte de dialogue affiche le nombre de cartes concernées. Elle propose aussi de rafraîchir ces cartes dans la même action.

La boîte de dialogue d’enregistrement. Lisez le nombre de cartes, puis décidez : si le commutateur est désactivé, le thème est enregistré et les cartes se rafraîchissent d’elles-mêmes.

Avec le commutateur désactivé, Enregistrer met à jour le thème uniquement. Chaque carte reçoit le nouveau design lors de son prochain rafraîchissement. Utilisez cette option pour des changements mineurs ou la préparation avant lancement.

Avec le commutateur activé, Enregistrer et diffuser la mise à jour enregistre le thème et rafraîchit chaque carte assignée. La boîte de dialogue affiche une durée estimée. Paramètres avancés contrôle la vitesse de rafraîchissement et l’actualisation des métadonnées. Utilisez cette option lorsque le visuel doit être en ligne immédiatement.

Annuler annule les modifications. Le thème est enregistré avant le début du rafraîchissement. Si le rafraîchissement échoue, le thème reste enregistré. Enregistrez de nouveau avec le commutateur activé, ou utilisez un automatisme, pour réessayer.

Limites pratiques

Les images de thème doivent être au format PNG ou JPEG, car elles sont intégrées dans la carte exactement telles qu’elles sont stockées. Un téléversement dans un autre format, comme WebP, GIF ou SVG, est refusé. Lorsqu’une image est choisie dans le back office, elle est convertie en PNG au moment de son recadrage. Les images sont acceptées jusqu’à 8 Mo chacune, le PNG transparent étant le format adapté aux logos. Un thème contient jusqu’à 20 étiquettes, et une image par emplacement — il n’existe pas de second logo Apple.

Les images fournies sous forme d’URL ne sont pas vérifiées. La vérification du format s’applique uniquement aux fichiers téléversés. Une image référencée par une URL externe au lieu d’être téléversée n’est pas vérifiée quant à son format ; elle doit donc déjà être un fichier PNG ou JPEG.

Appliquer un thème aux cartes Wallet

Un thème ne fait rien tant que des cartes ne pointent pas vers lui. Trois voies permettent cela : une carte à la fois dans le back office, un public entier via un automatisme, ou un système externe via l’API.

À une seule carte, depuis le back office

Utilisez cette voie lorsqu’une carte a besoin d’un design différent. Elle ne concerne que cette carte.

Exemples concrets

• Tester un design avant une campagne. Le nouveau thème est appliqué à une carte de test et ouvert sur un vrai téléphone, à la fois dans Apple Wallet et dans Google Wallet, avant qu’un automatisme ne le présente à un public.

• Corriger un client. Une carte qu’un automatisme a manquée, ou une carte qu’un agent du service client voit encore avec le visuel de la saison précédente.

• Une exception volontaire. Une carte de personnel, une carte VIP ou une carte partenaire qui ne doit pas ressembler à celle de tout le monde.

1. Ouvrez la carte : Wallet → Cartes, puis la carte concernée.

2. Sélectionnez Actions → Appliquer un thème.

3. Choisissez un thème dans la grille. La boîte de dialogue s’ouvre sur le thème que la carte porte aujourd’hui, ce qui rend le point de départ visible.

4. Confirmez. Retirer le thème signifie plutôt choisir Aucun — utiliser le type de carte tel qu’il est configuré et confirmer avec Retirer le thème.

Une carte porte au maximum un thème. Il est défini depuis le Thème champ de la carte, ou depuis Actions → Appliquer un thème.

Le sélecteur affiche le visuel et les couleurs de chaque thème, de sorte que le choix se fait sur le design plutôt que sur le nom.

La modification s’applique immédiatement. La carte se rafraîchit afin que le nouveau visuel atteigne l’appareil.

À de nombreuses cartes, avec un automatisme

Utilisez un automatisme pour déployer une campagne à grande échelle. Il sélectionne un public et applique un thème en fonction d’une date, d’un calendrier ou d’un événement de carte.

1. Accédez à Engagement → Automatisations et créez-en un.

2. Définissez le déclencheur : une date de lancement, une récurrence, un événement de carte ou une date relative à un champ de la carte.

3. Définissez le public avec des filtres — un type de carte, un niveau, un magasin. Sans filtre, toutes les cartes de la marque sont concernées.

4. Sélectionnez Ajoutez une action → Appliquer un thème et choisissez le thème. Retirer le thème signifie plutôt activer Retirer le thème à la place.

5. Définissez le condition de fin, puis enregistrez et activez l’automatisme.

Appliquer un thème est l’une des actions qu’un automatisme peut effectuer sur une carte.

L’étape de thème dans une chaîne d’automatisation. Confirmez le public au-dessus de l’étape avant d’activer l’automatisme ; Retirer le thème à la place transforme la même étape en action de nettoyage.

Un automatisme peut combiner plusieurs actions. Il peut appliquer une offre, mettre à jour les données de la carte, modifier un modèle, appliquer un thème et envoyer une notification. La plateforme pousse la carte une seule fois après l’exécution de toutes les actions.

Le rafraîchissement est silencieux. Ajoutez une Envoyer une notification action lorsqu’un utilisateur final doit être averti. L’application d’un thème laisse inchangés les champs et la structure de la carte.

Depuis des systèmes externes

Un CRM, une plateforme e-commerce ou une autre intégration peut créer une carte avec un thème. Elle peut aussi attribuer plus tard un thème différent. Définissez le champ du thème sur un identifiant de thème pour l’appliquer. Omettez le champ pour conserver le thème actuel. Envoyez une valeur vide pour le supprimer.

Deux règles comptent lorsqu’une intégration gère aussi les thèmes eux-mêmes. Un identifiant de thème ne change jamais, car les cartes et les automatismes y font référence : mettre à jour un thème avec un corps id différent de id dans l’URL est refusé avec 400. Et toute erreur provenant des points de terminaison des thèmes, comme l’erreur que renvoient les points de terminaison des cartes pour un themeId, est renvoyée sous forme de détails du problème (application/problem+json). Les erreurs de validation nomment le champ en cause, comme id, file ou themeId, afin que l’intégration puisse indiquer quelle valeur corriger.

Les points de terminaison, les charges utiles et les autorisations sont disponibles dans la référence de l’API. Pour des changements à l’échelle d’un public, un automatisme demande généralement moins de travail d’intégration.

Supprimer un thème de carte Wallet

La suppression d’un thème est bloquée tant que quelque chose en dépend encore, afin qu’aucune carte ni aucun automatisme en cours ne pointe vers un thème disparu. Un thème ne peut pas être supprimé tant qu’une carte le porte, ou tant qu’un automatisme activé l’applique. Un automatisme désactivé ne bloque pas la suppression.

Lorsque la suppression est bloquée, le back office explique pourquoi — le nombre de cartes portant le thème et les noms des automatismes qui l’appliquent — et l’action de suppression est désactivée. Le déblocage se fait en deux étapes :

1. Déplacez les cartes vers un autre thème, ou retirez-leur leur thème, une carte à la fois depuis la page de la carte ou pour un public via un automatisme.

2. Désactivez les automatismes listés, ou modifiez le thème qu’ils appliquent.

Une fois qu’aucune carte ni aucun automatisme activé ne dépend du thème, l’action de suppression dans le … menu redevient disponible.

Supprimer un thème supprime aussi ses images ; conservez donc les fichiers sources en dehors de The Wallet Crew. Une carte dont le thème est manquant revient à son modèle et est marquée comme manquante sur la page de la carte.

Événements de thème et mises à jour de cartes

Les changements dans le catalogue de thèmes peuvent notifier les webhooks connectés, les outils marketing et les systèmes du back office. Ces événements fournissent une piste d’audit et permettent aux autres systèmes de réagir automatiquement.

Les trois événements de thème

Événement	Envoyé quand	Ce qu’il contient
Thème créé (Theme:Created)	Un thème est ajouté.	Quel thème — identifiant, nom et étiquettes — et qui l’a ajouté.
Thème mis à jour (Theme:Updated)	Un thème existant est enregistré.	Quel thème — identifiant, nom et étiquettes — et qui l’a enregistré. Cela n’indique pas quelles parties du thème ont changé.
Thème supprimé (Theme:Deleted)	Un thème est supprimé.	L’identité du thème — identifiant, nom et étiquettes — telle qu’elle était avant la suppression, ainsi que la personne qui l’a supprimé. Ses couleurs et ses images ne sont pas incluses.

Chaque événement de thème comporte un thème objet (themeId, nom, étiquettes) et un utilisateur objet (credentialType, id, nom) qui indique qui a effectué la modification. credentialType est User pour un utilisateur du back-office connecté, ApiKey pour une clé API, ou Unknown lorsque la modification s’est produite en dehors d’une requête et ne porte aucune identité. Pour un User, id est l’identifiant utilisateur chez le fournisseur d’identité ; pour un ApiKey, il s’agit de apiKey:{name} et nom est le nom sous lequel la clé a été émise ; pour Unknown, id peut être vide. Les événements ne contiennent aucune adresse e-mail : l’ API des utilisateurs associe un identifiant utilisateur à une personne. Cette identité correspond à l’historique de configuration.

Lorsqu’une Carte est affectée à un thème

Les événements de thème décrivent les changements du catalogue. Les événements de Carte décrivent les changements apportés à une Carte individuelle.

Événement	Envoyé quand	Ce qu’il contient
Thème de Carte modifié (Carte:ThemeChanged)	Une Carte est déplacée vers un thème différent, ou son thème lui est retiré.	La Carte, le thème qu’elle porte maintenant, et le thème qu’elle portait auparavant. L’un ou l’autre peut être vide — vide avant signifie qu’elle n’en avait pas, vide après signifie que le thème a été retiré.
Carte créée / Carte mise à jour (Carte:Created, Carte:Updated)	Chaque création et chaque mise à jour, avec thème ou non.	Le thème que porte la Carte, ainsi que son modèle et ses identifiants.

Carte mise à jour indique l’état actuel de la Carte. Thème de Carte modifié enregistre le déplacement et les deux valeurs de thème. Utilisez la seconde pour mesurer l’attribution d’une campagne sans comparer l’historique des Cartes.

Thème de Carte modifié est envoyé uniquement lorsque le thème assigné diffère. Enregistrer à nouveau le même thème n’envoie aucun événement. Créer une Carte avec un thème envoie Carte créée, pas Thème de Carte modifié. Le même comportement s’applique aux modifications du back-office, de l’automatisation et de l’API.

Comme pour chaque événement de Carte, Thème de Carte modifié ne comporte aucun acteur : ni utilisateur ni clé API. L’événement indique ce qui a été déplacé, pas qui l’a déplacé.

Exemples concrets

• Conserver une trace de la personne qui a modifié un thème saisonnier, et à quelle date.

• Avertir un canal lorsqu’un thème en production est modifié, puisque chaque Carte qui le porte est sur le point de changer.

• Mesurer le déploiement d’une campagne en comptant les Cartes qui ont été déplacées vers son thème.

• Informer un système en aval qu’un habillage de campagne a été déployé, sans avoir à l’interroger régulièrement.

Liste de contrôle de lancement pour un thème de carte Wallet

Un thème devient actif lorsqu’il est enregistré. Il ne revient pas automatiquement en arrière. Vérifiez les points suivants avant le lancement :

• Planifiez la date de fin. Créez une deuxième automatisation pour appliquer le thème suivant ou supprimer le thème actuel.

• Vérifiez les deux plateformes. Apple Wallet et Google Wallet utilisent des emplacements d’image différents.

• Vérifiez les langues. Lorsque le thème a un titre ou une description traduits, confirmez que le modèle les affiche via des valeurs par langue ; sinon une seule langue s’affiche partout.

• Testez d’abord une Carte. Installez une Carte de test, appliquez le thème et examinez-le sur chaque type d’appareil.

Un thème encore porté par des Cartes, ou appliqué par une automatisation activée, ne peut pas être supprimé. Les étapes pour le libérer se trouvent dans Supprimer un thème de carte Wallet.

FAQ

Quand un thème est-il le bon outil plutôt qu’une modification du modèle ?

Utilisez un thème lorsque seul le design visuel change : couleurs, images ou titre saisonnier. Modifiez le modèle lorsque la Carte elle-même change, par exemple ses champs, son code-barres ou sa structure.

Quelle est la différence entre un thème et une offre ?

Une offre donne aux utilisateurs finaux quelque chose à utiliser. Elle peut inclure des dates de validité, du stock et une utilisation. Un thème ne change que l’apparence. Une automatisation peut appliquer une offre et un thème ensemble.

Une Carte peut-elle porter deux thèmes ?

Non. Une Carte porte un seul thème, ou aucun. Les thèmes ne se cumulent pas.

Quand les utilisateurs finaux voient-ils réellement le nouveau look ?

Les utilisateurs finaux voient le changement lorsque leur Carte se rafraîchit. L’application d’un thème directement ou via une automatisation rafraîchit la Carte immédiatement.

La modification d’un thème rafraîchit les Cartes assignées uniquement lorsque Envoyer la mise à jour à ces Cartes également est activé lors de l’enregistrement. Sinon, chaque Carte attend sa prochaine actualisation. Les actualisations sont silencieuses. Ajoutez une Envoyer une notification étape pour avertir les utilisateurs finaux.

Comment rétablir l’apparence précédente ?

Rien ne revient automatiquement en arrière. Appliquez le thème suivant ou retirez le thème actuel. Utilisez la page de la Carte pour une Carte, ou une automatisation pour une audience.

Peut-on essayer un thème sans toucher aux Cartes en production ?

Oui. La création d’un thème ne modifie aucune Carte. Appliquez-le à une Carte de test et examinez-le sur un appareil physique avant un déploiement plus large.

Quel format d’image doit être utilisé pour un thème de carte Wallet ?

PNG ou JPEG, jusqu’à 8 Mo. Les autres formats, comme WebP, GIF ou SVG, sont refusés, car les images sont intégrées dans la Carte exactement comme elles sont stockées. Une image fournie sous forme d’URL externe n’est pas vérifiée, elle doit donc déjà être au format PNG ou JPEG. Utilisez des fichiers PNG transparents pour les logos, et des visuels à la taille indiquée ou plus grands.

Pourquoi le titre du thème s’affiche-t-il dans une seule langue ?

C’est le modèle qui décide. {{ theme.title }} et {{ theme.description }} suivent la langue de l’appareil uniquement lorsque le modèle les place dans ses valeurs traduites, les valeurs par langue d’un champ. Un champ écrit une seule fois est rendu une seule fois, dans une seule langue. Déplacez l’espace réservé dans les valeurs par langue du champ, puis actualisez une Carte de test sur un appareil configuré pour chaque langue.

Apple Wallet et Google Wallet affichent-ils les mêmes images de thème ?

Non. L’image par défaut devient la bande Apple Wallet et le visuel principal Google Wallet, sauf si le thème remplace l’un ou l’autre emplacement. Les autres emplacements diffèrent selon la plateforme et conservent l’image du modèle sauf remplacement. Apple Wallet prend en charge des images spécifiques à la langue. Google Wallet utilise l’image de la langue par défaut.

Pourquoi l’image par défaut est-elle recadrée différemment sur deux Cartes ?

La bande est plus courte sur les billets d’événement que sur les autres Cartes, et une seule image par défaut sert à tous les types de Carte. Lorsque l’optimisation des images est activée dans le modèle, l’image est recadrée aux dimensions exactes de la bande et du visuel principal ; sans cela, Wallet ajuste l’image telle qu’elle a été importée. Garder le sujet au centre de l’image évite de le perdre dans les deux cas.

Peut-on supprimer un thème actif ?

Non. Un thème ne peut pas être supprimé tant qu’une Carte le porte ou qu’une automatisation activée l’applique ; une automatisation désactivée ne le bloque pas. Le back-office indique le nombre de Cartes et les automatisations concernées. Déplacez les Cartes vers un autre thème ou retirez leur thème, puis désactivez ces automatisations ou changez le thème qu’elles appliquent. Conservez les fichiers image source en dehors de The Wallet Crew, car la suppression supprime les images du thème.