중복 알림

​

여기서 시작하세요

• 서버가 실패한 API 호출을 재시도하거나 백엔드 파이프라인이 이중 전송할 수 있습니다 → 동일한 메시지가 여러 번 전송됨
• 앱이 OneSignal과 함께 Firebase 또는 다른 푸시 SDK를 사용합니다 → 서드파티 알림 핸들러
• Android 앱이 코드에서 알림을 커스터마이즈합니다(서비스 확장 또는 포그라운드 리스너) → Android 알림 핸들러
• iOS 앱이 자체 UNUserNotificationCenterDelegate를 구현합니다 → iOS 포그라운드 핸들러
• 개발 빌드 또는 여러 번 설치했을 때만 중복이 나타납니다 → 다중 앱 인스턴스

​

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

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

​

서드파티 알림 핸들러

• 동일한 페이로드를 수신하는 다른 원격 푸시 SDK(예: Firebase Cloud Messaging).
• Android의 FirebaseMessagingService 또는 iOS의 UNUserNotificationCenterDelegate와 같이 수신 페이로드를 읽고 로컬 알림을 구성하는 커스텀 메시지 핸들러.

​

OneSignal 알림 식별

{
  "custom": {
    "i": "the-notification-id"
  }
}

​

서드파티 핸들러에서 OneSignal 알림 필터링

override fun onMessageReceived(remoteMessage: RemoteMessage) {
    val customJson = remoteMessage.data["custom"]
    if (customJson != null) {
        try {
            val custom = JSONObject(customJson)
            if (custom.has("i")) {
                // OneSignal 알림——OneSignal SDK가 처리하도록 합니다
                return
            }
        } catch (e: JSONException) {
            // OneSignal 페이로드가 아니므로 계속 진행합니다
        }
    }

    // 여기서 자체 알림을 처리합니다
}

func userNotificationCenter(_ center: UNUserNotificationCenter,
                            willPresent notification: UNNotification,
                            withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
    let userInfo = notification.request.content.userInfo

    if let custom = userInfo["custom"] as? [String: Any], custom["i"] != nil {
        // OneSignal 알림——OneSignal SDK가 처리하도록 합니다
        completionHandler([])
        return
    }

    // 여기서 자체 알림을 처리합니다
}

​

Android 알림 핸들러

• 알림 서비스 확장의 onNotificationReceived——앱이 백그라운드에 있을 때를 포함하여 모든 푸시에서 실행됩니다.
• 포그라운드 생명주기 리스너의 onWillDisplay——앱이 포그라운드에 있을 때만 실행됩니다.

​

preventDefault() 및 display() 규칙

• 먼저 event.preventDefault()를 호출하지 않고 event.getNotification().display()를 호출하면——알림이 두 번 표시됩니다.
• OneSignal이 원본을 표시하는 동안 NotificationManagerCompat.notify()로 별도의 알림을 게시하는 경우.

override fun onNotificationReceived(event: INotificationReceivedEvent) {
    event.preventDefault()

    val notification = event.notification
    notification.setExtender { builder ->
        builder.setColor(0xFF0000FF.toInt())
    }
    notification.display()
}

OneSignal.Notifications.addForegroundLifecycleListener(object : INotificationLifecycleListener {
    override fun onWillDisplay(event: INotificationWillDisplayEvent) {
        event.preventDefault()

        // 자체 UI를 렌더링하거나 event.notification.display()를 호출하여 OneSignal 알림을 표시합니다
    }
})

​

콜백 내 비동기 작업

​

iOS 포그라운드 핸들러

• OneSignal로 호출을 전달하지 않고 자체 UNUserNotificationCenterDelegate를 구현한 후, 동일한 메서드에서 completionHandler([.banner, .sound])를 호출하고 커스텀 인앱 알림을 표시하는 경우.
• OneSignal이 표시하는 수신 푸시에 응답하여 로컬 알림(UNUserNotificationCenter.current().add(...))을 예약하는 경우.

OneSignal.Notifications.addForegroundLifecycleListener(self)

func onWillDisplay(event: OSNotificationWillDisplayEvent) {
    event.preventDefault()

    // 자체 UI를 렌더링하거나 event.notification.display()를 호출하여 OneSignal 알림을 표시합니다
}

​

다중 앱 인스턴스

​

진단 팁

• 중복을 수신한 기기의 OneSignal 구독 ID
• OneSignal 메시지 ID 또는 대시보드의 메시지 링크
• 앱의 다른 라이브러리 또는 플러그인 목록
• 문제를 재현하는 디버그 로그
• 자세한 재현 단계

​

FAQ

​

앱에 두 개의 알림 SDK가 있으면 어떻게 되나요?

​

이전 제공업체와 OneSignal에서 동시에 푸시를 보내는 방법은 무엇인가요?

• Android: OneSignal을 통합하고 앱을 출시할 때 이전 SDK 알림 처리 코드를 제거하세요. 사용자가 업데이트하면 이전 제공업체에서 푸시를 받지 않게 됩니다.
• iOS: 사용자가 업데이트하는 동안 일시적으로 이전 제공업체에서 계속 보낼 수 있습니다. 완전히 전환되면 중복을 피하기 위해 OneSignal에서만 보내세요.

​

빠르게 변하는 업데이트에 대한 여러 알림을 방지하는 방법은 무엇인가요?

​

관련 페이지