Bu sayfada, kullanıcıların Google One Tap ile oturum açma veya oturumu kapatma şekliyle ilgili özelliklerin nasıl uygulanacağı açıklanmaktadır.
Kullanıcıların oturumunu otomatik olarak açma
Google One Tap, otomatik oturum açmayı destekler. Bu özellik, kullanıcıların sitenize döndüklerinde yapmaları gereken manuel adımları ortadan kaldırarak sorunsuz bir kullanıcı deneyimi (UX) sağlar. Kullanıcıların son ziyaretlerinde hangi Google Hesabı'nı seçtiklerini hatırlamaları gerekmez. Bu sayede, platformunuzda gereksiz yinelenen hesapların oluşturulma olasılığı azalır.
Otomatik oturum açma, Google ile oturum açma düğmemizi ve One Tap iletişim kutularımızı tamamlamak için tasarlanmıştır. Tüm sitenizde kullanılmak üzere tasarlanmıştır. Manuel kaydolma veya hesap değiştirme işlemleri yalnızca kullanıcı sitenizden çıkış yaptıktan sonra gerçekleşir.
Otomatik oturum açma işleminin gerçekleşmesi için aşağıdaki koşulların karşılanması gerekir:
- Kullanıcıların öncelikle Google Hesaplarında oturum açmış olması gerekir.
- Hesap profilini uygulamanızla paylaşmak için daha önce izin vermiş ve
- FedCM kullanırken son 10 dakika içinde yalnızca bir kez oturum açma girişiminde bulunmuş olmalıdır. Bu zaman aralığında tekrarlanan oturum açma girişimleri olduğunda One Tap gösterilir.
- FedCM kullanılırken Chrome, kullanıcı web sitesini FedCM kullanıma sunulmadan önce onaylamış olsa bile her Chrome örneğinde Google Hesabı ile web sitesinde oturum açmak istediğini yeniden onaylamasını zorunlu kılar. Bu değişiklik, One Tap kullanan mevcut sitenizdeki dönüşüm oranını etkileyebilir. Chrome M121 güncellemesinde, otomatik oturum açma iyileştirmesi dönüşüm oranındaki düşüş sorununu azaltır.
Otomatik oturum açma özelliğinin etkin olduğu sayfalarda bu koşullar karşılanırsa kullanıcının kimlik jetonuna ait kimlik bilgileri, kullanıcı etkileşimi olmadan otomatik olarak döndürülür. Bu koşullar karşılanmazsa ve sayfada otomatik oturum açma etkinleştirilmiş olsa bile kullanıcı, oturum açma veya izin için varsayılan olarak One Tap akışına yönlendirilir. Birden fazla Google Hesabı olan bir kullanıcı sitenizi ziyaret ederse önce tek bir Google Hesabı'nda oturum açması ve bu hesap için izin vermesi gerekir.
Yanıtı bir JavaScript geri çağırma işlevinde (callback veya data-callback) işlerken döndürülen CredentialResponse nesnesinin select_by alanındaki auto değerini kullanarak otomatik oturum açma başarı oranını ölçebilirsiniz.
select_by, login_uri veya data-login_uri adresine gönderilen HTTP POST isteklerine dahil edilmez.
Otomatik oturum açmayı etkinleştirmek için aşağıdaki snippet'te gösterildiği gibi kodunuza data-auto_select="true" ekleyin:
<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>
Oturumu kapat
Kullanıcılar web sitenizden çıkış yaptığında Google One Tap isteminin otomatik olarak gösterildiği bir sayfaya yönlendirilebilir. Bu kurulumda otomatik seçim yasaklanmalıdır. Aksi takdirde, kullanıcının oturumu otomatik olarak tekrar açılır ve bu da sonsuz döngü kullanıcı deneyimine yol açar.
FedCM'yi kullanma
Kullanıcı deneyimini iyileştirmek için her otomatik oturum açma denemesi arasında 10 dakikalık bir bekleme süresi vardır. Bu süre zarfında, bunun yerine Tek Dokunuş istemi gösterilir. Kullanıcıların oturum açmak için One Tap'i açıkça tıklaması gerekir.
FedCM olmadan
Kullanıcı oturumu kapattıktan sonra otomatik seçimi yasaklamak için tüm çıkış bağlantılarınıza ve düğmelerinize g_id_signout sınıf adını ekleyin. Aşağıdaki kod snippet'ine bakın:
<div class="g_id_signout">Sign Out</div>
Oturumu kapatmak için aşağıdaki JavaScript kod snippet'i de kullanılabilir:
const button = document.getElementById('signout_button');
button.onclick = () => {
google.accounts.id.disableAutoSelect();
}
Kullanıcı deneyiminde sonsuz döngü oluşmasını önlemek için kullanıcının oturumunun kapalı olduğu bilgisi, Google Kimlik Hizmetleri kitaplığı tarafından ayarlanan g_state adlı bir çerezde saklanır. Çerez alanı varsayılan olarak mevcut sayfanın alanına ayarlanır. Tek Dokunuş, üst alan adında ve alt alan adlarında gösteriliyorsa durum çerezi tüm alan adlarınızda görünür olmalıdır. g_state çerez alanını üst alanınıza ayarlamak için data-state_cookie_domain özelliğini kullanın. Örneğin, example.com üst alanı ve webapp.example.com adlı alt alan için g_id_onload öğesine data-state_cookie_domain="example.com" ekleyin.
Alanınızda kullanılan tüm çerezleri izleyen bir hizmetiniz varsa bu hizmete g_state çerezi hakkında bilgi vermeniz gerekir.
İstemci kitaplığını giriş sonrası sayfalarınıza yüklemek istemiyorsanız çıkış yapıldıktan sonra sonsuz döngü kullanıcı deneyimini önlemek için aşağıdaki çözümleri kullanın:
- Çıkış yapıldığında kullanıcıları, One Tap'in gösterilmediği veya otomatik oturum açmanın her zaman devre dışı olduğu bir sayfaya (ör.
https://example.com/logged_out) yönlendirin. - Kullanıcı çıkış yaptığında URL'ye bir parametre ekleyin. Örneğin,
logged_out=1. JavaScript API ile One Tap'i oluştururken bu URL parametresini kontrol edin ve varsa otomatik oturum açma özelliğini devre dışı bırakın.
Önemli kullanıcı yolculukları
Otomatik oturum açma sayfası.
FedCM'yi kullanma
Kullanıcılar X düğmesini tıklayarak One Tap istemini kapatabilir. Erişilebilirlik nedeniyle, kullanıcılar X düğmesini tıklasa bile web sitenizle bir kimlik jetonu paylaşılır.
Kullanıcı deneyimini iyileştirmek için her otomatik oturum açma denemesi arasında 10 dakikalık bir bekleme süresi vardır. Bu süre zarfında, bunun yerine Tek Dokunuş istemi gösterilir. Kullanıcıların oturum açmak için One Tap'i açıkça tıklaması gerekir.
FedCM olmadan
Kullanıcılar 5 saniye içinde İptal düğmesini tıklamazsa web sitenizle bir kimlik jetonu paylaşılır.
Oturum açma işlemi iptal edildiğinde, etkin Google oturumlarının sayısına bağlı olarak hesap seçici sayfası veya geri dönen kullanıcı sayfası gösterilir.
- Birden çok Google oturumu
- Tek Google Oturumları
