メッセージング診断ダッシュボード

メッセージング診断ダッシュボードは、メッセージ送信結果の概要を提示し、傾向を把握してメッセージング設定における潜在的な問題を診断できるようにします。このダッシュボードは、キャンペーンやキャンバスからのメッセージが期待通りに送信されなかった理由を理解するのに役立ちます。

主要な概念

送信済みと配信済み

このダッシュボードは、メッセージの最終的な配信ステータスではなく、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レスポンスが返されました。
WhatsApp	メッセージは送信パートナーに正常に引き渡されました。

データの鮮度

このダッシュボードのデータ更新頻度は、システム負荷によって変動する可能性があります。更新頻度は保証されませんが、ほとんどの場合1時間以内に更新されます。

ダッシュボードの設定

診断ダッシュボードには、分析 > ダッシュボードビルダーに移動し、Brazeが作成したダッシュボードの一覧からメッセージング診断を選択することでアクセスできます。

ダッシュボードを実行してデータを表示するには：

1. ダッシュボードレポートのソースとして、キャンペーンまたはキャンバスのいずれかを選択します。
2. 1つ以上のキャンペーンまたはキャンバスを選択します。
3. ダッシュボードを実行を選択して、選択したフィルターのデータを読み込みます。

データの解釈

サマリータイル

ページの上部には、選択した期間の主要なサマリータイルが表示され、以下の情報が示されます：

• 合計中止数：中止されたメッセージの総数です。これには、ステップの失敗を経験したか、退出イベントの実行中に退出条件を満たしたためにキャンバスに入らなかった、またはキャンバスから退出したキャンバスオーディエンスメンバーも含まれます。
• メッセージ送信数：Brazeが正常に処理し送信したメッセージの総数です。
  • メール、SMS/MMS/RCS、WhatsApp、LINE、プッシュ：メッセージは送信パートナーに正常に引き渡されました。
  • Webhook：Webhookリクエストは正常に送信され、2xxレスポンスが返されました。
  • コンテンツカード：カードは送信済みであり、閲覧可能です。
  • アプリ内メッセージ：メッセージはユーザーに表示されました。

時間経過に伴うメッセージ結果

この時系列チャートは、メッセージが中止されたりユーザーがキャンバスからドロップされたりしたさまざまな理由を、日ごとの内訳で示します。このチャートには送信数は表示されません。

メッセージ結果の内訳

このチャートは、選択した時間範囲内の全メッセージ結果の内訳を示します。以下の全体像を提供します：

• 全結果に占める送信総数の割合。
• 各中止およびドロップ理由の割合内訳。これにより、メッセージが送信されない最も一般的な原因を素早く特定できます。

中止結果

以下の定義は、ダッシュボードに表示される中止結果を説明します。結果はカテゴリー別にグループ化されており、調査対象の項目を簡単に見つけられます。

コンテンツとレンダリング

中止結果	説明
コンテンツカードの期限切れ	コンテンツカードはユーザーが閲覧する前に期限切れになりました。
コンテンツカードが無効	コンテンツカードにエラーがあったため、ユーザーに送信されませんでした。一般的な理由には以下があります： 最大サイズを超過（2 KB） 有効期限が無効 メッセージに無効な文字が含まれている
コネクテッドコンテンツの失敗	Brazeはメッセージを送信しようとしましたが、最大再試行回数（デフォルトは5回）を超えてコネクテッドコンテンツが失敗しました。注：このカウントは、最大再試行回数に達したために中止されたメッセージの数を表しており、コネクテッドコンテンツリクエストの失敗総数ではありません。
アプリ内メッセージのレンダリングタイムアウト	複数回の再試行後、Liquidをレンダリングできずタイムアウトしました。
Liquid中止	abort_message Liquidタグが呼び出されたため、送信がキャンセルされました。
Liquidレンダリングタイムアウト	Liquidテンプレートのレンダリングに時間がかかりすぎました。バナー、アプリ内メッセージ、メールで発生する可能性が最も高いです。
Liquid構文エラー	Liquidテンプレートに解析エラーがあったため、メッセージがキャンセルされました。

