커스텀 로그 (Custom Log Key)

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

비디오 게이트웨이 요청 형식

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

https://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 (UTF-8 기준 영문 10자, 한글 3자)
인코딩	한글, 특수문자, 공백 포함 시 UTF-8 URL 인코딩 필수

기술 지원

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