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

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

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

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

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

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

  • המשתמשים צריכים קודם להיכנס לחשבון Google שלהם, וגם
  • נתנו בעבר הסכמה לשיתוף פרופיל החשבון שלהם עם האפליקציה שלכם, וגם
  • כשמשתמשים ב-FedCM, בוצע רק ניסיון כניסה אחד ב-10 הדקות האחרונות. התכונה "כניסה בקליק אחד" מוצגת כשמתבצעים ניסיונות כניסה חוזרים במהלך החלון הזה.
  • כשמשתמשים ב-FedCM, המשתמשים צריכים לאשר מחדש ב-Chrome שהם רוצים להיכנס לאתר באמצעות חשבון Google בכל מופע של Chrome, גם אם הם אישרו את האתר לפני ההשקה של FedCM. השינוי הזה עשוי להשפיע על שיעור ההמרה באתר הקיים שבו אתם משתמשים ב-One Tap. בגרסה M121 של Chrome, השיפור בכניסה האוטומטית מצמצם את הבעיה של ירידה בשיעור ההמרה.

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

אתם יכולים למדוד את שיעור ההצלחה של הכניסה האוטומטית באמצעות הערך auto בשדה select_by של האובייקט CredentialResponse שמוחזר כשמטפלים בתגובה בקריאה חוזרת (callback) של JavaScript (callback או data-callback). select_by לא נכלל בבקשות HTTP POST שנשלחות אל login_uri או אל data-login_uri.

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

בלי 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 Identity Services. כברירת מחדל, הדומיין של קובצי ה-Cookie מוגדר לדומיין של הדף הנוכחי. אם One Tap מוצג בדומיין הראשי ובתת-הדומיינים, קובץ ה-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) שבו לא מוצגת ההודעה של One Tap, או שבו הכניסה האוטומטית תמיד מושבתת.
  • כשמתנתקים, מוסיפים פרמטר לכתובת ה-URL. לדוגמה, logged_out=1. כשמציגים את One Tap באמצעות JavaScript API, צריך לבדוק את הפרמטר של כתובת ה-URL ולהשבית את הכניסה האוטומטית אם הוא קיים.

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

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

איך משתמשים ב-FedCM

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

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

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

בלי FedCM

דוגמה לחלון קופץ של כניסה אוטומטית.

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

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

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

דוגמה לדף של Account Chooser

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

דף למשתמשים חוזרים של One Tap