メッセージングオブザーバビリティ

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

主要な概念

送信済みと配信済み

このダッシュボードは、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 > Dashboard Builderに移動し、Braze作成済みダッシュボードのリストからメッセージングオブザーバビリティを選択します。

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

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

データの解釈

サマリータイル

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

• 送信済み： Brazeが正常に処理して送信したメッセージの合計数。
  • メール、SMS/MMS/RCS、WhatsApp、LINE、プッシュ： メッセージが送信パートナーに正常に引き渡されました。
  • webhook： Webhookリクエストが正常に実行され、2xxレスポンスが返されました。
  • Content Cards： カードが送信され、表示対象となっています。
  • アプリ内メッセージ： メッセージがユーザーに表示されました。
• 未送信： 中止されたメッセージの合計数。これには、キャンバスに入らなかったキャンバスオーディエンスメンバーや、ステップの失敗またはイグジットイベントの実行中にイグジット条件を満たしたためにキャンバスを退出したメンバーが含まれます。

メッセージ結果の時系列

この時系列チャートは、メッセージが中止された理由やユーザーがキャンバスからドロップされた理由の時間別内訳を表示します。このチャートの結果ラベルは正規化されたダッシュボードラベルであり、生のイベントペイロード値ではありません。このチャートには送信数は表示されません。

メッセージ結果の詳細ログ

ダッシュボードには、選択したフィルターと期間に対する個別のメッセージ結果の詳細テーブルが表示されます。このテーブルを使用して、タイムスタンプ、ユーザーID、キャンバスステップ、結果、詳細、チャネルなどの特定のレコードを確認できます。

テーブルをフィルタリングして特定のレコードに絞り込むことができます：

• 結果でフィルター： 結果フィルターから結果を選択して、その結果の行のみを表示します（例：Frequency cappedやUser not eligible for channel）。
• ユーザーIDで検索： 検索フィールドにユーザーIDを入力して、特定のユーザーの行を表示します。

両方のフィルターを適用すると、選択した結果と入力したユーザーIDの両方に一致する行がテーブルに返されます。

テーブルの行を選択して詳細パネルを開きます。詳細パネルにはその結果に関する追加のコンテキストが表示され、Ask Operatorが根本的な問題のトラブルシューティングに役立つ修正ガイダンスを提供します。

中止の結果

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

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

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

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

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

レート制限とタイミング

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

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

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

チャネルと配信

中止の結果	説明
パートナー配信エラー	Brazeは24時間にわたって配信パートナーにこのメッセージを送信しようとしましたが、パートナーがその全期間にわたって一時的なエラーを返しました。
プッシュ認証情報が無効	このアプリのプッシュ認証情報が欠落しているか無効なため、送信がキャンセルされました。アプリ設定で認証情報を更新してください。
購読グループの失敗	購読グループまたはメッセージングサービスの設定の問題により、メッセージを送信できませんでした。一般的な理由には、SMSまたはWhatsAppの送信番号が欠落している、または設定されたメッセージングサービスでMMSがサポートされていないことが含まれます。
ユーザーがチャネル対象外	選択したチャネルでこのメッセージを受信する資格がユーザーにありません。一般的な理由には、チャネル識別子の欠落または無効、適格なプッシュトークンがない、購読状態の制限、サポートされていないチャネル機能、または電話ベースのチャネルでブロックされている国が含まれます。
Webhookの失敗	Webhookが失敗したレスポンスコード（非2xx）を受信しました。一般的なエラーコードには、4XXクライアントエラー、5XXサーバーエラーまたはタイムアウト、598 Host Unhealthyまたはリクエストの一時的な停止があります。

よくある質問

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

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

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

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

これらは、既存のダッシュボードカテゴリに分類されない中止です。「その他」の中止が大きな割合を占めている場合は、Brazeサポートにお問い合わせください。

未送信と送信済みの合計が期待されるオーディエンスサイズより少ないのはなぜですか？

これはいくつかの理由で発生する可能性があります：

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

未送信と送信済みの合計がキャンペーンやキャンバスのオーディエンスより多いのはなぜですか？

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

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