コンテンツにスキップ

Connected Contentデバッガー

Connected Contentデバッガーを使用すると、各Connected Content呼び出しのライブリクエストとレスポンスを確認できるため、キャンペーンやキャンバスを開始する前にエンドポイント、ヘッダー、Liquidタグを検証できます。

デバッガーについて

Connected Contentを使用すると、レンダリング時に外部APIへHTTPコールを行い、そのレスポンスをLiquidでメッセージに挿入することで、リアルタイムデータを使ってメッセージを充実させることができます。このコールはBrazeの外部で行われるため、キャンペーンやキャンバスを公開する前に、Brazeがどのようなリクエストを送信したのか、エンドポイントが何を返したのか、あるいはコールが失敗した理由を正確に把握するのは難しい場合があります。

Connected Contentデバッガーは、公開前にこうした問題のトラブルシューティングに役立ちます。プレビューとテストセクションで、メッセージ内のすべてのConnected Contentコールについて、実際のリクエストとレスポンスを表示します。これにより、エンドポイント、ヘッダー、Liquidタグが正しく設定されていることを、すべてBrazeダッシュボード内で確認できます。

サポートされている領域

Connected Contentデバッガーは、次の領域で利用できます。

  • バナー
  • キャンバスのコンテキストステップ
  • Content Blocks
  • Content Cards
  • メール
    • テンプレートを含む
    • フッターと購読ページを除く
  • アプリ内メッセージ
  • プッシュ通知
  • SMS、MMS、RCS
  • Webhook
    • テンプレートを含む
  • WhatsApp

デバッガーを使用する

プレビューを実行するたびに、BrazeはプレビュータブにConnected Contentの呼び出し結果を自動的に表示します。デバッガーを使用するには、次の手順に従います。

  1. {% connected_content %}タグを使用してメッセージを設定します。
  2. プレビューとテストセクションに移動します。メッセージにConnected Contentタグが含まれている場合は、Connected Contentの呼び出し回数と、成功およびエラーのステータスをまとめたサマリービューが表示されます。

テストセクション内のConnected Contentセクション。

  1. 詳細を表示を選択すると、プレビューの横にデバッガーが開きます。ドロワーには、各Connected Content呼び出しのURLと結果を示す表が表示されます。

確認対象の3つのURLを含むConnected Content呼び出し。

  1. 各URLと結果の横にある表示を選択すると、リクエストヘッダーとレスポンスヘッダー、ペイロード、メソッド、所要時間、キャッシュ情報を確認できます。

リクエストとレスポンスの詳細を表示したConnected Content呼び出し。

  1. 結果を確認し、必要に応じてタグ、ヘッダー、またはエンドポイントを調整します。その後、新しいプレビューを生成して修正内容を確認します。

テンプレートに複数の{% connected_content %}タグが含まれている場合、デバッガーには実行されたすべての呼び出しが一覧表示されます。1つのテンプレートから複数のメッセージ本文やプラットフォームのバリアントをレンダリングするチャネルでは、デバッガーはプレビュー中の本文だけでなく、それらすべてのレンダリングにわたるConnected Content呼び出しを一覧表示します。メールでは、HTMLとプレーンテキストで別々のレンダリング処理が行われることがあり（送信時にはAccelerated Mobile Pages（AMP）も含まれます）、同じURLが複数回表示される場合があります。クイックプッシュは最大4つのプラットフォーム（iOS、Android、Web、Kindle）向けにレンダリングできるため、同じConnected Contentの参照が最大4回表示される場合があります。

これらの重複は、Brazeがメッセージをレンダリングして送信する方法と一致しており、デバッガーはこれらをまとめて表示しません。呼び出し回数が送信数を上回る理由について詳しくは、Connected Contentの呼び出し量についてを参照してください。

デバッグ出力について

各 Connected Content 呼び出しには、それぞれレスポンスタブとリクエストタブが表示されます。レスポンスタブは、呼び出しが成功したかどうかを確認する最初の指標となることが多いため、デフォルトで表示されます。

URL の詳細

フィールド 説明
URL Braze が呼び出した、Liquidタグがすべて解決された状態の完全にレンダリングされた URL です。
メソッド 使用された HTTP メソッド (GET または POST) です。
ステータスコード エンドポイントが返した HTTP ステータスコード (200、404、500 など) です。Braze 固有のコードについては、レスポンスコードのトラブルシューティングを参照してください。

レスポンスタブ

フィールド 説明
所要時間 リクエストの完了にかかった時間 (秒) です。所要時間は、ライブ (キャッシュされていない) 呼び出しの場合にのみ表示されます。
キャッシュから提供 このレスポンスが、エンドポイントへのライブ呼び出しではなく、Braze の Connected Content キャッシュから提供されたかどうかを示します (はい または いいえ)。キャッシュされた結果は以前のレスポンスを反映したものであり、必ずしもエンドポイントの現在の状態を表しているとは限りません。
レスポンス本文 エンドポイントが返した本文です。

