연결된 콘텐츠 디버거
연결된 콘텐츠 디버거를 사용하면 각 연결된 콘텐츠 호출에 대한 실시간 요청 및 응답을 확인할 수 있으므로, Campaign 또는 Canvas를 시작하기 전에 엔드포인트, 헤더, Liquid 태그를 검증할 수 있습니다.
Connected Content Debugger은(는) 현재 조기 액세스 단계입니다. 조기 액세스 참여에 관심이 있으시면 Braze account manager에게 문의하세요.
디버거 소개
연결된 콘텐츠를 사용하면 렌더링 시점에 외부 API로 HTTP 호출을 수행하여 실시간 데이터로 메시지를 강화한 다음, Liquid를 사용해 응답을 메시지에 삽입할 수 있습니다. 이 호출은 Braze 외부에서 이루어지기 때문에, Campaign이나 Canvas가 실시간으로 전환되기 전에 Braze가 어떤 요청을 보냈는지, 엔드포인트가 무엇을 반환했는지, 또는 호출이 왜 실패했는지 정확히 확인하기 어려울 수 있습니다.
연결된 콘텐츠 디버거는 출시 전에 이러한 문제를 해결하는 데 도움을 줍니다. 미리보기 및 테스트 섹션에서 메시지 내 모든 연결된 콘텐츠 호출에 대한 실시간 요청과 응답을 보여줍니다. 이를 통해 Braze 대시보드 내에서 엔드포인트, 헤더, Liquid 태그가 올바르게 구성되어 있는지 확인할 수 있습니다.
지원되는 채널
연결된 콘텐츠 디버거는 다음 채널에서 사용할 수 있습니다.
- Content Cards
- 이메일
- 템플릿 포함
- 푸터 및 구독 페이지 제외
- In-App Messages
- 푸시 알림
- SMS/MMS/RCS
- 웹훅
- 템플릿 포함
얼리 액세스 기간 동안 디버거는 대부분의 채널에서 사용할 수 있지만, KakaoTalk, LINE, 배너 또는 채널에 특화되지 않은 구성 화면(예: Content Blocks, Canvas 사용자 업데이트 단계, 컨텍스트 단계)에서는 아직 지원되지 않습니다. 디버거가 보이지 않는 경우, 해당 기능에 대해 연결된 콘텐츠 디버깅이 아직 지원되지 않을 수 있습니다.
디버거 사용하기
미리보기를 실행할 때마다 Braze는 미리보기 탭에 연결된 콘텐츠 호출 결과를 자동으로 렌더링합니다. 디버거를 사용하려면:
{% connected_content %}태그로 메시지를 구성합니다.- 미리보기 및 테스트 섹션으로 이동합니다. 메시지에 연결된 콘텐츠 태그가 포함되어 있으면 연결된 콘텐츠 호출 수와 성공 및 오류 상태를 요약한 보기를 확인할 수 있습니다.
- 세부 정보 보기를 선택하여 미리보기 옆에 디버거를 엽니다. 서랍에는 각 연결된 콘텐츠 호출의 URL과 성과가 표 형태로 표시됩니다.
- 각 URL과 성과 옆에 있는 보기를 선택하여 요청 및 응답 헤더, 페이로드, 메서드, 소요 시간, 캐싱 정보를 확인합니다.
- 결과를 검토하고 필요에 따라 태그, 헤더 또는 엔드포인트를 조정합니다. 그런 다음 새 미리보기를 생성하여 수정 사항을 확인합니다.
템플릿에 {% connected_content %} 태그가 두 개 이상 포함되어 있으면 디버거에 수행된 모든 호출이 나열됩니다. 하나의 템플릿에서 여러 메시지 본문을 렌더링하는 채널(예: HTML, 일반 텍스트, AMP 본문을 각각 렌더링하는 이메일 또는 기기별 본문을 각각 렌더링하는 Quick Push)의 경우, 디버거는 현재 미리보기 중인 본문뿐만 아니라 모든 본문에서 수행된 연결된 콘텐츠 호출을 모두 표시합니다.
디버그 출력 이해하기
각 연결된 콘텐츠 호출은 고유한 Response 탭과 Request 탭으로 표시됩니다. Response 탭은 호출 성공 여부를 확인하는 첫 번째 지표이므로 기본적으로 표시됩니다.
URL 세부 정보
| 필드 | 설명 |
|---|---|
| URL | Braze가 호출한 완전히 렌더링된 URL로, 모든 Liquid 태그가 해석된 상태입니다. |
| Method | 사용된 HTTP 메서드(GET 또는 POST)입니다. |
| Status code | 엔드포인트가 반환한 HTTP 상태 코드입니다(예: 200, 404, 500). Braze 전용 코드는 응답 코드 문제 해결을 참조하세요. |
Response 탭
| 필드 | 설명 |
|---|---|
| Duration | 요청이 완료되기까지 걸린 시간(초 단위)입니다. Duration은 실시간(캐시되지 않은) 호출에서만 표시됩니다. |
| Served from cache | 이 응답이 엔드포인트에 대한 실시간 호출이 아닌 Braze의 연결된 콘텐츠 캐시에서 제공되었는지 여부를 나타냅니다(Yes 또는 No). 캐시된 결과는 이전 응답을 반영하며, 반드시 엔드포인트의 현재 상태를 나타내지는 않습니다. |
| Response body | 엔드포인트가 반환한 본문입니다. |
Request 탭
| 필드 | 설명 |
|---|---|
| Headers | Braze가 전송한 요청 헤더로, :headers로 설정된 헤더를 포함합니다. |
| Body | 전송된 요청 본문입니다(POST 요청의 경우). |
자격 증명 수정
연결된 콘텐츠 태그에서 :basic_auth, 일반적인 시크릿 헤더, 키 또는 기타 인증 자격 증명 옵션을 사용하는 경우, 디버거는 Request 탭에서 해당 값을 수정하고 일련의 별표(*)로 대체합니다. 이를 통해 Preview & Test에서 값을 노출하지 않으면서도 요청에 자격 증명이 포함되었는지 확인할 수 있습니다.
자격 증명이 수정된 경우에도 인증 실패는 여전히 표시됩니다. 엔드포인트가 401 또는 403을 반환하면 해당 상태 코드가 Response 탭에 정상적으로 표시되므로, 자격 증명 자체는 숨겨져 있더라도 인증 문제로 인해 요청이 거부되었음을 확인할 수 있습니다.
응답 코드 문제 해결
엔드포인트 오류와 Braze 제한의 차이
Response 탭에 표시되는 2XX가 아닌 상태 코드가 모두 엔드포인트에서 발생하는 것은 아닙니다. Braze는 연결된 콘텐츠 호출에 자체 제한을 적용하며, 이로 인해 엔드포인트 오류와 유사하게 보이는 응답이 생성될 수 있습니다.
408, 429, 502, 503, 504, 599와 같은 응답 코드가 표시되는 경우, 일반적으로 호스트 상태, 타임아웃 또는 페이로드 크기와 관련된 Braze 측 문제입니다. 엔드포인트가 지속적으로 큰 응답을 반환하는 경우, 메시지에 필요한 필드만 포함하도록 응답 페이로드를 줄이는 것을 고려하세요.
엔드포인트가 예상치 못한 상태 코드를 반환한 경우
Request 탭을 사용하여 Braze가 전송한 정확한 URL, 헤더, 본문을 확인하세요. 예상치 못한 4XX 응답의 일반적인 원인은 URL, 헤더 또는 본문 내의 Liquid 태그가 예상대로 해석되지 않은 경우입니다. {{ }} 참조가 미리보기 중인 사용자 또는 컨텍스트에 존재하는 필드를 가리키고 있는지 확인하세요.
응답이 오래된 것처럼 보이는 경우
Response 탭에서 Served from cache를 확인하세요. Yes로 표시되면, 디버거가 새로운 호출이 아닌 이전에 캐시된 응답을 표시하고 있는 것입니다. 현재 엔드포인트 동작을 확인하려면 태그에 임시로 :no_cache를 추가하거나, 캐시가 만료될 때까지(:cache_max_age 기준) 기다리세요.