커스텀 로그 추가 (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 이상의 대용량 데이터를 기록해야 하는 경우, 기술 지원팀(PE, tech_support@catenoid.net)으로 문의해 주세요.