Mettre à jour les données de carte dans les modèles

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

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

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

Exemples concrets

• Une carte de fidélité affiche les points et le niveau et se met à jour après chaque achat.
• Un billet d’événement affiche le dernier portail et siège après un changement de programme.
• Une carte d’adhésion affiche le statut et date d’expiration après un renouvellement.

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

Dans The Wallet Crew, les champs du Wallet proviennent généralement de deux endroits : les données supplémentaires stockées sur la Carte et les 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 le Wallet.

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

Étape par étape : mettre à jour les données, puis les afficher

1

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

Mettez à jour la Carte en utilisant l’API Carte. C’est la même API que vous utilisez pour les mises à jour push et l’actualisation des données.

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

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

2

2) Inspectez les données mises à jour sur une vraie Carte

Ouvrez une Carte et examinez la charge JSON. C’est votre source de vérité lorsque vous référez ensuite des champs dans Liquid.

Dans la console d’administration, allez à Wallet > Cartes, choisissez une Carte, puis ouvrez le menu (...) et cliquez sur Afficher les données.

Utilisez « Afficher les données » pour confirmer les clés et les valeurs présentes sur cette Carte.

3

3) Utilisez Liquid dans votre modèle de Carte

Allez à Wallet > Modèles et modifiez le modèle utilisé par votre Carte.

Modifiez le modèle qui correspond à votre type de Carte.

Sélectionnez ensuite la section que vous souhaitez modifier. Les sections sont regroupées afin que vous puissiez développer uniquement ce dont vous avez besoin.

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

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

Utilisez Liquid lorsque les champs de 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 Afficher les données pour confirmer ce qui existe sur la Carte, puis référencez exactement ces clés dans votre modèle.

4

4) Enregistrez et validez sur un appareil

Enregistrez vos modifications de modèle, puis validez avec une Carte que vous pouvez installer sur un téléphone.

Si les Cartes sont distribuées via une page Web ou un flux QR, validez la vue hébergée sur un véritable appareil. Si la distribution se fait depuis une application native, validez la même Carte via le flux de l’application utilisé par le projet.

Conseils de dépannage

Si vous ne voyez pas la nouvelle valeur dans Apple Wallet ou Google Wallet, commencez par vérifier la charge utile de la Carte dans Afficher les données. Si la valeur y est absente, le problème se situe dans l’appel de mise à jour ou dans le système source utilisé par le connecteur. Si elle existe dans Afficher les données mais pas sur la Carte rendue, le problème se situe dans le mappage du modèle ou dans la logique Liquid.

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

Liste de contrôle 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 fait référence à la clé exacte utilisée au moment du rendu.
• Un déclencheur de rendu a eu lieu, comme un aperçu, une installation ou une mise à jour push.
• La Carte finale est validée sur un véritable appareil.

FAQ

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

Utilisez des 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 du 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. Vérifiez que le champ existe dans Afficher les données, puis assurez-vous que votre modèle référence exactement le même nom de clé.

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

Non. Les modèles définissent la façon d’afficher les données. En général, vous ne mettez à jour un modèle que lorsque vous modifiez la mise en page ou ajoutez de nouveaux champs. Les changements quotidiens doivent être effectués en mettant à jour les données de la Carte via l’API.