Auf dieser Seite wird beschrieben, wie Sie Funktionen im Zusammenhang mit der Anmeldung oder Abmeldung von Nutzern mit Google One Tap implementieren.
Nutzer automatisch anmelden
Google One Tap unterstützt die automatische Anmeldung. Dadurch wird die Nutzerfreundlichkeit verbessert, da Nutzer keine manuellen Schritte ausführen müssen, wenn sie zu Ihrer Website zurückkehren. Nutzer müssen sich nicht merken, welches Google-Konto sie bei ihrem letzten Besuch ausgewählt haben. Dadurch sinkt die Wahrscheinlichkeit, dass unnötige doppelte Konten auf deiner Plattform erstellt werden.
Die automatische Anmeldung soll den Button „Über Google anmelden“ und die One Tap-Dialogfelder ergänzen. Sie ist für die Verwendung auf der gesamten Website konzipiert. Eine manuelle Anmeldung oder ein Kontowechsel ist erst möglich, nachdem sich der Nutzer von Ihrer Website abgemeldet hat.
Für die automatische Anmeldung müssen die folgenden Bedingungen erfüllt sein:
- Nutzer müssen in ihrem Google-Konto angemeldet sein und
- zuvor die Einwilligung zur Weitergabe seines Kontoprofils an Ihre App erteilt hat und
- bei Verwendung von FedCM in den letzten 10 Minuten nur einen einzigen Anmeldeversuch unternommen haben. Die One-Tap-Anmeldung wird angezeigt, wenn während dieses Zeitfensters wiederholte Anmeldeversuche erfolgen.
- Bei der Verwendung von FedCM müssen Nutzer in Chrome in jeder Chrome-Instanz noch einmal bestätigen, dass sie sich mit ihrem Google-Konto auf der Website anmelden möchten, auch wenn sie die Website vor der Einführung von FedCM genehmigt haben. Diese Änderung kann sich auf die Conversion-Rate auf Ihrer bestehenden Website auswirken, auf der One Tap verwendet wird. Im Chrome-Update M121 wird das Problem mit dem Rückgang der Conversion-Rate durch die Verbesserung der automatischen Anmeldung behoben.
Auf Seiten, auf denen die automatische Anmeldung aktiviert ist, und wenn diese Bedingungen erfüllt sind, werden die ID-Token-Anmeldedaten des Nutzers automatisch ohne Nutzerinteraktion zurückgegeben. Wenn diese Bedingungen nicht erfüllt sind, wird der Nutzer standardmäßig zur One Tap-Anmeldung oder -Zustimmung weitergeleitet, auch wenn die automatische Anmeldung auf der Seite aktiviert ist. Wenn ein Nutzer mehrere Google-Konten hat und Ihre Website besucht, muss er sich zuerst in einem Google-Konto anmelden und seine Einwilligung für dieses Konto erteilen.
Sie können die Erfolgsquote der automatischen Anmeldung mit dem Wert auto im Feld select_by des zurückgegebenen CredentialResponse-Objekts messen, wenn Sie die Antwort in einem JavaScript-Callback (callback oder data-callback) verarbeiten.
select_by ist nicht in HTTP-POST-Anfragen enthalten, die an login_uri oder data-login_uri gesendet werden.
Wenn Sie die automatische Anmeldung aktivieren möchten, fügen Sie Ihrem Code data-auto_select="true" hinzu, wie im folgenden Snippet gezeigt:
<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>
Abmelden
Wenn sich ein Nutzer von Ihrer Website abmeldet, kann er auf eine Seite weitergeleitet werden, auf der automatisch eine Google One Tap-Aufforderung angezeigt wird. Für diese Einrichtung muss die automatische Auswahl deaktiviert werden. Andernfalls wird der Nutzer automatisch wieder angemeldet, was zu einer Endlosschleife führt.
FedCM verwenden
Um die Nutzerfreundlichkeit zu verbessern, gibt es zwischen jedem automatischen Anmeldeversuch eine 10-minütige Ruhezeit. Während dieses Zeitraums wird stattdessen die One Tap-Aufforderung angezeigt. Nutzer müssen explizit auf „One Tap“ klicken, um sich anzumelden.
Ohne FedCM
Wenn Sie die automatische Auswahl nach dem Abmelden eines Nutzers verhindern möchten, fügen Sie allen Abmeldelinks und -schaltflächen den Klassennamen g_id_signout hinzu. Hier ein Code-Snippet zur Veranschaulichung:
<div class="g_id_signout">Sign Out</div>
Das folgende JavaScript-Code-Snippet kann ebenfalls für die Abmeldung verwendet werden:
const button = document.getElementById('signout_button');
button.onclick = () => {
google.accounts.id.disableAutoSelect();
}
Damit es nicht zu einer Endlosschleife kommt, wird der Abmeldestatus des Nutzers in einem Cookie namens g_state gespeichert, das von der Google Identity Services-Bibliothek festgelegt wird. Standardmäßig ist die Cookie-Domain auf die Domain der aktuellen Seite festgelegt. Wenn One Tap auf der übergeordneten Domain und den Subdomains angezeigt wird, muss das Status-Cookie auf allen Ihren Domains sichtbar sein. Verwenden Sie das Attribut data-state_cookie_domain, um die Cookie-Domain g_state auf Ihre übergeordnete Domain festzulegen. Fügen Sie beispielsweise data-state_cookie_domain="example.com" zum g_id_onload-Element für eine übergeordnete Domain von example.com und eine Subdomain mit dem Namen webapp.example.com hinzu.
Wenn Sie einen Dienst haben, der alle in Ihrer Domain verwendeten Cookies überwacht, müssen Sie ihn über das g_state-Cookie informieren.
Wenn Sie die Clientbibliothek nicht auf Ihren Seiten nach der Anmeldung laden möchten, können Sie die folgenden Lösungen verwenden, um eine Endlosschleife nach der Abmeldung zu verhindern:
- Leite Nutzer bei der Abmeldung auf eine Seite weiter (z. B.
https://example.com/logged_out), auf der One Tap nicht angezeigt wird oder auf der die automatische Anmeldung immer deaktiviert ist. - Fügen Sie der URL bei der Abmeldung einen Parameter hinzu. Beispiel:
logged_out=1. Wenn Sie One Tap über die JavaScript API rendern, prüfen Sie diesen URL-Parameter und deaktivieren Sie die automatische Anmeldung, falls vorhanden.
Wichtige User Journeys
Die Seite für die automatische Anmeldung.
FedCM verwenden
Nutzer können die One Tap-Aufforderung schließen, indem sie auf das X klicken. Aus Gründen der Barrierefreiheit wird ein ID-Token mit Ihrer Website geteilt, auch wenn Nutzer auf die Schaltfläche X klicken.
Um die Nutzerfreundlichkeit zu verbessern, gibt es zwischen jedem automatischen Anmeldeversuch eine 10-minütige Ruhezeit. Während dieses Zeitraums wird stattdessen die One Tap-Aufforderung angezeigt. Nutzer müssen explizit auf „One Tap“ klicken, um sich anzumelden.
Ohne FedCM
Wenn Nutzer nicht innerhalb von 5 Sekunden auf den Button Abbrechen klicken, wird ein ID-Token an deine Website weitergegeben.
Wenn die Anmeldung abgebrochen wird, wird je nach Anzahl der aktiven Google-Sitzungen entweder die Seite zur Kontoauswahl oder die Seite für wiederkehrende Nutzer angezeigt.
- Mehrere Google-Sitzungen
- Einzelne Google-Sitzungen
