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 Google One Tap.
Tự động đăng nhập người dùng
Google One Tap hỗ trợ tính năng tự động đăng nhập, mang đến trải nghiệm người dùng (UX) mượt mà 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 nhằm bổ sung cho nút Đăng nhập bằng Google và hộp thoại Một lần chạm. Phương thức này được thiết kế để sử dụng trên toàn bộ trang web của bạn, trong đó việc đăng ký hoặc chuyển đổi tài khoản theo cách thủ công chỉ xảy 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 diễn ra, 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à
- đã đồng ý chia sẻ hồ sơ tài khoản của họ với ứng dụng của bạn trước đó 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 Một lần nhấn sẽ xuất hiện khi có nhiều lần đăng nhập xảy ra 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 triển khai FedCM. 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 Thanh toán không tiếp xúc. Trong bản cập nhật Chrome M121, tính năng Cải thiện tính năng Tự động đăng nhập giúp giảm thiểu vấn đề tỷ lệ chuyển đổi giảm.
Đối với các trang đã bật tính năng Tự động đăng nhập và nếu đáp ứng các điều kiện này, thông tin xác thực 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 và ngay cả khi bạn bật tính năng Tự động đăng nhập trên trang, người dùng sẽ 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 và đồng ý với 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 cách sử dụng giá trị auto trong trường select_by của đối tượng thông tin xác thực đượ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ười dùng đăng xuất khỏi trang web của bạn, họ có thể được chuyển hướng đến một trang mà lời nhắc Google One Tap sẽ tự động hiển thị. Đố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 lại.
Sử dụng FedCM
Để cải thiện trải nghiệm người dùng, có một khoảng thời gian yên tĩnh 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 Nhấn một lầ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 Một lần chạm để đăng nhập.
Không có FedCM
Để cấm 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 để đăng xuất:
const button = document.getElementById('signout_button');
button.onclick = () => {
google.accounts.id.disableAutoSelect();
}
Để ngăn trải nghiệm người dùng bị lặp lại, trạng thái đã đăng xuất của người dùng được lưu trữ trong một cookie có tên g_state do thư viện Dịch vụ nhận dạng của Google đặt. 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 Một lần nhấn hiển thị trên miền gốc và miền con, thì cookie trạng thái phải hiển thị trên tất 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 gốc example.com và miền con có tên webapp.example.com.
Nếu có một dịch vụ theo dõi tất cả cookie được sử dụng trong miền của bạn, bạn cần thông báo cho họ về cookie g_state.
Nếu bạn 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 trải nghiệm người dùng bị lặp lại 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) không hiển thị tính năng Một lần chạm hoặc luôn tắt tính năng đăng nhập tự động. - Khi đăng xuất, hãy thêm một tham số vào URL. Ví dụ:
logged_out=1. Khi hiển thị tính năng Một lần chạm bằng API JavaScript, hãy kiểm tra tham số URL đó và tắt tính năng tự động đăng nhập nếu có.
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 Một lần nhấn bằng cách nhấp vào nút X. Để cân nhắc đến khả năng hỗ trợ 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 yên tĩnh 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 Nhấn một lầ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 Một lần chạm để đă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ột mã thông báo nhận dạng sẽ được chia sẻ với trang web của bạn.
Khi bạn huỷ quy trình Đăng nhập, dựa trên số phiên Google đang hoạt động, 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
- Một phiên trên Google
