Login dan logout otomatis

Halaman ini menjelaskan cara mengimplementasikan fitur terkait cara pengguna login atau logout dengan Google One Ketuk.

Membuat pengguna login secara otomatis

Google One Tap mendukung login otomatis, yang memberikan pengalaman pengguna (UX) yang lancar dengan menghapus langkah-langkah manual yang harus dilakukan pengguna saat kembali ke situs Anda. Pengguna tidak perlu mengingat Akun Google mana yang mereka pilih selama kunjungan terakhir, sehingga mengurangi kemungkinan akun duplikat yang tidak perlu dibuat di platform Anda.

Login otomatis dimaksudkan untuk melengkapi dialog tombol Login dengan Google dan dialog Sekali Ketuk kami. Layanan ini dirancang untuk digunakan di seluruh situs Anda, dengan pendaftaran manual atau peralihan akun yang hanya terjadi setelah pengguna logout pertama kali dari situs.

Agar Login otomatis dapat terjadi, kondisi berikut diperlukan:

  • pengguna harus login terlebih dahulu ke Akun Google mereka, dan
  • sebelumnya memberikan izin untuk membagikan profil akunnya dengan aplikasi Anda, dan
  • saat menggunakan FedCM, hanya melakukan satu kali upaya login dalam 10 menit terakhir. Sekali Ketuk ditampilkan saat upaya login berulang terjadi dalam jendela ini.
  • Saat menggunakan FedCM, Chrome mengharuskan pengguna mengonfirmasi ulang bahwa mereka ingin login ke situs dengan Akun Google di setiap instance Chrome meskipun pengguna menyetujui situs sebelum peluncuran FedCM. Perubahan ini dapat memengaruhi rasio konversi di situs Anda yang sudah ada menggunakan fitur Sekali Ketuk. Pada update Chrome M121, Peningkatan login Otomatis mengurangi masalah penurunan rasio konversi.

Untuk halaman yang mengaktifkan Login otomatis dan jika kondisi ini terpenuhi, kredensial token ID pengguna akan otomatis ditampilkan tanpa interaksi pengguna. Jika kondisi ini tidak terpenuhi, dan meskipun Login otomatis diaktifkan di halaman, pengguna akan menetapkan alur Sekali Ketuk untuk login atau memberikan izin secara default. Jika pengguna memiliki beberapa Akun Google dan mengunjungi situs Anda, dia harus login terlebih dahulu ke satu Akun Google dan memberikan izin untuk akun tersebut.

Anda dapat mengukur Tingkat keberhasilan login otomatis menggunakan nilai auto di kolom select_by dari objek kredensial yang ditampilkan.

Untuk mengaktifkan login otomatis, tambahkan data-auto_select="true" ke kode Anda, seperti yang ditunjukkan dalam cuplikan berikut:

<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>

Logout

Saat pengguna logout dari situs Anda, mereka dapat diarahkan ke halaman tempat perintah Google One Ketuk ditampilkan otomatis. Untuk penyiapan ini, pemilihan otomatis harus dilarang. Jika tidak, pengguna akan otomatis login lagi, yang akan menyebabkan UX tanpa loop.

Menggunakan FedCM

Untuk meningkatkan pengalaman pengguna, ada periode tenang 10 menit di antara setiap upaya login otomatis. Selama jangka waktu ini, perintah Sekali Ketuk akan ditampilkan. Pengguna harus mengklik Sekali Ketuk secara eksplisit untuk login.

Tanpa FedCM

Untuk mencegah pemilihan otomatis setelah pengguna logout, tambahkan nama class g_id_signout ke semua tombol dan link logout Anda. Lihat cuplikan kode berikut:

<div class="g_id_signout">Sign Out</div>

Cuplikan kode JavaScript berikut juga dapat digunakan untuk logout:

const button = document.getElementById('signout_button');
button.onclick = () => {
  google.accounts.id.disableAutoSelect();
}

Dengan demikian, status logout akan dicatat melalui cookie di domain Anda untuk menghindari UX yang tidak berfungsi.

Status logout disimpan ke dalam cookie g_state di domain Anda. Jika Anda memiliki layanan yang memantau semua cookie yang digunakan di domain, Anda harus memberi tahu mereka tentang cookie ini.

Jika Anda tidak ingin memuat library klien di halaman setelah login, gunakan solusi ini untuk mencegah UX yang tidak berfungsi setelah logout:

  • Saat logout, alihkan pengguna ke halaman (misalnya, https://example.com/logged_out) tempat Sekali Ketuk tidak ditampilkan, atau login otomatis selalu dinonaktifkan.
  • Saat logout, tambahkan parameter ke URL. Misalnya, logged_out=1. Saat merender Sekali Ketuk dari JavaScript API, periksa parameter URL tersebut dan nonaktifkan login otomatis jika ada.

Perjalanan pengguna utama

Halaman login otomatis.

Menggunakan FedCM

Pop-up login otomatis FedCM

Pengguna dapat menutup dialog Sekali Ketuk dengan mengklik tombol X. Untuk pertimbangan aksesibilitas, token ID dibagikan ke situs Anda meskipun pengguna mengklik tombol X.

Untuk meningkatkan pengalaman pengguna, ada periode tenang 10 menit di antara setiap upaya login otomatis. Selama jangka waktu ini, perintah Sekali Ketuk akan ditampilkan. Pengguna harus mengklik Sekali Ketuk secara eksplisit untuk login.

Tanpa FedCM

Pop-up login otomatis.

Jika pengguna tidak mengklik tombol Cancel dalam 5 detik, token ID akan dibagikan ke situs Anda.

Saat Login dibatalkan, berdasarkan jumlah sesi Google yang aktif, halaman pemilih akun atau halaman pengguna yang kembali akan ditampilkan.

  • Beberapa sesi Google

Halaman Pemilih Akun

  • Satu Sesi Google

Halaman pengguna yang kembali Sekali Ketuk