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、バナー、およびチャネル固有でない作成画面（コンテンツブロックやキャンバスのユーザー更新ステップなど）にはまだ対応していません。デバッガーが表示されない場合は、その機能ではConnected Contentのデバッグがまだサポートされていない可能性があります。
デバッガーの使用
プレビューを実行するたびに、BrazeはConnected Contentの呼び出し結果をプレビュータブに自動的にレンダリングします。デバッガーを使用するには：
{% connected_content %}タグを使用してメッセージを設定します。- プレビューとテストセクションに移動します。メッセージにConnected Contentタグが含まれている場合、Connected Contentの呼び出し数と成功およびエラーのステータスを含むサマリービューを確認できます。
- 詳細を表示を選択して、プレビューの横にデバッガーを開きます。ドロワーには、各Connected Content呼び出しのURLと結果のテーブルが表示されます。
- 各URLと結果の横にある表示を選択すると、リクエストヘッダーとレスポンスヘッダー、ペイロード、メソッド、所要時間、キャッシュ情報を確認できます。
- 結果を確認し、必要に応じてタグ、ヘッダー、またはエンドポイントを調整します。その後、新しいプレビューを生成して修正を確認します。
テンプレートに複数の{% connected_content %}タグが含まれている場合、デバッガーは行われたすべての呼び出しを一覧表示します。1つのテンプレートから複数のメッセージ本文をレンダリングするチャネル（例えば、HTML、プレーンテキスト、AMP本文を個別にレンダリングするメールや、デバイス固有の本文を個別にレンダリングするクイックプッシュ）では、デバッガーは現在プレビュー中の本文だけでなく、すべての本文にわたって行われたすべてのConnected Content呼び出しを表示します。
デバッグ出力を理解する
各Connected Contentの呼び出しには、それぞれ固有のResponseタブとRequestタブが表示されます。呼び出しが成功したかどうかを確認する最初の指標となるため、デフォルトではResponseタブが表示されます。
URLの詳細
| フィールド | 説明 |
|---|---|
| URL | BrazeがLiquidタグをすべて解決した状態で呼び出した、完全にレンダリングされたURL。 |
| 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が課す制限
Responseタブに表示される非2XXステータスコードのすべてがエンドポイントから返されるわけではありません。BrazeはConnected Contentの呼び出しに対して独自の制限を適用しており、これらはエンドポイントエラーと似たレスポンスを生成することがあります。
408、429、502、503、504、599などのレスポンスコードが表示される場合、問題は通常Braze側の呼び出しに関連しており、ホストの状態、タイムアウト、またはペイロードサイズが原因です。エンドポイントが一貫して大きなレスポンスを返す場合は、メッセージに必要なフィールドのみにレスポンスペイロードをトリミングすることを検討してください。
エンドポイントが予期しないステータスコードを返した
Requestタブを使用して、URL、タグからのヘッダー、およびボディを確認してください。予期しない4XXレスポンスの一般的な原因は、URL、ヘッダー、またはボディ内のLiquidタグが期待どおりに解決されなかったことです。{{ }}の参照が、プレビューに使用しているユーザーまたはコンテキストに存在するフィールドを指していることを確認してください。
レスポンスが古く見える
ResponseタブのServed from cacheを確認してください。Yesと表示されている場合、デバッガーは新しい呼び出しではなく、以前にキャッシュされたレスポンスを表示しています。現在のエンドポイントの動作を確認するには、一時的にタグに:no_cacheを追加するか、キャッシュが期限切れになるのを待ってください（:cache_max_ageに従います）。