Variabili e formati della carta loyalty ({{ }} e pipe)

Le variabili permettono a ogni cliente di vedere i propri dati sulla carta loyalty: nome, punti, livello o compleanno. Si scrivono tra doppie parentesi graffe, come {{ firstName }}, in Label o Value di qualsiasi campo del fronte della carta in Customize → Loyalty card. Aggiungi un formato dopo una pipe (|) per cambiare l'aspetto del dato, per esempio {{ birthdate | date:'dd/MM/yyyy' }}. Questa guida elenca ogni variabile e formato, con esempi da copiare. Per scegliere quali campi compaiono sulla carta, vedi progettare la carta loyalty.

Dove scrivere le variabili ¶

1

Apri il fronte della carta

Vai a Customize → Loyalty card, scegli Apple Wallet store card o Google Wallet loyalty card e controlla che la vista mostri Card front.

2

Apri i campi

Fai clic sull'area evidenziata sopra i testi della carta per aprire Card front fields. Fai clic su un campo qualsiasi per modificarlo.

3

Scrivi l'etichetta e il valore

Scrivi testo, variabili o entrambi in Label e Value. Fai clic sull'icona { } alla fine di ogni casella per scegliere una variabile da un elenco invece di digitarla. Per date e numeri, l'elenco propone anche formati già pronti.

4

Salva

Fai clic su Save nel campo, poi su Save in Card front fields. Per ora non è salvato nulla: fai clic su Save nella barra di salvataggio in alto nella pagina per pubblicare le modifiche. Le carte già installate si aggiornano qualche minuto dopo.

L'anteprima nell'admin usa dati di esempio (Ada Lovelace, 1250 punti e il tuo primo livello o il livello che stai modificando), così puoi controllare il risultato prima di salvare.

Come si scrive una variabile ¶

Una variabile va tra doppie parentesi graffe. Gli spazi dentro le parentesi non contano, quindi {{firstName}} e {{ firstName }} sono uguali.

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

• I formati vanno dopo una pipe (|). Puoi concatenarne diversi, e si applicano da sinistra a destra.
• I valori di un formato vanno dopo i due punti (:), uno per ogni valore.
• I testi vanno tra apici singoli o doppi: default:'Customer'. I numeri non vogliono apici: slice:0:12.
• Un'altra variabile può essere un valore senza apici: default:email mostra l'email quando la prima variabile è vuota.
• Mescola liberamente testo e variabili nella stessa casella: Hi {{ firstName }}!
• I nomi delle variabili distinguono maiuscole e minuscole: firstName funziona, firstname no.
• Scrivi ogni variabile su una sola riga.

Se una variabile o un formato non si può leggere, la carta mostra il testo esattamente come l'hai scritto, parentesi comprese. L'admin segnala questi errori prima del salvataggio (vedi messaggi di errore).

Variabili che puoi usare sul fronte della carta ¶

Queste variabili funzionano in ogni etichetta e valore del fronte della carta e nel titolo della pass di Apple Wallet. La colonna Nell'elenco { } mostra il nome nel selettore delle variabili. Alcuni testi del programma non sono nell'elenco, ma funzionano se li scrivi.

Gli identificativi sono sotto More variables nell'elenco. Tier status e Tier points compaiono nell'elenco solo quando il programma ha livelli.

Sul fronte della carta i link non sono ammessi. Variabili come referralLink, inviteFriendLink o i link alle pagine cliente (linkCustomerAppRewards e simili) funzionano solo sul retro della carta e nei pulsanti. Lo stesso vale per gli indirizzi web scritti per esteso.

Formati (pipe) ¶

I formati funzionano solo con il tipo di dato che si aspettano. date vuole una data (birthdate, memberSince), number e plural vogliono un numero (balance, tierPoints), e uppercase, lowercase, titlecase e slice vogliono un testo. default e if funzionano con qualsiasi dato. L'admin ti avvisa quando un formato non è adatto alla variabile.

0 non è vuoto. Un cliente con 0 punti vede 0, non il valore di default.

Modelli di data ¶

date accetta quattro stili già pronti che si adattano alla lingua della carta, oppure un modello tuo.

