> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# プッシュメッセージレポート

> プッシュメッセージレポートは、各プッシュ送信の配信結果、確認済み配信、失敗診断、クリックスルー率、およびサブスクリプションごとのオーディエンスアクティビティを表示します。

プッシュメッセージレポートは、配信結果、ユーザーエンゲージメント（CTR）、デバイスレベルの確認、エラー診断を含む、各プッシュ通知のパフォーマンスを追跡するのに役立ちます。

<Frame caption="プッシュメッセージレポートの高レベル統計。">
  <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/7fb7f716c8be4e153110e21fe514e872347188578674781fc75787cbc2f60136-Screenshot_2025-03-11_at_2.48.15_PM.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=3a0aae3f8a7376838920bd16234c6876" alt="配信済み、クリック済み、CTRの指標を表示するプッシュメッセージレポート" width="2292" height="386" data-path="images/docs/7fb7f716c8be4e153110e21fe514e872347188578674781fc75787cbc2f60136-Screenshot_2025-03-11_at_2.48.15_PM.png" />
</Frame>

***

## 配信指標

OneSignalはプッシュ通知を**プッシュサービス**（Google FCM、Apple APNs、Huawei HMS）に送信し、プッシュサービスがユーザーのデバイス（サブスクリプション）に配信します。配信済み、サブスクライブ解除、失敗の指標はこれらのプッシュサービスからのものです。[確認済み配信](./confirmed-delivery)とクリックの指標はデバイス上のOneSignal SDKからのものです。

