In questa pagina viene descritto come implementare le funzionalità relative al modo in cui gli utenti accedono o escono con Google One Tap.
Accesso automatico agli utenti
Google One Tap supporta l'accesso automatico, che fornisce un'esperienza utente senza problemi grazie alla rimozione dei passaggi manuali che i visitatori devono eseguire quando tornano al tuo sito. Gli utenti non hanno bisogno di ricordare quale Account Google hanno selezionato durante l'ultima visita, riducendo così le possibilità di creare account duplicati non necessari sulla tua piattaforma.
L'accesso automatico è pensato per integrare le finestre di dialogo Accedi con Google e One Tap. È progettato per essere utilizzato in tutto il sito, con la registrazione manuale o il passaggio da un account a un 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 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 questo periodo.
Per le pagine in cui è abilitato l'accesso automatico e se queste condizioni sono soddisfatte, la credenziale del token ID visitatori viene restituita automaticamente senza alcuna interazione da parte dell'utente. Se queste condizioni non sono soddisfatte e anche se nella pagina è abilitato 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 unico Account Google e aver fornito il consenso per l'account in questione.
Puoi misurare la percentuale di accesso automatico riuscito 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 una richiesta di Google One Tap. Per questa configurazione, la selezione automatica deve essere vietata. In caso contrario, l'accesso dell'utente viene eseguito di nuovo automaticamente, il che comporta un'esperienza utente con un loop morto.
Utilizzo di FedCM
Per migliorare l'esperienza utente, esiste un periodo senza notifiche di 10 minuti tra ogni tentativo di accesso automatico. Durante questo periodo di tempo viene invece visualizzato One Tap.
Senza FedCM
Per vietare la selezione automatica dopo che un utente si è disconnesso, aggiungi il nome del corso
g_id_signout a tutti i link e i pulsanti di uscita. Vedi il seguente snippet di codice:
<div class="g_id_signout">Sign Out</div>
Per l'uscita puoi anche utilizzare 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 che venga evitata l'esperienza utente con loop morto.
Lo stato di disconnessione viene memorizzato nel cookie g_state del tuo dominio. Se hai un servizio che monitora tutti i cookie utilizzati nel tuo dominio, devi informarlo di questo cookie.
Se non vuoi caricare la libreria client nelle pagine successive all'accesso, utilizza queste soluzioni per evitare un'esperienza utente a circuito inattivo 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. Quando esegui il rendering dell'API One Tap by JavaScript, controlla il parametro URL e disattiva l'accesso automatico, se presente.
Percorsi dell'utente chiave
La pagina di accesso automatico.
Utilizzo di FedCM
Se gli utenti non fanno clic sulla X per annullare l'abbonamento entro 5 secondi, viene condiviso un token ID con il tuo sito web.
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 la pagina dell'utente di ritorno.
Più sessioni Google
Utilizzo di FedCM
Senza FedCM
Sessioni Google singole
Utilizzo di FedCM
Senza FedCM
