Connected Contentデバッガー
Connected Contentデバッガーを使用すると、各Connected Content呼び出しのライブリクエストとレスポンスを確認できるため、キャンペーンやキャンバスを開始する前にエンドポイント、ヘッダー、Liquidタグを検証できます。
デバッガーについて
Connected Contentは、レンダリング時に外部APIへHTTPコールを実行し、そのレスポンスをLiquidを使ってメッセージに挿入することで、リアルタイムデータでメッセージを強化する機能です。このコールはBrazeの外部で発生するため、Brazeがどのようなリクエストを送信したか、エンドポイントが何を返したか、またはコールが失敗した理由を、キャンペーンやキャンバスが本番稼働する前に正確に確認することは難しい場合があります。
Connected Contentデバッガーは、ローンチ前にこれらの問題をトラブルシューティングするのに役立ちます。メッセージ内のすべてのConnected Contentコールについて、ライブのリクエストとレスポンスをプレビューとテストセクションに表示します。これにより、エンドポイント、ヘッダー、Liquidタグが正しく設定されているかどうかを、Brazeダッシュボード内ですべて確認できます。
サポート対象エリア
Connected Contentデバッガーは、以下のエリアで使用できます。
- バナー
- キャンバスのコンテキストステップ
- Content Cards
- メール
- テンプレートを含む
- フッターと購読ページは除外
- アプリ内メッセージ
- プッシュ通知
- SMS/MMS/RCS
- Webhook
- テンプレートを含む
デバッガーはほとんどのチャネルで利用可能ですが、KakaoTalk、LINE、またはチャネル固有ではない作成画面（Content Blocksやキャンバスのユーザー更新ステップなど）にはまだ対応していません。デバッガーが表示されない場合、その機能ではConnected Contentのデバッグがまだサポートされていない可能性があります。
デバッガーの使用
プレビューを実行するたびに、Brazeは自動的にConnected Contentの呼び出し結果をプレビュータブにレンダリングします。デバッガーを使用するには：
{% connected_content %}タグを使ってメッセージを設定します。- プレビューとテストセクションに移動します。メッセージにConnected Contentタグが含まれている場合、Connected Contentの呼び出し回数と、成功およびエラーのステータスを含むサマリービューを確認できます。
- 詳細を表示を選択すると、プレビューの横にデバッガーが開きます。ドロワーには、各Connected Content呼び出しのURLと結果がテーブルで表示されます。
- 各URLと結果の横にある表示を選択すると、リクエストおよびレスポンスのヘッダー、ペイロード、メソッド、所要時間、キャッシュ情報を確認できます。
- 結果を確認し、必要に応じてタグ、ヘッダー、またはエンドポイントを調整します。その後、新しいプレビューを生成して修正を確認します。
テンプレートに複数の{% connected_content %}タグが含まれている場合、デバッガーは実行されたすべての呼び出しをリストします。1つのテンプレートから複数のメッセージ本文やプラットフォームバリアントをレンダリングするチャネルの場合、デバッガーはプレビュー中の本文だけでなく、すべてのレンダリングにわたるConnected Content呼び出しをリストします。メールではHTMLとプレーンテキストのレンダリングパスが別々に生成される場合があり（送信時にはAccelerated Mobile Pages（AMP）も含む）、同じURLが複数回表示されることがあります。クイックプッシュでは最大4つのプラットフォーム（iOS、Android、Web、Kindle）でレンダリングされるため、同じConnected Contentの参照が最大4回表示されることがあります。
これらの繰り返しは、Brazeがメッセージをレンダリングして送信する方法と一致しており、デバッガーはそれらを集約しません。呼び出し回数が送信数を超える理由について詳しくは、Connected Contentの呼び出し回数についてを参照してください。
デバッグ出力を理解する
各Connected Contentコールには、それぞれResponseタブとRequestタブがあります。Responseタブはデフォルトで表示され、コールが成功したかどうかを確認する最初の指標となります。
URLの詳細
| フィールド | 説明 |
|---|---|
| URL | BrazeがコールしたフルレンダリングURL。Liquidタグはすべて解決済みです。 |
| Method | 使用されたHTTPメソッド（GETまたはPOST）。 |
| Status code | エンドポイントが返したHTTPステータスコード（例：200、404、500）。Braze固有のコードについては、レスポンスコードのトラブルシューティングを参照してください。 |
Responseタブ
| フィールド | 説明 |
|---|---|
| Duration | リクエストの完了にかかった時間（秒単位）。Durationはライブ（キャッシュされていない）コールの場合のみ表示されます。 |
| Served from cache | このレスポンスがエンドポイントへのライブコールではなく、BrazeのConnected Contentキャッシュから提供されたかどうかを示します（YesまたはNo）。キャッシュされた結果は以前のレスポンスを反映しており、エンドポイントの現在の状態とは異なる場合があります。 |
| Response body | エンドポイントが返したレスポンスボディ。 |
Requestタブ
| フィールド | 説明 |
|---|---|
| Headers | Connected Contentタグからのヘッダー（:headers、認証情報、:content_typeなどのオプション）。 |
| Body | 送信されたリクエストボディ（POSTリクエストの場合）。 |
デバッガーに表示されるリクエストヘッダー
Request タブには、Connected Contentタグからのヘッダーが一覧表示されます。カスタム :headers、保存された認証情報、:content_type や :basic_auth などのタグオプションで設定されたヘッダーが含まれます。Brazeは、エンドポイントへの送信リクエストに標準ヘッダー（例: User-Agent や Host）も追加します。これらのBrazeが追加するヘッダーは、:headers で設定した場合にデバッガーに表示されます。
一貫した User-Agent を送信するには、:headers で設定してください。Brazeはその値を使用し、デバッガーにそのヘッダーが表示されます。
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、一般的なシークレットヘッダー、キー、またはその他の認証情報オプションを使用している場合、デバッガーはRequestタブでそれらの値をリダクション（非表示に）し、一連のアスタリスク（*）に置き換えます。これにより、値をプレビュー＆テストで公開することなく、リクエストに認証情報が含まれていたことを確認できます。
認証情報がリダクションされている場合でも、認証の失敗は表示されます。エンドポイントが401または403を返した場合、そのステータスコードはResponseタブに通常どおり表示されるため、認証情報自体は非表示であっても、認証の問題によりリクエストが拒否されたことを判断できます。
レスポンスコードのトラブルシューティング
エンドポイントエラーとBrazeの制限
レスポンスタブに表示されるすべての非2XXステータスコードがエンドポイントから返されたものとは限りません。BrazeはConnected Contentの呼び出しに独自の制限を適用しており、これらがエンドポイントエラーに似たレスポンスを生成することがあります。
408、429、502、503、504、599などのレスポンスコードが表示される場合、問題は通常Braze側の呼び出しに関連しており、ホストの健全性、タイムアウト、またはペイロードサイズに起因しています。エンドポイントが一貫して大きなレスポンスを返す場合は、メッセージに必要なフィールドのみにレスポンスペイロードを絞り込むことを検討してください。
エンドポイントが予期しないステータスコードを返した場合
リクエストタブを使用して、URL、タグからのヘッダー、およびボディを確認してください。予期しない4XXレスポンスの一般的な原因は、URL、ヘッダー、またはボディ内のLiquidタグが想定どおりに解決されなかったことです。{{ }}の参照が、プレビューに使用しているユーザーまたはコンテキストに存在するフィールドを指しているか確認してください。
レスポンスが古い場合
レスポンスタブのキャッシュから配信を確認してください。Yesと表示されている場合、デバッガーは新しい呼び出しではなく、以前にキャッシュされたレスポンスを表示しています。現在のエンドポイントの動作を確認するには、タグに一時的に:no_cacheを追加するか、キャッシュの有効期限（:cache_max_ageで設定）が切れるまで待ってください。