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

メッセージングオブザーバビリティは、キャンバスやキャンペーン全体のイベントをトレースすることで、メッセージングの監査やトラブルシューティングを行えるようにします。傾向の把握、キャンバス内でのユーザーの進行状況の確認、メッセージが期待どおりに送信されなかった理由の診断に使用できます。

主なコンセプト

送信済みと配信済み

このダッシュボードは、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が作成したダッシュボードの一覧からメッセージングオブザーバビリティを選択します。
• キャンバスまたはキャンペーンの分析ページで、メッセージングオブザーバビリティを選択します。利用可能な場合、そのキャンバスまたはキャンペーンが事前選択された状態でダッシュボードが開きます。

ダッシュボードを実行してデータを表示するには、以下の手順に従います。

1. 過去7日間以内の日付または日付範囲を選択します。
2. ダッシュボードレポートのソースとしてキャンペーンまたはキャンバスを選択します。
3. キャンペーンまたはキャンバスを1つ選択します。
4. （オプション、キャンバスのみ）1つ以上のキャンバスステップを選択して、結果をそれらのステップに絞り込みます。
5. ダッシュボードを実行を選択して、選択したフィルターのデータを読み込みます。

データを解釈する

サマリータイル

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

• エントリ: 選択した期間内に評価された、対象となるすべてのキャンバスまたはキャンペーンのエントリ。メッセージングオブザーバビリティは異なるソースのトラブルシューティングデータを使用するため、これらのカウントは分析ビューとわずかに異なる場合があります。
• 抑制: エントリ後に、適格性、フリークエンシーキャップ、サイレント時間などの理由でBrazeが意図的に送信しなかったメッセージ。詳細については、抑制を参照してください。
• 失敗: Liquid、Webhook、プッシュエラーなど、予期せず失敗したメッセージ。詳細については、失敗を参照してください。
• 送信済み: Brazeの処理を正常に通過したメッセージ。これは受信者への配信を保証するものではありません。配信はチャネル、キャリア、デバイスに依存します。詳細については、送信済みと配信済みを参照してください。

時系列イベント

この時系列チャートには、選択したフィルターに基づくイベントの1時間ごとの内訳が表示されます。チャートビューを使用して、概要の合計を比較したり、抑制と失敗を結果別に分類したりできます。このチャートの結果ラベルは正規化されたダッシュボードラベルであり、未加工のイベントペイロード値ではありません。

イベントログ

イベントログには、選択したフィルターと期間に基づいて、各ユーザーに対してBrazeが記録した個々のイベント（主に抑制、進行、失敗）が一覧表示されます。タイムスタンプ、ユーザー ID、キャンバスステップ、イベント、説明、メッセージングチャネルを含む特定のレコードを確認するために使用します。

特定のレコードに絞り込むには、テーブルをフィルタリングします。

• イベントフィルターからイベントカテゴリまたは個別のイベントを選択します（例: 抑制 > フリークエンシーキャップ、または進行 > ステップにエントリ）。
• 検索フィールドにユーザー IDを入力すると、そのユーザーの行が表示されます。

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

行の表示を選択すると、そのイベントに関する詳細なコンテキストを含むサイドパネルが開きます。パネルからAsk Operatorを選択して、修正ガイダンスを取得することもできます。

進行イベント

進行イベントは、ユーザーがキャンバスをどのように進むかを示します。キャンバス専用のイベントです。キャンペーンのエントリは、エントリの下にキャンペーンにエントリとして表示されます。

