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

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

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

前提条件

メッセージング可観測性にアクセスするには、ワークスペースに対する「ダッシュボードレポートを表示」の権限が必要です。

主要な概念

送信と配信

このダッシュボードは、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、キャンバスステップ、イベント、説明、メッセージングチャネルなど、特定のレコードを確認する際に使用します。

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

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

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

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

注

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

進行イベント

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

注

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

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

抑制

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

注

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

送信設定

抑制	説明
優先度による中止	このユーザーに対して優先度の高い別のメッセージがすでに保留中であったか、このメッセージの優先度が下げられたため、送信が中止されました。
バナーの有効期限切れ	バナーが配信される前に有効期限が切れました。
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つの「最初のパス」にまとめています。

ユーザーがこの1つのまとめられたチェックに失敗すると、そのユーザーはすぐに除外されます。このまとめて検証する方法により、Brazeは大量のメッセージを高速に処理できます。また、メッセージごとの処理レイテンシーが短くなるため、キャンペーンやキャンバスのパフォーマンスがより高速かつ安定する場合があります。

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

既存のダッシュボードカテゴリーのいずれにも該当しない失敗です。それでも「その他」の失敗が多い場合は、Brazeサポートに問い合わせてサポートを受けてください。

エントリ、抑制、失敗、送信の合計が想定したオーディエンスサイズと一致しないのはなぜですか?

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

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

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

これは、次の理由で発生することがあります。

マルチチャネルメッセージ: キャンペーンやキャンバスのステップが、複数のチャネル (SMSとメールなど) で送信するように設定されています。1人のユーザーが、あるチャネル (メールなど) では「送信」の結果となり、別のチャネルでは抑制や失敗 (「ユーザーがチャネルの対象外」など) となることがあります。この場合、その1人のユーザーがタイルやイベントログで複数回カウントされます。
- たとえば、iOSとAndroidの両方を対象に、100人のユーザーにプッシュキャンペーンを送信するとします。iOSデバイスのみを持つユーザーは、iOSプッシュを受信します (「送信」) が、Androidプッシュについては抑制 (「ユーザーがチャネルの対象外」) も発生します。
複数のメッセージステップ (キャンバスのみ): キャンバスの1つのパスに、複数のメッセージステップが含まれている場合があります。このダッシュボードはすべてのイベントを集計するため、選択した期間内にユーザーが複数のステップを通過すると、1人のユーザーが複数回カウントされることがあります。
テストメッセージ: テスト送信 (ダッシュボードでカウントされます) により、合計がオーディエンスサイズより多くなることがあります。

New Stuff!