На этой странице описано, как реализовать функции, связанные с входом и выходом пользователей с помощью Google One Tap.
Автоматический вход пользователей
Google One Tap поддерживает автоматический вход в систему, что обеспечивает удобство работы с пользователем (UX) за счет удаления ручных действий, которые пользователи должны выполнять при возвращении на ваш сайт. Пользователям не нужно помнить, какую учетную запись Google они выбрали во время последнего посещения, что снижает вероятность создания ненужных дубликатов учетных записей на вашей платформе.
Автоматический вход предназначен для дополнения нашей кнопки «Войти с помощью Google» и диалоговых окон «В одно касание». Он предназначен для использования на всем вашем сайте, при этом ручная регистрация или переключение учетных записей происходит только после того, как пользователь впервые вышел из вашего сайта.
Для автоматического входа в систему необходимы следующие условия:
- пользователи должны сначала войти в свою учетную запись Google, и
- ранее предоставленное согласие на передачу профиля своей учетной записи в ваше приложение, и
- при использовании FedCM предпринял только одну попытку входа в систему за последние 10 минут. Функция One Tap отображается, когда в этом окне происходят повторные попытки входа.
- при использовании FedCM Chrome требует, чтобы пользователи повторно подтверждали, что они хотят войти на веб-сайт с учетной записью Google в каждом экземпляре Chrome, даже если пользователь одобрил веб-сайт до развертывания FedCM. Это изменение может повлиять на коэффициент конверсии на вашем существующем сайте, использующем One Tap. В обновлении Chrome M121 улучшение автоматического входа смягчает проблему падения коэффициента конверсии.
Для страниц, на которых включен автоматический вход, и если эти условия соблюдены, учетные данные токена идентификатора пользователя автоматически возвращаются без какого-либо взаимодействия с пользователем. Если эти условия не выполняются и даже если на странице включен автоматический вход, пользователь по умолчанию использует процесс «Одно касание» для входа или согласия. Если у пользователя есть несколько учетных записей 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
Пользователи могут закрыть приглашение One Tap, нажав кнопку X. В целях обеспечения доступности токен идентификатора передается на ваш веб-сайт, даже если пользователи нажимают кнопку X.
Чтобы улучшить взаимодействие с пользователем, между каждой попыткой автоматического входа в систему устанавливается 10-минутный период молчания. В течение этого периода времени вместо этого отображается подсказка One Tap. Пользователям необходимо явно щелкнуть «Одно касание», чтобы войти в систему.
Без FedCM
Если пользователи не нажмут кнопку «Отмена» в течение 5 секунд, токен идентификатора будет передан на ваш сайт.
При отмене входа в систему в зависимости от количества активных сеансов Google отображается либо страница выбора учетной записи, либо страница возвращающегося пользователя.
- Несколько сеансов Google
- Одиночные сеансы Google
