ورود و خروج خودکار

این صفحه نحوه پیاده‌سازی ویژگی‌های مربوط به نحوه ورود یا خروج کاربران با Google One Tap را شرح می‌دهد.

ورود خودکار کاربران

گوگل وان تپ از ورود خودکار پشتیبانی می‌کند که با حذف مراحل دستی که کاربران هنگام بازگشت به سایت شما باید انجام دهند، یک تجربه کاربری (UX) بدون مشکل را فراهم می‌کند. کاربران نیازی به یادآوری حساب گوگلی که در آخرین بازدید خود انتخاب کرده‌اند، ندارند و این امر احتمال ایجاد حساب‌های تکراری غیرضروری در پلتفرم شما را کاهش می‌دهد.

ورود خودکار به سیستم، مکمل دکمه ورود با گوگل و پنجره‌های گفتگوی تک‌لمسی ما است. این قابلیت به گونه‌ای طراحی شده است که در کل سایت شما قابل استفاده باشد و ثبت نام دستی یا تغییر حساب کاربری تنها پس از اولین خروج کاربر از سایت شما انجام شود.

برای ورود خودکار به سیستم، شرایط زیر لازم است:

• کاربران ابتدا باید به حساب گوگل خود وارد شوند، و
• قبلاً رضایت خود را برای به اشتراک گذاشتن نمایه حساب خود با برنامه شما دریافت کرده باشید، و
• هنگام استفاده از FedCM، در 10 دقیقه گذشته فقط یک بار برای ورود به سیستم تلاش کرده‌اید. در صورت تکرار تلاش‌های ورود به سیستم در طول این پنجره، گزینه One Tap نمایش داده می‌شود.
• هنگام استفاده از FedCM، کروم از کاربران می‌خواهد که در هر نمونه کروم، حتی اگر کاربر قبل از راه‌اندازی FedCM وب‌سایت را تأیید کرده باشد، دوباره تأیید کنند که می‌خواهند با حساب گوگل به وب‌سایت وارد شوند. این تغییر ممکن است بر نرخ تبدیل در سایت فعلی شما با استفاده از One Tap تأثیر بگذارد. در به‌روزرسانی Chrome M121، بهبود ورود خودکار ، مشکل افت نرخ تبدیل را کاهش می‌دهد.

برای صفحاتی که ورود خودکار در آنها فعال است و در صورت برآورده شدن این شرایط، اعتبارنامه شناسه کاربر بدون هیچگونه تعاملی با کاربر به طور خودکار بازگردانده می‌شود. اگر این شرایط برآورده نشوند، و حتی اگر ورود خودکار در صفحه فعال باشد، کاربر برای ورود یا رضایت به طور پیش‌فرض از جریان One Tap استفاده می‌کند. اگر کاربری چندین حساب گوگل داشته باشد و از سایت شما بازدید کند، لازم است ابتدا با یک حساب گوگل وارد شود و برای آن حساب رضایت خود را ارائه دهد.

شما می‌توانید نرخ موفقیت ورود خودکار را با استفاده از مقدار 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>

توجه: رابط کاربری One Tap UX ارتقا یافته برای مرورگرهای ITP از ورود خودکار پشتیبانی نمی‌کند.

خروج از سیستم

وقتی کاربری از وب‌سایت شما خارج می‌شود، می‌توان او را به صفحه‌ای هدایت کرد که در آن به‌طور خودکار اعلان Google One Tap نمایش داده می‌شود. برای این تنظیم، انتخاب خودکار باید ممنوع باشد. در غیر این صورت، کاربر به‌طور خودکار دوباره وارد سیستم می‌شود که منجر به یک تجربه کاربری بدون بازگشت (dead-loop UX) می‌شود.

استفاده از FedCM

برای بهبود تجربه کاربری، بین هر تلاش خودکار برای ورود به سیستم، یک دوره ۱۰ دقیقه‌ای سکوت وجود دارد. در این مدت، به جای آن، پیام One Tap نمایش داده می‌شود. کاربران برای ورود باید صریحاً روی One Tap کلیک کنند.

