コネクテッドコンテンツのリトライロジックを使用する

このページでは、コネクテッドコンテンツの呼び出しにリトライを追加する方法について説明します。

リトライの仕組み

コネクテッドコンテンツは API からのデータ受信に依存しているため、Braze が呼び出しを行う際に API が一時的に利用できない場合があります。このような場合、Braze はエクスポネンシャルバックオフを使用してリクエストを再試行するリトライロジックをサポートしています。

リトライロジックの使用

リトライロジックを使用するには、以下のコードスニペットに示すように、コネクテッドコンテンツの呼び出しに :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 %}

コネクテッドコンテンツの呼び出しに :retry タグが含まれている場合、Braze は最大5回まで呼び出しのリトライを試みます。

リトライの結果

リトライが成功した場合

リトライが成功した場合、メッセージが送信され、そのメッセージに対するそれ以上のリトライは行われません。

API 呼び出しが失敗し、リトライが有効な場合

API 呼び出しが失敗し、リトライが有効な場合、Braze は再送信ごとに設定したレート制限を遵守しながら呼び出しをリトライします。Braze は失敗したメッセージをキューの末尾に移動し、必要に応じてメッセージの送信にかかる合計時間に追加の分数を加えます。

コネクテッドコンテンツの呼び出しが5回を超えてエラーになった場合、メッセージ中止タグがトリガーされた場合と同様に、メッセージは中止されます。

コネクテッドコンテンツの呼び出しにおける中止とリトライのロジック

コネクテッドコンテンツの呼び出しで、リトライロジックと同じ条件に対して中止ロジックを使用している場合、中止ロジックが優先されます。これにより、リトライが試行されなくなります。リトライロジックは、ステータスコードが失敗の場合、中止する前にすでに呼び出しを再送信しています。どちらも同じステータスコードの動作をターゲットにしているため、中止ロジックを削除しても、すべてのリトライが失敗した場合には呼び出しは中止されます。