キャンペーンとキャンバスの状態

中止結果	説明
遅延ステップの失敗	遅延ステップが失敗したため、ユーザーはキャンバスを退出しました。この失敗は以下の場合に発生する可能性があります： パーソナライズされた遅延ステップに渡された変数が空または無効な型だった 遅延がキャンバス内で許容される最大期間を超えている
例外イベントまたは退出イベント	ユーザーは以前メッセージを受け取る資格がありましたが、以下のいずれかに該当しました： アクションベースのキャンペーンで例外イベントを実行したため、メッセージが中止された。 キャンバスの退出条件を満たしたため、ジャーニーの途中でドロップされた。
非アクティブなキャンペーン	メッセージが送信中にキャンペーンが停止されたため、中止されました。
非アクティブなキャンバス	ユーザーがジャーニーに入る前にキャンバスが停止されました。
非アクティブなキャンバスステップ	キャンバスでは、以下の場合に発生する可能性があります： キャンバスステップが削除された キャンバスが停止され、すべてのステップが非アクティブになった
ボリューム制限	キャンペーンが設定されたボリューム制限に達したため、送信がキャンセルされました。

レート制限とタイミング

中止結果	説明
フリークエンシーキャップ適用	ユーザーはワークスペースのフリークエンシーキャップルールで許可されている最大メッセージ数を既に受信しているため、送信がキャンセルされました。
サイレント時間による中止	キャンペーンまたはキャンバスステップでサイレント時間が有効になっており、フォールバックがメッセージを中止に設定されていました。ユーザーがサイレント時間中にキャンペーンをトリガーしたか、キャンバスメッセージステップに入ったため、メッセージが中止されました。ただし、これによりユーザーがキャンバスから退出することはありません。
72時間を超えるレート制限	配信速度のレート制限により、メッセージが72時間以上スロットリングされたため、送信が中止されました。

ユーザーの適格性とプロファイル

中止結果	説明
重複したユーザー識別子	同一の識別子（external ID、メールアドレス、電話番号など）を持つ複数のユーザーが、このメッセージを受信する資格がありました。同じユーザーへの重複送信を防ぐため、このメッセージは中止されました。
ユーザーがメッセージステップの事前チェックに失敗	この事前チェックは、配信検証の前に実行されます。この場合、ユーザーはこのメッセージステップの基本的な事前チェックを満たしていません（ユーザーが見つからないか、メッセージステップのチャネルの対象外です）。注：マルチチャネルのメッセージステップの場合、これはユーザーが見つからなかったことを意味します。チャネル適格性のチェックは、シングルチャネルのメッセージステップでのみここで行われます。
ユーザーがトリガーメッセージの事前チェックに失敗	トリガーメッセージについて、Brazeはこのトリガーから送信メッセージを作成する前に、オーディエンスの適格性、再適格性、およびチャネル適格性に関する基本的な事前チェックを初回パスとして実行します。
ユーザーの適格性喪失	ユーザーは当初ターゲットオーディエンスに含まれていましたが、Brazeがメッセージを送信する前、またはユーザーをキャンバスに入れる前に、オーディエンス条件に合致しなくなりました。ユーザーが最初にオーディエンス条件を満たしてから条件を満たさなくなるまでの時間は、以下の遅延が原因である可能性があります： インテリジェントタイミング サイレント時間 ローカルタイム 配信速度のレート制限（キャンバスエントリには適用されません） メッセージングパイプラインの遅延
ユーザーがステップの対象外	ユーザーは、メッセージステップで設定された配信検証条件を満たさなかったか、除外リストに含まれていたため、キャンバスを退出しました。
ユーザーに再適格性なし	ユーザーはメッセージを受信する資格があったか、またはキャンバスに入る資格がありましたが、再適格性または再エントリの設定により送信がキャンセルされました。これは、ユーザーが既にキャンペーンを受信しているか、キャンバスに最近入った場合、同じキャンペーンの別の送信がこのユーザーに対して既に進行中の場合、または再適格性や再エントリが無効になっている場合に発生する可能性があります。
ユーザープロファイルが見つからない	そのユーザーはBrazeに存在したことがないか、既に存在していません。よくあるケースには以下があります： そのユーザーはAPIメッセージングでターゲットにされたが、Brazeには存在しなかった。 メッセージが送信される前、またはキャンバスステップが実行される前に、ユーザーが削除された。 メッセージが送信される前に、そのユーザーは別のプロファイルと統合された。

