توضّح هذه الصفحة كيفية تنفيذ الميزات المتعلّقة بطريقة تسجيل المستخدمين الدخول أو تسجيل الخروج باستخدام ميزة "Google One Tap".
تسجيل دخول المستخدمين تلقائيًا
تتيح خدمة Google One Tap ميزة تسجيل الدخول التلقائي التي توفّر تجربة مستخدم سلسة عن طريق إزالة الخطوات اليدوية التي يجب أن يتّخذها المستخدمون عند العودة إلى موقعك الإلكتروني. لا يحتاج المستخدمون إلى تذكّر حساب Google الذي اختاروه خلال زيارتهم الأخيرة، ما يقلّل من فرص إنشاء حسابات مكرّرة غير ضرورية على منصتك.
تهدف ميزة "تسجيل الدخول تلقائيًا" إلى تكملة مربّعَي الحوار "تسجيل الدخول باستخدام حساب Google" و"نقرة واحدة". تم تصميمه ليتم استخدامه على موقعك الإلكتروني بالكامل، ولا يتم تسجيل الاشتراك يدويًا أو تبديل الحسابات إلا بعد تسجيل الخروج من موقعك الإلكتروني أولاً.
لكي تتم عملية تسجيل الدخول التلقائي، يجب استيفاء الشروط التالية:
- يجب أن يكون المستخدمون مسجّلين الدخول أولاً إلى حساباتهم على Google.
- قدّم موافقته سابقًا على مشاركة ملفه الشخصي على حسابه مع تطبيقك،
- عند استخدام FedCM، أجريت محاولة واحدة فقط لتسجيل الدخول في آخر 10 دقائق. يتم عرض ميزة "النقرة الواحدة" عند حدوث محاولات متكررة لتسجيل الدخول خلال هذه الفترة.
- عند استخدام FedCM، يطلب Chrome من المستخدمين إعادة تأكيد رغبتهم في تسجيل الدخول إلى الموقع الإلكتروني باستخدام حساب Google في كل نسخة افتراضية من Chrome حتى إذا وافق المستخدم على الموقع الإلكتروني قبل طرح FedCM. وقد يؤثر هذا التغيير في معدّل الإحالات الناجحة على موقعك الإلكتروني الحالي باستخدام ميزة "نقرة واحدة". في تحديث Chrome M121، يؤدي تحسين ميزة "تسجيل الدخول تلقائيًا" إلى تخفيف مشكلة انخفاض معدّل الإحالات الناجحة.
بالنسبة إلى الصفحات التي تم فيها تفعيل ميزة "تسجيل الدخول تلقائيًا"، وفي حال استيفاء هذه الشروط، تتم تلقائيًا إحالة بيانات اعتماد رمز التعريف الخاص بالمستخدم بدون أي تفاعل من العميل. في حال عدم استيفاء هذه الشروط، وحتى إذا كان تسجيل الدخول التلقائي مفعّلاً على الصفحة، سيتم توجيه المستخدم تلقائيًا إلى مسار "النقرة الواحدة" لتسجيل الدخول أو منح الموافقة. إذا كان أحد المستخدمين يمتلك حسابات متعددة على Google وزار موقعك الإلكتروني، يجب أن يسجّل الدخول أولاً إلى حساب واحد على Google وأن يقدّم الموافقة على هذا الحساب.
يمكنك قياس معدّل نجاح ميزة "تسجيل الدخول تلقائيًا" باستخدام القيمة 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>
تسجيل الخروج
عندما يسجِّل مستخدم الخروج من موقعك الإلكتروني، يمكن أن يتم توجيهه إلى صفحة يظهر فيها طلب "نقرة واحدة من Google" تلقائيًا. في ما يتعلّق بهذا الإعداد، يجب منع الاختيار التلقائي. خلاف ذلك، يتم تسجيل دخول المستخدم تلقائيًا مرة أخرى، مما يؤدي إلى حدوث خلل في تجربة المستخدم.
استخدام FedCM
لتحسين تجربة المستخدم، يجب الانتظار لمدة 10 دقائق بين كل محاولة لتسجيل الدخول تلقائيًا. خلال هذه الفترة الزمنية، يتم بدلاً من ذلك عرض طلب One Tap. على المستخدمين النقر صراحةً على ميزة "النقرة الواحدة" لتسجيل الدخول.
بدون FedCM
لحظر الاختيار التلقائي بعد تسجيل خروج المستخدم، أضِف اسم الفئة
g_id_signout
إلى جميع روابط وزرّات تسجيل الخروج. اطّلع على مقتطف الرمز التالي:
<div class="g_id_signout">Sign Out</div>
يمكن أيضًا استخدام مقتطف رمز JavaScript التالي لتسجيل الخروج:
const button = document.getElementById('signout_button');
button.onclick = () => {
google.accounts.id.disableAutoSelect();
}
وبالتالي، يتم تسجيل حالة تسجيل الخروج من خلال ملف تعريف ارتباط في نطاقك لتجنّب حدوث حلقة توقُّف تجربة المستخدم.
يتم تخزين حالة تسجيل الخروج في ملف تعريف الارتباط g_state
في نطاقك. إذا كانت لديك خدمة تراقب جميع ملفات تعريف الارتباط المستخدمة في نطاقك، عليك إبلاغهم بملف تعريف الارتباط هذا.
إذا كنت لا تريد تحميل مكتبة العميل على صفحات ما بعد تسجيل الدخول، استخدِم هذه الحلول لمنع حدوث تجربة مستخدم متكررة بعد تسجيل الخروج:
- عند تسجيل الخروج، أعِد توجيه المستخدمين إلى صفحة (مثل
https://example.com/logged_out
) لا يتم فيها عرض ميزة "النقرة الواحدة"، أو حيث يكون تسجيل الدخول التلقائي غير مفعّل دائمًا. - عند تسجيل الخروج، أضِف مَعلمة إلى عنوان URL. مثلاً:
logged_out=1
عند عرض واجهة برمجة التطبيقات One Tap by JavaScript، تحقّق من مَعلمة عنوان URL هذه وأوقِف ميزة "تسجيل الدخول تلقائيًا" إذا كانت متوفّرة.
تجارب المستخدمين الرئيسية
صفحة تسجيل الدخول التلقائي
استخدام FedCM
يمكن للمستخدمين إغلاق طلب One Tap بالنقر على الزر X. للتفكير في إمكانية الوصول، تتم مشاركة رمز مميز للمعرّف مع موقعك الإلكتروني حتى إذا نقر المستخدمون على الزر X.
لتحسين تجربة المستخدم، يتم تطبيق فترة هدوء مدتها 10 دقائق بين كل محاولة تسجيل دخول تلقائية. خلال هذه الفترة الزمنية، يتم عرض الطلب بنقرة واحدة بدلاً من ذلك. على المستخدمين النقر صراحةً على ميزة "النقرة الواحدة" لتسجيل الدخول.
بدون FedCM
إذا لم ينقر المستخدمون على الزر إلغاء خلال 5 ثوانٍ، تتم مشاركة رمز تعريف مع موقعك الإلكتروني.
عند إلغاء تسجيل الدخول، استنادًا إلى عدد جلسات Google النشطة، يتم عرض صفحة اختيار الحساب أو صفحة المستخدم المتكرّر.
- جلسات Google متعددة
- جلسات Google الفردية