تسجيل الدخول التلقائي وتسجيل الخروج

توضّح هذه الصفحة كيفية تنفيذ الميزات المتعلقة بطريقة تسجيل المستخدمين الدخول أو الخروج باستخدام ميزة "نقرة واحدة في Google".

تسجيل دخول المستخدمين تلقائيًا

تتيح ميزة "نقرة واحدة" في 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". في هذا الإعداد، يجب حظر الاختيار التلقائي. بخلاف ذلك، يتم تسجيل دخول المستخدم تلقائيًا مرة أخرى، مما يؤدي إلى تجربة مستخدم ثابتة.

استخدام 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

نافذة منبثقة لتسجيل الدخول تلقائيًا إلى FedCM

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

بدون FedCM

نافذة منبثقة لتسجيل الدخول تلقائيًا

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

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

  • جلسات متعددة على Google

    استخدام FedCM

    صفحة محدد حساب FedCM

    بدون FedCM

    صفحة محدد الحساب
  • جلسات فردية على Google

    استخدام FedCM

    صفحة المستخدم المكرّر لميزة FedCM One Tap

    بدون FedCM

    صفحة المستخدم المكرّرة لميزة &quot;نقرة واحدة&quot;