進行イベント	説明
キャンバスにエントリ	ユーザーがキャンバスにエントリしました。エントリはスケジュール、アクションベース、またはAPIトリガーで行われます。コントロールグループに登録されたユーザーもこのラベルの下に表示される場合があります。
アクションパスステップにエントリ	ユーザーがアクションパスステップにエントリし、アクション後にパスを取りました（または全員パスを取りました）。
エージェントステップにエントリ	ユーザーがエージェントステップにエントリし、コンテキストが評価されました。
オーディエンスパスステップにエントリ	ユーザーがオーディエンスパスステップにエントリし、オーディエンスパスを取りました（または全員パスを取りました）。
オーディエンス同期ステップにエントリ	ユーザーがオーディエンス同期ステップにエントリし、オーディエンス同期が開始されました。
コンテンツオプティマイザーステップにエントリ	ユーザーがコンテンツオプティマイザーステップにエントリし、バリアントが選択されました。
コンテキストステップにエントリ	ユーザーがコンテキストステップにエントリし、コンテキスト変数が設定または評価されました。
条件分岐ステップにエントリ	ユーザーが条件分岐ステップにエントリし、Branchを取りました。
ディレイステップにエントリ	ユーザーがディレイステップにエントリし、遅延中、即時進行（例: ゼロ遅延）、またはそのステップを進行中です。
実験パスステップにエントリ	ユーザーが実験パスステップにエントリし、実験バリアントに割り当てられました。
フィーチャーフラグステップにエントリ	ユーザーがフィーチャーフラグステップにエントリし、フィーチャーフラグが評価されています。
メッセージステップにエントリ	ユーザーがメッセージステップにエントリしました。そのステップの後続の抑制、失敗、または送信は別のイベントとして表示されます。
送信先ステップにエントリ	ユーザーが送信先ステップにエントリしました。Brazeは、ユーザーが送信先のキャンバスにエントリする資格があるかどうかを確認しています。
ユーザー更新ステップにエントリ	ユーザーがユーザー更新ステップにエントリしました。ユーザー属性が更新されているか、ユーザー更新のレート制限により一時的に遅延しています。
送信先に送信済み	ユーザーが送信先のキャンバスに送信され、現在のキャンバスの次のステップに進みました。
送信先に送信されず	ユーザーは送信先のキャンバスにエントリしませんでした（例: オーディエンスの不一致のため）。現在のキャンバスの次のステップに進みました。
送信先が見つからない	送信先のキャンバスが見つかりませんでした。ユーザーは現在のキャンバスの次のステップに進みました。
キャンバスを退出	ユーザーがキャンバスを退出しました。これは以下の場合に発生します。 キャンバスの退出基準 を満たした場合。 キャンバスまたはステップが停止されたか、ステップが削除された場合。 続行する資格がないか、キャンバスパスが存在しない場合。 パーソナライズされた遅延が計算できないか、遅延時間がすでに経過しているため、ディレイステップが続行できない場合。 アクションパスステップの評価ウィンドウが計算できないか、重複したアクションを受信した場合。 分割を適用できない、ホールドアウトを送信できない、またはコントロールグループに次のステップがないなどの理由で、実験パスステップが続行できない場合。 ステップがリトライを使い果たした場合。

抑制

抑制は、設定、適格性、または配信コントロールに基づく、エントリ後の意図的な非送信です。

送信設定

抑制	説明
優先度により中止	このユーザーに対してより高い優先度のメッセージがすでに保留中であったか、このメッセージの優先度が下げられたため、送信が中止されました。
バナーの有効期限切れ	バナーが配信される前に有効期限が切れました。
Content Cardの有効期限切れ	ユーザーが確認する前にContent Cardの有効期限が切れました。
コンテンツオプティマイザーバリアントが無効化	コンテンツオプティマイザーのバリアント割り当てが、送信前に無効化されました。
フリークエンシーキャップ	ワークスペースのフリークエンシーキャップルールで許可されている最大メッセージ数をユーザーがすでに受信したため、送信がキャンセルされました。
非アクティブなキャンペーン	メッセージが送信中にキャンペーンが停止されたため、中止されました。
非アクティブなキャンバス	ユーザーがジャーニーにエントリする前にキャンバスが停止されました。
非アクティブなキャンバスステップ	これはキャンバスで以下の場合に発生します。 キャンバスステップが削除された場合 キャンバスが停止され、すべてのステップが非アクティブになった場合
サイレント時間による中止	フォールバックがメッセージを中止に設定されたキャンペーンまたはキャンバスステップで、サイレント時間が有効でした。ユーザーがサイレント時間中にキャンペーンをトリガーしたか、キャンバスのメッセージステップにエントリしたため、メッセージが中止されました。ただし、これによりユーザーはキャンバスから退出しません。
ボリューム制限	キャンペーンまたはキャンバスが設定されたボリューム制限に達したため、送信がキャンセルされました。

