In questa pagina viene descritto come implementare le funzionalità relative al modo in cui gli utenti accedono o esci con Google One Tap.
Consentire l'accesso automatico degli utenti
Google One Tap supporta l'accesso automatico, che offre un'esperienza utente (UX) fluida eliminando i passaggi manuali che gli utenti devono eseguire quando tornano sul tuo sito. Gli utenti non devono ricordare quale Account Google hanno selezionato durante l'ultima visita, diminuendo le possibilità che sulla piattaforma vengano creati account duplicati non necessari.
L'accesso automatico è pensato per integrare le finestre di dialogo Accedi con Google e il pulsante Accedi con Google. È progettata per essere utilizzata in tutto il sito, con la registrazione manuale o il passaggio da un account all'altro solo dopo che l'utente si è disconnesso per la prima volta dal sito.
Affinché l'accesso automatico si verifichi, sono necessarie le seguenti condizioni:
- gli utenti devono prima aver eseguito l'accesso al proprio Account Google e
- ha concesso in precedenza il consenso a condividere il profilo del suo account con la tua app e
- quando utilizza FedCM, ha effettuato un solo tentativo di accesso negli ultimi 10 minuti. Un tocco viene visualizzato quando si verificano ripetuti tentativi di accesso durante questa finestra.
- Quando utilizza FedCM, Chrome richiede agli utenti di riconfermare che vogliono accedere al sito web con l'Account Google in ogni istanza di Chrome, anche se l'utente ha approvato il sito web prima dell'implementazione di FedCM. Questa modifica potrebbe influire sul tasso di conversione sul tuo sito esistente con One Tap. Nell'aggiornamento di Chrome M121, il miglioramento dell'accesso automatico attenua il problema di calo del tasso di conversione.
Per le pagine in cui l'accesso automatico è abilitato e se queste condizioni sono soddisfatte, la credenziale del token ID dell'utente viene restituita automaticamente senza alcuna interazione dell'utente. Se queste condizioni non vengono soddisfatte, e anche se nella pagina è attivato l'accesso automatico, l'utente utilizza per impostazione predefinita il flusso One Tap per l'accesso o il consenso. Se un utente ha più Account Google e visita il tuo sito, deve prima accedere a un singolo Account Google e avere fornito il consenso per l'account in questione.
Puoi misurare la percentuale di accesso automatico utilizzando il valore auto nel campo select_by dell'oggetto credenziali restituito.
Per attivare l'accesso automatico, aggiungi data-auto_select="true" al tuo codice, come mostrato nel seguente snippet:
<div id="g_id_onload"
data-client_id="YOUR_GOOGLE_CLIENT_ID"
data-login_uri="https://your.domain/your_login_endpoint"
data-auto_select="true">
</div>
Esci
Quando un utente esce dal tuo sito web, può essere indirizzato a una pagina in cui viene visualizzata automaticamente la richiesta di Google One Tap. Per questa configurazione, la selezione automatica deve essere vietata. In caso contrario, l'utente accederà di nuovo automaticamente, il che genera un'esperienza utente con un loop morto.
Utilizzo di FedCM
Per migliorare l'esperienza utente, c'è un periodo senza notifiche di 10 minuti tra un tentativo di accesso automatico e l'altro. Durante questo periodo di tempo, viene visualizzata invece la richiesta One Tap. Per accedere, gli utenti devono fare clic esplicitamente su One Tap.
Senza FedCM
Per impedire la selezione automatica dopo che un utente è uscito, aggiungi il nome della classe
g_id_signout a tutti i link e i pulsanti di disconnessione. Vedi il seguente snippet di codice:
<div class="g_id_signout">Sign Out</div>
Per uscire, puoi utilizzare anche il seguente snippet di codice JavaScript:
const button = document.getElementById('signout_button');
button.onclick = () => {
google.accounts.id.disableAutoSelect();
}
Di conseguenza, lo stato di disconnessione viene registrato tramite un cookie nel tuo dominio, in modo da evitare l'UX con un loop morto.
Lo stato di disconnessione viene memorizzato nel cookie g_state nel tuo dominio. Se disponi di un servizio che monitora tutti i cookie utilizzati nel tuo dominio, devi informarli di questo cookie.
Se non vuoi caricare la libreria client nelle pagine post-accesso, utilizza queste soluzioni per evitare un ciclo UX dopo l'uscita:
- All'uscita, reindirizza gli utenti a una pagina, ad esempio
https://example.com/logged_out, in cui One Tap non è visualizzato o in cui l'accesso automatico è sempre disattivato. - All'uscita, aggiungi un parametro all'URL. Ad esempio,
logged_out=1. Durante il rendering dell'API One Tap by JavaScript, controlla il parametro URL e disabilita l'accesso automatico, se presente.
Percorsi chiave degli utenti
La pagina di accesso automatico.
Utilizzo di FedCM
Gli utenti possono chiudere la richiesta di One Tap facendo clic sul pulsante X. Per motivi di accessibilità, un token ID viene condiviso con il tuo sito web anche se gli utenti fanno clic sul pulsante X.
Per migliorare l'esperienza utente, c'è un periodo senza notifiche di 10 minuti tra un tentativo di accesso automatico e l'altro. Durante questo periodo di tempo, viene visualizzata invece la richiesta One Tap. Per accedere, gli utenti devono fare clic esplicitamente su One Tap.
Senza FedCM
Se gli utenti non fanno clic sul pulsante Annulla entro 5 secondi, viene condiviso un token ID con il tuo sito web.
Quando l'accesso viene annullato, in base al numero di sessioni Google attive, viene visualizzata la pagina del selettore account o quella dell'utente di ritorno.
- Più sessioni Google
- Sessioni Google singole
