메인 콘텐츠로 건너뛰기
이 가이드는 중복 푸시 알림 수신과 관련된 문제를 해결하는 데 도움을 줍니다. 중복 인앱 메시지가 표시되는 경우 중복 인앱 메시지 가이드를 참조하세요.
• Apple은 중복을 유발한 iOS 17의 버그를 인정했습니다. 이는 iOS 17.3에서 수정되었습니다. 자세히 보기. • OneSignal Android SDK 버전 4.4.1 – 4.6.2를 사용하는 경우 알려진 문제를 피하기 위해 최신 버전으로 업데이트하세요.

​
동일한 메시지가 여러 번 전송됨

중복 알림의 가장 일반적인 원인은 OneSignal API를 통해 동일한 알림 페이로드를 두 번 이상 전송하는 것입니다.

​
일반적인 이유:

  • 서버가 첫 번째 요청이 성공했는지 확인하지 않고 요청을 재시도합니다.
  • 백엔드 알림 파이프라인의 우발적인 로직 중복.
  • OneSignal로 마이그레이션했지만 이전 제공업체에서 여전히 알림을 보내고 있습니다. 두 시스템에서 동시에 보내는 것을 피하세요.

​
다중 푸시 알림 SDK

앱에 다른 푸시 알림 SDK(예: Firebase, Urban Airship)가 포함되어 있는지 확인하세요. 이들은 OneSignal 알림을 처리하고 표시할 수도 있습니다.
  • OneSignal은 유일한 SDK일 때 중복을 피하기 위한 로직을 포함합니다.
  • 다른 SDK는 OneSignal의 페이로드를 인식하고 필터링하지 못할 수 있어 여러 번 표시됩니다.
SDK 상호 운용성에 대한 자세한 내용은 아래 FAQ를 참조하세요.

​
다중 앱 인스턴스

  • Android
  • IOS
  • Web Push

​
Android

다음과 같은 경우 중복 알림이 발생할 수 있습니다:
  • 프로덕션 및 개발 버전의 앱이 모두 설치되어 있습니다.
  • 각 앱에는 고유한 패키지 이름이 있고 자체 푸시 토큰을 받습니다.
알림을 길게 눌러 어느 앱 인스턴스에서 온 것인지 확인하세요.

​
진단 팁

중복 문제를 더 빠르게 디버그하는 데 도움을 주려면 다음을 수집하여 보내주세요:
  • OneSignal SDK 버전
  • 기기 OS 버전
  • 빌드 환경(Mac/Windows)
  • Xcode 로그 또는 logcat 출력
  • 앱의 다른 라이브러리/플러그인 목록
  • 자세한 재현 단계

​
FAQ

  • Android: OneSignal은 "i" 필드가 있는 "custom" 키를 포함하는 알림만 처리합니다. 이전 SDK가 이 키를 확인하지 않으면 동일한 알림을 처리하고 표시할 수도 있습니다.
  • iOS: 모든 알림이 시스템 트레이에 나타납니다. 두 SDK가 동일한 메시지를 보내면 사용자는 두 번 보게 됩니다. 권장 사항: iOS 클릭 처리의 경우 처리하기 전에 "custom" 페이로드를 확인하거나 자체 페이로드 키를 사용하여 중복 처리를 피하세요.
  • Android: OneSignal을 통합하고 앱을 출시할 때 이전 SDK 알림 처리 코드를 제거하세요. 사용자가 업데이트하면 이전 제공업체에서 푸시를 받지 않게 됩니다.
  • iOS: 사용자가 업데이트하는 동안 일시적으로 이전 제공업체에서 계속 보낼 수 있습니다. 완전히 전환되면 중복을 피하기 위해 OneSignal에서만 보내세요.