La registrazione e la funzionalità di accesso al programma fedeltà consentono agli utenti di cercare il tuo programma fedeltà e partecipare o accedere al proprio account da Google Wallet. Gli utenti verranno indirizzati al tuo sito web ottimizzato per il mobile per completare la procedura, dopodiché potranno aggiungere la propria carta a Google Wallet.
Questa guida fornisce una panoramica dei passaggi di implementazione necessari per abilitare il tuo programma fedeltà per questa funzionalità.
Panoramica
Per iniziare, assicurati di aver configurato in precedenza il progetto e di poter accedere all'API Google Wallet.
Per implementare la funzionalità di registrazione e accesso per il tuo programma fedeltà, devi seguire questi quattro passaggi:
- Configura un corso di prova in Google Wallet per testare i flussi di registrazione/accesso.
- Sviluppare pagine di registrazione/accesso che utilizzano Google Wallet
SharedDataType. - Implementa il push-back della carta fedeltà su Google Wallet dopo la registrazione/l'accesso.
- Richiedi la verifica e l'attivazione.
Configurare un corso di prova in Google Wallet
Determina gli URL di registrazione e di accesso, il logo del programma e i campi utente selezionati. Quindi, utilizza i campi nidificati discoverableProgram in loyaltyclass per impostare i valori appropriati.
Imposta i valori in discoverableProgram per creare una bozza del programma fedeltà
abilitato all'accesso o alla registrazione. Per assicurarti che sia visibile ai tester, verifica che
i tester abbiano accesso alla tua console Google Pay e Wallet. Per maggiori dettagli su come condividere
l'accesso di Google Pay e Wallet Console con altre persone, consulta
Informazioni sulla pagina Utenti.
Per completare la verifica della funzionalità della tua implementazione durante il processo di sviluppo, contattaci utilizzando il widget Contatta l'assistenza nella console Google Pay e Wallet. Nella console, seleziona API Google Wallet nell'argomento e seleziona Accesso/registrazione al programma fedeltà nell'argomento secondario.
Sviluppare pagine di registrazione e di accesso che utilizzano i dati utente di Google Wallet
Quando un utente sceglie di accedere o iscriversi al tuo programma fedeltà, viene indirizzato a una pagina personalizzata sul tuo sito web al fine di completare la procedura di registrazione o di accesso. Se un utente sceglie di registrarsi, Google Wallet gli chiederà di approvare la condivisione dei suoi dati utente con te.
Devi fornire una delle due pagine o entrambe che consentano agli utenti di completare queste azioni.
- Un URL di accesso da cui un utente può accedere a un account esistente.
- Un URL di registrazione in cui un utente può creare un nuovo account.
Le pagine di accesso e di registrazione devono soddisfare i seguenti requisiti:
- Offri un'esperienza utente ottimizzata per i dispositivi mobili.
- Riduci al minimo il numero di campi obbligatori durante la procedura di registrazione.
- Consenti all'utente di completare l'accesso o la registrazione da un'unica pagina.
- Usa la crittografia
HTTPScon un certificato valido per garantire la trasmissione dei dati utente in modo sicuro. - Assicura un tempo di attività di almeno il 99,9% delle pagine di accesso e registrazione.
Oltre a soddisfare i requisiti di cui sopra, ti consigliamo di consentire agli utenti di iscriversi al tuo programma fedeltà senza compilare alcun modulo o mantenere la pagina accettando solo i Termini di servizio.
- Sfruttando i dati utente forniti in
SharedDataType, puoi creare un account e respingere immediatamente la carta fedeltà. - Successivamente, puoi inviare all'utente un'email con una password monouso o un link per configurare la sua password e i dettagli facoltativi dell'account.
- In questo modo si riduce la possibilità che gli utenti abbandonino il processo di registrazione, poiché ogni passaggio aggiuntivo può comportare ulteriori abbandoni.
Durante la presentazione della pagina di accesso o di registrazione, Google Wallet crea
un componente Android WebView e viene inviata una richiesta di tipo POST all'URL
fornito. I dati utente vengono forniti nel parametro SharedDataType
che è incluso nella richiesta POST utilizzando
il tipo di contenuto
application/x-www-form-urlcoded e la
codifica UTF-8. Il valore del parametro SharedDataType è un oggetto JSON codificato in Base64.
A seconda dell'azione scelta dall'utente e dei campi che hai specificato per richiedere all'utente, l'oggetto JSON potrebbe contenere i seguenti campi.
| Campo | Registrazione | Accesso |
|---|---|---|
| ✓ | ✓ | |
| firstName | ✓ | |
| lastName | ✓ | |
| Riga indirizzo [1-3] | ✓ | |
| city | ✓ | |
| state | ✓ | |
| CAP | ✓ | |
| country | ✓ | |
| telefono | ✓ |
Di seguito è riportato un oggetto JSON di esempio decodificato contenuto in SharedDataType.
Risorsa
{
"firstName": "Jane",
"lastName": "Doe",
"addressLine1": "1600 Amphitheatre Pkwy",
"addressLine2": "Apt 123",
"addressLine3": "Attn:Jane",
"city": "Mountain View",
"state": "CA",
"zipcode": "94043",
"country": "US",
"email": "jane.doe@example.com",
"phone": "555-555-5555"
}
Implementa il ritiro immediato della carta fedeltà su Google Wallet
Una volta autenticata (accesso) o dopo la creazione dell'account (registrazione), la pagina deve immediatamente reinviare la carta fedeltà dell'utente a Google Wallet.
Puoi respingere la carta fedeltà a Google Wallet reindirizzando a un link che segue la struttura riportata di seguito.
https://pay.google.com/gp/v/save/{jwt_generated}
La lunghezza di sicurezza di un URL è di 2000 caratteri. I link devono rimanere al di sotto di questo limite. Gli oggetti codificati in JWT devono essere di piccole dimensioni e contenere solo dati specifici per l'utente. Cerca di mantenere la maggior parte dei dati nella classe dell'oggetto, creandoli prima di creare il JWT. Per gli oggetti più grandi che non soddisfano il limite, valuta la possibilità di creare prima l'oggetto nell'API Google Wallet e di inviare solo l'ID oggetto nel JWT.
Flusso di comunicazione tipico
Il flusso di comunicazione per un utente che completa la registrazione o l'accesso è illustrato nell'immagine seguente. È tua responsabilità implementare tutte le azioni tra "il tuo server".
Richiedi verifica e attivazione
Dopo aver completato il lavoro di sviluppo e testato i flussi di registrazione/accesso, invia una richiesta tramite il widget dell'assistenza di Google Pay e Wallet Console.
Dopo una revisione completa della tua implementazione che confermi la corretta funzionalità in combinazione con l'app Google Wallet, la funzionalità di registrazione/accesso al programma fedeltà verrà lanciata pubblicamente per il tuo programma fedeltà. Ciò consente a qualsiasi utente di vedere il programma e di utilizzare questa funzionalità.
Al fine di garantire un'esperienza utente ottimale, verranno condotti controlli ricorrenti dell'implementazione della registrazione/accesso per garantire la conformità continua ai requisiti delle funzionalità. In caso di discrepanze, riceverai una notifica e la funzionalità di accesso/registrazione potrebbe essere disattivata fino alla risoluzione del problema.
Domande frequenti
- Sono previsti requisiti per le immagini utilizzate nel mio programma fedeltà?
- Sì, le immagini devono essere ospitate nella località
HTTPS, altrimenti non saranno visibili in Google Wallet.
- Sì, le immagini devono essere ospitate nella località
- Esistono strumenti che semplificano l'implementazione e il debug dei JWT?
- Sì, piattaforme come www.jwt.io ti consentono di decodificare ed eseguire il debug dei tuoi token durante il processo di sviluppo, in modo da verificare i contenuti che stai inviando. Tieni presente che Google non ha affiliazione e non consiglia specificamente terze parti di questo tipo.
- Come gestiamo correttamente i dati SharedDataType codificati in Base64?
- Assicurati di utilizzare la codifica UTF-8 durante il processo. La stringa JSON viene prima codificata in UTF-8 e successivamente codificata utilizzando android.util.Base64 con le opzioni NO_WRAP e URL_SAFE. Corrisponde alla sezione 4 di RFC 3548.