بدون FedCM

برای جلوگیری از انتخاب خودکار پس از خروج کاربر، کلاس g_id_signout را به تمام لینک‌ها و دکمه‌های خروج خود اضافه کنید. به قطعه کد زیر توجه کنید:

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

قطعه کد جاوا اسکریپت زیر نیز می‌تواند برای خروج از سیستم استفاده شود:

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

To prevent a dead-loop UX, user signed-out status is stored in a cookie named g_state that is set by the Google Identity Services library. By default the cookie domain is set to the domain of current page. If One Tap is displayed on the parent domain and subdomains, the state cookie must be visible across all of your domains. Use the data-state_cookie_domain attribute to set the g_state cookie domain to your parent domain. For example, add data-state_cookie_domain="example.com" to the g_id_onload element for a parent domain of example.com and a subdomain named webapp.example.com .

نکته کلیدی: اگر One Tap روی چندین دامنه نمایش داده می‌شود، باید دامنه کوکی g_state را روی دامنه والد خود تنظیم کنید.

اگر سرویسی دارید که تمام کوکی‌های استفاده شده در دامنه شما را رصد می‌کند، باید آنها را از کوکی g_state مطلع کنید.

نکته کلیدی: در صورت تمایل می‌توانید از روش‌های دیگری برای جلوگیری از تجربه کاربری بدون بازگشت (dead-loop UX) در لحظه خروج از سیستم استفاده کنید.

اگر نمی‌خواهید کتابخانه کلاینت در صفحات پس از ورود به سیستم بارگذاری شود، از این راه‌حل‌ها برای جلوگیری از بروز حلقه مرگ در تجربه کاربری (UX) پس از خروج از سیستم استفاده کنید:

• هنگام خروج، کاربران را به صفحه‌ای (مثلاً https://example.com/logged_out ) هدایت کنید که در آن گزینه One Tap نمایش داده نمی‌شود، یا ورود خودکار همیشه غیرفعال است.
• هنگام خروج، یک پارامتر به URL اضافه کنید. برای مثال، logged_out=1 . هنگام رندر کردن One Tap by JavaScript API، آن پارامتر URL را بررسی کنید و در صورت وجود، ورود خودکار را غیرفعال کنید.

هشدار: اصطلاح «خروج» در اینجا به غیرفعال کردن موقت ورود خودکار با یک ضربه برای یک روز اشاره دارد. این API کاربران شما را از وب‌سایت شما یا هیچ وب‌سایت گوگلی خارج نمی‌کند.

مسیرهای کلیدی کاربر

صفحه ورود خودکار.

استفاده از FedCM

کاربران می‌توانند با کلیک روی دکمه X ، پنجره One Tap را ببندند. برای ملاحظات دسترسی، حتی اگر کاربران روی دکمه X کلیک کنند، یک توکن شناسایی با وب‌سایت شما به اشتراک گذاشته می‌شود.

برای بهبود تجربه کاربری، بین هر تلاش خودکار برای ورود به سیستم، یک دوره ۱۰ دقیقه‌ای سکوت وجود دارد. در این مدت، به جای آن، پیام One Tap نمایش داده می‌شود. کاربران برای ورود باید صریحاً روی One Tap کلیک کنند.

بدون FedCM

اگر کاربران ظرف ۵ ثانیه روی دکمه لغو کلیک نکنند، یک توکن شناسایی با وب‌سایت شما به اشتراک گذاشته می‌شود.

وقتی ورود لغو می‌شود، بر اساس تعداد جلسات فعال گوگل، یا صفحه انتخاب حساب کاربری یا صفحه کاربر بازگشتی نمایش داده می‌شود.

• جلسات متعدد گوگل

• جلسات تکی گوگل

نکته کلیدی: پس از لغو، ورود خودکار به مدت یک روز غیرفعال می‌شود.