La funzionalità di registrazione e accesso al programma fedeltà consente agli utenti di cercare il tuo programma fedeltà e partecipare o accedere al suo account da Google Wallet. Gli utenti verranno indirizzati al tuo sito web ottimizzato per il mobile per completare la , dopodiché potrà aggiungere la carta a Google Wallet.
Questa guida fornisce una panoramica dei passaggi di implementazione richiesti per attivare il tuo programma fedeltà per questa funzionalità.
Panoramica
Per iniziare, assicurati di aver già configurato il tuo progetto e di avere accesso API Google Wallet.
Per implementare la funzionalità di registrazione e accesso, devi seguire questi quattro passaggi per il tuo programma fedeltà:
- Configura un corso di prova in Google Wallet per testare i flussi di registrazione/accesso.
- Sviluppa pagine di registrazione/accesso che utilizzino Google Wallet
SharedDataType
. - Implementa il respingimento della carta fedeltà a Google Wallet dopo la registrazione/l'accesso.
- Richiedi la verifica e l'attivazione.
Impostare un corso di prova in Google Wallet
Determina gli URL di registrazione e accesso, il logo del programma e i campi utente scelti. Poi,
utilizza i campi nidificati discoverableProgram
nella
loyaltyclass
per impostare
i valori appropriati.
Imposta i valori in discoverableProgram
per creare una versione bozza del tuo
programma fedeltà abilitato per registrazione/accesso. Per assicurarti che sia visibile ai tester, verifica che
I tester hanno accesso a Google Pay e alla tua console Wallet. Per i dettagli su come condividere
Accesso a Google Pay e alla console Wallet con altre persone; consulta
Scopri di più sulla pagina Utenti.
Completare la verifica della funzionalità dell'implementazione durante lo sviluppo contattaci utilizzando il widget Contatta l'assistenza in Google Pay e Wallet Console. Mentre sei Nella console, seleziona API Google Wallet nell'argomento e poi Accesso/registrazione al programma fedeltà in l'argomento secondario.
Sviluppare pagine di registrazione e di accesso che utilizzino i dati degli utenti di Google Wallet
Quando un utente sceglie di accedere o di iscriversi al tuo programma fedeltà, vengono indirizzati a una pagina personalizzata sul tuo sito web per completare la procedura di registrazione o di accesso. Se un utente sceglie di registrarsi, Google Wallet chiederà all'utente di approvare la condivisione dei suoi dati utente con te.
Devi fornire una delle due pagine, o entrambe, che consentono agli utenti di completare queste azioni.
- Un URL di accesso tramite il quale 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 il processo di registrazione.
- Consenti all'utente di completare l'accesso o la registrazione in un'unica pagina.
- Usa la crittografia di
HTTPS
con un certificato valido per assicurarti che i dati utente vengano trasmessi in modo sicuro. - Garantisci un tempo di attività di almeno il 99,9% delle pagine di accesso e di registrazione.
Oltre ai requisiti sopra riportati, ti consigliamo di consentire agli utenti di iscriversi al programma fedeltà senza compilare alcun modulo o e mantenere la pagina accettata solo con 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 via email una password monouso o un link per configurare la password e i dettagli facoltativi dell'account.
- In questo modo si riduce la possibilità che gli utenti abbandonino la procedura di registrazione poiché ogni passaggio aggiuntivo può portare a un ulteriore abbandono.
Quando presenti la pagina di accesso o di registrazione, Google Wallet crea
viene fatta una richiesta Android WebView e POST
all'indirizzo fornito
URL. I dati utente vengono forniti nel parametro SharedDataType
incluso nella richiesta POST
utilizzando
il tipo di contenuti application/x-www-form-urlEncoding e
UTF-8
. Il valore dell'attributo SharedDataType
è un oggetto JSON codificato in Base64.
A seconda dell'azione scelta dall'utente e dei campi specificati da richiedere all'utente, l'oggetto JSON può contenere i seguenti campi.
Campo | Registrazione |
---|---|
✓ | |
firstName | ✓ |
lastName | ✓ |
Rigaindirizzo [1-3] | ✓ |
city | ✓ |
stato | ✓ |
codice postale | ✓ |
country | ✓ |
telefono | ✓ |
Fai riferimento a quanto segue per 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 respingimento immediato della carta fedeltà su Google Wallet
Dopo l'autenticazione (accesso) o dopo la creazione dell'account (registrazione), la tua pagina deve respingere immediatamente la carta fedeltà dell'utente a Google Wallet.
Puoi respingere la carta fedeltà a Google Wallet reindirizzando a un che segue la struttura di seguito.
https://pay.google.com/gp/v/save/{jwt_generated}
La lunghezza di sicurezza di un URL è di 2000 caratteri. I link devono rimangono al di sotto di questo limite. Gli oggetti codificati in JWT devono essere di piccole dimensioni e contenere solo specifici dell'utente. Cerca di conservare la maggior parte dei dati nella classe dell'oggetto, prima di creare il JWT. Per gli oggetti più grandi che non rientrano nel limite, considera a creare prima l'oggetto API Google Wallet e inviando 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 in nell'immagine che segue. Tutte le azioni tra "Il tuo server" la cui implementazione è di tua responsabilità.
Richiedi verifica e attivazione
Dopo aver completato il lavoro di sviluppo e testato i flussi di registrazione/accesso, invia una richiesta tramite Google Pay e Console Wallet contatta l'assistenza widget.
Dopo un'analisi completa dell'implementazione che ha confermato il corretto funzionamento in in combinazione con l'app Google Wallet, la funzionalità di registrazione/accesso al programma fedeltà sarà lanciate pubblicamente per il tuo programma fedeltà. In questo modo qualsiasi utente potrà visualizzare programma e utilizzare questa funzionalità.
Per garantire un'esperienza utente ottimale, controlli ricorrenti della registrazione/dell'accesso per garantire la conformità continua ai requisiti delle funzionalità. Riceverai una notifica in caso di discrepanze e in caso di problemi con la funzionalità di accesso/registrazione potrebbe essere disattivato finché il problema non verrà risolto.
Domande frequenti
- Esistono requisiti per le immagini utilizzate nel mio programma fedeltà?
- Sì, le immagini devono essere ospitate in
HTTPS
posizione in quanto non saranno visibili in Google Wallet.
- Sì, le immagini devono essere ospitate in
- Esistono strumenti che semplificano l'implementazione e il debug dei JWT?
- Sì, piattaforme come www.jwt.io ti consente di decodificare ed eseguire il debug dei token durante il processo di sviluppo, consentendoti di verificare contenuti che stai inviando. Tieni presente che Google non ha alcuna affiliazione e non consigliano espressamente queste terze parti.
- Come gestiamo correttamente i dati SharedDataType codificati in Base64?
- Assicurati di utilizzare la codifica UTF-8 durante l'intero 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. Ciò corrisponde a RFC 3548, sezione 4.