コネクテッドコンテンツのリトライロジックを使用する
このページでは、コネクテッドコンテンツの呼び出しにリトライを追加する方法について説明します。
リトライの仕組み
Connected Contentは API からのデータ受信に依存しているため、Brazeが呼び出しを行う際に API が一時的に利用できなくなる場合があります。この場合、Brazeは指数バックオフを使用してリクエストを再試行するリトライロジックをサポートしています。
Connected Contentの:retryはアプリ内メッセージでは利用できません。
リトライロジックの使用
リトライロジックを使用するには、以下のコードスニペットに示すように、Connected Content呼び出しに:retryタグを追加します。
1
2
{% 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回を超えてエラーになった場合、メッセージ中止タグがトリガーされた場合と同様に、メッセージは中止されます。
コネクテッドコンテンツの呼び出しにおける中止とリトライのロジック
コネクテッドコンテンツの呼び出しで、リトライロジックと同じ条件に対して中止ロジックを使用している場合、中止ロジックが優先されます。これにより、リトライが試行されなくなります。リトライロジックは、ステータスコードが失敗の場合、中止する前にすでに呼び出しを再送信しています。どちらも同じステータスコードの動作をターゲットにしているため、中止ロジックを削除しても、すべてのリトライが失敗した場合には呼び出しは中止されます。