OneTrace.pro Centro assistenza

Carte Wallet

La carta fedeltà in Apple Wallet e Google Wallet è sempre nel telefono del cliente: mostra il saldo punti, il livello, il codice promozionale valido e un codice a barre per la cassa. OneTrace.pro aggiorna la carta da solo: dopo un ordine, un accredito di punti o l'assegnazione di un codice promozionale il cliente vede i nuovi valori, e Apple Wallet mostra una notifica. La carta è anche un canale di messaggi: un breve messaggio arriva come notifica e resta sul retro della carta.

Le carte Wallet sono disponibili dal piano «Crescita» (piani). La sezione si trova nel menu Coinvolgimento → Carte Wallet. Statistiche e aspetto sono visibili al «Manager», all'«Osservatore» e ai ruoli superiori; modificare l'aspetto possono i ruoli con il permesso di gestire le integrazioni: l'«Amministratore» e il «Proprietario».

Collegamento

Le carte le emette il Suo negozio, a proprio nome e con le proprie chiavi Apple e Google. Colleghi una delle due piattaforme o entrambe:

  1. Apra Integrazioni e faccia clic su Aggiungi integrazione → Carte Wallet (integrazioni).
  2. Per Apple Wallet:
    • in Apple Developer apra Certificates, Identifiers & Profiles → Identifiers e registri un Pass Type ID, ad esempio pass.com.example.loyalty;
    • crei per esso un certificato Pass Type ID Certificate, lo installi su un Mac e lo esporti da «Accesso Portachiavi» insieme alla chiave privata in un file .p12;
    • incolli nel campo Certificato Pass Type ID il contenuto del .p12 in base64 oppure il certificato e la chiave in PEM, e nel campo Password della chiave la password di esportazione. Il certificato intermedio Apple WWDR lo aggiunge OneTrace.pro da solo.
  3. Per Google Wallet:
    • in Google Pay & Wallet Console crei un emittente e copi l'Issuer ID;
    • in Google Cloud attivi la Google Wallet API, crei un account di servizio e una chiave JSON per esso;
    • aggiunga l'email dell'account di servizio in Google Pay & Wallet Console come utente dell'emittente;
    • incolli l'Issuer ID e la chiave JSON nell'integrazione.
  4. Faccia clic su Salva e Verifica: per Apple la verifica mostra il Pass Type ID, il team e la scadenza del certificato, per Google che la classe di carta è stata creata.

Finché Google non ha approvato il Suo emittente per la pubblicazione, la carta Google possono salvarla solo gli utenti di test aggiunti nella console. Il certificato Apple viene rilasciato per un anno: prima della scadenza ne emetta uno nuovo e lo sostituisca nell'integrazione, altrimenti le carte smetteranno di aggiornarsi.

Aspetto della carta

Apra Carte Wallet o faccia clic su Design della carta nell'integrazione. Se le integrazioni sono più di una, scelga quella che Le serve in alto.

Campo Cosa definisce
Nome sulla carta Il negozio che emette la carta. Se vuoto, il nome dell'integrazione
Sfondo, Testo, Etichette I colori della carta. Google Wallet usa solo il colore di sfondo e sceglie da solo il colore del testo
Logo Apple: in alto a sinistra al posto del nome. Carichi un'immagine di almeno 480×150 pixel
Striscia Apple: immagine larga sotto il logo, dietro i punti; Google: intestazione della carta. Circa 1125×369 pixel
Icona Quadrato di almeno 660×660 pixel: icona delle notifiche Apple e logo del programma in Google Wallet
Codice a barre Codice QR, Code 128, PDF417 o Aztec: quello che legge lo scanner alla cassa. Il codice a barre contiene il numero della carta
Campi personalizzati Fino a 4 campi: l'etichetta sulla carta e un attributo del profilo, ad esempio «Città» — city. Se il profilo non ha l'attributo, il campo non compare neanche sulla sua carta

