커스텀 로그 추가 (Custom Log Key)

Kollus VOD는 시청자의 재생 환경 정보를 기록하는 표준 접근 로그 외에, 고객사가 정의한 부가 정보(Custom Log Key)를 로그 데이터에 병합하여 기록할 수 있는 기능을 제공합니다. 이 데이터는 외부 로그 수집 시스템과의 연동이나 특정 시청자 그룹 분석을 위한 핵심 식별자로 활용됩니다.

---

VideoGateway 요청 형식

콘텐츠 재생을 위한 VideoGateway 호출 시, 파라미터에 Custom Log Key를 추가합니다. 전송된 값은 해당 재생 세션의 로그 필드에 바인딩되어 기록됩니다.

http://v.kr.kollus.com/{MEDIA_CONTENT_KEY}?custom_log_key0=...&custom_log_key9=...

---

Custom Log Key 사용 규칙

정확한 데이터 수집과 로그 정합성을 위해 아래의 규격을 반드시 준수해야 합니다.

항목	명세
필드 수	최대 10개 사용 가능(custom_log_key0~custom_log_key9)
데이터 길이	필드당 최대 10 bytes
인코딩	한글, 특수문자, 공백 포함 시 URL 인코딩 필수

ℹ️참고

비즈니스 요구 사항에 따라 10 bytes 이상의 대용량 데이터를 기록해야 하는 경우, 기술 지원팀(PE, tech_support@catenoid.net)으로 문의해 주세요.