Questa pagina descrive come implementare le funzionalità relative alla modalità di accesso o di logout degli utenti con Google One Tap.
Consentire l'accesso automatico degli utenti
Google One Tap supporta l'accesso automatico, che offre un'esperienza utente (UX) senza problemi rimuovendo i passaggi manuali che gli utenti devono svolgere 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. È progettato per essere utilizzato nell'intero sito, con la registrazione manuale o il passaggio da un account all'altro che si verificano solo dopo che l'utente ha eseguito la prima volta la disconnessione 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
- abbia precedentemente concesso il consenso a condividere il profilo del proprio account con la tua app e
- quando utilizzi FedCM, ha effettuato un solo tentativo di accesso negli ultimi 10 minuti. One Tap viene visualizzato quando si verificano tentativi di accesso ripetuti durante questo periodo.
- quando si utilizza FedCM, Chrome richiede agli utenti di confermare di voler 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 che utilizza One Tap. Nell'aggiornamento di Chrome M121, il miglioramento dell'accesso automatico riduce il problema di calo del tasso di conversione.
Per le pagine in cui è attivato l'accesso automatico e se queste condizioni sono soddisfatte, la credenziale token ID dell'utente viene restituita automaticamente senza alcuna interazione da parte dell'utente. Se queste condizioni non sono soddisfatte e anche se l'accesso automatico è attivo sulla pagina, per l'utente viene utilizzato 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 successo dell'accesso automatico utilizzando il valore auto nel
select_by dell'oggetto delle 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 visualizzato automaticamente un prompt di Google One Tap. Per questa configurazione, la selezione automatica deve essere vietata. In caso contrario, l'utente accede di nuovo automaticamente, il che porta a un'esperienza utente inutilizzata.
Utilizzo di FedCM
Per migliorare l'esperienza utente, è previsto un periodo di riposo di 10 minuti tra ogni tentativo di accesso automatico. Durante questo periodo di tempo, viene visualizzata invece la richiesta One Tap. Gli utenti devono fare clic esplicitamente su One Tap per accedere.
Senza FedCM
Per vietare la selezione automatica dopo la disconnessione di un utente, aggiungi il nome della classeg_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>
Il seguente snippet di codice JavaScript può essere utilizzato anche per la disconnessione:
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 per evitare l'esperienza utente con loop infinito.
Lo stato di disconnessione viene memorizzato nel cookie g_state nel tuo dominio. Se hai un servizio che monitora tutti i cookie utilizzati nel tuo dominio, devi comunicargli la presenza di questo cookie.
Se non vuoi caricare la libreria client nelle pagine post-accesso, utilizza queste soluzioni per evitare un'UX con un loop morto dopo l'uscita:
- Al momento dell'uscita, reindirizza gli utenti a una pagina (ad esempio
https://example.com/logged_out) in cui One Tap non viene visualizzato o in cui l'accesso automatico è sempre disattivato. - Al momento della disconnessione, aggiungi un parametro all'URL. Ad esempio,
logged_out=1. Quando esegui il rendering di One Tap tramite l'API JavaScript, controlla il parametro URL e disattiva 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, è previsto un periodo di riposo di 10 minuti tra ogni tentativo di accesso automatico. Durante questo periodo di tempo, viene visualizzato il prompt di One Tap. Gli utenti devono fare clic esplicitamente su One Tap per accedere.
Senza FedCM
Se gli utenti non fanno clic sul pulsante Annulla entro 5 secondi, un token ID viene condiviso con il tuo sito web.
Quando l'accesso viene annullato, in base al numero di sessioni Google attive, viene visualizzata la pagina di scelta dell'account o la pagina dell'utente di ritorno.
- Più sessioni Google
- Sessioni Google singole