| 指標            | 定義                                                                                                    |
| ------------- | ----------------------------------------------------------------------------------------------------- |
| **送信済み**      | OneSignalからプロバイダーへの送信に成功したメッセージの数。                                                                    |
| **総試行数**      | OneSignalが送信を試みたメッセージの数。送信済み + 頻度制限の合計として算出されます。                                                      |
| **オーディエンス**   | 対象セグメント内のサブスクリプション数。                                                                                  |
| **配信済み**      | プッシュサービスによってユーザーのデバイスに配信されたプッシュサブスクリプションの数。                                                           |
| **サブスクライブ解除** | アプリをアンインストールした、ブラウザデータをクリアした、またはプッシュをオプトアウトし、それ以降アプリを開いていないため、メッセージを受信しなかったプッシュサブスクリプションの数。           |
| **失敗**        | エラーのためにメッセージを受信しなかったプッシュサブスクリプションの数。[失敗メッセージのトラブルシューティング](#failure-message-troubleshooting)を参照してください。 |
| **クリック**      | 通知のクリック数。                                                                                             |
| **頻度制限**      | 頻度制限設定のために通知が送信されなかったプッシュサブスクリプションの数。                                                                 |
| **確認済み配信**    | メッセージの受信を確認したプッシュサブスクリプションの数。                                                                         |
| **残り**        | OneSignal側で送信のためにまだキューに入っている通知の数。                                                                     |
| **クリックスルー率**  | `(クリック / 配信済み) * 100%`として計算されます。                                                                      |
| **確認済みCTR**   | `(クリック / 確認済み配信) * 100%`として計算されます。                                                                    |
| **影響を受けた開封**  | クリックせずに通知を受信した後に発生したアプリの開封数。**設定 > プッシュとアプリ内 > 影響を受けた開封**で設定された時間ウィンドウに基づきます。                         |

<Note>
  全チャネルにわたる詳細な指標の定義については、[指標用語集](./analytics-metrics-glossary)を参照してください。
</Note>

### 失敗メッセージのトラブルシューティング

これらのエラーにより、OneSignalはプッシュプロバイダーにメッセージを配信できませんでした：

| エラー                                                                                                                                                                    | タイプ  | トラブルシューティング手順                                                                                                                                 |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **401 Unauthorized**                                                                                                                                                   | Web  | Webプッシュサーバーが不明確な401エラーを出しました。慎重に再試行してください。重複送信が発生する可能性があります。                                                                                  |
| **404 Not Found**                                                                                                                                                      | Web  | 無効なプッシュサブスクリプションエンドポイント（不正なトークン）。                                                                                                             |
| **Authentication Error**                                                                                                                                               | FCM  | [FCM認証情報](./android-firebase-credentials)を確認し、サービスアカウントファイルを再アップロードして、もう一度試してください。                                                            |
| **[DeviceTokenNotForTopic](https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/CommunicatingwithAPNs.html)** | APNs | トークンのBundle IDがAPNsキーまたは証明書と一致しません。[p8トークン](./ios-p8-token-based-connection-to-apns)または[p12セットアップ](./ios-p12-generate-certificates)で修正してください。 |
| **Expired Certificate**                                                                                                                                                | APNs | p12証明書の有効期限が切れています。[証明書のセットアップ](./ios-p12-generate-certificates)を参照してください。                                                                    |
| **FcmV1InvalidToken / Not Found**                                                                                                                                      | FCM  | 無効なプッシュトークン。[Firebase認証情報](./android-firebase-credentials)を確認してください。デバイスはトークンを更新するためにアプリを再度開く必要があります。                                         |
| **None / Missing**                                                                                                                                                     | FCM  | Firebase Cloud Messaging APIがプロジェクトで有効になっていない可能性があります。Firebaseコンソールでアクティブ化して再試行してください。                                                        |
| **Permission Denied**                                                                                                                                                  | FCM  | どの権限が欠落しているかを確認するために完全なエラーメッセージを確認してください。[サービスアカウントファイルの権限を更新](./android-firebase-credentials)し、OneSignalに再アップロードしてください。                      |
| **SenderIdMismatch**                                                                                                                                                   | FCM  | FCM v1 Sender IDの不一致。[Firebase認証情報](./android-firebase-credentials)を確認してください。ユーザーは更新されたトークンのためにアプリを再度開く必要があります。                               |
| **[TopicDisallowed](https://developer.apple.com/documentation/usernotifications/handling-notification-responses-from-apns)**                                           | APNs | APNsトークンの不一致。[p8設定](./ios-p8-token-based-connection-to-apns)でTeam ID、Key ID、Bundle IDを確認してください。                                               |

***

## 配信ステータス

| ステータス        | 説明                                                                             |
| ------------ | ------------------------------------------------------------------------------ |
| **配信済み**     | プッシュサービスが受信者へのメッセージ配信を報告しました。                                                  |
| **スケジュール済み** | メッセージは将来の配信予定です。                                                               |
| **送信中**      | メッセージは積極的に送信されています。                                                            |
| **キュー済み**    | メッセージは送信待ちです。                                                                  |
| **キャンセル済み**  | メッセージは手動でキャンセルされました。[プッシュ通知のキャンセル](./push#cancel-push-notifications)を参照してください。 |
| **受信者なし**    | 送信時に有効なオーディエンスがありません（例：サブスクライブ解除またはセグメント外）。                                    |
| **失敗**       | OneSignalはエラーによりメッセージを送信できませんでした。                                              |

***

## コンバージョン

<Info>
  **近日公開** — [コンバージョン指標](/docs/ja/conversion-metrics)がメッセージレポートで利用可能になります。利用可能になると、各メッセージのレポートで帰属済みコンバージョンと影響を受けたコンバージョンを直接確認できます。アトリビューションモデルと設定手順の詳細については、[コンバージョン指標](/docs/ja/conversion-metrics)を参照してください。
</Info>

## メッセージ統計

メッセージ統計グラフは、送信後30日間のクリック、セッション、[カスタム成果](./custom-outcomes)（レガシー、コンバージョン指標に置き換え中）を追跡します。エンゲージメントが配信直後に発生したか、それとも時間をかけて継続したかを確認するために使用します。

<Frame caption="クリック、セッション、カスタム成果を時系列で示すメッセージ統計グラフ。">
  <img src="https://mintcdn.com/onesignal/4HyuQPBpu-4xjmQC/images/docs/d3e4db9-Screenshot_2023-07-25_at_2.18.57_PM.png?fit=max&auto=format&n=4HyuQPBpu-4xjmQC&q=85&s=03607676051399984b2966a93216b3a7" alt="30日間のクリック、セッション、カスタム成果を表示するメッセージ統計グラフ" width="1364" height="993" data-path="images/docs/d3e4db9-Screenshot_2023-07-25_at_2.18.57_PM.png" />
</Frame>

<Warning>
  OneSignal API経由で送信されたメッセージは30日間のみ保持されます。[テンプレート分析](./template-analytics)を使用して時間の経過に伴うパフォーマンスを追跡するか、[データをエクスポート](./exporting-data)してオフライン分析を行ってください。
</Warning>

***

## オーディエンスアクティビティ

**オーディエンスアクティビティ**レポートは、各サブスクリプションが特定のメッセージとどのようにインタラクションしたかを示します。結果はカテゴリにグループ化されているため、配信の問題を診断したり、エンゲージメントを測定したり、特定のメッセージに関連するサブスクライブ解除を特定したり、リターゲティングやエクスポートのためにオーディエンスをセグメント化したりすることができます。

<Frame caption="オーディエンスアクティビティのタブとテーブル">
  <img src="https://mintcdn.com/onesignal/DAcDCtZEGr7EAIA1/images/push/push-reports-audience-activity.png?fit=max&auto=format&n=DAcDCtZEGr7EAIA1&q=85&s=6ca39ae71008717bc4606b0633369949" alt="Audience activity screenshot" width="2048" height="706" data-path="images/push/push-reports-audience-activity.png" />
</Frame>

<Tabs>
  <Tab title="カテゴリ">
    | カテゴリ          | 説明                                    |
    | ------------- | ------------------------------------- |
    | **送信済み**      | メッセージがデバイスに送信されました。                   |
    | **確認済み配信**    | 配信がデバイスによって確認されました。                   |
    | **配信未確認**     | 配信確認が受信されませんでした。                      |
    | **クリック済み**    | ユーザーが通知をクリックしました。                     |
    | **未クリック**     | ユーザーが通知をクリックしませんでした。                  |
    | **失敗**        | 配信に失敗しました。                            |
    | **サブスクライブ解除** | メッセージを受信した後にサブスクリプションがサブスクライブ解除されました。 |

    各タブには、そのカテゴリの受信者数が表示され、個々のサブスクリプションレコードにドリルダウンできます。
  </Tab>

  <Tab title="テーブル列">
    | 列                   | 説明                                       |
    | ------------------- | ---------------------------------------- |
    | **External ID**     | システム識別子（設定されている場合）。                      |
    | **OneSignal ID**    | 一意のOneSignalユーザーID。                      |
    | **Subscription ID** | 一意のサブスクリプションインスタンス（デバイス + アプリ/ブラウザ）。     |
    | **デバイス**            | ブラウザまたはOSタイプ。`()`が表示される場合、デバイスは削除されています。 |
    | **サブスクリプションステータス**  | 現在のステータス（例：サブスクライブ済み、サブスクライブ解除）。         |
    | **送信済み**            | メッセージが送信された時刻。                           |
    | **確認済み配信**          | 配信がデバイスによって確認された時刻、または確認されていない場合は`-`。    |
    | **クリック済み**          | ユーザーがクリックした場合はタイムスタンプ、クリックしていない場合は`-`。   |
    | **失敗**              | 配信が失敗したかどうかを示します。                        |
    | **サブスクライブ解除**       | メッセージを受信した後にユーザーがサブスクライブ解除したかどうかを示します。   |
    | **失敗メッセージ**         | 配信が失敗した場合のエラーメッセージ（例：「無効なトークン」）。         |
  </Tab>
</Tabs>

<Warning>
  オーディエンスアクティビティデータは、メッセージが送信されてから**30日間**のみ利用可能です。より長く保持する必要がある場合は、結果をエクスポートしてください。
</Warning>

### オーディエンスのリターゲティング

**オーディエンスアクティビティ**ビューから、任意のカテゴリ（例：クリックしなかったすべてのユーザー）に直接**リターゲティングメッセージ**を送信できます。

これにより、エンゲージしなかったユーザーをフォローアップしたり、チャーンしたユーザーを再エンゲージしたり、配信を確認したユーザーで成功を強化したりすることが簡単になります。

***

### 結果のエクスポート

**エクスポート**メニューを使用してオーディエンスデータをダウンロードできます：

* **選択されたアクティビティ** – 現在表示されているタブのみをエクスポートします（例：配信に失敗したすべてのユーザー）。
* **すべてのアクティビティ** – すべてのカテゴリにわたる完全なレポートをエクスポートします。

エクスポートにより、オフラインで結果を分析したり、他のチームと共有したり、CRMおよび分析ツールとマージしたりできます。

<Card title="データのエクスポート" icon="file-export" href="./exporting-data">
  オフライン分析のためにメッセージおよびユーザーデータをCSVにエクスポートします。
</Card>

***

## メッセージ設定

メッセージ設定パネルには、送信に使用された設定が表示されます。

* **オーディエンス** - オーディエンスの詳細（次を含む）：
  * 受信者の合計数 - メッセージが送信されたサブスクリプションの数
  * メッセージの送信方法：使用されたターゲティングフィルターまたはセグメント
* **スケジュール** - メッセージの送信が開始された時刻と、選択されたユーザーごとの配信オプション（ある場合）。
* **スロットリング** - スロットリング、頻度制限、またはチャネルオーバーライド
* **メッセージ** - メッセージコンテンツ。
  * ターゲットプラットフォーム（Android、iOS、特定のブラウザ）
* **詳細設定** - 優先度、有効期限、Collapse IDなど。
* **追加データ** - メッセージに追加されたカスタムデータ。

***

## よくある質問

### プッシュサブスクリプションのステータスはいつ更新されますか？

プッシュサブスクリプションのステータスは2つのメカニズムで更新されます：

**1. ユーザーがアプリまたはサイトを開いたとき**

OneSignal SDKはプッシュトークンが有効かどうか、および通知の許可がまだ付与されているかどうかを確認し、サブスクリプションのステータスをすぐに更新します。

たとえば、ユーザーがデバイスの設定でプッシュ通知を無効にしてからアプリを再度開くと、SDKがその変更を検出し、サブスクリプションをすぐに**サブスクライブ解除**としてマークします。

SDKのサブスクリプションオブザーバー（[モバイル](./mobile-sdk-reference#addobserver-push-subscription-changes) | [Web](./web-sdk-reference#addeventlistener-push-subscription-changes)）を使用して、これらの変更を独自のデータベースに同期できます。

**2. プッシュ通知を送信したとき**

ユーザーがアプリをアンインストールしたり、ブラウザデータをクリアしたり、プッシュを無効にして**そのまま戻ってこない**場合、OneSignalは通知を送信するまでその変更を検出できません。プッシュサービス（FCM、APNs、HMS）がトークンを無効として報告すると、OneSignalはサブスクリプションを**サブスクライブ解除**としてマークします。

この検出には通常2件以上のメッセージが必要です：

| 送信       | 何が起きるか                                                                               |
| -------- | ------------------------------------------------------------------------------------ |
| メッセージ1   | デバイスに配信済み。ユーザーがデバイスの設定でサブスクライブ解除するかアプリをアンインストール。                                     |
| メッセージ2   | プッシュサービスはメッセージを受け付けますが、デバイスは受信しません。プッシュサービスがまだトークンを拒否していないため、OneSignalは「配信済み」と報告します。 |
| メッセージ3   | プッシュサービスがトークンを拒否。OneSignalがサブスクリプションを**サブスクライブ解除**としてマーク。                            |
| メッセージ4以降 | OneSignalはこのサブスクリプションへの配信を試みません。                                                     |

メッセージ送信時のリアルタイムでのサブスクライブ解除検出には[Event Streams](./event-streams)を使用してください。

<Warning>
  全ユーザーへの送信を長期間行わない場合、サブスクライブ解除が蓄積され、送信再開時に大きなスパイクとして現れます。サブスクライブ解除を徐々に検出するために、月に1〜2回は全ユーザーに送信してください。詳細は[FCM期限切れトークンFAQ](./fcm-expired-token-faq)を参照してください。

  Appleはサブスクライブ解除の報告を14日以上遅延させます。ユーザーのプライバシーを保護するため、Appleはアンインストールや許可の取り消しをすぐに報告しません。ユーザーがプッシュを無効にした後にアプリを開いた場合、OneSignalはSDK経由で即座にその変更を検出します。ユーザーが再びアプリを開かない場合、Appleが無効なトークンを報告するまでに数週間かかる可能性があります。詳細は[Apple Forum](https://developer.apple.com/forums/thread/670868)と[Technical Note](https://developer.apple.com/library/archive/technotes/tn2265/_index.html#//apple_ref/doc/uid/DTS40010376-CH1-TNTAG34)を参照してください。

  ダッシュボードまたはAPIを使用して[古いサブスクリプションを削除](./delete-users)し、オーディエンスをクリーンに保ちましょう。
</Warning>

### 配信済み数と確認済み配信数が一致しないのはなぜですか？

配信済みはプッシュサービス（FCM、APNs）が報告したもの——メッセージを配信のために受け付けたことを意味します。確認済み配信は、デバイス上のOneSignal SDKがレポートする必要があり、デバイスがオンラインで、アプリが通知を処理した場合にのみ発生します。オフラインのデバイス、アプリが強制終了されているデバイス、またはSDKがないデバイスは、配信済みとして表示されますが、確認済みにはなりません。

### オーディエンスアクティビティデータはどのくらいの期間利用できますか？

オーディエンスアクティビティデータは、メッセージが送信されてから30日間保持されます。より長く保持する必要がある場合は、この期間が終わる前に結果をエクスポートしてください。

***

## 関連ページ

<Columns cols={2}>
  <Card title="確認済み配信" icon="check-double" href="./confirmed-delivery">
    デバイスレベルの配信確認の仕組みと確認率に影響する要因。
  </Card>

  <Card title="指標用語集" icon="book" href="./analytics-metrics-glossary">
    全チャネルにわたる配信、エンゲージメント、コンバージョン指標の定義。
  </Card>

  <Card title="テンプレート分析" icon="chart-line" href="./template-analytics">
    テンプレートを使用した送信全体のプッシュ通知パフォーマンスの追跡。
  </Card>

  <Card title="プッシュスロットリング" icon="gauge" href="./throttling">
    大量送信時のサーバー負荷を管理するための配信レート制御。
  </Card>
</Columns>
