Variables et formats de la carte de fidélité ({{ }} et pipes)

Les variables permettent à chaque client de voir ses propres données sur la carte de fidélité : son nom, ses points, son niveau ou son anniversaire. Vous les écrivez entre doubles accolades, comme {{ firstName }}, dans Label ou Value de n'importe quel champ du recto de la carte, dans Customize → Loyalty card. Ajoutez un format après une barre verticale (|) pour changer l'apparence de la donnée, par exemple {{ birthdate | date:'dd/MM/yyyy' }}. Ce guide liste chaque variable et chaque format, avec des exemples à copier. Pour choisir les champs qui apparaissent sur la carte, consultez concevoir votre carte de fidélité.

Où écrire les variables ¶

1

Ouvrir le recto de la carte

Accédez à Customize → Loyalty card, choisissez Apple Wallet store card ou Google Wallet loyalty card, et vérifiez que la vue affiche Card front.

2

Ouvrir les champs

Cliquez sur la zone mise en évidence au-dessus des textes de la carte pour ouvrir Card front fields. Cliquez sur un champ pour le modifier.

3

Saisir le libellé et la valeur

Saisissez du texte, des variables ou les deux dans Label et Value. Cliquez sur l'icône { } à la fin de chaque zone pour choisir une variable dans une liste plutôt que de la saisir. Pour les dates et les nombres, la liste propose aussi des formats prêts à l'emploi.

4

Enregistrer

Cliquez sur Save dans le champ, puis sur Save dans Card front fields. Rien n'est encore enregistré : cliquez sur Save dans la barre d'enregistrement en haut de la page pour publier les modifications. Les cartes installées se mettent à jour quelques minutes plus tard.

L'aperçu dans l'admin utilise des données d'exemple (Ada Lovelace, 1250 points, et votre premier niveau ou le niveau que vous modifiez). Vous pouvez donc vérifier le résultat avant d'enregistrer.

Comment écrire une variable ¶

Une variable se place entre doubles accolades. Les espaces à l'intérieur des accolades n'ont pas d'importance : {{firstName}} et {{ firstName }} sont identiques.

{{ variable }}
{{ variable | format }}
{{ variable | format:'text' }}
{{ variable | format:'text':'other text' }}
{{ variable | first format | second format }}

• Les formats se placent après une barre verticale (|). Vous pouvez en enchaîner plusieurs, ils s'appliquent de gauche à droite.
• Les valeurs d'un format se placent après deux-points (:), un deux-points par valeur.
• Les textes vont entre guillemets simples ou doubles : default:'Customer'. Les nombres n'ont pas besoin de guillemets : slice:0:12.
• Une autre variable peut servir de valeur, sans guillemets : default:email affiche l'e-mail quand la première variable est vide.
• Mélangez librement du texte et des variables dans la même zone : Hi {{ firstName }}!
• Les noms de variables sont sensibles à la casse : firstName fonctionne, firstname non.
• Écrivez chaque variable sur une seule ligne.

Si une variable ou un format est illisible, la carte affiche le texte exactement comme vous l'avez saisi, accolades comprises. L'admin détecte ces erreurs avant l'enregistrement (consultez les messages d'erreur).

Variables utilisables au recto de la carte ¶

Ces variables fonctionnent dans chaque libellé et chaque valeur du recto de la carte, ainsi que dans le titre du pass Apple Wallet. La colonne Dans la liste { } indique le nom affiché dans le sélecteur de variables. Quelques textes du programme ne figurent pas dans la liste, mais ils fonctionnent si vous les saisissez.

Les identifiants se trouvent sous More variables dans la liste. Tier status et Tier points n'apparaissent dans la liste que si votre programme comporte des niveaux.

Les liens ne peuvent pas figurer au recto de la carte. Des variables comme referralLink, inviteFriendLink ou les liens vers les pages client (linkCustomerAppRewards et similaires) ne fonctionnent qu'au verso de la carte et dans les boutons. Il en va de même pour les adresses web écrites en toutes lettres.

Formats (pipes) ¶

Les formats ne fonctionnent que sur le type de donnée attendu. date exige une date (birthdate, memberSince), number et plural exigent un nombre (balance, tierPoints), et uppercase, lowercase, titlecase et slice exigent du texte. default et if fonctionnent avec n'importe quoi. L'admin vous avertit quand un format ne convient pas à la variable.

0 n'est pas vide. Un client avec 0 point voit 0, pas la valeur default.

Modèles de date ¶

date accepte quatre styles prêts à l'emploi qui s'adaptent à la langue de la carte, ou votre propre modèle.

