Add Custom Log (Custom Log Key)
This document is a machine-translated draft and is currently undergoing review. Some content may be inaccurate or differ from the original Korean version. For the most precise information, refer to the Korean documentation.
In addition to standard access logs that record viewer playback environment information, Kollus VOD provides a feature that merges customer-defined supplementary data (Custom Log Key) into log data for recording. This data is used as a key identifier for integration with external log collection systems or for analyzing specific viewer groups.
Video Gateway request format
When calling the Video Gateway for content playback, add the Custom Log Key to the parameters. The transmitted value is bound to the log field of the corresponding playback session and recorded.
https://v.kr.kollus.com/{MEDIA_CONTENT_KEY}?custom_log_key0=...&custom_log_key9=...
Custom log key usage rules
To ensure accurate data collection and log consistency, the following specifications must be strictly followed.
| Item | Specification |
|---|---|
| Number of fields | Up to 10 fields available (custom_log_key0~custom_log_key9) |
| Data length | Maximum 10 bytes per field (10 ASCII characters or 3 Korean characters in UTF-8) |
| Encoding | UTF-8 URL encoding required when including Korean characters, special characters, or spaces |
If you need to record large data exceeding 10 bytes based on your business requirements, please contact Technical Support(tech_support@catenoid.net).