Auf dieser Seite wird beschrieben, wie Sie Funktionen implementieren, die sich darauf beziehen, wie sich Nutzer mit Google One Tap an- oder abmelden.
Nutzer automatisch anmelden
Google One Tap unterstützt die automatische Anmeldung, was eine reibungslose Nutzererfahrung ermöglicht, da die manuellen Schritte entfallen, die Besucher 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. So verringern Sie die Wahrscheinlichkeit, dass unnötige doppelte Konten auf Ihrer Plattform erstellt werden.
Die automatische Anmeldung dient als Ergänzung zu unserer Schaltfläche „Über Google anmelden“ und den One Tap-Dialogfeldern. Sie ist so konzipiert, dass sie auf Ihrer gesamten Website verwendet werden kann. Eine manuelle Registrierung oder ein Kontowechsel erfolgt erst, nachdem sich der Nutzer zuerst von Ihrer Website abgemeldet hat.
Damit die automatische Anmeldung erfolgen kann, sind die folgenden Bedingungen erforderlich:
- Nutzer müssen sich zuerst in ihrem Google-Konto anmelden.
- der Person eingewilligt hat, ihr Kontoprofil für Ihre App freizugeben, und
- bei der Verwendung von FedCM in den letzten 10 Minuten nur einen einzigen Anmeldeversuch unternommen haben. One Tap wird bei wiederholten Anmeldeversuchen während dieses Fensters angezeigt.
Für Seiten, auf denen die automatische Anmeldung aktiviert ist und diese Bedingungen erfüllt sind, werden die Anmeldedaten des Besucher-ID-Tokens automatisch ohne Nutzerinteraktion zurückgegeben. Wenn diese Bedingungen nicht erfüllt sind und die automatische Anmeldung auf der Seite aktiviert ist, verwendet der Nutzer für die Anmeldung oder Einwilligung standardmäßig den One Tap-Ablauf. Wenn ein Nutzer mehrere Google-Konten hat und Ihre Website besucht, muss er sich zuerst in einem einzigen Google-Konto anmelden und diesem Konto zustimmen.
Sie können die Erfolgsquote der automatischen Anmeldung anhand des Werts auto im Feld select_by des zurückgegebenen Berechtigungsobjekts messen.
Um die automatische Anmeldung zu aktivieren, 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 deiner 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 verboten sein. Andernfalls wird der Nutzer automatisch wieder angemeldet, was zu einer Dead-Loop-UX führt.
FedCM verwenden
Um die Nutzererfahrung zu verbessern, ist zwischen jedem automatischen Anmeldeversuch eine 10-minütige Pausierungsperiode geplant. Während dieses Zeitraums wird stattdessen One Tap angezeigt.
Ohne FedCM
Wenn Sie die automatische Auswahl nach der Abmeldung eines Nutzers verhindern möchten, fügen Sie allen Abmeldelinks und -schaltflächen den Klassennamen g_id_signout hinzu. Hier ein Code-Snippet:
<div class="g_id_signout">Sign Out</div>
Das folgende JavaScript-Code-Snippet kann auch zur Abmeldung verwendet werden:
const button = document.getElementById('signout_button');
button.onclick = () => {
google.accounts.id.disableAutoSelect();
}
Der Status der Abmeldung wird über ein Cookie in Ihrer Domain erfasst, um eine Dead-Loop-UX zu vermeiden.
Der Abmeldestatus wird im g_state-Cookie 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 verhindern:
- Leiten Sie Nutzer nach der Abmeldung auf eine Seite (z. B.
https://example.com/logged_out) weiter, 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. Prüfen Sie beim Rendern von One Tap durch die JavaScript API diesen URL-Parameter und deaktivieren Sie gegebenenfalls die automatische Anmeldung.
Wichtige Nutzererfahrungen
Die Seite für die automatische Anmeldeseite
FedCM verwenden
Wenn Nutzer nicht innerhalb von 5 Sekunden auf X klicken, um den Vorgang abzubrechen, wird ein ID-Token mit Ihrer Website geteilt.
Ohne FedCM
Wenn Nutzer nicht innerhalb von 5 Sekunden auf die Schaltfläche Abbrechen klicken, wird ein ID-Token mit Ihrer Website geteilt.
Wenn die Anmeldung abgebrochen wird, wird je nach Anzahl der aktiven Google-Sitzungen entweder die Seite für die Kontoauswahl oder die Seite für wiederkehrende Nutzer angezeigt.
Mehrere Google-Sitzungen
FedCM verwenden
Ohne FedCM
Einzelne Google-Sitzungen
FedCM verwenden
Ohne FedCM
