연결된 콘텐츠에 재시도 로직 사용하기
이 페이지에서는 연결된 콘텐츠 호출에 재시도를 추가하는 방법을 다룹니다.
재시도 작동 방식
연결된 콘텐츠는 API에서 데이터를 수신하는 데 의존하기 때문에, Braze가 호출을 수행하는 동안 API가 간헐적으로 사용 불가능할 수 있습니다. 이 경우 Braze는 지수 백오프를 사용하여 요청을 다시 시도하는 재시도 로직을 지원합니다.
연결된 콘텐츠 :retry는 In-App Messages에서는 사용할 수 없습니다.
캔버스 단계에서의 재시도 동작
Canvas의 연결된 콘텐츠 호출은 해당 호출에 :retry가 포함된 경우에만 재시도됩니다. 동작은 단계 유형에 따라 다릅니다.
- 메시지 단계:
:retry가 포함된 연결된 콘텐츠는 여전히 메시징 파이프라인을 사용합니다. Braze가 최대 5회까지 호출을 재시도하는 동안 수신자는 전송 대기줄에서 대기합니다. 모든 재시도가 실패하면 메시지가 중단되고 사용자는 다음 단계로 진행합니다. 자세한 내용은 API 호출이 실패하고 재시도가 활성화된 경우를 참조하세요. - Context 및 User Update 단계: Braze는 단계 수준에서 연결된 콘텐츠 호출을 재시도합니다(최대 5회). 모든 재시도가 실패하면 사용자는 Canvas에서 나갑니다.
Context 및 User Update 단계의 경우, 프로모 코드 가져오기 실패 또는 예기치 않은 단계 오류와 같은 특정 재시도 가능한 단계 오류가 발생하면, Braze가 사용자를 Canvas에서 내보내기 전에 지수 백오프를 사용한 추가 단계 수준 재시도(약 13회)가 트리거될 수 있습니다.
자세한 내용은 재시도 동작을 참조하세요.
재시도 로직 사용하기
재시도 로직을 사용하려면 다음 코드 스니펫에서와 같이 연결된 콘텐츠 호출에 :retry 태그를 추가합니다:
{% 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회까지 호출을 재시도합니다.
미리보기 동작
재시도 로직은 실시간 발송(테스트 발송 포함)에만 적용되며 미리보기에는 적용되지 않습니다. :retry가 포함된 연결된 콘텐츠 호출이 미리보기 중 실패하면, 콘텐츠를 렌더링하는 대신 “재시도 기능이 트리거되어 이 메시지가 표시되지 않았을 것입니다”라는 메시지가 미리보기에 표시될 수 있습니다. 이는 예상된 동작이며 Braze 내 문제를 나타내는 것이 아닙니다.
재시도 성과
재시도가 성공하는 경우
재시도가 성공하면 메시지가 발송되며, 해당 메시지에 대해 더 이상 재시도가 시도되지 않습니다.
API 호출이 실패하고 재시도가 활성화된 경우
API 호출이 실패하고 재시도가 활성화된 경우, Braze는 각 재발송에 대해 설정한 사용량 제한을 준수하면서 호출을 재시도합니다. Braze는 실패한 메시지를 대기줄 맨 뒤로 이동시키며, 필요한 경우 메시지 발송에 소요되는 전체 시간에 추가 시간(분)을 더합니다.
연결된 콘텐츠 호출이 5회 이상 오류가 발생하면, 메시지 중단 태그가 트리거되는 것과 유사하게 메시지가 중단됩니다.
중단 및 재시도 로직이 포함된 연결된 콘텐츠 호출
연결된 콘텐츠 호출에서 재시도 로직과 동일한 조건에 대해 중단 로직을 사용하는 경우, 중단 로직이 우선 적용됩니다. 이로 인해 재시도가 시도되지 않습니다. 재시도 로직은 상태 코드가 실패일 때 호출을 중단하기 전에 이미 호출을 다시 전송합니다. 두 로직 모두 동일한 상태 코드 동작을 대상으로 하므로, 중단 로직을 제거해도 모든 재시도가 실패하면 호출은 여전히 중단됩니다.