קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בדף הזה נסביר איך להטמיע תכונות שקשורות לאופן שבו משתמשים נכנסים או יוצאים באמצעות 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" לקוד, כפי שמוצג בקטע הקוד הבא:
כשמשתמש יוצא מהחשבון באתר, אפשר להפנות אותו לדף שבו תוצג הנחיה של Google One Tap באופן אוטומטי. בהגדרה הזו, צריך לאסור את הבחירה האוטומטית. אחרת, המשתמש ייכנס שוב באופן אוטומטי, מה שיוביל למצב של לולאה סגורה בממשק המשתמש.
שימוש ב-FedCM
כדי לשפר את חוויית המשתמש, יש תקופת שקט של 10 דקות בין כל ניסיון כניסה אוטומטי. במהלך פרק הזמן הזה, תוצג במקום זאת הנחיה להקשה אחת. המשתמשים צריכים ללחוץ באופן מפורש על 'הקשה אחת' כדי להיכנס לחשבון.
ללא FedCM
כדי לא לאפשר בחירה אוטומטית אחרי שהמשתמש יוצא מהחשבון, מוסיפים את שם הכיתה g_id_signout לכל הקישורים והלחצנים ליציאה מהחשבון. קטע הקוד הבא:
<div class="g_id_signout">Sign Out</div>
אפשר גם להשתמש בקטע הקוד הבא של JavaScript כדי לצאת מהחשבון:
כדי למנוע לולאת UX ללא מוצא, סטטוס היציאה של המשתמש מאוחסן בקובץ cookie בשם g_state שמוגדר על ידי הספרייה של Google Identity Services. כברירת מחדל, הדומיין של קובץ ה-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
המשתמשים יכולים לסגור את ההנחיה 'הקשה אחת' בלחיצה על הלחצן X. מטעמי נגישות, אסימון מזהה ישותף עם האתר שלכם גם אם המשתמשים ילחצו על הלחצן X.
כדי לשפר את חוויית המשתמש, יש תקופת שקט של 10 דקות בין כל ניסיון כניסה אוטומטי. במהלך פרק הזמן הזה, תוצג במקום זאת הנחיה להקשה אחת. המשתמשים צריכים ללחוץ באופן מפורש על 'הקשה אחת' כדי להיכנס לחשבון.
ללא FedCM
אם המשתמשים לא לוחצים על הלחצן ביטול תוך 5 שניות, אסימון מזהה ישות ישותף עם האתר שלכם.
כשהכניסה מבוטלת, על סמך מספר הסשנים הפעילים ב-Google, מוצג דף הבחירה של החשבון או דף המשתמש החוזר.
[null,null,["עדכון אחרון: 2025-05-23 (שעון UTC)."],[[["\u003cp\u003eGoogle One Tap enables automatic sign-in, providing a frictionless user experience by eliminating manual login steps for returning users.\u003c/p\u003e\n"],["\u003cp\u003eAutomatic sign-in works when users are signed in to their Google Account, have previously granted consent, and (for FedCM) haven't attempted sign-in within the last 10 minutes.\u003c/p\u003e\n"],["\u003cp\u003eTo enable automatic sign-in, add \u003ccode\u003edata-auto_select="true"\u003c/code\u003e to your One Tap implementation code.\u003c/p\u003e\n"],["\u003cp\u003eWhen implementing sign-out functionality, ensure auto-selection is disabled to prevent a login loop, which can be achieved by using the \u003ccode\u003eg_id_signout\u003c/code\u003e class or \u003ccode\u003egoogle.accounts.id.disableAutoSelect()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eOne Tap sign-out (disabling automatic sign-in) is temporary and does not sign users out of your website or Google services.\u003c/p\u003e\n"]]],[],null,["# Automatic sign-in and sign-out\n\nThis page describes how to implement features related to how users sign in or\nsign out with Google One Tap.\n\nSign in users automatically\n---------------------------\n\nGoogle One Tap supports automatic sign-in, which provides a frictionless user\nexperience (UX) by removing the manual steps users must take when returning\nto your site. Users don't need to remember which Google Account they selected\nduring their last visit, decreasing the chances of unnecessary duplicate\naccounts being created on your platform.\n\nAutomatic sign-in is intended to complement our Sign in with Google button\nand One Tap dialogs. It is designed to be used across your entire site, with\nmanual sign-up or switching accounts occurring only after the user has first\nsigned-out of your site.\n\nFor Automatic sign-in to occur the following conditions are required:\n\n- users must first be signed-in to their Google Account, and\n- previously granted consent to share their account profile with your app, and\n- when using FedCM, made only a single sign-in attempt in the last 10 minutes. One Tap is displayed when repeated sign-in attempts occur during this window.\n- when using FedCM, Chrome requires users to reconfirm that they want to sign in to the website with Google Account in each Chrome instance even if the user approved the website prior to the FedCM rollout. This change may affect conversion rate on your existing site using One Tap. In Chrome M121 update, [Auto Sign-in improvement](/identity/gsi/web/reference/release-notes#2023-12-21) mitigates conversion rate drop issue.\n\nFor pages where Automatic sign-in is enabled and if these conditions are met\nthe user's ID token credential is automatically returned without any user\ninteraction. If these conditions are not met, and even if Automatic sign-in is\nenabled on the page, the user defaults to the One Tap flow for sign-in or\nconsent. If a user has multiple Google Accounts and visits your site they are\nrequired to first sign-in to a single Google Account and to have provided\nconsent for that account.\n\nYou may measure Automatic sign-in success rate using the `auto` value in the\n[select_by](/identity/gsi/web/reference/js-reference#select_by) field of the returned credential object.\n\nTo enable automatic sign-in, add `data-auto_select=\"true\"` to your code, as\nshown in the following snippet: \n\n \u003cdiv id=\"g_id_onload\"\n data-client_id=\"\u003cvar translate=\"no\"\u003eYOUR_GOOGLE_CLIENT_ID\u003c/var\u003e\"\n data-login_uri=\"\u003cvar translate=\"no\"\u003ehttps://your.domain/your_login_endpoint\u003c/var\u003e\"\n data-auto_select=\"true\"\u003e\n \u003c/div\u003e\n\n| **Note:** The [upgraded One Tap UX for ITP browsers](/identity/gsi/web/guides/features#upgraded_ux_on_itp_browsers) doesn't support auto sign-in.\n\nSign out\n--------\n\nWhen a user signs out of your website, they can be directed to a page where a\nGoogle One Tap prompt is automatically displayed. For this setup, auto-selection\nmust be prohibited. Otherwise, the user is automatically signed in again, which\nleads to a dead-loop UX. \n\n### Using FedCM\n\nTo improve user experience, there is a 10 minute quiet period between every\nautomatic sign-in attempt. During this time period, One Tap prompt is\ndisplayed instead. Users need to explicitly click One Tap to sign in.\n\n### Without FedCM\n\nTo prohibit auto-selection after a user signs out, add the class name\n`g_id_signout` to all of your logout links and buttons. See the following code\nsnippet: \n\n \u003cdiv class=\"g_id_signout\"\u003eSign Out\u003c/div\u003e\n\nThe following JavaScript code snippet can also be used for sign out: \n\n const button = document.getElementById('signout_button');\n button.onclick = () =\u003e {\n google.accounts.id.disableAutoSelect();\n }\n\nTo prevent a dead-loop UX, user signed-out status is stored in a cookie named\n`g_state` that is set by the Google Identity Services library. By default the\ncookie domain is set to the domain of current page. If One Tap is displayed\non the parent domain and subdomains, the state cookie must be visible across\nall of your domains. Use the `data-state_cookie_domain` attribute to set the\n`g_state` cookie domain to your parent domain. For example, add\n`data-state_cookie_domain=\"example.com\"` to the `g_id_onload` element for a\nparent domain of `example.com` and a subdomain named `webapp.example.com`.\n| **Key Point:** If One Tap is displayed on multiple domains, you need to set the `g_state` cookie domain to your parent domain.\n\nIf you have a service that monitors all of the cookies used in your domain,\nyou need to notify them of the `g_state` cookie.\n| **Key Point:** Feel free to use other ways to prevent the dead-loop UX on log out moment.\n\nIf you don't want to load the client library on your post-login pages, use\nthese solutions to prevent a dead-loop UX after log out occurs:\n\n- On log out, redirect users to a page (say, `https://example.com/logged_out`) where One Tap is not displayed, or where auto sign-in is always disabled.\n- On log out, add a parameter to the URL. For example, `logged_out=1`. When rendering One Tap by JavaScript API, check that URL parameter and disable auto sign-in when present.\n\n| **Warning:** The term 'sign out' here refers to temporarily disabling One Tap Automatic sign-in for one day. This API does not sign out your users out of your website or any Google websites.\n\nKey user journeys\n-----------------\n\nThe automatic sign-in page. \n\n### Using FedCM\n\nUsers can close the One Tap prompt by clicking the **X** button. For\naccessibility consideration, an ID token is shared with your website\neven if users click the **X** button.\n\nTo improve user experience, there is a 10 minute quiet period between every\nautomatic sign-in attempt. During this time period, One Tap prompt is\ndisplayed instead. Users need to explicitly click One Tap to sign in.\n\n### Without FedCM\n\nIf users don't click the **Cancel** button within 5 seconds, an ID token\nis shared with your website.\n\nWhen Sign-In is cancelled, based on the number of active Google sessions,\neither the account chooser page or the returning user page displays.\n\n- Multiple Google sessions\n\n- Single Google Sessions\n\n| **Key Point:** Once cancelled, Automatic sign-in is disabled for one day."]]
