Rendi professionale e coerente con il brand la carta loyalty caricando immagini personalizzate. Ogni risorsa appare in un'area diversa della carta, quindi è importante rispettare dimensioni e proporzioni.
Vai a Customize → Loyalty card, scegli un wallet e apri Card front per modificare la grafica e l'aspetto. Gli editor Apple e Google hanno impostazioni separate.
In Card type, scegli Apple Wallet store card o Apple Wallet poster, poi Card front nel menu successivo. Modifica le aree evidenziate nell’anteprima.

In Card type, scegli Google Wallet loyalty card, poi Card front nel menu successivo. Modifica le aree evidenziate nell’anteprima.

Usa il menu della vista per passare da Card front a Details. Se ci sono livelli, scegline uno in Design, sopra l’anteprima. Lo stato indica se ha un design proprio. Reset ripristina il design predefinito.
Tutte le immagini devono essere in formato PNG. Il sistema le mostrerà in Apple Wallet, Google Wallet e nelle notifiche push.
Modifica i testi sul fronte della carta ¶
Ogni testo sul fronte della carta si può modificare: il saldo, il nome del membro, il livello e fino a due campi in più in Apple Wallet. In Card front, fai clic sull'area evidenziata sopra i testi della carta per aprire Card front fields.

I campi sono raggruppati in base a dove compaiono sulla carta:
| Wallet | Zona | Campi |
|---|---|---|
| Apple Wallet store card | Header | Top right field (il saldo, per impostazione predefinita) |
| Apple Wallet store card | Main fields | da First field under the banner a Fourth field under the banner. Fai clic su Add field per usare il terzo e il quarto |
| Apple Wallet poster | Header | Top right field (il saldo, per impostazione predefinita) |
| Apple Wallet poster | Main fields | da First field under the banner a Fourth field under the banner, con Add field |
| Apple Wallet poster | Footer | Poster footer (membro dal, per impostazione predefinita) |
| Google Wallet loyalty card | First row e Second row | First row, left field, First row, right field, Second row, left field, Second row, right field |


Apri un campo
Fai clic su un campo in Card front fields. La finestra prende il nome del campo, per esempio First field under the banner.
Mostralo o nascondilo
Show this field on the card attiva o disattiva il campo. Un campo nascosto conserva i suoi testi per quando lo mostri di nuovo. Puoi anche usare l'icona a forma di occhio accanto a ogni campo.
Scrivi l'etichetta e il valore
Label è il testo piccolo sopra, Value è il testo principale. Entrambi accettano testo e variabili con formati, come {{ firstName | default:'Customer' }}. Fai clic sull'icona { } per scegliere una variabile. Lascia Value vuoto per nascondere il campo nella pass.

Salva
Fai clic su Save nel campo, poi su Save in Card front fields. Poi fai clic su Save nella barra di salvataggio in alto nella pagina, altrimenti le modifiche non vengono salvate. Restore default ripristina il contenuto integrato del campo.
Tieni a mente alcune cose:
- Ogni etichetta o valore può avere fino a 255 caratteri. Sul fronte i link non sono ammessi: mettili in una sezione sul retro o in un pulsante.
- In Apple Wallet, i campi sotto il banner condividono una sola riga. I campi nascosti o vuoti non lasciano spazio, e i testi lunghi si rimpiccioliscono e poi vengono tagliati.
- In Google Wallet, se un campo di una riga è vuoto, l'altro inizia la riga. Una riga vuota viene omessa.
- Un campo il cui valore dipende dai dati del cliente, come telefono o compleanno, non compare sulla carta dei clienti senza quel dato. Aggiungi
defaultper mostrare sempre qualcosa. - Per nascondere il saldo punti, disattiva Top right field in Apple Wallet e First row, left field in Google Wallet.
Per tradurre etichette e valori, scegli una lingua con il pulsante della lingua sotto l'anteprima prima di aprire Card front fields. Vedi tradurre le sezioni del wallet.
Icona Google Wallet e icona delle notifiche ¶
L'icona Google Wallet appare sul fronte della pass Google. JeriCommerce usa un'icona anche per le notifiche push su iOS e Android.
| Requisito | Valore |
|---|---|
| Proporzioni | 1:1 |
| Dimensione minima | 840 × 840 px |
Logo Apple Pass ¶
Il logo si trova nella parte superiore del fronte della pass Apple Wallet. Se mostri anche un titolo della pass, logo e titolo condividono lo spazio. Altrimenti, appare solo il logo. Fai clic sul titolo nell'anteprima per aprire Edit pass title, dove puoi modificarlo, tradurlo, aggiungere variabili o disattivare Show this field on the card per nasconderlo.
| Requisito | Valore |
|---|---|
| Proporzioni | 1:1 o 3:1 |
| Dimensione consigliata (1:1) | 512 × 512 px |
| Dimensione consigliata (3:1) | 1536 × 512 px |
Immagine strip Apple e immagine hero Google ¶
L'editor usa immagini separate per ciascun wallet. L'immagine strip Apple riempie l'ampia area grafica nella parte alta della pass; l'immagine hero Google appare in basso.
| Requisito | Valore |
|---|---|
| Proporzioni | 3:1 |
| Dimensione consigliata | 1032 × 336 px |
Le dimensioni del banner possono variare leggermente in base all'app wallet. Mantieni i contenuti più importanti al centro e lascia un'area di sicurezza del 10% lungo i bordi.
Banner iniziale (overlay) ¶
Il banner iniziale è un overlay che appare sopra il banner principale quando la carta viene installata per la prima volta. Aiuta i clienti a capire che devono toccare i tre puntini per visualizzare i dettagli della carta. L'overlay scompare quando il cliente tocca un link sul retro.
Trovi questa opzione nelle impostazioni avanzate del banner, subito sotto il caricamento dell'immagine principale.
I nuovi programmi iniziano con un modello di overlay trasparente, così il banner principale resta visibile senza immagini di istruzioni finché non carichi un overlay. Apple Wallet e Google Wallet mantengono output overlay separati affinché ogni piattaforma possa mostrare correttamente la grafica.
Usa la trasparenza nel banner iniziale per lasciare intravedere quello principale sullo sfondo. Mantieni le stesse dimensioni e proporzioni dell'immagine principale.
Grafica Poster Apple ¶
La grafica Poster riempie una tela verticale. Mantieni il soggetto principale vicino al centro: Wallet ritaglia l'immagine per riempire la tela e il codice a barre e la fascia inferiore ne coprono una parte. Considera lo schema dell'area di sicurezza come indicativo, non come un limite garantito.
| Requisito | Valore |
|---|---|
| Dimensione della tela | 358 × 448 pt |
| Dimensione immagine consigliata | 1074 × 1344 px |
Impostazioni avanzate del wallet ¶
Apri More actions → More wallet settings per trovare le opzioni della pass Apple. Attiva Enable Apple Poster format per mostrare la pass Poster a schermo intero ai clienti con iOS 27 o versioni successive. I clienti con versioni precedenti di iOS vedono una Store card generata dal design Poster. Store card è di sola lettura quando Poster è attivo.
La stessa finestra include Notification links, che consente a una notifica push attiva di sostituire le azioni sotto la pass. Prima di modificare questa impostazione, consulta come funzionano i link delle notifiche push.

