> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 웹 푸시 브라우저 동작

> 알림 수신을 해제하는 방법과 브라우저가 웹 푸시 구독을 처리하는 방법을 알아보세요.

이 가이드는 웹 푸시 [구독](./subscriptions)을 관리하는 방법과 사용자 작업 및 브라우저 동작에 따라 구독 상태가 어떻게 영향을 받는지 설명합니다.

***

## 푸시 권한 이해

사용자는 웹사이트에 푸시 알림을 보낼 수 있는 권한을 부여해야 합니다. 시스템 수준 권한 프롬프트를 사용하여 사이트에 명시적으로 권한을 부여하지 않으면 푸시 알림을 받을 수 없습니다.

<Frame caption="이 사이트에 대한 푸시 알림을 받으려면 '허용'을 클릭해야 하는 Chrome 필수 시스템 수준 권한 프롬프트의 예입니다.">
  <img src="https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/60324a7f57f452db6054d4442689b8fb7f269f8dc123cc5b4154481ae8b89db4-Screenshot_2025-04-07_at_12.08.33_PM.png?fit=max&auto=format&n=jFWn5xzleD8du3j6&q=85&s=6d9631d8e6c3fb165068b20259df4457" width="1578" height="974" data-path="images/docs/60324a7f57f452db6054d4442689b8fb7f269f8dc123cc5b4154481ae8b89db4-Screenshot_2025-04-07_at_12.08.33_PM.png" />
</Frame>

권한은 다음 중 하나일 수 있습니다:

* **기본값**: 권한이 부여되거나 거부되지 않았습니다.
* **허용됨**: 웹사이트가 알림을 보낼 수 있도록 허용했습니다.
* **거부됨**: 웹사이트가 알림을 보내는 것을 차단했습니다. 프롬프트를 반복적으로 닫기 위해 **x**를 클릭한 경우 임시 차단일 수 있으며 **차단**을 클릭하거나 브라우저 설정에서 권한을 끈 경우 영구 차단일 수 있습니다.

<Note>
  기본 시스템 수준 권한 프롬프트 및/또는 OneSignal 프롬프트에 대한 자세한 내용은 [웹 권한 프롬프트](./permission-requests)를 참조하세요.
</Note>

***

## 웹 알림 구독 해제 방법

세 가지 방법으로 웹 푸시 알림 수신을 해제할 수 있습니다:

### 브라우저 설정 내에서 구독 해제

브라우저 설정에서 직접 알림 권한을 관리하거나 제거할 수 있습니다. 자세한 내용은 빠른 액세스 URL 및 공식 문서를 참조하세요:

* **Chrome**: `chrome://settings/content/notifications` ([Chrome 문서에서 자세히 알아보기](https://support.google.com/chrome/answer/3220216?hl=en\&co=GENIE.Platform%3DDesktop\&sjid=12874758545589453111-NA))
* **Edge**: `edge://settings/content/notifications` ([Microsoft 문서에서 자세히 알아보기](https://www.microsoft.com/en-us/edge/learning-center/how-to-turn-off-block-browser-notifications?form=MA13I2))
* **Firefox**: `about:preferences#privacy` 권한 > 알림 > 설정으로 스크롤 ([Mozilla 문서에서 자세히 알아보기](https://support.mozilla.org/en-US/kb/push-notifications-firefox))
* **Safari**: 설정 > 웹사이트 > 알림 ([Safari 문서에서 자세히 알아보기](https://support.apple.com/guide/safari/customize-website-notifications-sfri40734/16.1/mac/13.0))

이러한 페이지에서 알림을 원하지 않는 웹사이트를 제거하거나 차단하는 옵션을 클릭하기만 하면 됩니다.

### 웹사이트에서 구독 해제

**권한 재설정**

대부분의 브라우저에는 URL 옆에 "자물쇠" 또는 "설정" 아이콘이 있습니다. 클릭하면 사용자가 푸시 알림을 비활성화할 수 있는 사이트별 권한이 표시됩니다.

<Frame caption="사이트에 대한 푸시 권한을 완전히 끄거나 권한을 재설정하여 사이트가 다시 프롬프트를 표시할 수 있도록 하는 Chrome 브라우저의 예입니다.">
  <img src="https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/6264e883e1d4c19f71712be79859cf48e26a47d4283571846d3e585ca2d26d6b-Screenshot_2025-04-07_at_10.56.32_AM.png?fit=max&auto=format&n=jFWn5xzleD8du3j6&q=85&s=38fbcf821abf6b7077e5e4b1e736ecb9" width="1636" height="974" data-path="images/docs/6264e883e1d4c19f71712be79859cf48e26a47d4283571846d3e585ca2d26d6b-Screenshot_2025-04-07_at_10.56.32_AM.png" />
</Frame>

**OneSignal 프롬프트**

웹사이트에 OneSignal [벨 프롬프트](./permission-requests) 또는 [사용자 지정 링크 프롬프트](./permission-requests)가 포함되어 있는 경우 사용자는 해당 UI 요소를 통해 직접 구독을 해제하고 원하는 경우 동일한 방법으로 다시 구독할 수 있습니다.

<Frame caption="OneSignal 벨 프롬프트의 예입니다.">
  <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/400a59de59dcc7ec2cb46e09a29f99bbd1da11861bba418e76e7a0b90f86ed4d-Screenshot_2025-04-07_at_10.59.38_AM.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=3226ef886346ee6abbc25ebb17abf36b" width="1636" height="974" data-path="images/docs/400a59de59dcc7ec2cb46e09a29f99bbd1da11861bba418e76e7a0b90f86ed4d-Screenshot_2025-04-07_at_10.59.38_AM.png" />
</Frame>

### 브라우저 데이터 삭제, 쿠키 및 사이트 데이터 지우기

기록을 삭제하거나 쿠키 및 사이트 데이터를 삭제하면 알림이 일시적으로 표시되지 않습니다. 그러나 사이트에서 푸시 권한을 제거하지 않으면 자동으로 다시 구독되어 사이트로 돌아갈 때 알림을 다시 받기 시작할 수 있습니다.

<Frame caption="브라우저 기록 및 사이트 데이터 지우기의 예입니다.">
  <img src="https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/5e463a765566c11fee159b98a88f0a66314be75e16d7963296b53cfb880d0640-Screenshot_2025-04-07_at_11.56.43_AM.png?fit=max&auto=format&n=jFWn5xzleD8du3j6&q=85&s=c133664ca1396ee6ed0dcc03c20f9c9b" width="2962" height="1458" data-path="images/docs/5e463a765566c11fee159b98a88f0a66314be75e16d7963296b53cfb880d0640-Screenshot_2025-04-07_at_11.56.43_AM.png" />
</Frame>

<br />

<Frame caption="사이트 데이터 지우기의 예입니다.">
  <img src="https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/9e18eb2c46e65b05e98bfe488268daaf8e1cb3d958767393b9e935de3189327c-Screenshot_2025-04-07_at_11.56.34_AM.png?fit=max&auto=format&n=6tscVAtiSqz353kV&q=85&s=56d550b0d11955804d5b7f6a71544125" width="2962" height="1458" data-path="images/docs/9e18eb2c46e65b05e98bfe488268daaf8e1cb3d958767393b9e935de3189327c-Screenshot_2025-04-07_at_11.56.34_AM.png" />
</Frame>

***

## 권한 프롬프트를 테스트하는 방법

이 단계는 처음 방문하는 사용자처럼 프롬프트 및 구독 흐름을 테스트하는 방법을 설명합니다.

<Steps>
  <Step title="OneSignal SDK가 설정된 사이트를 방문하세요.">
    **시크릿, 프라이빗 또는 게스트 브라우저 설정을 사용하지 마세요.** 이 예제는 macOS에서 Chrome 버전 135를 사용하지만 대부분의 브라우저에서 흐름은 비교적 동일해야 합니다.
  </Step>

  <Step title="푸시 권한 재설정">
    사이트 URL 옆에 있는 사이트 설정 또는 자물쇠 아이콘을 클릭하고 **권한 재설정**을 선택하거나 알림 권한을 제거하세요.
    이 권한 옵션이 표시되지 않으면 다음 단계로 건너뛰세요.

    <Frame caption="Chrome 사이트 설정 메뉴 > 알림 권한 재설정.">
      <img src="https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/0caa8967d5d339eb83795e9c8aae6fd58dfb370e7937eec2689286bc37b7d3ad-Screenshot_2025-04-07_at_1.15.10_PM.png?fit=max&auto=format&n=6v_cVPknFpo5qSVB&q=85&s=cc627d94184116ba58ab88a9ebd192b3" width="1642" height="1038" data-path="images/docs/0caa8967d5d339eb83795e9c8aae6fd58dfb370e7937eec2689286bc37b7d3ad-Screenshot_2025-04-07_at_1.15.10_PM.png" />
    </Frame>
  </Step>

  <Step title="사이트 데이터를 삭제하세요.">
    **쿠키 및 사이트 데이터 > 기기 내 사이트 데이터 관리**를 클릭하거나 브라우저의 흐름을 따라 사이트의 데이터 옵션을 확인하세요.

    <Frame caption="Chrome의 기기 내 사이트 데이터 화면.">
      <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/3ddc97a656d2a7e72851bb723c3ef6bb7cf451f43f2980b6e16326b34ad0694d-Screenshot_2025-04-07_at_1.17.51_PM.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=cc96365a817a37b63a008bf300dba8b2" width="1642" height="1264" data-path="images/docs/3ddc97a656d2a7e72851bb723c3ef6bb7cf451f43f2980b6e16326b34ad0694d-Screenshot_2025-04-07_at_1.17.51_PM.png" />
    </Frame>

    사이트의 데이터를 삭제하고 설정을 종료하여 사이트로 돌아가세요.

    <Frame caption="사이트 쿠키 지우기의 예입니다.">
      <img src="https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/14356bf800a63a9cb7ce3396c86ab636720ff152d65f266cb253142266b246d2-Screenshot_2025-04-07_at_1.22.02_PM.png?fit=max&auto=format&n=tNi1OgLc_p9hiq7_&q=85&s=61dcb2f2c4967bf79dfd609b820a2507" width="1554" height="1216" data-path="images/docs/14356bf800a63a9cb7ce3396c86ab636720ff152d65f266cb253142266b246d2-Screenshot_2025-04-07_at_1.22.02_PM.png" />
    </Frame>
  </Step>

  <Step title="개발자 도구를 여세요.">일반적으로 화면을 마우스 오른쪽 버튼으로 클릭하고 **검사**를 누르기만 하면 됩니다.</Step>

  <Step title="푸시 알림을 프롬프트하는 데 필요한 단계를 따르고 필수 시스템 수준 권한 프롬프트에서 &#x22;허용&#x22;을 선택하세요.">
    프롬프트가 표시되지 않거나 단계를 모르는 경우 [웹 권한 프롬프트](./permission-requests)를 참조하세요.

    <Frame caption="Chrome 필수 시스템 수준 프롬프트의 예입니다.">
      <img src="https://mintcdn.com/onesignal/tc0EvmtSSX56SX0c/images/docs/99abfc40c2cbce6d99a32295716ba683e77a1ef4c3d8e26736d1448a62513703-Screenshot_2025-04-07_at_1.22.55_PM.png?fit=max&auto=format&n=tc0EvmtSSX56SX0c&q=85&s=d522e924e8cf68c5e2e331705571159b" width="1642" height="1038" data-path="images/docs/99abfc40c2cbce6d99a32295716ba683e77a1ef4c3d8e26736d1448a62513703-Screenshot_2025-04-07_at_1.22.55_PM.png" />
    </Frame>
  </Step>

  <Step title="콘솔에서 오류를 확인하세요.">
    OneSignal과 관련된 빨간색 내용이 보이면 [웹 SDK 문제 해결](./troubleshooting-web-push) 문서를 참조하세요.
  </Step>

  <Step title="구독 ID 가져오기">
    **콘솔**에 이 코드를 입력하거나 복사하여 붙여넣으세요: `OneSignal.User.PushSubscription.id`

    1. OneSignal 구독 ID가 기록됩니다. 이것을 OneSignal 대시보드 Audience > Subscriptions 탭에 복사하여 붙여넣으세요.
    2. 구독 ID가 콘솔에 기록되지 않은 경우 성공적으로 구독되지 않은 것입니다. 자세한 내용은 [웹 SDK 문제 해결](./troubleshooting-web-push)을 참조하세요.

    <Frame caption="콘솔을 사용하여 푸시 구독 ID를 가져오는 방법.">
      <img src="https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/0585c363af7bf9154c7cd204b9ce4636049694af313c80564ab94c75dc898da3-Screenshot_2025-04-07_at_1.35.26_PM.png?fit=max&auto=format&n=6v_cVPknFpo5qSVB&q=85&s=96e4c0b9515e7e62cb3e29ed0afdc8a5" width="1642" height="1038" data-path="images/docs/0585c363af7bf9154c7cd204b9ce4636049694af313c80564ab94c75dc898da3-Screenshot_2025-04-07_at_1.35.26_PM.png" />
    </Frame>

    <Frame caption="OneSignal 대시보드 Subscriptions 페이지에서 구독 ID 보기.">
      <img src="https://mintcdn.com/onesignal/tc0EvmtSSX56SX0c/images/docs/97de08625efcb3ae048d8db0ce79ab6400d4edb1e32fb586ee2ccfdec64ef533-Screenshot_2025-04-07_at_1.35.39_PM.png?fit=max&auto=format&n=tc0EvmtSSX56SX0c&q=85&s=f0e59d2577e9301240efca039c941212" width="2268" height="1320" data-path="images/docs/97de08625efcb3ae048d8db0ce79ab6400d4edb1e32fb586ee2ccfdec64ef533-Screenshot_2025-04-07_at_1.35.39_PM.png" />
    </Frame>
  </Step>

  <Step title="구독 옆에 있는 3점 옵션 버튼을 선택하고 &#x22;테스트 구독에 추가&#x22;를 선택하세요. 그런 다음 테스트 사용자의 이름과 날짜를 지정하여 식별할 수 있도록 하세요.&#x22;">
    <Frame caption="구독을 테스트 구독으로 추가하세요.">
      <img src="https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/daee83f7f444a1361390186abfd493252ae59b8ffbdb42f4a14fd979f2f9e268-Screenshot_2025-04-07_at_1.35.46_PM.png?fit=max&auto=format&n=Z6xkXGfmy814If53&q=85&s=65ddc58a9861c912ccc19abe1225c6aa" width="2268" height="1320" data-path="images/docs/daee83f7f444a1361390186abfd493252ae59b8ffbdb42f4a14fd979f2f9e268-Screenshot_2025-04-07_at_1.35.46_PM.png" />
    </Frame>
  </Step>

  <Step title="Messages > Push > New Message > New Push로 이동하고 푸시 생성 양식에서 메시지를 추가하세요.">
    필요한 경우 [Push](./push)에서 자세한 내용을 참조하세요.

    <Frame caption="테스트 구독으로 보낼 새 푸시를 만드세요.">
      <img src="https://mintcdn.com/onesignal/3zq1PvSaqvUE2bIx/images/docs/2b9d9a6022f8c8566fe9ab63dde56ef8a6dc5bca9e4a1902c5b939748eea696a-Screenshot_2025-04-07_at_1.39.55_PM.png?fit=max&auto=format&n=3zq1PvSaqvUE2bIx&q=85&s=c153b7d978104a1639d5b2269871c7ce" width="2268" height="1320" data-path="images/docs/2b9d9a6022f8c8566fe9ab63dde56ef8a6dc5bca9e4a1902c5b939748eea696a-Screenshot_2025-04-07_at_1.39.55_PM.png" />
    </Frame>
  </Step>

  <Step title="&#x22;Test & Preview&#x22;를 선택하고 테스트 구독을 찾아 확인한 다음 &#x22;Send Test Push&#x22;를 클릭하세요.">
    <Frame caption="자신에게 테스트 푸시를 보내세요.">
      <img src="https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7829f46df767772414b32b05edb166a59b3d853b054263057dbb3042c1f13606-Screenshot_2025-04-07_at_1.41.19_PM.png?fit=max&auto=format&n=jBdBk5XvQR5eKOks&q=85&s=b6efff85cdd63ce7b1ebfd41394d8f49" width="2268" height="1320" data-path="images/docs/7829f46df767772414b32b05edb166a59b3d853b054263057dbb3042c1f13606-Screenshot_2025-04-07_at_1.41.19_PM.png" />
    </Frame>
  </Step>

  <Step title="테스트한 푸시를 받아야 합니다.">
    푸시를 받지 못한 경우 추가 디버깅을 위해 [웹 푸시: 알림이 표시되지 않음](./notifications-not-shown-web-push)을 참조하세요.

    <Frame caption="테스트 푸시를 받았습니다.">
      <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/81a55eefc69a1cc6e4aba2bc240e780bb8cb5bdcafac2891862e3c11f1d45591-Screenshot_2025-04-07_at_1.43.07_PM.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=c779697abc1576141e9a542bec927be2" width="740" height="198" data-path="images/docs/81a55eefc69a1cc6e4aba2bc240e780bb8cb5bdcafac2891862e3c11f1d45591-Screenshot_2025-04-07_at_1.43.07_PM.png" />
    </Frame>
  </Step>
</Steps>

<Check>
  OneSignal로 웹 푸시를 성공적으로 설정했습니다. 다음 단계:

  * [웹 푸시 설정](./web-push-setup) - 개발자가 아닌 추가 웹 설정 단계.
  * [웹 SDK 설정](./web-sdk-setup) - 개발자 웹 SDK 설정 단계.
  * [웹 SDK 문제 해결](./troubleshooting-web-push) - 콘솔에서 오류가 표시되거나 구독 ID를 가져오지 못하는 경우 문제 해결.
  * [웹 푸시: 알림이 표시되지 않음](./notifications-not-shown-web-push) - 기기에 알림이 표시되지 않는 경우 문제 해결.
</Check>

***

### 브라우저가 닫혀 있을 때 알림 받기

브라우저는 플랫폼마다 다르게 동작합니다. 브라우저가 닫혀 있을 때도 알림을 받을 수 있는지 지원 여부는 아래 표를 참조하세요.

| 브라우저 이름           | Android | Windows | macOS |
| ----------------- | ------- | ------- | ----- |
| Chrome / Chromium | Yes     | Yes     | No    |
| Firefox           | Yes     | Yes     | No    |
| Safari            | N/A     | N/A     | Yes   |
| Opera             | Yes     | Yes     | No    |
| Edge              | Yes     | Yes     | No    |

**Chrome** - Chrome은 모든 창이 닫혀 있어도 기본적으로 백그라운드 프로세스로 실행됩니다. 백그라운드 프로세스가 실행되는 한 알림은 계속 수신됩니다. Chrome 백그라운드 프로세스가 실행되고 있지 않으면 알림을 받을 수 없습니다.

**Firefox** - Mac OS X에서는 창이 닫혀 있어도 프로세스가 여전히 존재하며 모든 창이 닫혀 있어도 알림을 받을 수 있습니다(Dock에 Firefox가 여전히 실행 중임을 나타내는 점이 있는 한). Windows에서는 모든 창이 닫힌 후 프로세스가 종료되므로 Firefox 창이 여전히 열려 있지 않으면 알림을 받을 수 없습니다.

**Safari** - Safari는 알림이 운영 체제로 직접 전송되므로 알림을 받기 위해 실행 중일 필요가 없습니다. 사용자는 Safari 웹 알림에 가입해야 하지만 그 이후에는 Safari가 완전히 닫혀 있어도 알림을 받을 수 있습니다.

구독자는 메시지가 영구적으로 만료되기 전에 마지막으로 알려진 누락된 알림을 검색할 수 있는 최대 3일이 있습니다.

예를 들어 구독자가 Firefox 웹 푸시 알림을 받기로 되어 있었지만 Firefox가 닫혀 있었다고 가정합니다. 구독자가 3일 이내에 Firefox를 열면 만료되지 않은 마지막으로 알려진 웹 푸시 알림만 받게 됩니다. 구독자가 3일 후에 Firefox를 열면 3일 이상 전에 전송된 웹 푸시 알림은 수신되지 않습니다.

***