このページはAIにより自動翻訳されており、不正確な内容が含まれている可能性があります。翻訳の誤りを報告するには、ページ右側の目次の下にあるフィードバックをご利用ください。

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

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

前提条件

メッセージング可観測性にアクセスするには、ワークスペースに対する「View Dashboard Reports」権限が必要です。

主な概念

送信と配信

このダッシュボードは、Brazeがメッセージを内部でどのように処理したかをレポートするもので、メッセージの最終的な配信ステータスを示すものではありません。

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

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

チャネル	最終配信の例
バナー	バナーが送信され、表示可能な状態になりました。
Content Cards	カードが送信され、表示可能な状態になりました。
メール	Brazeはメッセージをメールサービスプロバイダー (ESP) に引き渡します。その後、ESPが最終的な配信を担います。たとえば、メールアドレスが無効な場合や受信トレイが満杯の場合、ESPは「バウンス」を報告することがあります。
アプリ内メッセージ	ユーザーがメッセージを表示し、インプレッションが記録されました。
KakaoTalk	メッセージが送信パートナーに正常に引き渡されました。
LINE	メッセージが送信パートナーに正常に引き渡されました。
プッシュ	Brazeはメッセージを適切なプッシュ通知サービス (iOSの場合はApple Push Notification service、Androidの場合はFirebase Cloud Messagingなど) に引き渡します。そのサービスが、デバイスへの通知の最終的な配信を担います。
SMS/MMS/RCS	Brazeはメッセージを SMS ゲートウェイ (Twilioなど) に引き渡します。そのゲートウェイが、携帯通信事業者への最終的な配信を担います。
Webhook	Webhookリクエストが正常に実行され、`2xx` レスポンスが返されました。
WhatsApp	メッセージが送信パートナーに正常に引き渡されました。

キャンバスの進行イベント

キャンバスの場合、メッセージング可観測性には進行イベントも表示されます。進行イベントとは、キャンバスへのエントリ、ステップへのエントリ、キャンバスからのエグジットなど、ユーザーがジャーニー内をどのように移動したかを示す記録です。進行イベントは、メッセージの送信結果とは別のものです。ユーザーがキャンバス内のどこにいるかを把握するのに役立ちます。

データの鮮度

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

ダッシュボードを設定する

メッセージング可観測性は、次のいずれかの場所から開けます。

分析 > ダッシュボードビルダーに移動し、Braze が作成したダッシュボードの一覧からメッセージング可観測性を選択します。
キャンバスまたはキャンペーンの分析ページで、メッセージング可観測性を選択します。可能な場合、そのキャンバスまたはキャンペーンが事前に選択された状態でダッシュボードが開きます。

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

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

重要

フィルターを変更した後は、再度ダッシュボードを実行を選択して、サマリータイル、グラフ、イベントログを更新してください。更新するまで、ダッシュボードに「古い結果」という警告が表示される場合があります。

サマリータイルを含むメッセージング可観測性ダッシュボード。時系列のイベントグラフにはエントリ、抑制、失敗、送信がプロットされ、前回の実行以降にフィルターが変更されたことを示す「古い結果」の警告が表示されています。

データを解釈する

注

ダッシュボードには、最大で過去7日間のデータが表示されます。すべてのタイムスタンプは、ワークスペースのタイムゾーンで表示されます。

サマリータイル

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

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

時系列のイベント

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

イベントログ

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

「イベント」フィルターが「すべてのイベント」に設定されたイベントログ。行には、遅延ステップの失敗、ユーザーが対象外、キャンバスからの退出、指定先に送信、Liquidの中止が含まれています。

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

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

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

行の表示を選択すると、そのイベントに関する詳細なコンテキストを示すサイドパネルが開きます。パネルからオペレーターに質問を選択して、修正のためのガイダンスを得ることもできます。

注

チャネルフィルターは、特定のメッセージングチャネルに関連付けられたイベントに適用されます。一部のイベントはチャネルに依存しないため、チャネルフィルターを適用しても集計ビューに表示される場合があります。

進行イベント

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

注

メッセージング可観測性の進行イベントのラベルは、人が読みやすいダッシュボードラベルです。これらのデータセットは表現方法や処理経路が異なるため、他のBraze分析画面とは数や名前が異なる場合があります。

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

抑制

抑制とは、設定、適格性、または配信コントロールによって、エントリ後に意図的に送信しないことです。

注

メッセージング可観測性の抑制と失敗のラベルは、人が読みやすいダッシュボードラベルです。Currentsのメッセージエンゲージメントイベントでは、中止情報は abort_type や abort_log などのフィールドで表されます。これらのデータセットは表現方法や処理経路が異なるため、Currentsとメッセージング可観測性では数や名前が異なる場合があります。

送信設定

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

ユーザーの適格性

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

失敗

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

失敗	説明
Connected Contentの失敗	Brazeはメッセージを送信しようとしましたが、最大再試行回数 (デフォルトは5回) の後にConnected Contentが失敗しました。この数は、最大再試行回数に達したために中止されたメッセージの数を表しており、失敗したConnected Contentリクエストの総数ではありません。
無効なContent Cards	Content Cardsにエラーがあったため、ユーザーに送信されませんでした。一般的な理由には次のものがあります。最大サイズ (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 人のユーザーがタイルとイベントログ全体で複数回カウントされます。
- たとえば、iOS と Android の両方を対象にして 100 人のユーザーにプッシュキャンペーンを送信したとします。ユーザーが iOS デバイスしか持っていない場合、そのユーザーは iOS プッシュを受信 (「送信」) しますが、Android プッシュについては抑制 (「ユーザーがチャネルの対象外」) もトリガーされます。
複数のメッセージステップ (キャンバスのみ): キャンバスの特定のパスに複数のメッセージステップがある場合があります。このダッシュボードはすべてのイベントを集計するため、選択した期間内にユーザーが複数のステップを通過すると、1 人のユーザーが複数回カウントされることがあります。
テストメッセージ: テスト送信 (ダッシュボードでカウントされます) により、合計がオーディエンスサイズを上回ることがあります。

New Stuff!