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

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

כניסה אוטומטית של משתמשים

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

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

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

  • המשתמשים צריכים קודם להיכנס לחשבון 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 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 בשם g_state שמוגדר על ידי ספריית שירותי הזהויות של Google. כברירת מחדל, הדומיין של קובצי ה-Cookie מוגדר לדומיין של הדף הנוכחי. אם לחיצה אחת מוצג בדומיין הראשי ובתת-הדומיינים, קובץ ה-Cookie של המצב צריך להיות גלוי בכל הדומיינים. משתמשים במאפיין data-state_cookie_domain כדי להגדיר את דומיין קובץ ה-Cookie g_state לדומיין הראשי. לדוגמה, מוסיפים את data-state_cookie_domain="example.com" לרכיב g_id_onload עבור דומיין אב של example.com ותת-דומיין בשם webapp.example.com.

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

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

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

תהליכים מרכזיים שעוברים המשתמשים

דף הכניסה האוטומטית.

שימוש ב-FedCM

חלון קופץ של כניסה אוטומטית ב-FedCM

המשתמשים יכולים לסגור את חלון הבקשה 'בלחיצה אחת' בלחיצה על הכפתור X. מטעמי נגישות, אסימון מזהה משותף עם האתר שלכם גם אם המשתמשים לוחצים על הלחצן X.

כדי לשפר את חוויית המשתמש, יש תקופת שקט של 10 דקות בין כל ניסיון כניסה אוטומטי. במהלך התקופה הזו, במקום זאת מוצגת בקשת אישור בלחיצה אחת. המשתמשים צריכים ללחוץ באופן מפורש על 'כניסה בלחיצה אחת' כדי להיכנס לחשבון.

ללא FedCM

דוגמה לחלון קופץ של התחברות אוטומטית.

אם המשתמשים לא לוחצים על הלחצן ביטול תוך 5 שניות, טוקן ID משותף עם האתר שלכם.

כשמבטלים את הכניסה, מוצג דף בחירת החשבון או דף המשתמש החוזר, בהתאם למספר הסשנים הפעילים ב-Google.

  • כמה סשנים ב-Google

דוגמה לדף של כלי לבחירת חשבון

  • סשנים יחידים ב-Google

דף משתמש חוזר בלחיצה אחת