Content types
VOD
This is used for all Video on Demand sessions that are not replays of channel content.
Name | Value | Type | Description |
---|---|---|---|
type | Fixed value “VOD“ | String | Fixed value |
contentId (required) | String | ID of the content according to the content provider's catalogue. Used to query the metadata of the content (e.g. Gracenote ID, IMDB, etc). | |
contentName (optional) | Example: “A Star Is Born“ | String | Name of the VOC content in the primary language of the organisation |
TV channel content
Live
This type is used when a user is watching a TV channel directly or with some delay (such as when the user pauses and then plays again). Where the user is watching delayed live TV with delay, the Agent must also set the offsetFromLive
attribute in the metrics.
Name | Value | Type | Description |
---|---|---|---|
type | Fixed value “LIVE” | String | Fixed value |
eventId (optional) | String | ID of the content according to the content provider's catalogue. Used to query the metadata of the content (e.g. Gracenote ID, IMDB etc). | |
eventName (optional) | Example: “Real Madrid vs Barcelona” | String (Optional if EPG / MDS is available) | Name of the event in the primary language of the organisation |
channelId (required) | String | ID of the content according to the content provider's catalogue. | |
channelName (optional) | Example: “Canal + Sports“ | String | Name of the channel in the primary language of the organisation |
Replay
Replay is similar to LIVE, only that the content is not watched via the live stream but through a catalogue/library. Catchup content is generally only available for a limited time after being broadcasted. There can be different types of replay:
Catchup - Users choose content from a catalogue.
Start Over - Users choose to watch the current content of a channel from the beginning.
Cloud Digital Video Recorder - Users watch content recorded on the cloud.
Personal Video Recorder - Users watch content recorded locally on their devices.
In the case of Replay TV, there is no need to specify the offsetFromLive
attribute, but you must specify the contentCompletionMinutes
and contentCompletionPercent.
Name | Value | Type | Description |
---|---|---|---|
type | CU | String | Catchup |
eventId | String | ID of the content according to the content provider's catalogue. Used to query the metadata of the content (e.g. Gracenote ID, IMDB etc). | |
eventName | Example: “Real Madrid vs Barcelona” | String | Name of the event in the primary language of the organisation. |
channelId | String | ID of the content according to the content provider's catalogue. Used to query the metadata of the content (e.g. Gracenote ID, IMDB etc). | |
channelName | Example: “Canal + Sports“ | String | Name of the channel in the primary language of the organisation. |