重複通知

​

OneSignal が重複配信を防止する仕組み

​

まずここから

• 独自のバックエンドまたはパイプラインから API 経由でメッセージを送信している → 同じメッセージが複数回送信される
• アプリが OneSignal と並行して Firebase または別のプッシュ SDK を使用している → サードパーティ通知ハンドラー
• Android アプリがコードで通知をカスタマイズしている（サービス拡張機能またはフォアグラウンドリスナー）→ Android 通知ハンドラー
• iOS アプリが独自の UNUserNotificationCenterDelegate を実装している → iOS フォアグラウンドハンドラー
• 開発ビルドまたは複数のインストールでのみ重複が見られる → 複数のアプリインスタンス
• Android でアプリを開いたときに、以前配信された古い通知が再表示される → これらは復元された通知であり、重複ではありません。復元された通知を参照してください

​

同じメッセージが複数回送信される

• サーバーが最初のリクエストが成功したかどうかを確認せずにリクエストを再試行します。
• バックエンドパイプラインのロジックが同じ通知を 2 回送信しています。
• 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() を呼び出すと、通知が 2 回表示されます。
• OneSignal がオリジナルを表示している間に NotificationManagerCompat.notify() で別の通知を投稿する。

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

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

@Override
public void onNotificationReceived(INotificationReceivedEvent event) {
    event.preventDefault();

    IDisplayableMutableNotification notification = event.getNotification();
    notification.setExtender(builder ->
        builder.setColor(0xFF0000FF)
    );
    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

​

アプリに 2 つの通知 SDK がある場合はどうなりますか？

​

以前のプロバイダーと OneSignal から同時にプッシュを送信するには？

• Android：OneSignal を統合してアプリをリリースする際に、古い SDK の通知処理コードを削除します。ユーザーが更新すると、古いプロバイダーからのプッシュを受信しなくなります。
• iOS：ユーザーが更新している間、一時的に古いプロバイダーから送信を続けることができます。完全に移行したら、重複を避けるために OneSignal からのみ送信してください。

​

OneSignal にはオーディエンスへの重複送信を防ぐ仕組みがありますか？

​

急速に変化する更新に対して複数の通知を防ぐには？

​

関連ページ