기기 알림 설정
기기 알림 설정은 웹 푸시 알림이 기기에 표시되지 않는 가장 일반적인 원인입니다. 다른 원인을 확인하기 전에 집중 모드(방해 금지, 배터리 부족 등)를 포함한 다음 설정을 먼저 확인하세요.- Windows
- macOS
- Android
- iOS
Windows 10 알림 설정
Windows 10 알림 설정
- 시작 > 설정 > 알림 및 작업 > 앱 및 기타 보낸 사람의 알림 받기를 선택합니다
- 사이트와 브라우저도 활성화되어 있는지 확인하세요.
- 시작 > 설정 > 시스템 > 알림을 선택합니다
- 알림을 켭니다
- 방해 금지를 끕니다 (테스트 중에는 이 옵션을 비활성화하면 푸시가 표시됩니다)
- 앱 및 기타 보낸 사람의 알림 아래로 스크롤합니다
- 브라우저가 켜져 있는지 확인하세요.
네트워크 문제 - 인터넷 없음
기기는 푸시 알림을 받으려면 온라인 상태여야 합니다. 기기가 꺼져 있거나 비행기 모드이거나 불안정하거나 인터넷 연결이 없는 경우 적절한 연결이 이루어질 때까지 푸시가 표시되지 않습니다. Time To Live (TTL) 매개변수로 FCM 및 APNs가 연결을 기다리는 기간을 설정할 수 있습니다(기본값은 3일). 또한 연결된 네트워크 / WiFi를 확인하세요. Apple 또는 Google 서버에 대한 연결이 닫혔을 수 있습니다. 인터넷 연결을 비활성화하고 다시 활성화하거나 셀룰러 데이터를 사용해 보세요. 자세한 내용은 알림 지연 문제 해결 가이드를 참조하세요.브라우저 알림 설정
브라우저에는 OS 설정과 별도의 알림 권한 설정이 있습니다. 브라우저에 대해 OS 알림이 활성화되어 있어도 사이트가 브라우저 수준에서 차단될 수 있습니다.- Chrome:
chrome://settings/content/notifications로 이동하여 사이트가 “알림 전송 허용” 아래에 있고 “알림 전송 허용 안 함” 아래에 없는지 확인하세요. - Firefox:
about:preferences#privacy로 이동하여 권한 > 알림까지 스크롤하고 설정을 클릭하여 사이트 상태를 확인하세요. - Edge:
edge://settings/content/notifications로 이동하여 사이트가 허용되어 있는지 확인하세요. - Safari: Safari > 설정 > 웹 사이트 > 알림으로 이동하여 사이트가 허용으로 설정되어 있는지 확인하세요.
브라우저가 닫힘
브라우저가 실행 중이 아니면 푸시 알림이 표시되지 않습니다. 전송된 알림의 Time To Live(TTL)이 만료되기 전에 브라우저를 열면 팝업됩니다.지원되지 않는 브라우저
사용자는 알림을 받으려면 데스크톱 또는 모바일 기기에서 알림을 구독해야 하며 푸시 알림을 지원하는 브라우저여야 합니다. 지원되는 웹 플랫폼은 Web Push FAQ를 참조하세요.모바일 브라우저 앱 데이터 가득 참
모바일 브라우저 앱이 데이터 한도에 도달했거나 데이터가 가득 찬 경우 앱의 데이터를 지워야 합니다. 모바일 브라우저 앱에 읽지 않은 푸시 알림이 많거나 열려 있는 탭이 많으면 알림이 표시되지 않을 수 있습니다.사용자 구독
기기가 여전히 구독되어 있고 푸시 알림의 대상이 되는지 확인하세요.구독 자격
메시지 대상을 확인하여 웹 푸시 구독이 포함되어 있는지 확인하세요:- 세그먼트: 구독이 모든 대상 필터 조건을 충족하는지 확인하세요.
- 직접 전송: 대상 ID가 올바른지 확인하세요:
- 구독이 여전히 푸시에 구독되어 있습니다.
- 최근 마지막 세션 날짜가 있습니다 — 오래되거나 비활성 구독에 전송하고 있을 수 있습니다.
웹사이트 코드베이스
Service Worker 등록 취소 또는 PWA 추가
사이트의 코드베이스에서.unregister() 메서드를 확인하세요. 이 메서드를 호출하면 Service Worker가 삭제됩니다. 이 메서드에 대한 자세한 내용은 이 가이드를 참조하세요.
PWA용과 같은 다른 Service Worker가 있는 경우 여러 Service Worker 통합에 대한 Service Worker 가이드를 따라야 합니다.
Web push 알림 디버깅
다음 단계에 따라 깨끗한 웹 푸시 구독을 얻고 웹 푸시가 엔드투엔드로 작동하는지 확인하세요.브라우저에서 사이트 열기
이 단계는 Chrome을 사용하지만 Edge, Firefox 등도 동일한 패턴을 따릅니다. 시크릿 모드나 게스트 브라우저 모드를 사용하지 말고 사이트에 열려 있는 다른 탭을 모두 닫으세요.
모바일 기기 디버깅
모바일 기기 디버깅
AndroidUSB 케이블로 Android 기기를 데스크톱에 연결하세요.
- Chrome: 데스크톱에서
chrome://inspect/#devices를 열고 모바일 기기에서 아래 단계를 따르세요. - Firefox: about:debugging을 참조하세요.
- iPhone 또는 iPad에서 설정 > Safari > 고급으로 이동하여 웹 인스펙터를 활성화하세요.
- USB 케이블로 기기를 Mac에 연결하세요.
- Mac에서 Safari를 열고 **개발 > [기기 이름] > [사이트 페이지]**로 이동하세요.
- 모바일 기기를 사용하여 아래 단계를 따르세요.
브라우저 권한 재설정 및 사이트 데이터 지우기
이것은 사이트를 처음 방문하는 상태로 시뮬레이션합니다.
- URL 옆의 사이트 정보 아이콘을 클릭하세요.
- 알림이 표시되면 권한 재설정을 선택하세요(“알림 전송 요청 가능”이 표시되어야 합니다).
- 쿠키 및 사이트 데이터를 클릭하세요.
- 기기의 사이트 데이터 관리를 클릭하세요.
- 다음 옆의 휴지통 아이콘을 클릭하세요:
- 사이트 URL
onesignal.com
- 탭을 닫고 새 탭에서 사이트를 다시 여세요.
콘솔 열기 및 푸시 알림 구독
- 새 탭에서 사이트로 돌아가면 페이지를 마우스 오른쪽 버튼으로 클릭하고 검사를 선택하여 콘솔을 여세요.
- 기본 브라우저 권한 프롬프트를 트리거하고 알림을 허용하도록 설정한 단계를 따르세요. 자세한 내용은 웹 권한 프롬프트를 참조하세요.
- 허용을 클릭하여 푸시 알림을 구독하세요.
- 콘솔에서 오류를 확인하세요. OneSignal과 관련된 빨간색 내용이 보이면 웹 SDK 문제 해결 문서를 참조하세요.
구독 ID 가져오기 및 테스트 구독으로 설정
- 콘솔에서 다음 코드를 실행하여 구독 ID를 가져오세요:
JavaScript
- 따옴표 없이 ID를 복사하세요.
- OneSignal 대시보드에서 대상 > 구독으로 이동하여 구독 ID(따옴표 없이)를 검색창에 붙여넣고 옵션 버튼을 클릭한 다음 테스트 구독으로 추가를 선택하세요.
도움이 필요하신가요?지원팀과 채팅하거나
support@onesignal.com으로 이메일을 보내주세요다음 내용을 포함해 주세요:- OneSignal App ID
- 구독 ID 또는 외부 ID
- OneSignal 대시보드에서 테스트한 메시지의 URL
- OneSignal 웹 SDK 코드가 있는 사이트의 URL