コネクテッドコンテンツのリトライロジックを使用する
このページでは、コネクテッドコンテンツの呼び出しにリトライを追加する方法について説明します。
リトライの仕組み
Connected Contentは API からデータを受信することに依存しているため、Braze が呼び出しを行う際に API が一時的に利用できなくなることがあります。この場合、Braze は指数バックオフを使用してリクエストを再試行するリトライロジックをサポートしています。
Connected Contentの:retryは、アプリ内メッセージやバナーでは使用できません。
キャンバスステップでのリトライ動作
キャンバスでのConnected Content呼び出しは、呼び出しに:retryが含まれている場合にのみリトライされます。動作はステップタイプによって異なります。
- メッセージステップ:
:retryを含むConnected Contentは引き続きメッセージングパイプラインを使用します。Braze が最大5回まで呼び出しをリトライする間、受信者は送信キューで待機します。すべてのリトライが失敗した場合、メッセージは中止され、ユーザーは次のステップに進みます。詳細については、API 呼び出しが失敗しリトライが有効な場合を参照してください。 - コンテキストステップおよびユーザー更新ステップ: Braze はステップレベルでConnected Content呼び出しをリトライします（最大5回）。すべてのリトライが失敗した場合、ユーザーはキャンバスから退出します。
コンテキストステップおよびユーザー更新ステップでは、プロモコードの取得失敗や予期しないステップエラーなど、特定のリトライ可能なステップエラーにより、Braze がユーザーをキャンバスから退出させる前に、指数バックオフによる追加のステップレベルリトライ（約13回）がトリガーされることがあります。
詳細については、リトライ動作を参照してください。
リトライロジックの使用
リトライロジックを使用するには、以下のコードスニペットに示すように、Connected Content呼び出しに :retry タグを追加します。
{% connected_content https://yourwebsite.com/api/endpoint :retry %}
{% connected_content https://www.braze.com :save my_content :basic_auth auth_name :retry %}
Connected Content呼び出しに :retry タグが含まれている場合、Brazeは最大5回まで呼び出しのリトライを試みます。
プレビューの動作
リトライロジックはライブ送信（テスト送信を含む）にのみ適用され、プレビューには適用されません。:retry を含むConnected Content呼び出しがプレビュー中に失敗した場合、コンテンツがレンダリングされる代わりに「This message would not have been shown because retry functionality was triggered」というメッセージが表示されることがあります。これは想定される動作であり、Braze内の問題を示すものではありません。
リトライの結果
リトライが成功した場合
リトライが成功すると、メッセージが送信され、そのメッセージに対してそれ以上のリトライは試みられません。
API呼び出しが失敗しリトライが有効な場合
API呼び出しが失敗しリトライが有効な場合、Brazeは再送信ごとに設定したレート制限を遵守しながら呼び出しをリトライします。Brazeは失敗したメッセージをキューの最後に移動し、必要に応じてメッセージ送信にかかる合計時間に追加の分数を加えます。
Connected Content呼び出しが5回以上エラーになった場合、メッセージ中止タグがトリガーされた場合と同様に、メッセージは中止されます。
コネクテッドコンテンツの呼び出しにおける中止とリトライのロジック
コネクテッドコンテンツの呼び出しで、リトライロジックと同じ条件に対して中止ロジックを使用している場合、中止ロジックが優先されます。これにより、リトライが試行されなくなります。リトライロジックは、ステータスコードが失敗の場合、中止する前にすでに呼び出しを再送信しています。どちらも同じステータスコードの動作をターゲットにしているため、中止ロジックを削除しても、すべてのリトライが失敗した場合には呼び出しは中止されます。