Nei tuoi modelli, d è il giorno, dd il giorno con due cifre, MM il mese in numeri, MMM il nome breve del mese, MMMM il nome completo del mese e yyyy l'anno. Usa yyyy e dd in minuscolo: YYYY o DD in maiuscolo non danno la data che ti aspetti, e la carta mostra la data così come è salvata, per esempio 1990-05-14 per birthdate.

Numeri ¶

number usa il separatore della lingua della carta: 1,250 in inglese, 1.250 in tedesco. Spagnolo e italiano lo aggiungono solo da cinque cifre (12.500). Senza valore mostra fino a tre decimali. Il tuo saldo è un numero intero, quindi di solito basta {{ balance | number }}. Per forzare i decimali, aggiungi un valore con il modello '{minimum digits}.{minimum decimals}-{maximum decimals}', per esempio number:'1.0-0' per nessun decimale.

Esempi pronti ¶

Copiali in Value o Label e adatta i testi.

Contenuto predefinito di ogni campo ¶

Ogni campo parte con un contenuto integrato, e le etichette integrate sono già tradotte per te. Restore default le ripristina.

Regole sul fronte della carta ¶

• Un valore vuoto nasconde il campo. Quando Value risulta vuoto per un cliente, per esempio {{ phone }} per chi non ha un telefono, il campo non compare sulla sua carta. L'admin avvisa con "May be left off the pass for customers without this data. Add a default to always show it." Aggiungi default per mostrare sempre qualcosa.
• Al massimo 255 caratteri per etichetta o valore. Il titolo della pass ne ammette 80, su Apple Wallet e Google Wallet.
• Niente link. Link e indirizzi web vengono rifiutati sul fronte. Mettili in una sezione sul retro o in un pulsante.
• Riga di Apple Wallet. I quattro campi sotto il banner condividono una sola riga a partire da sinistra. I campi nascosti o vuoti non lasciano spazio. I testi lunghi si rimpiccioliscono e poi vengono tagliati, quindi tieni i valori brevi.
• Righe di Google Wallet. Ogni riga ha due campi. Se uno è vuoto, l'altro inizia la riga, e una riga vuota viene omessa.
• Livelli. Il design di un livello può cambiare qualsiasi campo o mostrare un campo che il design predefinito nasconde. Vedi design per livelli.
• Aggiornamenti. Le carte già installate ricevono il nuovo design circa cinque minuti dopo il salvataggio. Quando cambiano i dati di un cliente, come punti, punti livello o livello, la sua carta si aggiorna in pochi secondi.

Traduzioni ¶

Per tradurre etichette e valori, scegli la lingua con il pulsante della lingua sotto l'anteprima, poi apri Card front fields. La finestra mostra la lingua che stai traducendo. Cambiano da una lingua all'altra solo i tuoi testi. Lascia nomi di variabili, nomi di formati e modelli esattamente come sono. Traduci solo i testi tra virgolette, per esempio default:'Cliente'. Se mostri i punti livello, tieni la variabile dei punti livello anche nel testo predefinito: quando compare solo in una traduzione, la carta non si aggiorna al variare dei punti livello del cliente.

Date e numeri seguono la lingua di ogni testo. {{ memberSince | date:'longDate' }} mostra "February 3, 2024" in inglese e "3 de febrero de 2024" in spagnolo. Google Wallet lo fa per ogni lingua. Su Apple Wallet, un testo viene formattato in un'altra lingua solo dopo che aggiungi una traduzione, anche se è lo stesso testo.

I valori della prima riga in Google Wallet (First row, left field e First row, right field) mostrano lo stesso testo in tutte le lingue, scritto nella tua lingua predefinita. Vedi tradurre le sezioni del wallet.

Altri posti che usano le variabili ¶

Anche il retro della carta, i link dei pulsanti e i messaggi push automatici accettano variabili tra doppie parentesi graffe, e applicano gli stessi formati. Lì l'admin non controlla i formati mentre scrivi, quindi prova il risultato su una carta. Le variabili di link (referralLink, inviteFriendLink, linkCustomerAppRewards, linkCustomerAppProfile e gli altri link alle pagine cliente) sono ammesse nelle sezioni del retro, nei pulsanti e nei messaggi push automatici. Il testo delle notifiche push delle campagne accetta solo referralLink e inviteFriendLink. Il titolo di Google Wallet è testo semplice e non usa variabili.

Messaggi di errore ¶

L'admin controlla ogni etichetta e valore mentre scrivi e mostra il problema sotto la casella.