メッセージング診断ダッシュボード
メッセージング診断ダッシュボードは、メッセージ送信結果の概要を提供し、メッセージング設定における傾向の把握や潜在的な問題の診断を可能にします。このダッシュボードは、キャンペーンやキャンバスからのメッセージが期待どおりに送信されなかった理由を理解するのに役立ちます。
メッセージング診断ダッシュボードは現在、早期アクセス段階です。早期アクセスへの参加をご希望の場合は、カスタマーサクセスマネージャーにお問い合わせください。
主要な概念
送信済みと配信済み
このダッシュボードは、Braze が内部的にメッセージを処理した方法を報告するものであり、メッセージの最終的な配信ステータスを報告するものではないことを理解することが重要です。
このダッシュボードで「送信済み」と表示されたメッセージは、Braze がメッセージの処理と送出に成功したことを意味します。ほとんどのチャネルでは、Braze が関連するサードパーティの送信パートナーにメッセージを引き渡したことを意味します。ただし、ユーザーのデバイスへの最終的な配信を保証するものではありません。
Braze がメッセージを「送信」した場合、最終的な配信は外部サービスに依存する場合があります。各チャネルの例を以下に示します。
| チャネル | 最終配信の例 |
|---|---|
| コンテンツカード | カードが送信され、閲覧可能な状態になりました。 |
| メール | Braze がメッセージをメールサービスプロバイダー (ESP) に引き渡します。ESP が最終的な配信を担当します。たとえば、メールアドレスが無効であったり受信トレイがいっぱいの場合、ESP が「バウンス」を報告することがあります。 |
| アプリ内メッセージ | メッセージがユーザーに表示されました。 |
| LINE | メッセージが送信パートナーに正常に引き渡されました。 |
| プッシュ通知 | Braze がメッセージを適切なプッシュ通知サービス(iOS の場合は Apple Push Notification service、Android の場合は Firebase Cloud Messaging)に引き渡します。そのサービスがデバイスへの通知の最終配信を担当します。 |
| SMS/MMS/RCS | Braze がメッセージを SMS ゲートウェイ(Twilio など)に引き渡します。そのゲートウェイがモバイルキャリアへの最終配信を担当します。 |
| webhook | Webhook リクエストが正常に実行され、2xx レスポンスが返されました。 |
| メッセージが送信パートナーに正常に引き渡されました。 |
データの鮮度
このダッシュボードのデータ更新頻度は、システム負荷に応じて変動する場合があります。更新頻度は保証されませんが、ほとんどの場合1時間未満です。
ダッシュボードの設定
診断ダッシュボードにアクセスするには、分析 > ダッシュボードビルダーに移動し、Braze が作成したダッシュボードのリストからメッセージング診断を選択します。
ダッシュボードを実行してデータを表示するには:
- ダッシュボードレポートのソースとしてキャンペーンまたはキャンバスを選択します。
- 1つ以上のキャンペーンまたはキャンバスを選択します。
- ダッシュボードを実行を選択して、選択したフィルターのデータを読み込みます。

