이 가이드에는 원탭이 표시되거나 표시되지 않는 경우와 사용자 세션 동작을 포함하여 원탭 사용자 환경에 관한 자세한 설명이 포함되어 있습니다.
전역 선택 해제
내 계정에 액세스할 수 있는 앱 페이지에서 Google 계정 로그인 메시지 플래그를 사용 중지하면 원탭을 선택 해제할 수 있습니다. 선택 해제된 세션은 원탭에 표시되지 않습니다. 모든 Google 세션이 선택 해제된 경우 원탭이 표시되지 않습니다.
사용자가 FedCM이 사용 설정된 브라우저에서 서드 파티 로그인을 사용 중지하면 원탭이 표시되지 않습니다. Chrome 설정의 개인 정보 보호 및 보안 섹션에서 사용자는 전체 또는 개별 사이트의 서드 파티 로그인 메시지 표시를 제어할 수 있습니다.
쿨다운 지수
사용자가 원탭 메시지를 수동으로 닫으면 원탭 메시지가 표시되지 않습니다. 사용자가 프롬프트 오른쪽 상단에서 닫기close를 탭하면 원탭이 닫힙니다. 그 후 원탭은 일정 기간 동안 동일한 브라우저나 마지막으로 방문한 웹사이트에 표시되지 않습니다.
FedCM이 사용 설정되지 않은 경우 쿨다운에 다음과 같은 지수 기간이 사용됩니다.
연속된 시간 종료됨
원탭이 사용 중지된 기간
1
2시간
2
1일
3
1주
4+
4주
원탭 또는 Google 계정으로 로그인 버튼을 사용하여 로그인이 완료되면 쿨다운 상태가 재설정됩니다.
FedCM이 사용 설정되면 브라우저 공급업체가 서로 다른 자체 쿨다운 기간을 정의할 수 있습니다.
모바일 브라우저에서 자동 닫기
모바일 브라우저에서 FedCM이 사용 설정되지 않은 경우 사용자가 원탭 UI와 직접 상호작용하지 않으면 Google 원탭이 잠시 후에 자동으로 닫힙니다.
자동 닫기 기준점은 90초입니다. 일정은 변경될 수 있습니다.
의도하지 않은 클릭을 방지하기 위해 대화상자 표시
이제 원탭은 대화상자의 무결성을 시행하기 위해 다양한 보안 조치를 제공하지만 일부 브라우저는 이러한 기능을 지원하지 않습니다. 지원되지 않는 브라우저에는 Chromium 기반이 아닌 브라우저 또는 v75 이전 브라우저 등이 있습니다. 이러한 경우 또는 대화상자가 다른 콘텐츠로 가려지면 계정을 만들기 위해 사용자의 동의를 요청하는 팝업 창이 표시됩니다.
ITP 브라우저의 업그레이드된 UX
지능형 추적 방지 (ITP)로 인해 일반적인 원탭 UX는 iOS, Safari 또는 Firefox의 Chrome에서 작동하지 않습니다. 대신 이러한 브라우저에서는 다른 UX가 제공됩니다. data-itp_support 속성을 설정하여 ITP 브라우저에서 이 UX를 사용 중지할 수 있습니다.
ITP 브라우저에서 업그레이드된 원탭 UX는 아래와 같이 시작 페이지로 시작됩니다. 사용자가 '계속'을 선택하면 팝업 창이 열립니다. 팝업 창의 UX는 일반적인 원탭과 매우 유사합니다.
Google 세션이 없으면 '계속' 버튼을 클릭한 후 사용자가 먼저 Google 계정에 로그인해야 합니다. 자세한 내용은 ITP 브라우저에서 원탭 지원을 참고하세요.
주요 사용자 경험
사용자 여정은 다음 상태에 따라 달라집니다.
Google 웹사이트의 세션 상태입니다. 다음 용어는 사용자 여정이 시작될 때 다른 Google 세션 상태를 나타내는 데 사용됩니다.
단일 세션: Google 웹사이트에 정확히 하나의 활성 세션이 있습니다.
다중 세션: Google 웹사이트에 활성 세션이 두 개 이상 있습니다.
사용자 여정이 시작될 때 선택된 Google 계정에서 웹사이트를 승인했는지 여부입니다. 다음 용어는 다양한 승인 상태를 나타내는 데 사용됩니다.
[null,null,["최종 업데이트: 2024-02-28(UTC)"],[[["\u003cp\u003eThis guide explains the One Tap user experience, including when it's displayed and user session behaviors.\u003c/p\u003e\n"],["\u003cp\u003eUsers can globally opt out of One Tap by disabling Google Account sign-in prompts in their account settings.\u003c/p\u003e\n"],["\u003cp\u003eOne Tap has cooldown periods where it won't display after being manually closed by the user, with varying durations.\u003c/p\u003e\n"],["\u003cp\u003eOn mobile browsers, One Tap automatically closes after 90 seconds of inactivity without triggering a cooldown.\u003c/p\u003e\n"],["\u003cp\u003eA different One Tap user experience is provided for ITP browsers like Chrome on iOS, Safari, and Firefox.\u003c/p\u003e\n"]]],[],null,["# Understand the One Tap user experience\n\nThis guide contains detailed descriptions of the One Tap user experience,\nincluding when One Tap is or is not displayed and user session behaviors.\n\nGlobally opt out\n----------------\n\nUsers can opt out of One Tap if they disable the Google Account sign-in prompts\nflag in the [Apps with access to your account](https://myaccount.google.com/permissions) page. The opted-out sessions\naren't shown in One Tap. If all Google sessions are opted out, One Tap doesn't\ndisplay.\n\nIf a user disables third-party sign-in on browsers with [FedCM enabled](/identity/gsi/web/guides/overview#federated_credential_manager_fedcm), One\nTap is not displayed. In Chrome settings under the Privacy and Security section\nusers control the display of [third-party sign-in](https://support.google.com/chrome/answer/14264742) prompts either globally\nor for individual sites.\n\nExponential cooldown\n--------------------\n\nIf the user closes the One Tap prompt manually, the One Tap prompt is\nsuppressed. A user closes One Tap when they tap **Close**\nclose in the\ntop-right corner of the prompt, after which One Tap wouldn't display in the\nsame browser or the last website visited for a period of time.\n\nThe following exponential time periods are used for cooldowns when FedCM is\n**not** enabled:\n\n| Consecutive times closed | Time period that One Tap is disabled |\n|--------------------------|--------------------------------------|\n| 1 | Two hours |\n| 2 | One day |\n| 3 | One week |\n| 4+ | Four weeks |\n\nThe cooldown status resets after a successful sign-in using One Tap or the Sign\nin with Google button.\n\nWhen FedCM is enabled, browser vendors may define their own, different, cooldown\ntime periods.\n| **Note:** When FedCM is enabled, Chrome users can reset cooldown status by clicking on the lock icon in the address bar and clicking the *Reset Permission* button.\n\nAuto-dismissal on mobile browsers\n---------------------------------\n\nOn **mobile** browsers, and when FedCM is not enabled, Google One Tap closes\nautomatically after a short time period unless the user directly interacts with\nthe One Tap UI.\n\nThe threshold for auto-dismissal is 90 seconds. This is subject to change.\n| **Note:** Auto-dismissal doesn't trigger a cooldown. Auto-dismissal doesn't happen on desktop, iPad, and tablet browsers.\n\nShow a dialog to prevent unintended clicks\n------------------------------------------\n\n| **Objective:** It's important that users understand the purpose of One Tap. They should be fully aware of the call to action when they give their consent to create an account, since they must share some personal information, such as their first name, last name, email, and profile picture.\n\nOne Tap now comes with different security measures to enforce the integrity of\nthe dialog, but some browsers don't support these capabilities. Unsupported\nbrowsers include non-Chromium-based ones or those before v75. In these cases, or\nif the dialog is covered with other content, a pop-up window is displayed that\nrequests the user's consent to create an account.\n\nUpgraded UX on ITP browsers\n---------------------------\n\nDue to\n[Intelligent Tracking Prevention](https://webkit.org/blog/9521/intelligent-tracking-prevention-2-3/) (ITP), the\nnormal One Tap UX doesn't work on Chrome on iOS, Safari, or Firefox. A different\nUX is provided instead on these browsers. You have the option to disable this UX\non ITP browsers by setting the [`data-itp_support`](/identity/gsi/web/reference/html-reference#data-itp_support) attribute.\n\nThe upgraded One Tap UX on ITP browsers begins with a welcome page as shown\nbelow. After the user selects Continue, a pop-up window is opened. The UX in the\npop-up window is very similar to normal One Tap.\n\nWhen there is no Google session, after the 'Continue' button is clicked, users\nmust first sign in to their Google Account. See\n[One Tap support on ITP browsers](/identity/gsi/web/guides/itp) for more details.\n| **Note:** To avoid the flashing pop-up issue, auto sign in isn't supported.\n\nKey user journeys\n-----------------\n\n| **Note:** Refer to [Automatic sign-in key user journeys](/identity/gsi/web/guides/automatic-sign-in-sign-out#key_user_journeys) for the UX flow when automatic sign-in is enabled.\n\nThe user journeys vary based on the following statuses.\n\n- Session status on Google websites. The following terms are used to indicate\n different Google session status when the user journey starts.\n\n - Single-session: There is exactly one active session on Google websites.\n - Multiple-session: There are more than one active sessions on Google websites.\n\n | **Key Point:** One Tap is not shown if there is no active session on Google websites.\n- Whether the selected Google Account has approved your website when the user\n journey starts. The following terms are used to indicate different approval\n status.\n\n - New user: The selected account hasn't approved your website.\n - Returning user: The selected account has approved your website before.\n\n### Single-session new user journey\n\n1. The new user consent page.\n\n2. The second confirmation dialog in a pop-up window for non-Chromium browsers.\n\n3. After users confirm, an ID token is shared with your website.\n\n### Single-session returning user journey\n\n1. The returning user page.\n\n2. After users click the button, an ID token is shared with your website.\n\n### Multiple-session new user journey\n\n1. The account chooser page.\n\n2. The consent page.\n\n For non-Chromium browsers, this confirmation dialog is displayed in a\n pop-up window:\n\n3. After user consent, an ID token is shared with your website.\n\n### Multiple-session returning user journey\n\n1. The account chooser page.\n\n2. After users select a returning account, an ID token is shared with your\n website."]]
