配信指標
OneSignalはプッシュ通知をプッシュサービス（Google FCM、Apple APNs、Huawei HMS）に送信し、プッシュサービスがユーザーのデバイス（サブスクリプション）に配信します。配信済み、サブスクライブ解除、失敗の指標はこれらのプッシュサービスからのものです。確認済み配信とクリックの指標はデバイス上のOneSignal SDKからのものです。| 指標 | 定義 |
|---|---|
| 送信済み | OneSignalからプロバイダーへの送信に成功したメッセージの数。 |
| 総試行数 | OneSignalが送信を試みたメッセージの数。送信済み + 頻度制限の合計として算出されます。 |
| オーディエンス | 対象セグメント内のサブスクリプション数。 |
| 配信済み | プッシュサービスによってユーザーのデバイスに配信されたプッシュサブスクリプションの数。 |
| サブスクライブ解除 | アプリをアンインストールした、ブラウザデータをクリアした、またはプッシュをオプトアウトし、それ以降アプリを開いていないため、メッセージを受信しなかったプッシュサブスクリプションの数。 |
| 失敗 | エラーのためにメッセージを受信しなかったプッシュサブスクリプションの数。失敗メッセージのトラブルシューティングを参照してください。 |
| クリック | 通知のクリック数。 |
| 頻度制限 | 頻度制限設定のために通知が送信されなかったプッシュサブスクリプションの数。 |
| 確認済み配信 | メッセージの受信を確認したプッシュサブスクリプションの数。 |
| 残り | OneSignal側で送信のためにまだキューに入っている通知の数。 |
| クリックスルー率 | (クリック / 配信済み) * 100%として計算されます。 |
| 確認済みCTR | (クリック / 確認済み配信) * 100%として計算されます。 |
| 影響を受けた開封 | クリックせずに通知を受信した後に発生したアプリの開封数。設定 > プッシュとアプリ内 > 影響を受けた開封で設定された時間ウィンドウに基づきます。 |
全チャネルにわたる詳細な指標の定義については、指標用語集を参照してください。
失敗メッセージのトラブルシューティング
これらのエラーにより、OneSignalはプッシュプロバイダーにメッセージを配信できませんでした：| エラー | タイプ | トラブルシューティング手順 |
|---|---|---|
| 401 Unauthorized | Web | Webプッシュサーバーが不明確な401エラーを出しました。慎重に再試行してください。重複送信が発生する可能性があります。 |
| 404 Not Found | Web | 無効なプッシュサブスクリプションエンドポイント（不正なトークン）。 |
| Authentication Error | FCM | FCM認証情報を確認し、サービスアカウントファイルを再アップロードして、もう一度試してください。 |
| DeviceTokenNotForTopic | APNs | トークンのBundle IDがAPNsキーまたは証明書と一致しません。p8トークンまたはp12セットアップで修正してください。 |
| Expired Certificate | APNs | p12証明書の有効期限が切れています。証明書のセットアップを参照してください。 |
| FcmV1InvalidToken / Not Found | FCM | 無効なプッシュトークン。Firebase認証情報を確認してください。デバイスはトークンを更新するためにアプリを再度開く必要があります。 |
| None / Missing | FCM | Firebase Cloud Messaging APIがプロジェクトで有効になっていない可能性があります。Firebaseコンソールでアクティブ化して再試行してください。 |
| Permission Denied | FCM | どの権限が欠落しているかを確認するために完全なエラーメッセージを確認してください。サービスアカウントファイルの権限を更新し、OneSignalに再アップロードしてください。 |
| SenderIdMismatch | FCM | FCM v1 Sender IDの不一致。Firebase認証情報を確認してください。ユーザーは更新されたトークンのためにアプリを再度開く必要があります。 |
| TopicDisallowed | APNs | APNsトークンの不一致。p8設定でTeam ID、Key ID、Bundle IDを確認してください。 |
配信ステータス
| ステータス | 説明 |
|---|---|
| 配信済み | プッシュサービスが受信者へのメッセージ配信を報告しました。 |
| スケジュール済み | メッセージは将来の配信予定です。 |
| 送信中 | メッセージは積極的に送信されています。 |
| キュー済み | メッセージは送信待ちです。 |
| キャンセル済み | メッセージは手動でキャンセルされました。プッシュ通知のキャンセルを参照してください。 |
| 受信者なし | 送信時に有効なオーディエンスがありません（例：サブスクライブ解除またはセグメント外）。 |
| 失敗 | OneSignalはエラーによりメッセージを送信できませんでした。 |
コンバージョン
メッセージ統計
メッセージ統計グラフは、送信後30日間のクリック、セッション、カスタム成果（レガシー、コンバージョン指標に置き換え中）を追跡します。エンゲージメントが配信直後に発生したか、それとも時間をかけて継続したかを確認するために使用します。
オーディエンスアクティビティ
オーディエンスアクティビティレポートは、各サブスクリプションが特定のメッセージとどのようにインタラクションしたかを示します。結果はカテゴリにグループ化されているため、配信の問題を診断したり、エンゲージメントを測定したり、特定のメッセージに関連するサブスクライブ解除を特定したり、リターゲティングやエクスポートのためにオーディエンスをセグメント化したりすることができます。
- カテゴリ
- テーブル列
| カテゴリ | 説明 |
|---|---|
| 送信済み | メッセージがデバイスに送信されました。 |
| 確認済み配信 | 配信がデバイスによって確認されました。 |
| 配信未確認 | 配信確認が受信されませんでした。 |
| クリック済み | ユーザーが通知をクリックしました。 |
| 未クリック | ユーザーが通知をクリックしませんでした。 |
| 失敗 | 配信に失敗しました。 |
| サブスクライブ解除 | メッセージを受信した後にサブスクリプションがサブスクライブ解除されました。 |
オーディエンスのリターゲティング
オーディエンスアクティビティビューから、任意のカテゴリ（例：クリックしなかったすべてのユーザー）に直接リターゲティングメッセージを送信できます。 これにより、エンゲージしなかったユーザーをフォローアップしたり、チャーンしたユーザーを再エンゲージしたり、配信を確認したユーザーで成功を強化したりすることが簡単になります。結果のエクスポート
エクスポートメニューを使用してオーディエンスデータをダウンロードできます：- 選択されたアクティビティ – 現在表示されているタブのみをエクスポートします（例：配信に失敗したすべてのユーザー）。
- すべてのアクティビティ – すべてのカテゴリにわたる完全なレポートをエクスポートします。
データのエクスポート
オフライン分析のためにメッセージおよびユーザーデータをCSVにエクスポートします。
メッセージ設定
メッセージ設定パネルには、送信に使用された設定が表示されます。- オーディエンス - オーディエンスの詳細（次を含む）：
- 受信者の合計数 - メッセージが送信されたサブスクリプションの数
- メッセージの送信方法：使用されたターゲティングフィルターまたはセグメント
- スケジュール - メッセージの送信が開始された時刻と、選択されたユーザーごとの配信オプション（ある場合）。
- スロットリング - スロットリング、頻度制限、またはチャネルオーバーライド
- メッセージ - メッセージコンテンツ。
- ターゲットプラットフォーム（Android、iOS、特定のブラウザ）
- 詳細設定 - 優先度、有効期限、Collapse IDなど。
- 追加データ - メッセージに追加されたカスタムデータ。
よくある質問
プッシュサブスクリプションのステータスはいつ更新されますか？
プッシュサブスクリプションのステータスは2つのメカニズムで更新されます： 1. ユーザーがアプリまたはサイトを開いたとき OneSignal SDKはプッシュトークンが有効かどうか、および通知の許可がまだ付与されているかどうかを確認し、サブスクリプションのステータスをすぐに更新します。 たとえば、ユーザーがデバイスの設定でプッシュ通知を無効にしてからアプリを再度開くと、SDKがその変更を検出し、サブスクリプションをすぐにサブスクライブ解除としてマークします。 SDKのサブスクリプションオブザーバー（モバイル | Web）を使用して、これらの変更を独自のデータベースに同期できます。 2. プッシュ通知を送信したとき ユーザーがアプリをアンインストールしたり、ブラウザデータをクリアしたり、プッシュを無効にしてそのまま戻ってこない場合、OneSignalは通知を送信するまでその変更を検出できません。プッシュサービス（FCM、APNs、HMS）がトークンを無効として報告すると、OneSignalはサブスクリプションをサブスクライブ解除としてマークします。 この検出には通常2件以上のメッセージが必要です：| 送信 | 何が起きるか |
|---|---|
| メッセージ1 | デバイスに配信済み。ユーザーがデバイスの設定でサブスクライブ解除するかアプリをアンインストール。 |
| メッセージ2 | プッシュサービスはメッセージを受け付けますが、デバイスは受信しません。プッシュサービスがまだトークンを拒否していないため、OneSignalは「配信済み」と報告します。 |
| メッセージ3 | プッシュサービスがトークンを拒否。OneSignalがサブスクリプションをサブスクライブ解除としてマーク。 |
| メッセージ4以降 | OneSignalはこのサブスクリプションへの配信を試みません。 |
配信済み数と確認済み配信数が一致しないのはなぜですか？
配信済みはプッシュサービス（FCM、APNs）が報告したもの——メッセージを配信のために受け付けたことを意味します。確認済み配信は、デバイス上のOneSignal SDKがレポートする必要があり、デバイスがオンラインで、アプリが通知を処理した場合にのみ発生します。オフラインのデバイス、アプリが強制終了されているデバイス、またはSDKがないデバイスは、配信済みとして表示されますが、確認済みにはなりません。オーディエンスアクティビティデータはどのくらいの期間利用できますか？
オーディエンスアクティビティデータは、メッセージが送信されてから30日間保持されます。より長く保持する必要がある場合は、この期間が終わる前に結果をエクスポートしてください。関連ページ
確認済み配信
デバイスレベルの配信確認の仕組みと確認率に影響する要因。
指標用語集
全チャネルにわたる配信、エンゲージメント、コンバージョン指標の定義。
テンプレート分析
テンプレートを使用した送信全体のプッシュ通知パフォーマンスの追跡。
プッシュスロットリング
大量送信時のサーバー負荷を管理するための配信レート制御。