연결된 콘텐츠 응답 캐싱하기
연결된 콘텐츠 응답을 서로 다른 캠페인 또는 메시지(동일한 작업 공간에서)에 캐시하여 전송 속도를 최적화할 수 있습니다.
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로 인해 전송 대기 시간(지연이 증가하거나 요청과 응답 사이의 시간 간격이 길어질 수 있음)이 증가할 수 있습니다.
Braze는 POST 요청의 결과를 캐시하지 않으므로 POST를 사용하면 바스트를 캐시할 필요가 없습니다.
알아두어야 할 사항
- 캐싱은 연결된 콘텐츠 호출의 중복을 줄이는 데 도움이 될 수 있습니다. 그러나 사용자당 항상 하나의 연결된 콘텐츠 호출이 발생한다는 보장은 없습니다.
- 연결된 콘텐츠 캐싱은 URL과 워크스페이스를 기반으로 합니다. 연결된 콘텐츠 호출이 동일한 URL에 대한 호출인 경우 캠페인과 캔버스에서 캐시할 수 있습니다.
- 캐시는 사용자 ID나 캠페인이 아닌 고유 URL을 기반으로 합니다. 즉, 연결된 콘텐츠 호출의 캐시된 버전은 URL이 동일한 경우 워크스페이스의 여러 사용자 및 캠페인에서 사용될 수 있습니다.
GitHub 에서 이 페이지를 편집합니다.