データとバックグラウンド通知

​

サイレント通知とは？

​

制限事項

• アプリがサイレントプッシュを受信できない場合：
  • iOS：アプリスイッチャーからスワイプして消した場合など、ユーザーがアプリを閉じた場合。（Appleサポートを参照）。
  • Android：デバイス設定を通じてアプリが強制終了された場合、またはスワイプして消したときに一部のメーカーによって自動的に終了された場合。（詳細はこちら）。
• 配信は保証されません：
  • AppleとGoogleの両方がサイレント通知をベストエフォートとして扱います。iOSは低電力モード、バックグラウンドアプリの更新がオフ、またはユーザーがアプリを閉じた場合に配信を遅延またはドロップする可能性があります。AndroidはDozeまたはOEMの省電力ルールの下で配信を制限またはバッチ処理する可能性があります。
  • このため、サイレント通知は重要な更新には使用しないでください。
• 購読ユーザーのみ：OneSignal SDKは購読しているサブスクリプションにのみデータ通知を送信します。非購読ユーザーに到達するには、この回避策に従ってください。
• クロスプラットフォームSDKの限定的なサポート：
  • サイレント通知は、ネイティブコード（AndroidのJava/Kotlin、iOSのSwift/Obj-C）で処理する必要があります。
  • iOSはapplication:didReceiveRemoteNotification:fetchCompletionHandler:の実装が必要です。
  • Androidは通知サービス拡張機能の実装が必要です。

​

OneSignalからサイレント通知を送信

​

APIペイロードの例

curl -X POST https://api.onesignal.com/notifications \
  -H "Authorization: Key YOUR_APP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "app_id": "YOUR_APP_ID",
    "include_aliases": { "external_id": ["user-123"] },
    "target_channel": "push",
    "content_available": true,
    "data": {
      "action": "sync_data",
      "version": "2"
    }
  }'

​

プラットフォーム固有の設定

​

iOSバックグラウンド通知の設定

• Pushing Background Updates to Your App
• Generating a Remote Notification

​

Androidデータ通知の設定

• アプリが強制終了されていない限り通知を処理
• 通知の表示または抑制方法をカスタマイズ

• FCMデータメッセージ
• DozeとApp Standbyへの最適化

​

VoIP通知の送信

​

FAQ

​

サイレント通知をアンインストールまたは購読解除の検出に使用できますか？

• 少なくとも月に1回、すべてのユーザーに可視通知（コンテンツを含む）を送信してください。
• オプションで補足チェックとしてサイレント通知を送信してください。

​

確認配信はサイレント通知で機能しますか？

​

サイレント通知を使ってリーチ可能なユーザー数を測定できますか？

1. 配信は保証されない — AppleとGoogleの両方がサイレント通知をベストエフォートとして扱い、遅延またはドロップする可能性があります。たとえば、アプリが閉じられている（強制終了）場合、iOSはドロップし、AndroidとiOSは省電力ルールの下で制限します。
2. 配信は確認されない — 確認配信はサイレント通知では機能しないため、どのユーザーが実際にプッシュを受信したかを知る方法がありません。