Connected Contentデバッガー
Connected Contentデバッガーを使用すると、各Connected Content呼び出しのライブリクエストとレスポンスを確認できるため、CampaignやCanvasを開始する前にエンドポイント、ヘッダー、Liquidタグを検証できます。
Connected Content Debuggerは現在早期アクセス中です。早期アクセスへの参加にご興味がある場合は、Braze account managerまでお問い合わせください。
デバッガーについて
Connected Contentを使用すると、レンダリング時に外部APIへHTTPコールを行い、そのレスポンスをLiquidでメッセージに挿入することで、リアルタイムデータでメッセージを充実させることができます。このコールはBrazeの外部で行われるため、CampaignやCanvasが公開される前に、Brazeがどのようなリクエストを送信したか、エンドポイントが何を返したか、またはコールが失敗した理由を正確に確認することが難しい場合があります。
Connected Contentデバッガーは、配信前にこれらの問題をトラブルシューティングするのに役立ちます。プレビューとテストセクションで、メッセージ内のすべてのConnected Contentコールのライブリクエストとレスポンスを表示します。これにより、エンドポイント、ヘッダー、Liquidタグが正しく設定されていることを、Brazeダッシュボード内ですべて確認できます。
サポートされているチャネル
Connected Contentデバッガーは、以下のチャネルで利用できます。
- Content Cards
- メール
- テンプレートを含む
- フッターと購読ページは除く
- アプリ内メッセージ
- プッシュ通知
- SMS/MMS/RCS
- Webhook
- テンプレートを含む
早期アクセス期間中、デバッガーはほとんどのチャネルで利用できますが、KakaoTalk、LINE、バナー、またはチャネル固有でないコンポジションサーフェス（Content Blocks、Canvasのユーザー更新ステップ、コンテキストステップなど）ではまだ利用できません。デバッガーが表示されない場合、その機能では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が呼び出した完全にレンダリングされた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 | :headersで設定されたものを含む、Brazeが送信したリクエストヘッダーです。 |
| Body | 送信されたリクエストボディ（POSTリクエストの場合）。 |
認証情報のリダクション
Connected Contentタグで:basic_auth、一般的なシークレットヘッダー、キー、またはその他の認証情報オプションを使用している場合、デバッガーはリクエストタブでそれらの値をリダクションし、一連のアスタリスク（*）に置き換えます。これにより、プレビュー＆テストで値を公開することなく、認証情報がリクエストに含まれていたことを確認できます。
認証情報がリダクションされている場合でも、認証の失敗は引き続き表示されます。エンドポイントが401または403を返した場合、そのステータスコードはレスポンスタブに通常どおり表示されるため、認証情報自体は非表示であっても、認証の問題によりリクエストが拒否されたことを判断できます。
レスポンスコードのトラブルシューティング
エンドポイントエラーとBrazeが課す制限
レスポンスタブに表示されるすべての非2XXステータスコードがエンドポイントから返されたものとは限りません。BrazeはConnected Contentの呼び出しに独自の制限を課しており、これらがエンドポイントエラーに似たレスポンスを生成することがあります。
408、429、502、503、504、599などのレスポンスコードが表示される場合、問題は通常Braze側の呼び出しに関連しており、ホストの状態、タイムアウト、またはペイロードサイズに起因します。エンドポイントが常に大きなレスポンスを返す場合は、メッセージに必要なフィールドのみにレスポンスペイロードを絞り込むことを検討してください。
エンドポイントが予期しないステータスコードを返した場合
リクエストタブを使用して、Brazeが送信した正確なURL、ヘッダー、本文を確認してください。予期しない4XXレスポンスの一般的な原因は、URL、ヘッダー、または本文内のLiquidタグが期待どおりに解決されなかったことです。{{ }}の参照が、プレビューに使用しているユーザーまたはコンテキストに存在するフィールドを指しているか確認してください。
レスポンスが古い場合
レスポンスタブのキャッシュから提供を確認してください。Yesと表示されている場合、デバッガーは新しい呼び出しではなく、以前にキャッシュされたレスポンスを表示しています。現在のエンドポイントの動作を確認するには、タグに一時的に:no_cacheを追加するか、キャッシュの有効期限（:cache_max_ageに基づく）が切れるのを待ってください。