コネクテッドコンテンツのレスポンスをキャッシュする

コネクテッドコンテンツのレスポンシブは、異なるキャンペーンやメッセージ（同じワークスペース内）でキャッシュして、送信速度を最適化できる。

Brazeはコネクテッドコンテンツのレスポンスを永久にログに記録したり保存したりしない。コネクテッドコンテンツのコールレスポンスを明示的にLiquid変数として保存することを選択した場合、BrazeはLiquid変数をレンダリングし、メッセージを送信するために、インメモリ、つまり短期間で削除される一時的なストレージにのみ保存する。

キャッシュを防ぐために、:no_cache を指定することができる。この場合、ネットワーク・トラフィックが増加する可能性がある。トラブルシューティングやシステムの健全性を監視するために、Brazeは、失敗したコネクテッドコンテンツコール（404 や429 など）を記録することもある。これらのログは最大30日間保存される。

デフォルトのキャッシュ設定

キャッシュエージは最大5分（300秒）である。コネクテッドコンテンツの呼び出しに:cache_max_age パラメータを追加することで更新できる。例は次のとおりです。

1
{{ {% connected_content [https://example.com/webservice.json] :cache_max_age 900 %}}}

GETリクエストはキャッシュされる。コネクテッド・コンテンツの呼び出しに:no_cacheパラメータを追加することで、これを設定することができる。

POSTリクエストはキャッシュされない。これは、コネクテッド・コンテンツの呼び出しに :cache_max_age パラメータを追加することで強制できる。最小キャッシュ時間は5分、最大キャッシュ時間は4時間である。

キャッシュサイズの制限

コネクテッド・コンテンツのレスポンス・ボディは最大1MBまで。レスポンス・ボディが1MBを超える場合は、キャッシュされない。

キャッシュ時間

コネクテッド・コンテンツは、GETエンドポイントから返す値を最低5分間キャッシュする。キャッシュ時間が指定されていない場合、デフォルトのキャッシュ時間は5分である。

コネクテッド・コンテンツのキャッシュ時間は、以下の例のように、:cache_max_ageでより長く設定することができる。最小キャッシュ時間は5分、最大キャッシュ時間は4時間である。コネクテッドコンテンツデータは、Memcachedなどの揮発性キャッシュシステムを使用してインメモリでキャッシュされます。

その結果、指定されたキャッシュ時間に関係なく、コネクテッドコンテンツのデータが指定よりも早くBrazeのメモリ内キャッシュから削除されることがある。これは、キャッシュ期間が提案であり、実際にBrazeによってデータがキャッシュされる期間を保証するものではないことを意味します。また、指定されたキャッシュ期間で予想されるよりも多くのコネクテッドコンテンツリクエストが発生する可能性があります。

指定秒間のキャッシュ

この例は900秒（または15分）キャッシュされます。

1
{% connected_content https://example.com/webservice.json :cache_max_age 900 %}

キャッシュバスティング

コネクテッドコンテンツによる、GET リクエストからの戻り値のキャッシュを防ぐには、:no_cache 構成を使用します。ただし、Braze 内部のホストからの応答は引き続きキャッシュされます。

1
{% connected_content https://example.com/webservice.json :no_cache %}

BrazeはPOSTリクエストの結果をキャッシュしないので、POSTではバストをキャッシュする必要はない。

知っておくべきこと

• キャッシュは、コネクテッド・コンテンツの重複コールを減らすのに役立つ。しかし、ユーザーごとにコネクテッド・コンテンツの呼び出しが1回になるとは限らない。
• コネクテッド・コンテンツのキャッシュは、URLとワークスペースに基づいて行われる。コネクテッドコンテンツの呼び出し先が同一のURLであれば、キャンペーンやキャンバス間でキャッシュすることができる。
• キャッシュはユーザーIDやキャンペーンではなく、ユニークなURLに基づいている。つまり、URLが同じであれば、キャッシュされたバージョンのコネクテッドコンテンツの呼び出しが、ワークスペース内の複数のユーザーやキャンペーンで使用される可能性がある。