Le immagini si scelgono dalla mediateca: per questo serve l'accesso ai modelli di messaggio. Un'immagine usata dalla carta non può essere eliminata dalla mediateca. A destra c'è l'Anteprima con dati di esempio; il selettore mostra come appare la carta in Apple Wallet e in Google Wallet. L'anteprima è indicativa: l'aspetto esatto dipende dal telefono.

Faccia clic su Salva. Le carte che i clienti hanno già installato si aggiorneranno entro pochi minuti.

Aspetto della carta con l'anteprima di Apple Wallet

Anteprima della carta in Google Wallet

Cosa c'è sulla carta

  • Punti e livello: dal conto del cliente nel programma fedeltà.
  • Nome: dagli attributi first_name e last_name.
  • Codice promozionale: l'ultimo codice promozionale personale assegnato al cliente e non ancora utilizzato.
  • Numero carta e codice a barre. Se il profilo ha già un numero di carta fedeltà (l'identificativo loyalty_card, ad esempio dagli scontrini dei negozi fisici), sulla carta Wallet compare lo stesso numero, altrimenti OneTrace.pro emette un nuovo numero di 13 cifre.
  • I campi personalizzati dell'aspetto e l'ultimo messaggio: sul retro della carta.

La carta si aggiorna quando cambiano i punti, il livello, il nome, i campi personalizzati o il codice promozionale. Apple Wallet mostra una notifica sul nuovo saldo, sul livello e sul codice promozionale. Se due profili vengono uniti in uno, le carte passano al profilo che rimane.

La carta viene emessa da un link personale: una pagina sul dominio del Suo brand con i pulsanti Aggiungi a Apple Wallet e Aggiungi a Google Wallet. Per primo compare il pulsante della piattaforma da cui è stata aperta la pagina. Il link è valido 90 giorni, la pagina è nella lingua del profilo.

  • Nelle email e negli altri messaggi: la variabile {{ wallet_url }} (modelli), ad esempio nel percorso di benvenuto del programma fedeltà.
  • Nel centro preferenze: il link Carta fedeltà in Wallet.
  • Nell'area personale del negozio: la richiesta GET /api/v1/profiles/{type}/{value}/wallet con la chiave segreta e il permesso «Lettura dei profili» (chiavi API): il link, la sua scadenza, le piattaforme e le carte del profilo.

Il link compare quando nel progetto c'è un'integrazione «Carte Wallet» attiva con un certificato Apple o una chiave Google.

Messaggi sulla carta

Il canale Carte Wallet funziona nei modelli, nei percorsi e nelle campagne come gli altri canali, con varianti A/B e stati di consegna. Nel modello ci sono il Titolo (l'etichetta del campo sul retro), il Testo e un Link facoltativo; in essi funzionano le variabili.

  • Apple Wallet mostra il testo come notifica e lo lascia sul retro della carta fino al messaggio successivo. Il messaggio è consegnato quando il telefono ha scaricato la carta aggiornata.
  • Google Wallet aggiunge il messaggio alla carta con una notifica. Google mostra al massimo 3 notifiche al giorno per carta.

Il messaggio lo ricevono solo i clienti con una carta installata di questa integrazione. Se la carta non c'è, l'invio termina con l'errore «Il profilo non ha nessuna carta Wallet installata»: usi una condizione o un segmento per scrivere su Wallet solo a chi ha la carta.

Statistiche

Il blocco Statistiche delle carte mostra per ogni piattaforma:

  • Emesse: quante carte sono state create dai link;
  • Installate: quante carte si trovano ora nel Wallet dei clienti;
  • Rimosse: quanti clienti hanno eliminato la carta.

Il grafico sotto mostra installazioni e rimozioni per giorno negli ultimi 30 giorni, nel fuso orario del progetto.

Statistiche delle carte Wallet

Nella scheda del profilo il blocco Carte Wallet mostra le carte del cliente: la piattaforma, il numero della carta e la data in cui la carta è stata installata, rimossa oppure emessa ma non installata.