La funzionalità di registrazione (accesso) delle carte regalo consente agli utenti di cercare una carta regalo e aggiungerla a 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 della procedura di implementazione necessaria per attivare il programma di carte regalo per questa funzionalità.
Panoramica
Per iniziare, assicurati di aver configurato in precedenza il progetto e di avere accesso all'API Google Wallet.
Per implementare la funzionalità di accesso per il tuo programma fedeltà con carte regalo, devi seguire questi quattro passaggi:
- Configura un corso di prova in Google Wallet per testare il flusso di accesso.
- Sviluppare pagine di accesso che utilizzano Google Wallet
SharedDataType. - Implementare il push back della carta regalo su Google Wallet dopo l'accesso.
- Richiedi la verifica e l'attivazione.
Configurare una classe di test in Google Wallet
Determina l'URL di accesso e il logo del programma. Quindi,
utilizza i campi nidificati discoverableProgram in
giftcardclass per impostare i valori appropriati.
Imposta i valori in discoverableProgram per creare una versione di bozza del tuo programma di carte regalo abilitato all'accesso. Per assicurarti che sia visibile ai tester, verifica che questi abbiano accesso a Google Pay e alla Console Wallet. Per informazioni dettagliate su come condividere l'accesso a Google Pay e Wallet Console con altre persone, consulta Informazioni sulla pagina Utenti.
Per completare la verifica della funzionalità dell'implementazione durante il processo di sviluppo, contattaci utilizzando il widget di contatto dell'assistenza in Google Pay e Wallet Console. Nella console, seleziona API Google Wallet nell'argomento e Accesso con carta regalo nel sottoargomento.
Sviluppare una pagina di accesso che utilizza i dati utente di Google Wallet
Quando un utente sceglie di aggiungere la tua carta regalo, viene indirizzato a una pagina personalizzata sul tuo sito web per completare la procedura di accesso.
Devi fornire un URL di accesso in cui un utente possa accedere a un account esistente.
La pagina di accesso deve soddisfare i seguenti requisiti:
- Offri un'esperienza utente ottimizzata per il mobile.
- Consenti all'utente di completare l'accesso in una sola pagina.
- Utilizza la crittografia
HTTPScon un certificato valido per garantire che i dati utente vengano trasmessi in sicurezza. - Assicurati un tempo di attività della pagina di accesso di almeno il 99,9%.
Quando viene presentata la pagina di accesso, Google Wallet crea un WebView Android e viene inviata una richiesta POST all'URL fornito. I dati utente vengono forniti nel parametro SharedDataType, incluso nella richiesta POST utilizzando il tipo di contenuto
application/x-www-form-urlencoded e la codifica UTF-8. Il valore del parametro SharedDataType
è un oggetto JSON con codifica base64.
Implementare il push back immediato della carta regalo su Google Wallet
Una volta autenticato (accesso), la tua pagina dovrebbe spingere immediatamente la carta regalo dell'utente su Google Wallet.
Puoi ritrasferire la carta regalo su Google Wallet reindirizzando a un link che segue la struttura
https://pay.google.com/gp/v/save/{jwt_generated}
La lunghezza sicura per un URL è di 2000 caratteri. I tuoi link devono rimanere al di sotto di questo limite. Gli oggetti codificati nei JWT devono essere di piccole dimensioni e contenere solo dati specifici per l'utente. Cerca di conservare la maggior parte dei dati nella classe dell'oggetto, creandoli prima di generare il JWT. Per gli oggetti più grandi che non rispettano il limite, ti consigliamo 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 l'accesso è illustrato nella seguente immagine. L'implementazione di tutte le azioni tra "Il tuo server" è di tua responsabilità.
Richiedi verifica e attivazione
Una volta completato il lavoro di sviluppo e testato il flusso di accesso, invia una richiesta tramite il widget di assistenza per contattare Google Pay e Wallet Console.
Dopo un'attenta revisione dell'implementazione che conferma la funzionalità corretta in combinazione con l'app Google Wallet, la funzionalità di accesso con carta regalo verrà lanciata pubblicamente per il tuo programma di carte regalo. In questo modo, qualsiasi utente potrà vedere il programma e utilizzare questa funzionalità.
Per garantire un'esperienza utente ottimale, verranno eseguiti controlli periodici dell'implementazione di Accesso per garantire la conformità continua ai requisiti della funzionalità. Riceverai una notifica in caso di discrepanze e la funzionalità di accesso potrebbe essere disattivata finché il problema non sarà risolto.
Domande frequenti
- Ci sono dei requisiti per le immagini utilizzate nel mio programma di carte regalo?
- Sì, le immagini devono essere ospitate nella posizione
HTTPSperché altrimenti non saranno visibili in Google Wallet.
- Sì, le immagini devono essere ospitate nella posizione
- Esistono strumenti che semplificano l'implementazione e il debug dei JWT?
- Sì, piattaforme come www.jwt.io ti consentono di decodificare e eseguire il debug dei token durante il processo di sviluppo, in modo da verificare i contenuti che invii. Tieni presente che Google non ha alcuna affiliazione e non consiglia specificamente nessuna di queste terze parti.
- Come gestiamo correttamente i dati di SharedDataType con codifica Base64?
- Assicurati di utilizzare la codifica UTF-8 durante l'intera procedura. La stringa JSON viene prima codificata in UTF-8 e successivamente utilizzando android.util.Base64 con le opzioni NO_WRAP e URL_SAFE. Questo corrisponde alla sezione 4 della RFC 3548.