ユーザーの適格性

抑制	説明
ユーザー識別子の重複	一致する識別子（external ID、メールアドレス、電話番号など）を持つ複数のユーザーが、このメッセージの受信対象でした。同一ユーザーへの重複送信を防ぐため、このメッセージは中止されました。
例外イベントまたは退出イベント	ユーザーは以前このメッセージの受信対象でしたが、 アクションベースのキャンペーンの例外イベント を実行したためメッセージが中止されたか、または キャンバスの退出基準 を満たしたため、ジャーニーの途中でドロップされました。
メッセージステップの事前チェックに失敗	Brazeは、キャンバスのメッセージステップの完全な配信検証の前に、オーディエンスの適格性、再適格性、チャネルの適格性に関する基本的な事前チェックの最初のパスを実行します。この結果は、ユーザーまたはメッセージがこれらのチェックのいずれかに失敗したため、そのステップのメッセージが中止されたことを意味します。
トリガーメッセージの事前チェックに失敗	Brazeは、このトリガーから送信するメッセージを作成する前に、オーディエンスの適格性、再適格性、チャネルの適格性に関する基本的な事前チェックの最初のパスを実行します。この結果は、ユーザーまたはメッセージがこれらのチェックのいずれかに失敗したため、メッセージが中止されたことを意味します。
ユーザーの適格性がなくなった	ユーザーは最初はターゲットオーディエンスに含まれていましたが、Brazeがメッセージを送信するか、ユーザーをキャンバスにエントリさせる前に、オーディエンス基準に一致しなくなりました。ユーザーが最初にオーディエンス基準を満たしてからオーディエンスから外れるまでの時間は、以下の遅延が原因の可能性があります。 インテリジェントタイミング サイレント時間 ローカル時間 配信速度のレート制限（キャンバスのエントリには適用されません） メッセージングパイプラインの遅延
チャネルの適格性がない	ユーザーは選択されたチャネルでこのメッセージを受信する適格性がありません。一般的な理由には、チャネル識別子が存在しないか無効、適格なプッシュトークンがない、購読状態の制限、サポートされていないチャネル機能、電話ベースのチャネルでのブロックされた国などがあります。
ステップの適格性がない	ユーザーがメッセージステップに設定された配信検証を満たさなかったか、抑制リストに含まれていました。配信検証の設定に応じて、ユーザーはキャンバスを退出したか、次のステップに進んだ可能性があります。
再適格性がない	ユーザーはメッセージの受信またはキャンバスへのエントリの適格性がありましたが、再適格性または再エントリの設定のため送信がキャンセルされました。これは、ユーザーがすでにキャンペーンを受信したか、キャンバスに最近エントリした場合、同じキャンペーンに対する別の送信がすでに進行中の場合、または再適格性もしくは再エントリがオフになっている場合に発生します。

失敗

失敗は、処理中または配信試行中に発生した予期しないエラーです。

