Mettre à jour les données de la Carte dans les modèles

Mettez à jour les données existantes de la Carte via l’API, puis affichez les dernières valeurs dans les modèles Apple Wallet et Google Wallet.

Mettre à jour les données de la Carte dans les gabarits

Les cartes sont les plus utiles lorsqu’elles restent exactes dans le temps. Le schéma habituel est simple : une carte est mise à jour via l’API The Wallet Crew, puis les modèles de carte rendent les dernières valeurs à l’aide de Liquid.

Exemples concrets

• Une carte de fidélité affiche points et niveau et se met à jour après chaque achat.

• Un billet d’événement affiche le dernier porte et siège après un changement d’horaire.

• Une carte d’adhésion affiche statut et expiryDate après un renouvellement.

Ce que signifie « données de carte mises à jour »

Dans The Wallet Crew, les champs Wallet proviennent généralement de deux sources : des données supplémentaires stockées sur la carte et des données en direct récupérées par les connecteurs au moment du rendu. Les identifiants externes aident les connecteurs à trouver le bon enregistrement source. Les métadonnées prennent en charge la segmentation et les rapports, pas l’affichage dans Wallet.

Si l’emplacement de stockage approprié n’est pas clair, commencez par Structure.

Étape par étape : mettez à jour les données, puis affichez-les

1

1) Mettez à jour les données de la carte via l’API

Mettez à jour la carte à l’aide de l’API Carte. C’est la même API utilisée pour les mises à jour push et l’actualisation des données.

Utilisez la Référence de l'API et cherchez Mettre à jour une carte.

Si la création de cartes n’est pas encore configurée, commencez par flux d'inscription ou création de Carte déclenchée par un connecteur.

2

2) Examinez les données mises à jour sur une vraie carte

Ouvrez une carte et examinez la charge utile JSON. C’est la source de vérité lorsque les champs sont ensuite référencés dans Liquid.

Dans la console d’administration, allez dans Wallet > Cartes, sélectionnez une carte, puis ouvrez le menu (...) et cliquez sur Voir les données.

Utilisez « Afficher les données » pour confirmer les clés et les valeurs qui existent sur cette carte.

3

3) Utilisez Liquid dans le modèle de carte

Accédez à Wallet > Modèles et modifiez le modèle utilisé par la carte.

Modifiez le modèle qui correspond au type de carte.

Sélectionnez ensuite la section à modifier. Les sections sont regroupées afin que seule la partie pertinente doive être développée.

Choisissez le champ où la valeur mise à jour doit apparaître.

Lorsque du contenu dynamique est nécessaire (conditions, mise en forme ou chaînes calculées), ouvrez l’éditeur de code (<>) et utilisez Liquid.

Utilisez Liquid lorsque les champs en texte brut ne suffisent pas.

Utilisation Moteur de templates pour la syntaxe Liquid prise en charge dans The Wallet Crew.

Évitez de deviner les chemins des variables. Utilisez Voir les données pour confirmer ce qui existe sur la carte, puis référencez ces clés exactes dans le modèle.

4

4) Enregistrez et validez sur un appareil

Enregistrez les modifications du modèle, puis validez-les avec une carte pouvant être installée sur un téléphone.

Si les cartes sont distribuées via une page web ou un parcours QR, validez la vue hébergée sur un vrai appareil. Si la distribution se fait depuis une application native, validez la même carte via le parcours de l’application utilisé par le projet.

Conseils de dépannage

Si la nouvelle valeur n’apparaît pas dans Apple Wallet ou Google Wallet, commencez par vérifier la charge utile de la carte dans Voir les données. Si la valeur est absente à cet endroit, le problème vient de l’appel de mise à jour ou du système source utilisé par le connecteur. Si elle existe dans Voir les données mais pas sur la carte rendue, le problème vient du mappage du modèle ou de la logique Liquid.

Si la valeur n’existe qu’en tant que métadonnée, elle n’apparaîtra pas sur la carte Wallet. Les métadonnées servent au ciblage et au reporting, pas aux champs d’affichage.

Liste de vérification de validation

Après une mise à jour, confirmez quatre choses :

• La valeur stockée existe sur la carte, ou l’enregistrement source du connecteur contient la nouvelle valeur.

• Le modèle référence la clé exacte utilisée au moment du rendu.

• Un déclencheur de rendu s’est produit, comme un aperçu, une installation ou une mise à jour push.

• La carte finale est validée sur un vrai appareil.

FAQ

Que dois-je utiliser : identifiants, métadonnées ou données supplémentaires ?

Utilisez les identifiants pour relier la carte à des systèmes externes. Utilisez les métadonnées pour segmenter les cartes à des fins opérationnelles. Utilisez les données supplémentaires pour les valeurs qui doivent persister sur la carte et apparaître dans les champs Wallet.

Si un aperçu rapide est nécessaire, lisez Structure.

Pourquoi Liquid affiche-t-il des valeurs vides ?

Dans la plupart des cas, la clé n’existe pas sur cette carte précise. Confirmez que le champ existe dans Voir les données, puis assurez-vous que le modèle référence exactement le même nom de clé.

Dois-je mettre à jour le modèle après chaque changement de données ?

Non. Les modèles définissent la manière d’afficher les données. Un modèle ne change généralement que lorsque la mise en page change ou que de nouveaux champs sont ajoutés. Les changements quotidiens doivent être effectués en mettant à jour les données de la carte via l’API.