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

メッセージング診断ダッシュボードは、メッセージ送信結果の概要を提供し、メッセージング設定における傾向の把握や潜在的な問題の診断を可能にします。このダッシュボードは、CampaignsやCanvasesからのメッセージが期待どおりに送信されなかった理由を理解するのに役立ちます。

主要な概念

送信済みと配信済み

このダッシュボードは、Brazeが内部的にメッセージを処理した方法を報告するものであり、メッセージの最終的な配信ステータスを報告するものではないことを理解することが重要です。

このダッシュボードで「送信済み」と表示されたメッセージは、Brazeがメッセージの処理と送出に成功したことを意味します。ほとんどのチャネルでは、Brazeが関連するサードパーティの送信パートナーにメッセージを引き渡したことを意味します。ただし、ユーザーのデバイスへの最終的な配信を保証するものではありません。

Brazeがメッセージを「送信」した場合、最終的な配信は外部サービスに依存する場合があります。各チャネルの例を以下に示します。

チャネル	最終配信の例
Content Cards	カードが送信され、閲覧可能な状態になりました。
メール	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時間未満です。

ダッシュボードの設定

診断ダッシュボードにアクセスするには、Analytics > ダッシュボードビルダーに移動し、Brazeが作成したダッシュボードのリストからMessaging Diagnosticsを選択します。

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

1. ダッシュボードレポートのソースとしてCampaignsまたはCanvasesを選択します。
2. 1つ以上のCampaignまたはCanvasを選択します。
3. Run Dashboardを選択して、選択したフィルターのデータを読み込みます。

データの解釈

サマリータイル

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

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

時系列でのメッセージ結果

この時系列チャートは、メッセージが中止された理由やユーザーがCanvasからドロップされた理由の日別内訳を表示します。このチャートには送信数は表示されません。

メッセージ結果の内訳

このチャートは、選択した期間内のすべてのメッセージ結果の内訳を表示します。以下の全体像を把握できます:

• すべての結果に対する送信数の割合。
• 各中止およびドロップ理由の割合の内訳。これにより、メッセージが送信されない最も一般的な理由をすばやく特定できます。

中止の結果

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

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

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

CampaignとCanvasの状態

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

レート制限とタイミング

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

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

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

チャネルと配信

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

よくある質問

「事前チェック」の失敗とは何ですか？

「事前チェック」とは、パイプラインステージ（メッセージのトリガーやCanvasのメッセージステップの送信など）の最初に実行される高速でバンドルされたバリデーションチェックのことです。最大速度を実現するための早期終了と考えてください。ユーザープロファイルのすべての詳細を検証するような、個別のリソース集約型チェックを多数実行する代わりに、Brazeは複数の基本的なバリデーションを1つの「最初のパス」にバンドルします。

ユーザーがこのバンドルされたチェックに失敗すると、即座にドロップされます。このバンドルアプローチにより、Brazeは大量のメッセージを高速で処理でき、各メッセージの処理レイテンシーを削減することで、CampaignsやCanvasesのパフォーマンスの向上と安定化に貢献します。

「その他」の中止結果とは何ですか？

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

「中止の合計」と「メッセージ送信数」の合計が、予想されるオーディエンスサイズよりも少ないのはなぜですか？

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

• オーディエンス条件: CampaignまたはCanvasが起動された時点で、予想よりも少ないユーザーしかオーディエンス条件を満たしていなかった可能性があります（たとえば、Segmentに含まれていなかったか、必要な属性を持っていなかった）。
• 処理中: メッセージがまだ処理中の可能性があります。ユーザーがまだCanvasの前のステップにいて、メッセージステップに到達していない場合があります。
• データの鮮度: ダッシュボードのデータは約15分ごとに更新されますが、これは保証されません。このCampaignまたはCanvasの最新データがまだダッシュボードに反映されていない可能性があります。
• エッジケース: 現時点でこのダッシュボードに反映されていないエッジケースに遭遇している可能性がわずかにあります。その疑いがある場合は、Brazeサポートにお問い合わせください。

「中止の合計」と「メッセージ送信数」の合計が、CampaignやCanvasのオーディエンスよりも多いのはなぜですか？

これは以下の理由で発生する可能性があります:

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