失敗	説明
Connected Contentの失敗	Brazeはメッセージの送信を試みましたが、Connected Contentが最大リトライ回数（デフォルトは5回）の後に失敗しました。このカウントは、最大リトライ回数に達したために中止されたメッセージの数を表しており、Connected Contentリクエストの失敗総数ではありません。
Content Cardが無効	Content Cardにエラーがあり、ユーザーに送信されませんでした。一般的な理由には以下があります。 最大サイズ（2 KB）を超過 有効期限が無効 メッセージに無効な文字が含まれている
ディレイステップの失敗	ディレイステップが失敗し、ユーザーがキャンバスを退出しました。この失敗は以下の場合に発生する可能性があります。 パーソナライズされた遅延ステップに提供された変数が空か、無効な型だった場合 遅延がキャンバス内で許可される最大期間を超えている場合
Liquidの中止	abort_message Liquidタグが呼び出されたため、送信がキャンセルされました。
Liquidレンダリングのタイムアウト	Liquidテンプレートのレンダリングに時間がかかりすぎました。バナー、アプリ内メッセージ、メールで最も発生しやすいです。
Liquid構文エラー	Liquidテンプレートに解析エラーがあったため、メッセージがキャンセルされました。
メディアURLの失敗	Brazeはメッセージ内のメディアURLを処理できませんでした。URLがブロックされている、無効、タイムアウト、無効なHTTPステータスを返す、またはSSL検証に失敗した場合に発生します。
パートナー配信エラー	Brazeは24時間にわたり配信パートナーにこのメッセージの送信を試みましたが、パートナーがその間ずっと一時的なエラーを返しました。
商品レコメンデーションが無効	商品レコメンデーションまたはカタログの選択をこの送信に使用できませんでした。一般的な理由には、レコメンデーションが欠落またはアーカイブされている、トレーニングが不完全、またはフィルターによりすべてのカタログアイテムが除外されたことなどがあります。
プッシュ認証情報が無効	このアプリのプッシュ認証情報が欠落しているか無効なため、送信がキャンセルされました。アプリ設定で認証情報を更新してください。
72時間を超えるレート制限	配信速度のレート制限により、メッセージが72時間以上スロットルされたため、送信が中止されました。
購読グループの失敗	購読グループまたはメッセージングサービスの設定の問題により、メッセージを送信できませんでした。一般的な理由には、SMSまたはWhatsAppの送信番号が欠落している、または設定されたメッセージングサービスでMMSがサポートされていないことなどがあります。
ユーザープロファイルが見つからない	ユーザーが存在したことがないか、Brazeに存在しなくなっています。一般的なケースには以下があります。 APIメッセージングを使用してユーザーをターゲットにしたが、Brazeに存在しなかった場合。 メッセージが送信される前またはキャンバスステップが実行される前にユーザーが削除された場合。 メッセージが送信される前にユーザーが別のプロファイルにマージされた場合。
Webhookの失敗	Webhookが失敗のレスポンスコード（非2xx）を受信しました。一般的なエラーコードには、4XXクライアントエラー、5XXサーバーエラーまたはタイムアウト、598 Host Unhealthyまたはリクエストの一時停止があります。
その他	このテーブルの他のカテゴリに該当しない失敗です。その他の失敗が大きな割合を占めている場合は、Brazeサポートにお問い合わせください。

よくある質問

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

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

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

「その他」の失敗とは何ですか？

これらは、既存のダッシュボードカテゴリに該当しない失敗です。「その他」の失敗の割合が依然として大きい場合は、Brazeサポートに連絡して、さらなるサポートを受けてください。

エントリ、抑制、失敗、送信済みの合計が期待するオーディエンスサイズと一致しないのはなぜですか？

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

• オーディエンス条件： キャンペーンやキャンバスが起動されたとき、予想よりも少ないユーザーしかオーディエンス条件を満たしていなかった可能性があります（例えば、セグメントに含まれていなかった、または必要な属性を持っていなかった）。
• 処理中： メッセージやキャンバスステップがまだ処理中の場合があります。ユーザーがまだキャンバスの初期のステップにいて、メッセージステップに到達していない可能性があります。
• 送信を伴わない進行： ユーザーは、同じ期間内に対応する抑制、失敗、または送信なしに、進行イベント（遅延ステップや条件分岐ステップへのエントリなど）を生成できます。
• データの鮮度： ダッシュボードのデータは約15分ごとに更新されますが、これは保証されていません。このキャンペーンやキャンバスの最新データがまだダッシュボードに反映されていない可能性があります。
• エッジケース： 現時点でこのダッシュボードに反映されていないエッジケースに遭遇している可能性がわずかにあります。その可能性がある場合は、Brazeサポートに連絡してください。

タイルやイベントログの合計がキャンペーンやキャンバスのオーディエンスよりも大きくなるのはなぜですか？

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

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