Trang này mô tả cách triển khai các tính năng liên quan đến cách người dùng đăng nhập hoặc đăng xuất bằng tính năng Một lần nhấn của Google.
Tự động đăng nhập người dùng
Tính năng Một lần chạm của Google hỗ trợ chế độ tự động đăng nhập, giúp mang lại trải nghiệm liền mạch cho người dùng bằng cách loại bỏ các bước thủ công mà người dùng phải thực hiện khi quay lại trang web của bạn. Người dùng không cần nhớ Tài khoản Google mà họ đã chọn trong lần truy cập gần đây nhất, nhờ đó giảm khả năng tạo các tài khoản trùng lặp không cần thiết trên nền tảng của bạn.
Tính năng tự động đăng nhập được thiết kế để bổ sung cho nút Đăng nhập bằng Google và hộp thoại Một lần chạm. API này được thiết kế để sử dụng trên toàn bộ trang web của bạn, với tính năng đăng ký thủ công hoặc chuyển đổi tài khoản chỉ diễn ra sau khi người dùng đăng xuất khỏi trang web của bạn lần đầu tiên.
Để tính năng Tự động đăng nhập hoạt động, bạn phải đáp ứng các điều kiện sau:
- trước tiên, người dùng phải đăng nhập vào Tài khoản Google của họ, và
- trước đây đã đồng ý chia sẻ hồ sơ tài khoản của họ với ứng dụng của bạn, và
- khi sử dụng FedCM, chỉ thực hiện một lần đăng nhập trong 10 phút qua. Tính năng Đăng nhập một lần sẽ xuất hiện khi người dùng cố gắng đăng nhập nhiều lần trong khoảng thời gian này.
- khi sử dụng FedCM, Chrome yêu cầu người dùng xác nhận lại rằng họ muốn đăng nhập vào trang web bằng Tài khoản Google trong mỗi phiên bản Chrome, ngay cả khi người dùng đã phê duyệt trang web trước khi FedCM ra mắt. Thay đổi này có thể ảnh hưởng đến tỷ lệ chuyển đổi trên trang web hiện tại của bạn khi sử dụng tính năng Một lần nhấn. Trong bản cập nhật Chrome M121, Cải thiện tính năng Đăng nhập tự động giúp giảm vấn đề về tỷ lệ chuyển đổi.
Đối với những trang đã bật tính năng Tự động đăng nhập và nếu các điều kiện này được đáp ứng, thì thông tin đăng nhập mã thông báo nhận dạng của người dùng sẽ tự động được trả về mà không cần người dùng tương tác. Nếu không đáp ứng các điều kiện này, thì ngay cả khi bạn bật tính năng tự động đăng nhập trên trang, người dùng vẫn mặc định sử dụng quy trình Một lần nhấn để đăng nhập hoặc đồng ý. Nếu có nhiều Tài khoản Google và truy cập vào trang web của bạn, trước tiên, người dùng phải đăng nhập vào một Tài khoản Google duy nhất và đã đồng ý cho tài khoản đó.
Bạn có thể đo lường tỷ lệ thành công của tính năng Tự động đăng nhập bằng giá trị auto trong trường select_by của đối tượng thông tin đăng nhập được trả về.
Để bật tính năng tự động đăng nhập, hãy thêm data-auto_select="true" vào mã của bạn, như minh hoạ trong đoạn mã sau:
<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>
Đăng xuất
Khi đăng xuất khỏi trang web của bạn, người dùng có thể được chuyển hướng đến một trang mà lời nhắc Google One Tap tự động xuất hiện. Đối với chế độ thiết lập này, bạn phải cấm tính năng tự động chọn. Nếu không, người dùng sẽ tự động đăng nhập lại, dẫn đến trải nghiệm người dùng bị lặp vô hạn.
Sử dụng FedCM
Để cải thiện trải nghiệm người dùng, có một khoảng thời gian không hoạt động là 10 phút giữa mỗi lần đăng nhập tự động. Trong khoảng thời gian này, lời nhắc Một lần nhấn sẽ xuất hiện. Người dùng cần phải nhấp rõ ràng vào tính năng Đăng nhập bằng một lượt nhấn để đăng nhập.
Không có FedCM
Để ngăn tính năng tự động chọn sau khi người dùng đăng xuất, hãy thêm tên lớp g_id_signout vào tất cả các đường liên kết và nút đăng xuất. Hãy xem đoạn mã sau:
<div class="g_id_signout">Sign Out</div>
Bạn cũng có thể sử dụng đoạn mã JavaScript sau đây để đăng xuất:
const button = document.getElementById('signout_button');
button.onclick = () => {
google.accounts.id.disableAutoSelect();
}
Để ngăn chặn UX vòng lặp vô tận, trạng thái người dùng đã đăng xuất được lưu trữ trong một cookie có tên là g_state do thư viện Dịch vụ nhận dạng của Google thiết lập. Theo mặc định, miền cookie được đặt thành miền của trang hiện tại. Nếu tính năng Đăng nhập một lần xuất hiện trên miền chính và miền con, thì cookie trạng thái phải xuất hiện trên tất cả các miền của bạn. Sử dụng thuộc tính data-state_cookie_domain để đặt miền cookie g_state thành miền mẹ. Ví dụ: thêm data-state_cookie_domain="example.com" vào phần tử g_id_onload cho miền mẹ là example.com và miền con có tên là webapp.example.com.
Nếu có một dịch vụ giám sát tất cả cookie được dùng trong miền của bạn, thì bạn cần thông báo cho dịch vụ đó về cookie g_state.
Nếu không muốn tải thư viện ứng dụng trên các trang sau khi đăng nhập, hãy sử dụng các giải pháp sau để ngăn chặn UX bị lặp vô hạn sau khi đăng xuất:
- Khi đăng xuất, hãy chuyển hướng người dùng đến một trang (ví dụ:
https://example.com/logged_out) nơi không hiển thị tính năng Đăng nhập bằng một lần chạm hoặc nơi tính năng tự động đăng nhập luôn bị tắt. - Khi đăng xuất, hãy thêm một tham số vào URL. Ví dụ:
logged_out=1. Khi kết xuất tính năng Một lần chạm bằng JavaScript API, hãy kiểm tra tham số URL và tắt tính năng tự động đăng nhập khi tham số này xuất hiện.
Hành trình chính của người dùng
Trang tự động đăng nhập.
Sử dụng FedCM
Người dùng có thể đóng lời nhắc Đăng nhập bằng một lần nhấn bằng cách nhấp vào nút X. Để đảm bảo khả năng tiếp cận, mã thông báo nhận dạng sẽ được chia sẻ với trang web của bạn ngay cả khi người dùng nhấp vào nút X.
Để cải thiện trải nghiệm người dùng, có một khoảng thời gian không hoạt động là 10 phút giữa mỗi lần đăng nhập tự động. Trong khoảng thời gian này, lời nhắc Một lần nhấn sẽ xuất hiện. Người dùng cần phải nhấp rõ ràng vào tính năng Đăng nhập bằng một lượt nhấn để đăng nhập.
Không có FedCM
Nếu người dùng không nhấp vào nút Huỷ trong vòng 5 giây, thì mã thông báo nhận dạng sẽ được chia sẻ với trang web của bạn.
Khi người dùng huỷ thao tác Đăng nhập, dựa trên số phiên hoạt động trên Google, trang chọn tài khoản hoặc trang người dùng cũ sẽ xuất hiện.
- Nhiều phiên truy cập vào Google
- Phiên truy cập vào Google
