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

إذا لم ينقر المستخدمون على X لإلغاء الاشتراك في غضون 5 ثوانٍ، ستتم مشاركة رمز مميّز للمعرّف مع موقعك الإلكتروني.
بدون FedCM

إذا لم ينقر المستخدمون على زر إلغاء في غضون 5 ثوانٍ، تتم مشاركة رمز مميّز للمعرّف مع موقعك الإلكتروني.
عند إلغاء تسجيل الدخول، استنادًا إلى عدد جلسات Google النشطة، يتم عرض صفحة محدد الحساب أو صفحة المستخدم المكرّر الزيارة.
جلسات متعددة على Google
استخدام FedCM
بدون FedCM
جلسات Google فردية
استخدام FedCM
بدون FedCM