На этой странице описано, как реализовать функции, связанные с входом и выходом пользователей с помощью Google One Tap.
Автоматический вход пользователей
Google One Tap поддерживает автоматический вход в систему, что обеспечивает удобство взаимодействия с пользователем (UX) за счет удаления ручных действий, которые посетители должны выполнять при возвращении на ваш сайт. Пользователям не нужно помнить, какую учетную запись Google они выбрали во время последнего посещения, что снижает вероятность создания ненужных дубликатов учетных записей на вашей платформе.
Автоматический вход предназначен для дополнения нашей кнопки «Войти с помощью Google» и диалоговых окон «В одно касание». Он предназначен для использования на всем вашем сайте, при этом ручная регистрация или переключение учетных записей происходит только после того, как пользователь впервые вышел из вашего сайта.
Для автоматического входа в систему необходимы следующие условия:
- пользователи должны сначала войти в свою учетную запись Google, и
- ранее предоставленное согласие на передачу профиля своей учетной записи в ваше приложение, и
- при использовании FedCM предпринял только одну попытку входа в систему за последние 10 минут. Функция One Tap отображается, когда в этом окне происходят повторные попытки входа.
Для страниц, на которых включен автоматический вход, и если эти условия соблюдены, учетные данные токена идентификатора посетителя автоматически возвращаются без какого-либо взаимодействия с пользователем. Если эти условия не выполняются и даже если на странице включен автоматический вход, пользователь по умолчанию использует процесс «Одно касание» для входа или согласия. Если у пользователя есть несколько учетных записей Google и он посещает ваш сайт, ему необходимо сначала войти в одну учетную запись Google и предоставить согласие для этой учетной записи.
Вы можете измерить показатель успешного автоматического входа в систему, используя значение auto в поле select_by возвращаемого объекта учетных данных.
Чтобы включить автоматический вход, добавьте data-auto_select="true" в свой код, как показано в следующем фрагменте:
<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>
выход
Когда пользователь выходит из вашего веб-сайта, он может быть перенаправлен на страницу, где автоматически отображается приглашение Google One Tap. Для этой настройки автоматический выбор должен быть запрещен. В противном случае пользователь снова автоматически войдет в систему, что приведет к зацикливанию пользовательского интерфейса.
Использование FedCM
Для улучшения пользовательского опыта между каждой попыткой автоматического входа в систему устанавливается 10-минутный период молчания. В этот период времени вместо него отображается One Tap.
Без FedCM
Чтобы запретить автоматический выбор после выхода пользователя, добавьте имя класса g_id_signout ко всем ссылкам и кнопкам выхода из системы. См. следующий фрагмент кода:
<div class="g_id_signout">Sign Out</div>
Следующий фрагмент кода JavaScript также можно использовать для выхода:
const button = document.getElementById('signout_button');
button.onclick = () => {
google.accounts.id.disableAutoSelect();
}
Следовательно, статус выхода из системы записывается с помощью файла cookie в вашем домене, чтобы избежать тупиковой ситуации в пользовательском интерфейсе.
Статус выхода сохраняется в файле cookie g_state в вашем домене. Если у вас есть служба, которая отслеживает все файлы cookie, используемые в вашем домене, вам необходимо уведомить их об этих файлах cookie.
Если вы не хотите загружать клиентскую библиотеку на страницы после входа в систему, используйте эти решения, чтобы предотвратить зацикливание пользовательского интерфейса после выхода из системы:
- При выходе из системы перенаправляйте пользователей на страницу (скажем,
https://example.com/logged_out), где One Tap не отображается или где автоматический вход всегда отключен. - При выходе из системы добавьте параметр к URL-адресу. Например,
logged_out=1. При отрисовке API One Tap с помощью JavaScript проверьте этот параметр URL-адреса и отключите автоматический вход, если он присутствует.
Ключевые пути пользователя
Страница автоматического входа.
Использование FedCM
Если пользователи не нажмут X для отмены в течение 5 секунд, токен идентификатора будет передан на ваш сайт.
Без FedCM
Если пользователи не нажмут кнопку «Отмена» в течение 5 секунд, токен идентификатора будет передан на ваш сайт.
При отмене входа в систему в зависимости от количества активных сеансов Google отображается либо страница выбора учетной записи, либо страница возвращающегося пользователя.
Несколько сеансов Google
Использование FedCM
Без FedCM
Отдельные сеансы Google
Использование FedCM
Без FedCM
