In questa pagina viene descritto come implementare le funzionalità relative al modo in cui gli utenti accedono o escono da Google One Tap.
Consentire l'accesso automatico agli utenti
Google One Tap supporta l'accesso automatico, che fornisce un'esperienza utente (UX) senza problemi rimuovendo i passaggi manuali che i visitatori devono eseguire quando tornano sul tuo sito. Gli utenti non devono ricordare quale Account Google hanno selezionato durante l'ultima visita, riducendo le possibilità che vengano creati account duplicati non necessari sulla piattaforma.
L'accesso automatico ha lo scopo di integrare le nostre 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 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:
- l'utente deve prima accedere al proprio Account Google e
- hanno precedentemente acconsentito a condividere il profilo del loro account con la tua app.
Per le pagine in cui è abilitata l'accesso automatico e se queste condizioni sono soddisfatte, le credenziali per il token ID visitatore vengono restituite automaticamente senza interazione da parte dell'utente. Se queste condizioni non sono soddisfatte e anche se l'Accesso automatico è attivato nella pagina, l'utente usa per impostazione predefinita il flusso One Tap per l'accesso o per il consenso. Se un utente ha più Account Google e visita il tuo sito, dovrà prima accedere a un singolo Account Google e aver dato il proprio consenso.
Puoi misurare la percentuale di successo dell'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 codice, come mostrato nel seguente snippet:
<div id="g_id_onload"
data-client_id="YOUR_GOOGLE_CLIENT_ID"
data-auto_select="true"
data-login_uri="https://your.domain/your_login_endpoint">
</div>
Esci
Quando un utente esce dal tuo sito web, può essere indirizzato a una pagina in cui viene visualizzato automaticamente un messaggio di Google One Tap. Per questa configurazione, la selezione automatica deve essere vietata. In caso contrario, l'utente accede di nuovo automaticamente, il che comporta un'esperienza utente senza risposta.
Per impedire 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 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 dominio in modo da evitare l'esperienza utente con loop inattivi.
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 informarli della presenza di questo cookie.
Se non vuoi caricare la libreria client nelle pagine post-accesso, puoi utilizzare alcune soluzioni semplici come indicato di seguito per evitare che l'esperienza utente offline non funzioni correttamente al momento della disconnessione.
- Quando esci, reindirizza gli utenti a una pagina (ad esempio
https://example.com/logged_out) in cui la funzionalità One Tap non viene visualizzata oppure l'accesso automatico è sempre disattivato. - Al momento dell'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, se presente, disattiva l'accesso automatico.
Principali percorsi dell'utente
La pagina di accesso automatico.
Se gli utenti non fanno clic sul pulsante Annulla entro 5 secondi, un token ID viene condiviso con il tuo sito web.
Quando l'opzione Accedi viene annullata, in base al numero di sessioni Google attive, viene visualizzata la pagina selettore account o la pagina utente di ritorno.
Più sessioni Google
Sessioni Google singole