チャネルと配信

中止結果	説明
パートナー配信タイムアウト	Brazeはこのメッセージを配信パートナーに24時間送信を試みましたが、パートナーは全期間にわたって一時的なエラーを返しました。
プッシュ認証情報が無効	このアプリのプッシュ認証情報が欠落しているか無効であるため、送信がキャンセルされました。アプリ設定で認証情報を更新してください。
ユーザーがAndroidプッシュ、アプリ、またはデバイスに対して有効でない	このユーザーにはプッシュ通知を送信できません。よくある理由には以下があります： ユーザーがアプリをインストールしていない。 ユーザーが有効なプッシュトークンを持っていない。 このプッシュ通知に必要なデバイスをユーザーが持っていない。 ユーザーがデバイスの設定でこのアプリの通知を無効にしている。 ユーザーがプッシュ通知の受信を購読またはオプトインしていない。
ユーザーがiOSプッシュ、アプリ、またはデバイスに対して有効でない	「ユーザーがAndroidプッシュ、アプリ、またはデバイスに対して有効でない」の中止結果と同じです。
ユーザーがKindleプッシュ、アプリ、またはデバイスに対して有効でない	「ユーザーがAndroidプッシュ、アプリ、またはデバイスに対して有効でない」の中止結果と同じです。
ユーザーがWebプッシュ、アプリ、またはデバイスに対して有効でない	「ユーザーがAndroidプッシュ、アプリ、またはデバイスに対して有効でない」の中止結果と同じです。
ユーザーがコンテンツカードに対して有効でない	ユーザーはこのコンテンツカードを含むアプリを使用していません。
ユーザーがメールに対して有効でない	このユーザーにはメールを送信できません。よくある理由には以下があります： ユーザープロファイルにメールアドレスが登録されていない。 ユーザーのサブスクリプション状態により、このメールの受信対象外となっている。 ユーザーのメールアドレスが以前に無効とマークされている（ハードバウンス）。 このメールアドレスに送信されたメッセージが常にスパムとしてマークされるため、送信がキャンセルされた。
ユーザーがLINEに対して有効でない	このユーザーにはLINEメッセージを送信できません。よくある理由には以下があります： ユーザープロファイルに電話番号が登録されていない。 ユーザーの電話番号が配信失敗のため無効とマークされた。 ユーザーのサブスクリプション状態により、このメッセージの受信対象外となっている。 ユーザーがLINE IDを持っていない。
ユーザーがSMS/MMS/RCSに対して有効でない	このユーザーにはSMSメッセージを送信できません。よくある理由には以下があります： ユーザープロファイルに電話番号が登録されていない。 ユーザーの電話番号が配信失敗のため無効とマークされた。 ユーザーの電話番号が有効なE.164形式ではなく、自動フォーマットの試みが失敗した。 ユーザーのサブスクリプション状態により、SMSメッセージの受信対象外となっている。 ユーザーの電話番号がブロックされた国のものである。
ユーザーがWhatsAppに対して有効でない	このユーザーにはWhatsAppメッセージを送信できません。よくある理由には以下があります： ユーザープロファイルに電話番号が登録されていない。 ユーザーの電話番号が配信失敗のため無効とマークされた。 ユーザーのサブスクリプション状態により、このメッセージの受信対象外となっている。 ユーザーがWhatsAppアカウントを持っていない。
Webhookの失敗	Webhookが失敗レスポンスコード（非2xx）を受け取りました。詳細についてはメッセージアクティビティログを参照してください。60時間以上経過したログは削除され、アクセスできなくなります。Webhookのエラーは1時間あたり最大20件までサンプリングされます。

