שירותי הזהויות של Google עוברים לממשקי API של FedCM. פועלים לפי ההוראות במדריך להעברת נתונים (מיגרציה) כדי לבדוק את השינויים האפשריים ולמנוע השפעות שליליות על הכניסה של המשתמשים לאתר.

דף זה תורגם על ידי Cloud Translation API.

כניסה ויציאה אוטומטיים

בדף הזה מוסבר איך להטמיע תכונות שקשורות לאופן שבו משתמשים נכנסים לחשבון או יוצאים ממנו באמצעות Google One Tap.

התכונה 'הקשה אחת' של Google תומכת בכניסה אוטומטית, שמספקת חוויית משתמש חלקה (UX) על ידי הסרת השלבים הידניים שהמשתמשים צריכים לבצע כשהם חוזרים לאתר. המשתמשים לא צריכים לזכור איזה חשבון Google הם בחרו במהלך הביקור האחרון שלהם, וכך יש פחות סיכוי ליצירת חשבונות כפולים מיותרים בפלטפורמה.

הכניסה האוטומטית נועדה להשלים את הלחצן 'כניסה באמצעות חשבון Google' ואת תיבת הדו-שיח של One Tap. הוא מיועד לשימוש בכל האתר, וההרשמה הידנית או המעבר בין חשבונות מתבצעים רק אחרי שהמשתמש יוצא מהחשבון באתר בפעם הראשונה.

כדי שהכניסה האוטומטית תתבצע, צריכים להתקיים התנאים הבאים:

המשתמשים חייבים קודם להיכנס לחשבון Google שלהם.
נתנו בעבר הסכמה לשיתוף פרופיל החשבון שלהם עם האפליקציה שלכם, וגם
כשמשתמשים ב-FedCM, ניסו להיכנס רק פעם אחת ב-10 הדקות האחרונות. האפשרות 'כניסה בהקשה אחת' מוצגת כשמתבצעות ניסיונות כניסה חוזרים במהלך החלון הזה.
כשמשתמשים ב-FedCM, משתמשי Chrome נדרשים לאשר מחדש שהם רוצים להיכנס לאתר באמצעות חשבון Google בכל מכונה של Chrome, גם אם המשתמש אישר את האתר לפני ההשקה של FedCM. השינוי הזה עשוי להשפיע על שיעור ההמרות באתר הקיים שלכם באמצעות One Tap. בעדכון 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 Tap באופן אוטומטי. בהגדרה הזו, צריך לאסור את הבחירה האוטומטית. אחרת, המשתמש ייכנס שוב באופן אוטומטי, מה שיוביל למצב של לולאה סגורה בממשק המשתמש.

שימוש ב-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();
}

לכן, הסטטוס של יציאה מהחשבון מתועד באמצעות קובץ cookie בדומיין שלכם, כדי למנוע את חוויית המשתמש של לולאת הקסם.

סטטוס היציאה נשמר בקובץ ה-cookie g_state בדומיין שלכם. אם יש לכם שירות שמנטר את כל קובצי ה-Cookie שמשמשים בדומיין שלכם, עליכם להודיע לו על קובץ ה-Cookie הזה.

אם אתם לא רוצים לטעון את ספריית הלקוח בדפים שאחרי ההתחברות, תוכלו להשתמש בפתרונות הבאים כדי למנוע חוויית משתמש של לולאה ללא מוצא אחרי היציאה מהחשבון:

כשמתנתקים, מפנים את המשתמשים לדף (למשל, https://example.com/logged_out) שלא מוצג בו הקשה אחת, או לדף שבו הכניסה האוטומטית תמיד מושבתת.
בזמן היציאה מהחשבון, מוסיפים פרמטר לכתובת ה-URL. לדוגמה, logged_out=1. כשמריצים את One Tap באמצעות JavaScript API, צריך לבדוק את הפרמטר של כתובת ה-URL ולהשבית את הכניסה האוטומטית אם הוא קיים.