Overview
Media tracking captures information about media player content (Media) and the visitor interactions with that player (Media Actions). Every media event is bound to a Media Session Id so that play, pause, seek, and end actions can be correlated to the same play-through.
Use the Media fields for the content being played (name, length, categories, volume, …) and the Media Action fields for individual interactions and their position within the media.
Field Definitions
Media
Name / Object | Key on Record | Description | Format | Comment |
|---|---|---|---|---|
Media Start Timestamp |
| The instant where the media started playing. |
|
|
Media Session Id |
| Identifies requests belonging to the same active media session. A user may have multiple media sessions open at the same time. |
| Contains an ID to identify media requests belonging to the same media session. |
Media Name |
| The name of the media item. |
|
|
Media Length |
| The total length of the media item in seconds. |
|
|
Media Elapsed time |
| The total amount of seconds of the media that were played including rewinding and forwarding. |
| The current state in the raw data stream refers to the time of the event. In the raw data export, it is the final state of the media session. Limited, does not reflect complete duration. Use mediaAction.position. |
Media Bandwidth |
| The bandwidth of the media item. |
|
|
Media Played time |
| The total amount of seconds of the media that were played excluding rewinding and forwarding. |
| The current state in the raw data stream refers to the time of the event. In the raw data export, it is the final state of the media session. |
Media Volume |
| The volume level the media was being played on from zero to hundred. |
| Available only at init command. |
Media Mute |
| The flag that determines if the media has been muted or not. |
| Available only at init command. |
Media (Text) Categories |
| Categories for the media. |
| Available for known media only (at latest beginning of the next day) |
Media (Numeric) Categories |
| Categories for the media. |
| Available in the future. |
Media Actions
Name / Object | Key on Record | Description | Format | Comment |
|---|---|---|---|---|
Media Action name |
| The name of the media action, which is the click identifier. |
|
|
Media Action Ranking |
| The ranking of the media action within all the media actions on the session. |
|
|
Media Action Position |
| The current position in elapsed seconds from the beginning of the media. |
|
|
Stream and Export Mapping
The same fields, mapped to their availability in the Root Stream, Custom Streams, the current Raw Data Export, and the Classic Raw Data Export. Use the Name / Object column to cross-reference rows with Field Definitions above.
Media
Name / Object | Available in Root Stream | Field in Custom Stream | Available in Custom Stream | File in the Raw Data Export | Field in the Raw Data Export | Available in Classic Raw Data Export |
|---|---|---|---|---|---|---|
Media Start Timestamp |
|
|
|
|
|
|
Media Session Id |
|
|
|
|
|
|
Media Name |
|
|
|
|
|
|
Media Length |
|
|
|
|
|
|
Media Elapsed time |
|
|
|
|
|
|
Media Bandwidth |
|
|
|
|
|
|
Media Played time |
|
|
|
|
|
|
Media Volume |
|
|
|
|
|
|
Media Mute |
|
|
|
|
|
|
Media (Text) Categories |
|
|
|
|
|
|
Media (Numeric) Categories |
|
|
|
|
|
|
Media Actions
Name / Object | Available in Root Stream | Field in Custom Stream | Available in Custom Stream | File in the Raw Data Export | Field in the Raw Data Export | Available in Classic Raw Data Export |
|---|---|---|---|---|---|---|
Media Action name |
|
|
|
|
|
|
Media Action Ranking |
|
|
|
|
|
|
Media Action Position |
|
|
|
|
|
|