よくある質問

「事前チェック」の失敗とはどういう意味ですか？

「事前チェック」とは、パイプライン段階の最初（メッセージのトリガー時やキャンバスメッセージステップの送信時など）に実行される、高速で一括処理される検証チェックを指します。これは、最高速度を追求した早期退出の仕組みと考えてください。多くの個別のリソース集約型チェック（ユーザープロファイルの詳細を一つ一つ検証するなど）を実行する代わりに、Brazeはいくつかの基本的な検証を1つの「初回パス」にまとめて処理します。

ユーザーがこの一括チェックに失敗した場合、即座にドロップされます。この一括処理方式により、Brazeは大量のメッセージを高速で処理でき、各メッセージの処理レイテンシーを削減することで、キャンペーンやキャンバスのパフォーマンスをより高速かつ安定させることに貢献します。

「その他」の中止結果とはどういう意味ですか？

これらは、既存のBrazeカテゴリーのいずれにも該当しなかった中止です。この結果の中止が大きな割合を占めている場合は、Brazeサポートにお問い合わせください。

_合計中止数_と_メッセージ送信数_の合計が、予想していたオーディエンスサイズより少ないのはなぜですか？

これにはいくつかの理由が考えられます：

• オーディエンス条件：キャンペーンやキャンバスが開始された時点で、予想より少ないユーザーしかオーディエンス条件を満たしていなかった可能性があります（例えば、対象セグメントに含まれていなかった、または必要な属性を持っていなかった）。
• 処理中：メッセージがまだ処理中の可能性があります。ユーザーがまだキャンバスの初期ステップに留まっており、メッセージステップに到達していない場合があります。
• データの鮮度：ダッシュボードのデータは約15分ごとに更新されますが、これは保証ではありません。このキャンペーンまたはキャンバスの最新データが、まだダッシュボードに反映されていない可能性があります。
• エッジケース：現時点でこのダッシュボードで捕捉されていないエッジケースに遭遇している可能性がわずかにあります。この状況が疑われる場合は、Brazeサポートにお問い合わせください。

キャンペーンとキャンバスの_合計中止数_と_メッセージ送信数_の合計が、オーディエンスサイズより大きくなるのはなぜですか？

これは以下の理由により発生する可能性があります：

• マルチチャネルメッセージ：キャンペーンまたはキャンバスステップが、複数のチャネル（SMSやメールなど）で送信されるように設定されていました。1人のユーザーが、あるチャネル（メールなど）では「送信済み」の結果を受け取り、別のチャネル（「ユーザーがSMS/MMS/RCSに対して有効でない」など）では「中止」の結果を受け取る可能性があります。この場合、そのユーザーはチャートで2回カウントされます：1回は「送信」として、もう1回は「中止」としてです。
  • 例：100人のユーザーにプッシュキャンペーンを送信し、iOSとAndroidの両方をターゲットにします。ユーザーがiOSデバイスのみを持っている場合、iOSプッシュ（「送信済み」）は受信しますが、Androidプッシュ（「ユーザーがAndroidプッシュ、アプリ、またはデバイスに対して有効でない」）の中止もトリガーされます。
• 複数のメッセージステップ（キャンバスのみ）：キャンバスの特定のパスに複数のメッセージステップが含まれている場合があります。このダッシュボードはすべての結果を集計するため、選択した時間範囲内で複数のメッセージステップを通過した場合、同一ユーザーが複数回カウントされる可能性があります。
• テストメッセージ：テスト送信（ダッシュボードでカウントされます）により、合計カウントがオーディエンスサイズより大きくなっています。