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

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

主要な概念

送付済み、配達済み

このダッシュボードは、メッセージの最終的なステータスではなく、Brazeが内部でメッセージをどのように処理したかをレポートしていることを理解することが重要だ。

このダッシュボードで「送信済み」とマークされたメッセージは、Brazeがメッセージを正常に処理し配信したことを意味する。ほとんどのチャネルでは、これはBrazeがメッセージを関連するサードパーティ送信パートナーに引き渡したことを意味する。ただし、ユーザーの端末への最終的な配信を保証するものではない。

Brazeがメッセージを「送信」する場合、最終的な配信は外部サービスに依存する可能性がある。各チャネルについて、以下の例を考えてみよ。

チャネル	最終納品の例
コンテンツカードによって促進された	カードは送付済みであり、閲覧可能である。
メール	Brazeはメッセージをメールサービスプロバイダー (ESP) に渡す。その後、メールサービスプロバイダー (ESP) が最終的な配送を担当する。例えば、メールサービスプロバイダー (ESP) はメールアドレスが無効だったり受信トレイが満杯だったりすると「バウンス」をレポートするかもしれない。
アプリ内メッセージ	そのメッセージはユーザーに表示された。
LINE	メッセージは送信パートナーに正常に引き渡された。
プッシュ	Brazeはメッセージを適切なプッシュ通知サービス（例えばiOS向けのAppleプッシュ通知サービスや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、プッシュ通知：メッセージは送信パートナーに正常に引き渡された。
  • Webhooks:Webhookのリクエストは正常に送信され、応答が2xx返された。
  • コンテンツカード:カードは送付済みであり、閲覧可能である。
  • アプリ内メッセージ:メッセージはユーザーに表示された。

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

この時系列チャートは、メッセージが中断されたりユーザーがキャンバスから切断されたりする様々な理由を、日ごとの内訳で示している。このグラフは送信数を表示していない。

メッセージの結果の内訳

このグラフは、選択した時間範囲内の全メッセージ結果の内訳を示している。それは次の完全な概要を提供する：

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

中止の結果

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

内容と表現

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

キャンペーンとキャンバス

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

レート制限とタイミング

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

ユーザー資格とプロファイル

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

チャネルと配信

中止の結果	説明
パートナーの配信タイムアウト	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件までサンプリングされる。

よくある質問

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

「事前チェック」とは、パイプライン段階の最初（例えばメッセージのトリガー時やCanvasメッセージステップの送信時）に実行される、高速で一括処理される検証チェックを指す。それを、最高速度を追求した早期退出と考えるといい。多くの別々のリソースを消費するチェック（例えばユーザープロファイルの詳細を一つ一つ検証する作業）を実行する代わりに、Brazeはいくつかの基本的な検証を一つにまとめて「最初のパス」として処理する。

ユーザーがこの単一のバンドルチェックに失敗した場合、即座に除外される。このバンドル方式により、Brazeは大量のメッセージを高速で処理できる。各メッセージの処理遅延を削減することで、キャンペーンやキャンバスのパフォーマンスを高速かつ安定させるのに寄与する。

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

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

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

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

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

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