메인 콘텐츠로 건너뛰기
모바일 앱이 아닌 웹사이트에 문제가 있는 경우 Web Push 문제 해결 가이드를 참조하세요.

​
문제 해결 단계

​
1. 설정 지침 검토 및 OneSignal SDK 업데이트

Mobile SDK 설정 지침은 일반적인 문제를 방지하고 통합을 테스트하는 데 도움이 되도록 설계되었습니다. 업데이트를 정기적으로 릴리스하여 버그 수정, 개선 사항 및 최신 운영 체제 변경 사항을 지원합니다. 문제가 발생하는 경우 먼저 최신 SDK 버전을 사용하고 설정 지침을 따랐는지 확인하세요.

​
2. 일반적인 문제 해결 가이드

알림이 표시되지 않거나 지연됨

푸시 알림을 보냈지만 장치에 표시되지 않거나 지연됩니다.

알림 이미지가 표시되지 않음

알림의 확장된 보기에 알림 이미지가 표시되지 않습니다.

알림 CTR

알림 클릭률이 낮거나 클릭이 없습니다.

중복 알림

알림이 여러 번 표시됩니다.

In-app 메시지 문제 해결

In-app 메시지의 일반적인 문제를 해결하세요.

​
3. SDK용 예제 프로젝트 테스트

엔지니어링 팀에서 각 SDK용으로 생성한 빌드를 사용하여 문제를 재현할 수 있는지 확인하세요.

​
4. 오류 로그 확인

문제를 진단하기 전에 로그 데이터를 수집하는 것이 중요합니다:
  • 디버그 로그 캡처 가이드를 따르세요.
  • 동작을 설명할 수 있는 오류, 경고 또는 사용 중단 알림을 찾으세요.

​
5. 지원팀에 문의

여전히 문제가 있는 경우:
  • support@onesignal.com에 다음 정보를 포함하여 문의하세요:
    • OneSignal App ID
    • 문제가 발생한 장치의 External ID 및/또는 Subscription ID
    • 해당하는 경우 알림 ID 또는 OneSignal 대시보드의 알림 링크
    • 가능한 경우 문제를 재현하는 장치의 디버그 로그

​
일반적인 오류

​
APNS Delegate never fired

“Apns Delegate Never Fired” 및 “APNS 3000”과 같은 APNS 오류는 Apple에서 제공하는 타임아웃 메시지로, 장치가 푸시 알림에 필요한 Apple의 APNS 서버에 연결할 수 없음을 나타냅니다. 다음과 같은 경우에 가장 일반적입니다:
  • APNS 개발 환경에서 테스트하는 경우
  • OneSignal과 함께 여러 푸시 알림 종속성 또는 네이티브 iOS 푸시 API를 사용하는 경우
  • 사용자가 다음에 새 세션을 시작할 때(앱이 30초 이상 포커스를 잃었다가 다시 열림) 자동으로 해결되는 일시적인 오류
해결 단계:
  • 다른 푸시 알림 종속성 또는 네이티브 iOS 푸시 API를 제거하고 OneSignal만 사용하세요. 오류가 해결되면 다른 코드를 다시 추가하고 모범 사례는 support@onesignal.com에 문의할 수 있습니다.
  • 자세한 내용은 장치의 디버그 로그를 확인하세요.
  • 오류가 지속되면 다음 단계에 따라 지원팀에 문의하세요.

​
FAQ

​
앱에서 OneSignal App ID를 변경하면 어떻게 되나요?

앱의 초기화 코드에서 OneSignal App ID를 변경하면 사용자가 앱을 최신 버전으로 업데이트하고 열 때 새로운 App ID 아래에 완전히 새로운 사용자 및 푸시 Subscription이 생성됩니다. iOS 번들 ID 및/또는 Android 패키지 ID가 동일한 경우 장치는 동일한 푸시 Subscription 상태를 유지합니다. 사용자 데이터는 완전히 새로운 것이므로 새 레코드에 Alias, 태그, 이메일 주소, 전화번호를 다시 추가해야 합니다. iOS 번들 ID 또는 Android 패키지 ID가 다른 경우 이는 완전히 새로운 앱이며 다른 푸시 인증서/키가 있어야 합니다.

​
OneSignal이 온프레미스 폐쇄형 네트워크에서 푸시 알림을 보낼 수 있나요?

폐쇄형 네트워크의 컴퓨터가 지원하려는 푸시 게이트웨이 서버에 액세스할 수 있는 한 작동할 수 있습니다: 네트워크가 인터넷에서 완전히 분리된 경우 표준 OS/브라우저 서비스를 통해 푸시 알림을 전달할 수 없으며, 이는 당사가 지원하는 것입니다.