Fai clic sull'area dei colori nell'anteprima per aprire Pass colors. La finestra mostra i colori del wallet che stai modificando:
- Apple Wallet store card: Theme color per lo sfondo e Text color.
- Google Wallet: Theme color, il colore della carta in Google Wallet. Google sceglie il colore del testo in modo che risalti.
- Apple Poster: l'oscuramento dell'intestazione Poster, lo sfondo del piè di pagina e il colore delle etichette. JeriCommerce richiede anche colori automatici per il testo della grafica Poster. Controlla il risultato su un dispositivo, perché iOS potrebbe non applicare i colori richiesti. Non puoi scegliere il colore del testo sulla grafica Poster, e l'anteprima nell'admin non lo mostra con precisione. Salva, poi trascina verso il basso la pass sul tuo iPhone per aggiornarla. Sugli iPhone precedenti a iOS 27 la pass appare come store card, con i suoi colori.


Configura le azioni Wallet ¶
Le azioni si configurano separatamente per Apple Wallet e Google Wallet a livello di programma. Scegli tra iscrizione, premi, coupon, accumulo, referral, transazioni, negozio online o una destinazione personalizzata. Una destinazione personalizzata può essere un indirizzo web o una pagina dell'app cliente.
Apple Wallet supporta fino a due riquadri azione. Scegli un tipo diverso per ciascun riquadro. Apple assegna a ogni riquadro etichetta e icona in base al tipo selezionato, quindi non puoi scrivere un'etichetta personalizzata.
Nell'editor, l'azione principale si chiama Left button e quella secondaria Right button. Per le pass loyalty, Apple offre cinque tipi di azione: View offers and rewards, View membership benefits, Add to balance, Shop Online or In App e Order Delivery or Collection. Il campo Opens accetta una destinazione come testo. Inserisci un indirizzo web, una pagina dell'app cliente o un link personalizzato supportato dal programma.

Google Wallet supporta un pulsante sul fronte della pass e un link separato nei dettagli. Configura ciascuno indipendentemente.
Usa i link delle notifiche push ¶
In Customize → Loyalty card, usa la grafica predefinita del programma, non una specifica per livello, quindi apri More actions → More wallet settings. Nella finestra Advanced settings, l'opzione Notification links controlla i pulsanti sotto la pass sia in Apple Wallet sia in Google Wallet. È attiva per impostazione predefinita.
Quando una notifica push include un link, questa impostazione permette ai clienti di aprire dalla carta la destinazione della notifica invece di quella del pulsante abituale:
| Wallet | Quando il link della notifica è attivo |
|---|---|
| Apple Wallet (iOS 27 o successivo) | Una notifica promozionale o relativa a un premio con link sostituisce i riquadri azione configurati con una sola azione che apre quel link. |
| Google Wallet (Android) | Il pulsante sul fronte apre il link della notifica e usa il testo della notifica come etichetta. |
La sostituzione è temporanea. Le azioni configurate tornano quando la pass non contiene più quel link di notifica attivo. Disattiva Notification links per mantenere i pulsanti abituali durante le notifiche. Fai clic su Save nella finestra, quindi salva l'editor della carta. Questa operazione non disattiva l'invio push e non rimuove i link di notifica dai dettagli della pass.
Apple richiede almeno un'azione configurata per mostrare un riquadro. Google richiede un pulsante o un link nei dettagli per mostrare il pulsante della notifica. Senza questi elementi, il link della notifica resta nei dettagli della pass invece di creare un pulsante sotto la carta.
Quando rinomini il programma o cambi il titolo della carta wallet, JeriCommerce aggiorna automaticamente la definizione condivisa della carta Google Wallet. Le carte Google Wallet esistenti ricevono il nuovo nome senza che i clienti debbano reinstallarle. Il titolo di Google Wallet si può tradurre, ma è testo semplice e non usa variabili.