본문으로 건너뛰기

사용자 접근 로그 확장 (Custom Log Key)

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


VideoGateway 요청 형식

콘텐츠를 재생하기 위한 VideoGateway 호출 시, URL 파라미터에 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
10 bytes 이상의 데이터를 기록해야 하는 비즈니스 요구 사항이 있는 경우, Kollus 기술 지원팀(PE, tech_support@catenoid.net)으로 문의해 주세요.
인코딩한글, 특수문자, 공백 포함 시 URL 인코딩 필수