ورود و خروج خودکار از سیستم

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

ورود خودکار کاربران به سیستم

Google One Tap از ورود خودکار به سیستم پشتیبانی می‌کند که با حذف مراحل دستی که کاربران باید هنگام بازگشت به سایت شما انجام دهند، تجربه کاربری (UX) یکپارچه‌ای را ارائه می‌دهد. کاربران لازم نیست به‌خاطر بیاورند که در آخرین بازدیدشان کدام «حساب Google» را انتخاب کرده‌اند، که این امر احتمال ایجاد حساب‌های تکراری غیرضروری در پلاتفرم شما را کاهش می‌دهد.

ورود خودکار به سیستم برای تکمیل دکمه «ورود به سیستم با Google» و کادرهای گفتگوی «تک‌ضرب» درنظر گرفته شده است. این ویژگی برای استفاده در سراسر سایت شما طراحی شده است و ثبت‌نام دستی یا تعویض حساب فقط پس‌از اینکه کاربر برای اولین‌بار از سایت شما خارج شد انجام می‌شود.

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

  • کاربران باید ابتدا به سیستم «حساب Google» خود وارد شده باشند، و
  • قبلاً برای هم‌رسانی کردن نمایه حسابشان با برنامه شما رضایت داده باشند، و
  • هنگام استفاده از FedCM، فقط یک تلاش برای ورود به سیستم در ۱۰ دقیقه گذشته انجام داده باشد. وقتی تلاش‌های مکرر برای ورود به سیستم در این بازه زمانی رخ دهد، «تک‌ضرب» نمایش داده می‌شود.
  • هنگام استفاده از FedCM، ‏Chrome از کاربران می‌خواهد که دوباره تأیید کنند که می‌خواهند با «حساب Google» در هر نمونه Chrome به سیستم وب‌سایت وارد شوند، حتی اگر کاربر وب‌سایت را قبل‌از عرضه FedCM تأیید کرده باشد. این تغییر ممکن است بر نرخ تبدیل در سایت فعلی شما که از «ورود با یک ضربه» استفاده می‌کند تأثیر بگذارد. در به‌روزرسانی Chrome M121، بهبود «ورود خودکار به سیستم» مشکل افت نرخ تبدیل را کاهش می‌دهد.

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

می‌توانید نرخ موفقیت «ورود خودکار به سیستم» را بااستفاده از مقدار auto در فیلد select_by شیء CredentialResponse برگردانده‌شده هنگام رسیدگی به پاسخ در فراخوانی برگشتی جاوا اسکریپت (callback یا data-callback) اندازه‌گیری کنید. select_by در درخواست‌های HTTP POST ارسال‌شده به login_uri یا data-login_uri گنجانده نشده است.

برای فعال کردن ورود خودکار به سیستم، 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>

خروج از سیستم

وقتی کاربری از سیستم وب‌سایت شما خارج می‌شود، می‌تواند به صفحه‌ای هدایت شود که در آن پیام‌واره Google 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();
}

برای جلوگیری از تجربه کاربری حلقه بی‌پایان، وضعیت خروج کاربر از سیستم در کوکی‌ای به‌نام g_state ذخیره می‌شود که توسط کتابخانه «سرویس‌های هویتی Google» تنظیم شده است. به‌طور پیش‌فرض، دامنه کوکی روی دامنه صفحه فعلی تنظیم شده است. اگر «ورود با یک ضربه» در دامنه اصلی و زیردامنه‌ها نمایش داده می‌شود، کوکی وضعیت باید در همه دامنه‌هایتان قابل‌مشاهده باشد. از مشخصه data-state_cookie_domain برای تنظیم دامنه کوکی g_state روی دامنه اصلی‌تان استفاده کنید. برای مثال، data-state_cookie_domain="example.com" را به عنصر g_id_onload برای دامنه اصلی example.com و زیردامنه‌ای با نام webapp.example.com اضافه کنید.

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

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

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

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

صفحه ورود خودکار به سیستم.

استفاده از «مدیریت اطلاعات اعتباری مشارکتی»

بالاپر ورود خودکار به سیستم FedCM

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

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

بدون FedCM

نمونه‌ای از بالاپر ورود خودکار به سیستم.

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

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

  • چندین جلسه Google

نمونه‌ای از صفحه «انتخاب‌گر حساب»

  • جلسه‌های Google تکی

صفحه کاربر بازگشتی «ورود با یک ضربه»