配信確認

​

概要

配信確認は、デバイスがOneSignalを通じて送信されたプッシュ通知を実際に受信したときを追跡します。 OneSignalダッシュボードでは、これはメッセージレポートで確認済み（または受信済み）として表示されます。 プッシュ通知は、プラットフォームのプッシュサービスを通じて配信されます：

• iOS & Safari: Apple Push Notification Service（APNs）
• Android & Chrome: Google Firebase Cloud Messaging（FCM）
• Huaweiデバイス: Huawei Messaging Service（HMS）
• Amazonデバイス: Amazon Device Messaging（ADM）
• Windowsデバイス: Microsoft Push Notification Service（MPNS）

これらのサービスは、通知がサービスに正常に配信されたとき、失敗したとき、またはデバイストークンが購読解除されたときを確認します。 ユーザーのデバイスが通知を受信すると、OneSignal SDKは配信確認イベントをOneSignalに送り返します。このイベントには次が含まれます：

• 通知ID
• デバイスのサブスクリプションID

これにより、どのサブスクリプションがどの通知を受信したかを正確に確認できます。

---

​

要件

• 有料プランでのみ利用可能です。プランを比較。
• 次を含むモバイルSDKセットアップを完了します：
  • iOS通知サービス拡張
  • App Group構成
• 配信確認は、デバイスにOneSignal SDKがインストールされている場合にのみ機能します。
  • APIのみで作成されたサブスクリプションにはサポートされていません。

​

プラットフォーム固有の制限

​

iOS

• 通知サービス拡張とApp Groupの両方のセットアップが必要です。
• APNsは、オフライン時にアプリごとに1つのメッセージのみを保持します。オフライン中に複数のプッシュが送信された場合、最新のもののみが配信されます。

​

Huawei

• data Huaweiメッセージタイプでのみサポートされています。
• messageタイプの場合、Huaweiは自社のダッシュボードでのみ受信データを提供します。

​

Web

• Safariは配信確認をサポートしていません。

---

​

FAQ

​

配信確認の数が少ないまたは欠落しているのはなぜですか？

一般的な原因：

1. 多くの非アクティブまたは放棄されたデバイス。非アクティブデバイスの処理を参照してください。
2. プラットフォームの制限（Huawei、Safari）。
3. セットアップの問題—特にiOSで一般的です。配信確認のトラブルシューティングを参照してください。
4. Androidデバイスはアプリを強制終了し、SDKイベントを停止する場合があります。一部のデバイスメーカーは、アプリをスワイプして閉じることを強制終了として扱います。モバイルプッシュが表示されないガイドを参照してください。

​

非アクティブデバイスの処理

オフラインのデバイスは、プッシュ通知を受信したり、配信確認イベントを送信したりしません。これは、ユーザーがデバイスを交換または放棄した場合によく発生します。 非アクティブユーザーを再エンゲージするためのヒント：

• オーディエンスアクティビティを使用して、配信確認をしなかったユーザーに再送信します。
• 最終セッションに基づいてセグメントを作成します（例：90日以上非アクティブ）。
  • 再エンゲージメントJourneyと組み合わせて、彼らを取り戻します。
  • 定期的に非アクティブユーザーをターゲットにして、到達不可能なデバイスを整理します。

​

確認済みと表示されているのに、デバイスに表示されないのはなぜですか？

配信確認イベントは、デバイスがプッシュを受信したことを意味します。まれに、デバイスが表示しない場合があります。 次を確認してください：

• 見逃した可能性があります。表示されるかどうかを確認するために、自分にテストプッシュを送信してみてください。
• iOSのフォーカスモード：「おやすみモード」、「睡眠」、またはその他のフォーカスモードがアクティブな場合、プッシュは遅延されたり、異なる方法でグループ化されたりします。グループ化された通知を閉じると、見逃す可能性があります。
• カスタムアプリコードが表示を抑制：
  • foreground lifecycle listenerまたは通知サービス拡張でのevent.preventDefault()
  • メッセージを削除する通知API：
    • removeDeliveredNotifications(withIdentifiers:)
    • removeAllDeliveredNotifications()
• プッシュペイロード設定：
  • priorityが高に設定されていることを確認してください。プッシュ優先度を参照してください。
  • collapse_idには注意してください—同じIDを使用して古いプッシュを新しいプッシュに置き換えます。
• 間違ったデバイスがターゲット：テストサブスクリプションを見つけて設定を使用して確認します。

---

​

配信確認のトラブルシューティング

​

一般

• **デバイスがオフライン：**プッシュは最大3日間（デフォルト）遅延する可能性があります。Time To Liveで調整します。
• **不安定なネットワーク：**アプリがクラッシュしたりネットワークがない場合、通知は受信されても確認が失敗する可能性があります。これはまれです。

​

iOS

最も一般的な問題：通知サービス拡張またはApp Groupsの誤構成。 チェックリスト：

1. XcodeでOneSignalNotificationServiceExtensionターゲットを追加します。
2. iOS SDKセットアップのステップ3〜6を再確認します。アプリと拡張機能の両方に同じApp Group名を使用していることを確認してください：
   • ✅ group.your-main-app-target-bundle-id.onesignal
   • ❌ group.your-bundle-id.OneSignalNotificationServiceExtension.onesignal
   • 独自のApp Group名を使用する場合は、メインアプリと通知サービス拡張機能の両方のInfo.plistファイルを更新して、SDKにどのApp Groupを使用するかを伝える必要があります。
3. ペイロードにmutable-content: 1が存在することを確認します（上書きされない限り自動的に設定されます）。

高度なデバッグについては、iOS通知サービス拡張のトラブルシューティングを参照してください。

​

Android

• 通知が表示されない場合：モバイルプッシュトラブルシューティングを参照してください。
• 通知は表示されるが配信確認が欠落している場合：カスタムAndroidサービス拡張がブロックしている可能性があります。Androidサービス拡張ガイドを確認してください。

​

Web

• Safariはサポートされていません。
• 他のブラウザの場合、v16 SDKへの移行が完了していることを確認します：
  • 正しいSDK初期化：
    Copy

    Ask AI

    <script src="https://cdn.onesignal.com/sdks/web/v16/OneSignalSDK.page.js" defer></script>
    

  • 正しいService Worker参照：
    Copy

    Ask AI

    importScripts("https://cdn.onesignal.com/sdks/web/v16/OneSignalSDK.sw.js");
    

---

---