Auf dieser Seite wird beschrieben, wie Sie Funktionen implementieren, die sich darauf beziehen, wie sich Nutzer mit Google One Tap anmelden oder abmelden.
Nutzer automatisch anmelden
Google One Tap unterstützt die automatische Anmeldung. Dadurch wird die Nutzerfreundlichkeit erhöht, da Nutzer beim erneuten Besuch Ihrer Website keine manuellen Schritte mehr ausführen müssen. Nutzer müssen sich nicht mehr merken, welches Google-Konto sie bei ihrem letzten Besuch ausgewählt haben. So sinkt das Risiko, dass auf Ihrer Plattform unnötige doppelte Konten erstellt werden.
Die automatische Anmeldung ist als Ergänzung für die Schaltfläche „Über Google anmelden“ und „One Tap“ gedacht. Sie kann auf Ihrer gesamten Website verwendet werden. Die manuelle Registrierung oder der Kontowechsel ist nur möglich, wenn sich der Nutzer zuvor von Ihrer Website abgemeldet hat.
Für die automatische Anmeldung müssen die folgenden Bedingungen erfüllt sein:
- Nutzer müssen zuerst in ihrem Google-Konto angemeldet sein und
- zuvor seine Einwilligung zur Weitergabe seines Kontoprofils an Ihre App erteilt hat und
- bei der Verwendung von FedCM in den letzten 10 Minuten nur einen einzigen Anmeldeversuch unternommen hat. „One Tap“ wird angezeigt, wenn in diesem Zeitraum wiederholte Anmeldeversuche erfolgen.
- Wenn Sie FedCM verwenden, müssen die 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 der Nutzer die Website vor dem FedCM-Roll-out genehmigt hat. Diese Änderung kann sich auf die Conversion-Rate Ihrer Website auswirken, auf der One Tap verwendet wird. Im Chrome-Update M121 wurde die automatische Anmeldung verbessert, um das Problem mit dem Rückgang der Conversion-Rate zu beheben.
Wenn die automatische Anmeldung auf Seiten aktiviert ist und diese Bedingungen erfüllt sind, werden die Anmeldedaten des Nutzers in Form eines ID-Tokens automatisch zurückgegeben, ohne dass der Nutzer etwas tun muss. Wenn diese Bedingungen nicht erfüllt sind, wird der Nutzer auch dann, wenn die automatische Anmeldung auf der Seite aktiviert ist, standardmäßig zur Anmeldung oder Einwilligung über die One-Tap-Funktion weitergeleitet. Wenn ein Nutzer mehrere Google-Konten hat und Ihre Website besucht, muss er sich zuerst in einem einzelnen Google-Konto anmelden und seine Einwilligung für dieses Konto gegeben haben.
Sie können die Erfolgsquote der automatischen Anmeldung mithilfe des Werts auto im Feld select_by des zurückgegebenen Anmeldedatenobjekts messen.
Zur Aktivierung der automatischen Anmeldung 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 Aufforderung für Google One Tap angezeigt wird. Für diese Einrichtung muss die automatische Auswahl verboten sein. Andernfalls wird der Nutzer automatisch wieder angemeldet, was zu einem Dead-Loop führt.
FedCM verwenden
Zur Verbesserung der Nutzerfreundlichkeit gibt es zwischen jedem automatischen Anmeldeversuch eine Ruhezeit von 10 Minuten. In diesem Zeitraum wird stattdessen die Aufforderung für die One-Tap-Funktion angezeigt. Nutzer müssen explizit auf „One Tap“ klicken, um sich anzumelden.
Ohne FedCM
Wenn Sie die automatische Auswahl nach der Abmeldung eines Nutzers verhindern möchten, fügen Sie allen Links und Schaltflächen zum Abmelden den Klassennamen g_id_signout hinzu. Hier ein Code-Snippet zur Veranschaulichung:
<div class="g_id_signout">Sign Out</div>
Sie können auch das folgende JavaScript-Code-Snippet verwenden, um sich abzumelden:
const button = document.getElementById('signout_button');
button.onclick = () => {
google.accounts.id.disableAutoSelect();
}
Daher wird der Status „Abgemeldet“ über ein Cookie in Ihrer Domain erfasst, um einen Dead-Loop zu vermeiden.
Der Abmeldestatus wird im g_state-Cookie in Ihrer Domain gespeichert. Wenn Sie einen Dienst haben, der alle in Ihrer Domain verwendeten Cookies überwacht, müssen Sie ihn über dieses Cookie informieren.
Wenn Sie die Clientbibliothek nicht auf Ihren Seiten nach der Anmeldung laden möchten, verwenden Sie diese Lösungen, um eine Dead-Loop-UX nach der Abmeldung zu vermeiden:
- Leiten Sie Nutzer nach der Abmeldung auf eine Seite weiter (z. B.
https://example.com/logged_out), auf der „One Tap“ nicht angezeigt wird oder die automatische Anmeldung immer deaktiviert ist. - Wenn Sie sich abmelden, fügen Sie der URL einen Parameter hinzu. Beispiel:
logged_out=1. Prüfen Sie beim Rendern der One Tap by JavaScript API den URL-Parameter und deaktivieren Sie gegebenenfalls die automatische Anmeldung.
Wichtige Nutzererfahrungen
Die Seite für die automatische Anmeldung.
FedCM verwenden
Nutzer können die One Tap-Aufforderung schließen, indem sie auf die Schaltfläche X klicken. Aus Gründen der Barrierefreiheit wird ein ID-Token auch dann an Ihre Website gesendet, wenn Nutzer auf die Schaltfläche X klicken.
Zur Verbesserung der Nutzerfreundlichkeit gibt es zwischen jedem automatischen Anmeldeversuch eine Ruhezeit von 10 Minuten. In diesem Zeitraum wird stattdessen die Aufforderung für die One-Tap-Funktion angezeigt. Nutzer müssen explizit auf One Tap klicken, um sich anzumelden.
Ohne FedCM
Wenn Nutzer innerhalb von 5 Sekunden nicht auf die Schaltfläche Abbrechen klicken, wird ein ID-Token an Ihre Website gesendet.
Wenn die Anmeldung abgebrochen wird, wird je nach Anzahl der aktiven Google-Sitzungen entweder die Kontoauswahl oder die Seite für wiederkehrende Nutzer angezeigt.
- Mehrere Google-Sitzungen
- Einzelne Google-Sitzungen