リクエストタブ

フィールド 説明
ヘッダー Connected Content タグからのヘッダー (:headers、認証情報、:content_type などのオプション) です。
本文 送信されたリクエスト本文です (POST リクエストの場合)。

デバッガーに表示されるリクエストヘッダー

リクエストタブには、Connected Contentタグのヘッダーが一覧表示されます。これには、カスタムの:headers、保存された認証情報、および:content_typeや:basic_authなどのタグオプションで設定されたヘッダーが含まれます。Brazeは、エンドポイントへの送信リクエストに標準ヘッダー (User-AgentやHostなど) も追加します。これらのBrazeが追加するヘッダーは、:headersで設定した場合にデバッガーに表示されます。

Brazeは、送信されるConnected Contentリクエストに以下のヘッダーを追加します。ほとんどのヘッダーは、タグ内でまだ指定されていない場合にのみ設定されます。:headers、認証情報、またはタグオプションで指定したヘッダーは、指定した通りに送信されます。

ヘッダー Brazeが設定するタイミング
User-Agent まだ設定されていない場合、BrazeはBraze Sender <version>を送信します。バージョン文字列は変更される場合があります。User-Agentでトラフィックをフィルタリングする場合は、Braze Senderで始まるすべての値を許可してください。一貫した値を送信するには、:headersでUser-Agentを設定してください。
X-Braze-Sender-Version 常にConnected Contentの送信元バージョンに設定されます。
Accept-Encoding まだ設定されていない場合、Brazeはgzipを送信します。
Authorization URLにユーザー名とパスワード（user:pass@host）が含まれている場合、Brazeはその認証情報から導出されたBasic Authorizationヘッダーを追加します。明示的なAuthorizationヘッダーはこれを上書きします。URLに認証情報を含めるのではなく、:basic_authまたは:headersの使用をお勧めします。
Host Hostヘッダーを設定しない限り、リクエストURLのホスト名です（例：https://www.example.com/abc/123の場合はwww.example.com）。
Content-Length ボディが存在する場合のリクエストボディのバイト単位のサイズです。
BrazeToBraze Braze RESTエンドポイントへのリクエストに対してのみtrueに設定されます。その他の送信先では省略されます。

認証情報の秘匿化

Connected Contentタグで :basic_auth、一般的なシークレットヘッダー、キー、またはその他の認証情報オプションを使用している場合、デバッガーは リクエストタブでそれらの値を秘匿化し、一連のアスタリスク (*) に置き換えます。これにより、プレビューとテストで値を公開することなく、認証情報がリクエストに含まれていることを確認できます。

認証情報が秘匿化されていても、認証の失敗は引き続き確認できます。エンドポイントが 401 または 403 を返した場合、そのステータスコードは レスポンスタブに通常どおり表示されます。そのため、認証情報自体は非表示のままでも、リクエストが認証によって拒否されたことを判断できます。

レスポンスコードのトラブルシューティング

エンドポイントのエラーと Braze による制限の違い

レスポンスタブに表示される 2XX 以外のステータスコードが、すべてエンドポイントから返されたものとは限りません。Braze は Connected Content の呼び出しに独自の制限を設けており、その制限によってエンドポイントのエラーと似たレスポンスが返されることがあります。

408、429、502、503、504、599 などのレスポンスコードが表示される場合、問題は通常、呼び出しの Braze 側にあり、ホストの状態、タイムアウト、またはペイロードサイズに関連しています。エンドポイントが常に大きなレスポンスを返す場合は、メッセージに必要なフィールドだけを含むようにレスポンスペイロードを絞り込むことを検討してください。

エンドポイントが予期しないステータスコードを返した

リクエストタブを使用して、URL、タグに指定したヘッダー、ボディを確認します。予期しない 4XX レスポンスのよくある原因は、URL、ヘッダー、またはボディ内の Liquidタグが想定どおりに解決されていないことです。{{ }} による参照が、プレビューに使用しているユーザーまたはコンテキストに存在するフィールドを指しているかを確認してください。

レスポンスが古いように見える

レスポンスタブのキャッシュから提供を確認します。はい と表示されている場合、デバッガーは新しい呼び出しではなく、以前にキャッシュされたレスポンスを表示しています。現在のエンドポイントの動作を確認するには、一時的にタグに :no_cache を追加するか、(:cache_max_age に従って) キャッシュの有効期限が切れるまで待ってください。

Brazeカスタマーエンゲージメントプラットフォームのドキュメント。

リソース
法的情報
会社情報
© 2026 Braze, Inc. All rights reserved.
Braze ステータスの確認
New Stuff!