توضّح هذه الصفحة كيفية تنفيذ الميزات المتعلّقة بكيفية تسجيل دخول المستخدمين أو تسجيل خروجهم باستخدام ميزة "نقرة واحدة" من Google.
تسجيل دخول المستخدمين تلقائيًا
تتيح خدمة Google One Tap ميزة تسجيل الدخول التلقائي التي توفّر تجربة مستخدم سلسة عن طريق إزالة الخطوات اليدوية التي يجب أن يتّخذها المستخدمون عند العودة إلى موقعك الإلكتروني. لا يحتاج المستخدمون إلى تذكّر حساب Google الذي اختاروه خلال زيارتهم الأخيرة، ما يقلّل من فرص إنشاء حسابات مكرّرة غير ضرورية على منصتك.
تهدف ميزة "تسجيل الدخول تلقائيًا" إلى تكملة مربّعَي الحوار "تسجيل الدخول باستخدام حساب Google" و"نقرة واحدة". وتم تصميم هذه الميزة للاستخدام في موقعك الإلكتروني بالكامل، مع عدم إمكانية الاشتراك اليدوي أو تبديل الحسابات إلا بعد أن يسجِّل المستخدم خروجه من الموقع الإلكتروني لأول مرة.
ليتم تسجيل الدخول تلقائيًا، يجب استيفاء الشروط التالية:
- على المستخدمين تسجيل الدخول أولاً إلى حسابهم على Google
- الذين سبق لهم الموافقة على مشاركة الملف الشخصي لحسابهم مع تطبيقك
- عند استخدام FedCM، حاول تسجيل دخول مرة واحدة فقط خلال آخر 10 دقائق. يتم عرض ميزة "نقرة واحدة" عند تكرار محاولات تسجيل الدخول المتكررة خلال هذه النافذة.
- عند استخدام FedCM، يطلب Chrome من المستخدمين إعادة تأكيد رغبتهم في تسجيل الدخول إلى الموقع الإلكتروني باستخدام حساب Google في كل نسخة افتراضية من Chrome حتى إذا وافق المستخدم على الموقع الإلكتروني قبل طرح FedCM. وقد يؤثر هذا التغيير في معدّل الإحالات الناجحة على موقعك الإلكتروني الحالي باستخدام ميزة "نقرة واحدة". في التحديث M121 على Chrome، تساعد تحسينات تسجيل الدخول التلقائي على الحدّ من مشكلة انخفاض معدّل الإحالات الناجحة.
بالنسبة إلى الصفحات التي تم فيها تفعيل "تسجيل الدخول تلقائيًا" وفي حال استيفاء هذه الشروط، يتم عرض بيانات اعتماد الرمز المميّز لمعرّف المستخدم تلقائيًا بدون أي تفاعل من المستخدم. إذا لم يتم استيفاء هذه الشروط، وحتى إذا كانت ميزة "تسجيل الدخول تلقائيًا" مفعَّلة على الصفحة، سيتم ضبط المستخدم تلقائيًا على مسار "نقرة واحدة" لتسجيل الدخول أو الموافقة. إذا كان أحد المستخدمين يملك حسابات 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 One" تلقائيًا. بالنسبة إلى هذا الإعداد، يجب حظر الاختيار التلقائي. خلاف ذلك، يتم تسجيل دخول المستخدم تلقائيًا مرة أخرى، مما يؤدي إلى حدوث توقف في تجربة المستخدم.
استخدام FedCM
لتحسين تجربة المستخدم، يجب الانتظار لمدة 10 دقائق بين كل محاولة لتسجيل الدخول تلقائيًا. خلال هذه الفترة الزمنية، يتم عرض الطلب بنقرة واحدة بدلاً من ذلك. على المستخدمين النقر صراحةً على "نقرة واحدة" لتسجيل الدخول.
بدون 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
عند عرض ميزة "نقرة واحدة" من خلال JavaScript API، تحقَّق من معلَمة عنوان URL وأوقِف ميزة "تسجيل الدخول تلقائيًا" عند توفّرها.
تجارب المستخدمين الرئيسية
صفحة تسجيل الدخول التلقائي
استخدام FedCM
يمكن للمستخدمين إغلاق الطلبات بنقرة واحدة من خلال النقر على الزر X. للتفكير في إمكانية الوصول، تتم مشاركة رمز مميز للمعرّف مع موقعك الإلكتروني حتى إذا نقر المستخدمون على الزر X.
لتحسين تجربة المستخدم، يجب الانتظار لمدة 10 دقائق بين كل محاولة لتسجيل الدخول تلقائيًا. خلال هذه الفترة الزمنية، يتم عرض الطلب بنقرة واحدة بدلاً من ذلك. على المستخدمين النقر صراحةً على "نقرة واحدة" لتسجيل الدخول.
بدون FedCM
إذا لم ينقر المستخدمون على زر إلغاء في غضون 5 ثوانٍ، ستتم مشاركة رمز مميّز لرقم التعريف مع موقعك الإلكتروني.
عند إلغاء عملية "تسجيل الدخول" استنادًا إلى عدد جلسات Google النشطة، ستُعرض صفحة محدد الحساب أو صفحة المستخدم العائدة.
- جلسات Google متعددة
- جلسات Google الفردية