データの解釈
ダッシュボードには直近7日間のデータのみが表示されます。すべてのタイムスタンプはワークスペースのタイムゾーンで表示されます。
サマリータイル
ページ上部には、選択した期間の主要なサマリータイルが表示されます:
- 中止の合計: 中止されたメッセージの合計数です。これには、キャンバスに入らなかったキャンバスオーディエンスメンバーや、ステップの失敗を経験したか、終了イベントの実行中に終了条件を満たしたためにキャンバスを退出したメンバーが含まれます。
- メッセージ送信数: Braze が正常に処理して送信したメッセージの合計数です。
- メール、SMS/MMS/RCS、WhatsApp、LINE、プッシュ通知: メッセージが送信パートナーに正常に引き渡されました。
- webhook: Webhook リクエストが正常に実行され、
2xxレスポンスが返されました。 - コンテンツカード: カードが送信され、閲覧可能な状態になりました。
- アプリ内メッセージ: メッセージがユーザーに表示されました。
時系列でのメッセージ結果
この時系列チャートは、メッセージが中止された理由やユーザーがキャンバスからドロップされた理由の日別内訳を表示します。このチャートには送信数は表示されません。
チャートを整理するため、選択した期間内で発生回数がゼロの中止またはドロップ理由はチャートに表示されません。
メッセージ結果の内訳
このチャートは、選択した期間内のすべてのメッセージ結果の内訳を表示します。以下の全体像を把握できます:
- すべての結果に対する送信数の割合。
- 各中止およびドロップ理由の割合の内訳。これにより、メッセージが送信されない最も一般的な理由をすばやく特定できます。
中止の結果
以下の定義は、ダッシュボードに表示される中止の結果を説明しています。結果はカテゴリ別にグループ化されており、調査対象を見つけやすくなっています。
コンテンツとレンダリング
| 中止の結果 | 説明 |
|---|---|
| コンテンツカードの有効期限切れ | ユーザーが閲覧する前にコンテンツカードの有効期限が切れました。 |
| コンテンツカードが無効 | コンテンツカードにエラーがあり、ユーザーに送信されませんでした。一般的な理由には以下が含まれます:
|
| コネクテッドコンテンツの失敗 | Braze はメッセージの送信を試みましたが、コネクテッドコンテンツが最大リトライ回数(デフォルトは5回)後に失敗しました。注: このカウントは、最大リトライ回数に達したために中止されたメッセージの数であり、コネクテッドコンテンツリクエストの失敗の合計数ではありません。 |
| アプリ内メッセージのレンダリングタイムアウト | 複数回のリトライ後、Liquid をレンダリングできずタイムアウトしました。 |
| Liquid による中止 | abort_message Liquid タグが呼び出されたため、送信がキャンセルされました。 |
| Liquid レンダリングタイムアウト | Liquid テンプレートのレンダリングに時間がかかりすぎました。バナー、アプリ内メッセージ、メールで最も発生しやすいです。 |
| Liquid 構文エラー | Liquid テンプレートに解析エラーがあったため、メッセージがキャンセルされました。 |
キャンペーンとキャンバスの状態
| 中止の結果 | 説明 |
|---|---|
| 遅延ステップの失敗 | 遅延ステップが失敗し、ユーザーがキャンバスを退出しました。この失敗は以下の場合に発生する可能性があります:
|
| 例外イベントまたは終了イベント | ユーザーは以前メッセージを受信する資格がありましたが、 |
| 非アクティブなキャンペーン | メッセージの送信中にキャンペーンが停止されたため、中止されました。 |
| 非アクティブなキャンバス | ユーザーがジャーニーに入る前にキャンバスが停止されました。 |
| 非アクティブなキャンバスステップ | これはキャンバスで以下の場合に発生する可能性があります:
|
| ボリューム制限 | キャンペーンが設定されたボリューム制限に達したため、送信がキャンセルされました。 |
レート制限とタイミング
| 中止の結果 | 説明 |
|---|---|
| フリークエンシーキャップ | ワークスペースのフリークエンシーキャップルールで許可されたメッセージの最大数をユーザーがすでに受信しているため、送信がキャンセルされました。 |
| サイレント時間帯による中止 | キャンペーンまたはキャンバスステップでサイレント時間帯が有効になっており、フォールバックがメッセージを中止に設定されていました。ユーザーがサイレント時間帯中にキャンペーンをトリガーしたか、キャンバスのメッセージステップに入ったため、メッセージが中止されました。ただし、これによりユーザーがキャンバスから退出することはありません。 |
| 72時間を超えるレート制限 | 配信速度レート制限により、メッセージが72時間以上スロットリングされたため、送信が中止されました。 |
ユーザーの適格性とプロファイル
| 中止の結果 | 説明 |
|---|---|
| 重複するユーザー識別子 | 一致する識別子(external ID、メールアドレス、電話番号など)を持つ複数のユーザーがこのメッセージを受信する資格がありました。同一ユーザーへの重複送信を防ぐため、このメッセージは中止されました。 |
| メッセージステップの事前チェックに失敗 | この事前チェックは配信バリデーションの前に実行されます。この場合、ユーザーはこのメッセージステップの基本的な事前チェックを満たしませんでした(ユーザーが見つからないか、メッセージステップのチャネルに対して不適格)。注: マルチチャネルのメッセージステップの場合、これはユーザーが見つからなかったことを意味します。チャネルの適格性は、シングルチャネルのメッセージステップでのみここでチェックされます。 |
| トリガーメッセージの事前チェックに失敗 | トリガーメッセージの場合、Braze はこのトリガーから送信するメッセージを作成する前に、オーディエンスの適格性、再適格性、チャネルの適格性に関する基本的な事前チェックの最初のパスを実行します。 |
| ユーザーが適格でなくなった | ユーザーは当初ターゲットオーディエンスに含まれていましたが、Braze がメッセージを送信するかユーザーをキャンバスに入れる前に、オーディエンス条件に一致しなくなりました。ユーザーが最初にオーディエンス条件を満たしてからオーディエンスから外れるまでの時間は、以下の遅延が原因である可能性があります:
|
| ステップに対してユーザーが不適格 | ユーザーがメッセージステップの設定された配信バリデーションを満たさなかったか、抑制リストに含まれていたため、キャンバスを退出しました。 |
| ユーザーが再適格でない | ユーザーはメッセージを受信するかキャンバスに入る資格がありましたが、再適格性または再エントリの設定により送信がキャンセルされました。これは、ユーザーがすでにキャンペーンを受信しているかキャンバスに最近入っている場合、同じキャンペーンの別の送信がこのユーザーに対してすでに進行中の場合、または再適格性や再エントリがオフになっている場合に発生する可能性があります。 |
| ユーザープロファイルが見つからない | ユーザーが存在したことがないか、Braze に存在しなくなりました。一般的なケースには以下が含まれます:
|
チャネルと配信
| 中止の結果 | 説明 |
|---|---|
| パートナー配信タイムアウト | Braze は24時間にわたってこのメッセージを配信パートナーに送信しようとしましたが、パートナーがその時間枠全体で一時的なエラーを返しました。 |
| プッシュ認証情報が無効 | このアプリのプッシュ認証情報が見つからないか無効なため、送信がキャンセルされました。アプリ設定で認証情報を更新してください。 |
| Android プッシュ通知、アプリ、またはデバイスに対してユーザーが有効でない | このユーザーにプッシュ通知を送信できません。一般的な理由:
|
| iOS プッシュ通知、アプリ、またはデバイスに対してユーザーが有効でない | 「Android プッシュ通知、アプリ、またはデバイスに対してユーザーが有効でない」の中止結果と同じです。 |
| Kindle プッシュ通知、アプリ、またはデバイスに対してユーザーが有効でない | 「Android プッシュ通知、アプリ、またはデバイスに対してユーザーが有効でない」の中止結果と同じです。 |
| Web プッシュ、アプリ、またはデバイスに対してユーザーが有効でない | 「Android プッシュ通知、アプリ、またはデバイスに対してユーザーが有効でない」の中止結果と同じです。 |
| コンテンツカードに対してユーザーが有効でない | ユーザーがこのコンテンツカードを含むアプリを使用していません。 |
| メールに対してユーザーが有効でない | このユーザーにメールを送信できません。一般的な理由:
|
| LINE に対してユーザーが有効でない | このユーザーに LINE メッセージを送信できません。一般的な理由:
|
| SMS/MMS/RCS に対してユーザーが有効でない | このユーザーに SMS メッセージを送信できません。一般的な理由:
|
| WhatsApp に対してユーザーが有効でない | このユーザーに WhatsApp メッセージを送信できません。一般的な理由:
|
| Webhook の失敗 | Webhook が失敗のレスポンスコード(非 2xx)を受信しました。詳細についてはメッセージアクティビティログを参照してください。60時間以上経過したログはクリーンアップされ、アクセスできなくなります。Webhook エラーは1時間あたり最大20件のログがサンプリングされます。 |
よくある質問
「事前チェック」の失敗とは何ですか?
「事前チェック」とは、パイプラインステージ(メッセージのトリガーやキャンバスのメッセージステップの送信など)の最初に実行される高速でバンドルされたバリデーションチェックのことです。最大速度を実現するための早期終了と考えてください。ユーザープロファイルのすべての詳細を検証するような、個別のリソース集約型チェックを多数実行する代わりに、Braze は複数の基本的なバリデーションを1つの「最初のパス」にバンドルします。
ユーザーがこのバンドルされたチェックに失敗すると、即座にドロップされます。このバンドルアプローチにより、Braze は大量のメッセージを高速で処理でき、各メッセージの処理レイテンシーを削減することで、キャンペーンやキャンバスのパフォーマンスの向上と安定化に貢献します。
「その他」の中止結果とは何ですか?
これらは、既存の Braze カテゴリのいずれにも該当しなかった中止です。この結果の中止が大きな割合を占めている場合は、Braze サポートにお問い合わせください。
中止の合計とメッセージ送信数の合計が、予想されるオーディエンスサイズよりも少ないのはなぜですか?
これにはいくつかの理由が考えられます:
- オーディエンス条件: キャンペーンまたはキャンバスが起動された時点で、予想よりも少ないユーザーしかオーディエンス条件を満たしていなかった可能性があります(たとえば、セグメントに含まれていなかったか、必要な属性を持っていなかった)。
- 処理中: メッセージがまだ処理中の可能性があります。ユーザーがまだキャンバスの前のステップにいて、メッセージステップに到達していない場合があります。
- データの鮮度: ダッシュボードのデータは約15分ごとに更新されますが、これは保証されません。このキャンペーンまたはキャンバスの最新データがまだダッシュボードに反映されていない可能性があります。
- エッジケース: 現時点でこのダッシュボードに反映されていないエッジケースに遭遇している可能性がわずかにあります。その疑いがある場合は、Braze サポートにお問い合わせください。
中止の合計とメッセージ送信数の合計が、キャンペーンやキャンバスのオーディエンスよりも多いのはなぜですか?
これは以下の理由で発生する可能性があります:
- マルチチャネルメッセージ: キャンペーンまたはキャンバスステップが複数のチャネル(SMS とメールなど)で送信するように設定されていました。1人のユーザーが、あるチャネル(メールなど)では「送信済み」の結果を受け取り、別のチャネル(「SMS/MMS/RCS に対してユーザーが有効でない」など)では「中止」の結果を受け取ることがあります。この場合、その1人のユーザーはチャートで2回カウントされます: 1回は「送信済み」として、もう1回は「中止」としてです。
- 例: 100人のユーザーに iOS と Android の両方をターゲットにしたプッシュキャンペーンを送信します。ユーザーが iOS デバイスのみを持っている場合、iOS プッシュ(「送信済み」)を受信しますが、Android プッシュの中止(「Android プッシュ通知、アプリ、またはデバイスに対してユーザーが有効でない」)もトリガーします。
- 複数のメッセージステップ(キャンバスのみ): キャンバスの特定のパスに複数のメッセージステップがある場合があります。このダッシュボードはすべての結果を集計するため、選択した期間内に複数のメッセージステップを通過した場合、1人のユーザーが複数回カウントされる可能性があります。
- テストメッセージ: テスト送信(ダッシュボードでカウントされます)により、合計数がオーディエンスサイズよりも大きくなることがあります。