Dans vos propres modèles, d est le jour, dd le jour sur deux chiffres, MM le mois en chiffres, MMM le nom court du mois, MMMM le nom complet du mois et yyyy l'année. Utilisez yyyy et dd en minuscules : YYYY ou DD en majuscules ne donnent pas la date attendue, et la carte affiche alors la date telle qu'elle est enregistrée, par exemple 1990-05-14 pour birthdate.

Nombres ¶

number utilise le séparateur de la langue de la carte : 1,250 en anglais, 1.250 en allemand. L'espagnol et l'italien ne l'ajoutent qu'à partir de cinq chiffres (12.500). Sans valeur, il affiche jusqu'à trois décimales. Votre solde est un nombre entier, donc {{ balance | number }} suffit généralement. Pour forcer les décimales, ajoutez une valeur avec le modèle '{minimum digits}.{minimum decimals}-{maximum decimals}', par exemple number:'1.0-0' pour aucune décimale.

Recettes ¶

Copiez-les dans Value ou Label et adaptez les textes.

Contenu par défaut de chaque champ ¶

Chaque champ démarre avec un contenu intégré, et les libellés intégrés sont traduits pour vous. Restore default les rétablit.

Règles du recto de la carte ¶

• Une valeur vide masque le champ. Quand la Value est vide pour un client, par exemple {{ phone }} pour quelqu'un sans téléphone, le champ n'apparaît pas sur sa carte. L'admin avertit avec "May be left off the pass for customers without this data. Add a default to always show it." Ajoutez default pour toujours afficher quelque chose.
• 255 caractères maximum par libellé ou valeur. Le titre du pass en autorise 80, sur Apple Wallet et Google Wallet.
• Pas de liens. Les liens et les adresses web sont refusés au recto. Placez-les dans une section au verso ou dans un bouton.
• Ligne Apple Wallet. Les quatre champs sous le bandeau partagent une seule ligne à partir de la gauche. Les champs masqués ou vides ne laissent aucun espace. Les textes longs rétrécissent, puis sont coupés : gardez donc des valeurs courtes.
• Lignes Google Wallet. Chaque ligne comporte deux champs. Si l'un est vide, l'autre commence la ligne, et une ligne vide est omise.
• Niveaux. Un design de niveau peut modifier n'importe quel champ ou afficher un champ que le design par défaut masque. Consultez designs par niveau.
• Mises à jour. Les cartes installées reçoivent un nouveau design environ cinq minutes après l'enregistrement. Quand les données d'un client changent, comme ses points, ses points de niveau ou son niveau, sa carte se met à jour en quelques secondes.

Traductions ¶

Les libellés et les valeurs peuvent être traduits Pour traduire les libellés et les valeurs, choisissez la langue avec le bouton de langue sous l'aperçu, puis ouvrez Card front fields. La boîte de dialogue indique la langue que vous traduisez. Seuls vos propres textes changent d'une langue à l'autre. Gardez les noms de variables, les noms de formats et les modèles exactement tels quels. Traduisez uniquement les textes entre guillemets, par exemple default:'Cliente'. Si vous affichez les points de niveau, gardez aussi la variable des points de niveau dans votre texte par défaut : quand elle n'apparaît que dans une traduction, la carte ne se met pas à jour lorsque les points de niveau du client changent.

Les dates et les nombres suivent la langue de chaque texte. {{ memberSince | date:'longDate' }} affiche "February 3, 2024" en anglais et "3 de febrero de 2024" en espagnol. Google Wallet le fait pour chaque langue. Sur Apple Wallet, un texte n'est formaté dans une autre langue que si vous ajoutez une traduction pour ce texte, même si la traduction est identique.

Les valeurs de la première ligne sur Google Wallet (First row, left field et First row, right field) affichent le même texte dans toutes les langues, écrit dans votre langue par défaut. Consultez traduire les sections du portefeuille.

Autres endroits qui utilisent des variables ¶

Le verso de la carte, les liens des boutons et les messages push automatiques acceptent aussi des variables entre doubles accolades, avec les mêmes formats. Là, l'admin ne vérifie pas les formats pendant la saisie : testez donc le résultat sur une carte. Les variables de lien (referralLink, inviteFriendLink, linkCustomerAppRewards, linkCustomerAppProfile et les autres liens vers les pages client) y sont autorisées dans les sections du verso, les boutons et les messages push automatiques. Le texte des notifications push de campagne n'accepte que referralLink et inviteFriendLink. Le titre Google Wallet est du texte brut et n'utilise pas de variables.

Messages d'erreur ¶

L'admin vérifie chaque libellé et chaque valeur pendant la saisie et affiche le problème sous la zone.