The Datazoom Media Player Data Dictionary specifically tracks a user's engagement with content played in a media player (i.e., when Media Type equals “content”), such as video or audio streams.

When a Datazoom Application Collector is configured with a Media Player Extension, the Datazoom SDK automatically makes these content-centric events, metadata, and fluxdata collectable.

Key Features:

Content-Focused: This dictionary tracks the primary content experience. Interactions with advertisements (pre-roll, mid-roll, post-roll) are tracked separately in the Ad Framework Data Dictionary.
Configurable: Usage of these data points can be managed dynamically via the Datazoom Console, allowing you to select or deselect specific metrics on demand.
Extensible: You can supplement these automatic data points with unlimited custom events and metadata using the Datazoom SDK APIs to capture player interactions specific to your implementation.
Additive: The Media Player Data Dictionary adds to the Application Data Dictionary, meaning application-level context is maintained alongside playback data.

Events

Discrete occurrences driven by user interactions or system actions

Metadata

Attributes describing the context of an event

Attributes

CMCD

Dolby Millicast

Dolby Millicast Metadata All

Player

User

Content Session ID

Video

Fluxdata

Metrics measuring changing parameters over time

Events

Audio Track Changed

audio_track_changed

When the user has chosen to switch to a different audio track in the video player.

Supported Collectors	9
Supported Media Types	Content
Notes	For the HTML5 collector, this is currently only supported by Safari.

Buffer End

buffer_end

When media plays after Buffer Start or when the player state changes during buffer due to user action or an error.

Supported Collectors	20
Supported Media Types	Content
Notes	A buffering event has just completed. The player fires this event which returns a value of 1 to indicate that playback has resumed.

Buffer Start

buffer_start

When the player has to wait for the video buffer to fill with video segments.

Supported Collectors	20
Supported Media Types	Content
Notes	When the Buffer Start event is thrown and a value received, it is correlated to a specific playback time by comparing it to the playback length within the manifest. Once the Buffer End event has thrown, the delta between the two can be used to forensically analyze a series of chunks to determine the veracity of the content files. If the issue is corrupt chunks, a new encode can be produced.

Cast End

cast_end

When a user ends casting.

Cast Start

cast_start

When a user casts video to a remote screen.

Cast Transfer

cast_transfer

When an orchestration event occurs between the casting sender and receiver devices. Upon cast initialization if both the sender and receiver are instrumented with Datazoom SDKs, a cast transfer event will be fired from both devices.

Error

error

This event fires if a error causes content or ad playback or retrieval of the video to fail.

Supported Collectors	18
Supported Media Types	Content

Exit Fullscreen

exit_fullscreen

When user exits fullscreen mode during video playback

Fullscreen

fullscreen

When the user enters fullscreen mode during video playback

Heartbeat

heartbeat

When configurable interval of time passes during video playback within a content session, or right after video playback is interrupted within a content session.

Supported Collectors	23
Notes	Configure heartbeats by visiting your collector configurations pages from the Collectors page, scroll to the Heartbeats setting in the Event Control section. By default, heartbeats fire every 60 seconds.

Media Loaded

media_loaded

Triggered when player is ready to begin playback after playback is invoked.

Supported Collectors	21
Supported Media Types	Content

Media Object Request

media_object_request

Fired after the player has requested an object related to video playback. This object may be a manifest, audio / video segment or subtitle file. The player will fire this event after the full roundtrip of request and response has completed.

Supported Collectors	6
Supported Media Types	Content
Notes	Primarily intended for open tracing via CMCD.

Media Request

media_request

When media type is 'content', this is triggered when media_request is invoked. This could happen automatically in auto-play situations or when a user presses the play button. When the media type is 'ad', this is triggered when VAST request is made.

Supported Collectors	23
Supported Media Types	Content
Notes	Identify problems that may be occurring in the video player which prevent successful playback after a user requests playback.

Milestone

milestone

When the playhead position plays through a customer configurable percentile milestone of the video's duration (seeking through the milestone does not trigger the event). The event fires no more than once for each percentile milestone per content session.

Supported Collectors	20
Supported Media Types	Content
Notes	Configure milestones by visiting your collector configurations pages from the Collectors page, scroll to the Milestones setting in the Event Control section. By default, for content, milestones fire when the user passes 5%, 10%, 25%, 50%, 75%, 90%, & 95% point in the content playback timeline and, for ads, when the user passes 25%, 50%, & 75% point in the ad playback timeline.

Mute

mute

When the player volume has been reduced to zero. If observable, mute is also triggered when the device volume is muted.

Pause

pause

When playback is intentionally halted.

Supported Collectors	23
Supported Media Types	Content

Playback Complete

playback_complete

When the video player reaches the end of the currently playing content. The event can be triggered multiple times if the user reaches the end of the currently playing content, scrubs back and then reaches the end of the content again.

Supported Collectors	22
Supported Media Types	Content

Playback Start

playback_start

When the video starts playing for the user, also known as "first frame".

Supported Collectors	23
Supported Media Types	Content

Player Ready

player_ready

Signifies when the player instance is made available to Datazoom, independent of any media selection.

Supported Collectors	23
Notes	“player has been initialized” independent of any media selection and when the player instance is handed over to us. A player can remain idle waiting for the next event which may or may not happen.

Playing

playing

The media is no longer blocked from playback, and has started playing. Fired when playback resumes from Stall, Buffering or Seek.

Supported Collectors	22
Supported Media Types	Content

Qualified View

qualified_view

When playback duration surpasses customer configurable thresholds of time in seconds.

Supported Collectors	23
Supported Media Types	Content
Notes	Configure qualified view thresholds by visiting your collector configurations pages from the Collectors page, scroll to the Qualified View setting in the Event Control section. By default, for content, qualified view thresholds are 30 seconds and 60 seconds and, for ads, the qualified view threshold is 5 seconds.

Quality Change Request

quality_change_request

This event signifies when the user selects a different preferred playback quality.

Supported Collectors	2
Notes	This is usually represented as a High, Med, Low setting that the user can select depending on their network capability. This event is different than Rendition Change which is fired automatically as video quality is adjusted dynamically as a response to actual network conditions.

Rendition Change

rendition_change

When the player's Adaptive Bitrate Streaming upshifts or downshifts during playback to a different quality level available in the manifest. This event includes absShift attribute identifying the direction of the change.

Supported Collectors	17
Supported Media Types	Content

Resize

resize

When the player's on-page dimensions have changed.

Resume

resume

When the user begins playing again after pausing the video during playback.

Supported Collectors	21
Supported Media Types	Content

Seek End

seek_end

When a user stops seeking.

Supported Collectors	15
Supported Media Types	Content
Notes	This event includes attributes Seek Start Point & Seek End Point to mark the starting & ending points of a seek event.

Seek Start

seek_start

When a user begins seeking.

Supported Collectors	13
Supported Media Types	Content

Stall End

stall_end

Event fired when video starts playing again after a stall

Supported Collectors	20
Supported Media Types	Content

Stall Start

stall_start

When there is an unexpected playback interruption because the buffer has been depleted.

Supported Collectors	20
Supported Media Types	Content

Stop

stop

Triggered when: 1. A playback error results in the termination of content playback. 2. The context (or the logical equivalent) corresponding to a specific player is destroyed: 2(a). The application may destroy the context when playback is stopped by the user. 2(b). The application may destroy the context after playback has reached the end of content (and the player isn’t going to be reused any further). 2(c). The collector (in certain cases) may be able to detect when the application is terminated (e.g., user closes the browser tab) and destroy all player contexts automatically. 3. If a change in the content URL is detected by the collector, a new content session should begin and a `stop` event should be triggered for the previous content session.

Supported Collectors	21
Supported Media Types	Content
Notes	Notable condition where the `stop` events is not triggered: When playback reaches the end of the content timeline (i.e., the same condition for triggering `playback_complete`), the content session remains open, unaffected by the fact that playback has reached the end of content so if post-roll ads are played or play-head is rewinded afterward, the subsequent events belong to the same content session.

Subtitle Change

subtitle_change

When the user enables or disables subtitles or closed captioning.

Supported Collectors	10
Supported Media Types	Content

Unmute

unmute

When the player audio has been reactivated.

Vendor Events All

vendor_events_all

Dolby Millicast Events All

Volume Change

volume_change

When the player audio level increases or decreases.

Metadata

Attributes

ABS Shift

abs_shift

The direction of the rendition change relative to the previous rendition. An attribute of the Rendition Change event.

Supported Collectors	17
Data type	string
Number Type	Not set
Required	true
Permitted Values	value list

Error Code

error_code

Error code emitted by the player

Supported Collectors	17
Data type	string
Number Type	Not set
Required	true

Error Message

error_msg

Error message emitted by the player

Supported Collectors	18
Data type	string
Number Type	Not set
Required	true

Heartbeat Count

heartbeat_count

Count of Heartbeat events per content session.

Supported Collectors	23
Data type	number
Number Type	Int
Unit	count
Required	true

Inner Error

inner_error

Returns the error that occurred during Google IMA ad processing.

Supported Collectors	8
Data type	string
Number Type	Not set
Required	true

Milestone Percent

milestone_percent

The point represented by the customer configurable percentage relative to the duration. Attribute of the Milestone event.

Supported Collectors	21
Data type	number
Number Type	Short
Unit	percentage
Required	true

Qualified View Trigger

qualified_view_sec

The point represented by the customer configurable duration of playback. Attribute of the Qualified View event.

Supported Collectors	23
Data type	number
Number Type	Not set
Unit	seconds
Required	true

Seek End Point

seek_end_point_ms

The point within in the content timeline at which the Seek End event is triggered.

Supported Collectors	12
Data type	number
Number Type	Not set
Unit	milliseconds
Required	true

Seek Start Point

seek_start_point_ms

The point within in the content timeline at which the Seek Start event is triggered.

Supported Collectors	13
Data type	number
Number Type	Not set
Unit	milliseconds
Required	true

Startup Duration - Content

startup_duration_content_ms

The total time a user spent waiting for content to begin playback excluding any time related to requesting, loading or playing pre-roll ads.

Supported Collectors	23
Data type	number
Number Type	Int
Unit	milliseconds
Required	true

Startup Duration - Total

startup_duration_total_ms

The total time a user spent waiting for content to begin playback including any time spent viewing pre-roll ads.

Supported Collectors	22
Data type	number
Number Type	Int
Unit	milliseconds
Required	true

Video

Asset ID

asset_id

Unique identifier of the content shown according to the player. This may be produced by the CMS or publishing system.

Supported Collectors	10
Data type	string
Number Type	Not set

Description

description

Description of the content (e.g., provided by the CMS, VAST response, etc) emitted by the media player

Supported Collectors	6
Data type	string
Number Type	Not set

Duration

duration_sec

The length of VOD content or ad media. Value is absent for live content.

Supported Collectors	20
Data type	number
Number Type	Double
Unit	seconds

Frame Rate

frame_rate

The frames per second of the video encoding.

Supported Collectors	1
Data type	number
Number Type	Short
Unit	fps

Media Tags

media_tags

A keyword or label assigned to an asset to describe its content and context

Supported Collectors	1
Data type	array of string
Number Type	Not set

Media Type

media_type

Whether the event relates to an Ad or Content asset.

Supported Collectors	23
Data type	string
Number Type	Not set
Required	true
Permitted Values	value list

Player Height

player_height

Height of the display port.

Supported Collectors	17
Data type	number
Number Type	Not set
Unit	pixels

Player Width

player_width

Width of the display port.

Supported Collectors	17
Data type	number
Number Type	Not set
Unit	pixels

Source

source

The URL of the current media file

Supported Collectors	18
Data type	string
Number Type	Not set
Permitted Values	URL

Title

title

The title of the content as reported by the media player.

Supported Collectors	10
Data type	string
Number Type	Not set

Player

Autostart

autostart

Returns whether the player is configured to autostart. Generally, when autostart is configured, video will start playing as soon as it is loaded; however, in some cases, browsers will prevent it.

Supported Collectors	15
Data type	bool
Number Type	Not set
Permitted Values	value list

Cast App Session ID

cast_app_session_id

The App Session ID from a related casting device. -- When collected by the receiver, this value represents the original user app session that was started on the sender device. -- When collected by the sender, the value will represent the app session created on the receiver device.

Supported Collectors	8
Data type	string
Number Type	Not set
Permitted Values	UUID

Cast Content Session ID

cast_content_session_id

The Content Session ID from a related casting device. -- When collected by the receiver, this value represents the content session on the sender device. -- When collected by the sender, this value represents the content session on the receiver device.

Supported Collectors	8
Data type	string
Number Type	Not set
Permitted Values	UUID

Casting

casting

Is the player in casting mode?

Supported Collectors	13
Data type	bool
Number Type	Not set
Permitted Values	value list

Controls

controls

Whether the controls are available for user interaction in the player. (i.e. play, pause, seek)

Supported Collectors	3
Data type	bool
Number Type	Not set
Permitted Values	value list

Default Muted

default_muted

Identifies whether the audio/video should be muted by default

Supported Collectors	16
Data type	bool
Number Type	Not set
Permitted Values	value list

Default Playback Rate

default_playback_rate

The default speed of the audio / video playback in relation to normal playback time (e.g., .5x, 1x, 1.5x, 2x).

Supported Collectors	16
Data type	number
Number Type	Float
Unit	percentage

Fullscreen

fullscreen

Whether the player is in fullscreen mode or not.

Supported Collectors	14
Data type	bool
Number Type	Not set
Permitted Values	value list

Loop

loop

Whether the media player is configured to start over again when the content finishes.

Supported Collectors	8
Data type	bool
Number Type	Not set
Permitted Values	value list

Muted

muted

Whether the player is muted or if the device volume is muted and observable.

Supported Collectors	16
Data type	bool
Number Type	Not set
Permitted Values	value list

Player Name

player_name

The name of the media player.

Supported Collectors	23
Data type	string
Number Type	Not set
Required	true

Player Version

player_version

The version of the media player.

Supported Collectors	14
Data type	string
Number Type	Not set

Preload

preload

The way in which the media player is configured to preload the content. -- "none": the media should not be preloaded; -- "metadata": only metadata (e.g. length) is fetched; -- "auto": the whole video file can be downloaded, even if the user is not expected to use it.

Supported Collectors	7
Data type	string
Number Type	Not set
Permitted Values	value list

Ready State

ready_state

Identifies the current ready state of the audio/video

Supported Collectors	9
Data type	number
Number Type	Short
Permitted Values	value list

Streaming Protocol

streaming_protocol

The streaming protocol used to deliver the content; if not collectable, then it is the container type.

Supported Collectors	14
Data type	string
Number Type	Not set
Permitted Values	value list

Streaming Type

streaming_type

Whether the content is Live, VOD or DVR as reported by the media player.

Supported Collectors	16
Data type	string
Number Type	Not set
Permitted Values	value list

Subtitles

subtitles

Whether subtitles are currently enabled.

Supported Collectors	15
Data type	bool
Number Type	Not set
Permitted Values	value list

CMCD

Buffer Length (CMCD)

bl

The buffer length associated with the media object being requested.

Supported Collectors	4
Data type	number
Number Type	Int
Unit	milliseconds

Buffer Starvation (CMCD)

bs

Key is included without a value if the buffer was starved at some point between the prior request and this object request, resulting in the player being in a rebuffering state and the video or audio playback being stalled. This key MUST NOT be sent if the buffer was not starved since the prior request. If the object type ‘ot’ key is sent along with this key, then the ‘bs’ key refers to the buffer associated with the particular object type. If no object type is communicated, then the buffer state applies to the current session.

Supported Collectors	3
Data type	bool
Number Type	Not set
Permitted Values	value list

Content ID (CMCD)

cid

A unique string identifying the current content.

Supported Collectors	2
Data type	string
Number Type	Not set

Deadline (CMCD)

dl

Deadline from the request time until the first sample of this Segment/Object needs to be available in order to not create a buffer underrun or any other playback problems.

Supported Collectors	2
Data type	number
Number Type	Int
Unit	milliseconds

Encoded Bitrate (CMCD)

br

The encoded bitrate of the audio or video object being requested. This may not be known precisely by the player; however, it MAY be estimated based upon playlist/manifest declarations. If the playlist declares both peak and average bitrate values, the peak value should be transmitted.

Supported Collectors	4
Data type	number
Number Type	Int
Unit	kbps

Measured throughput (CMCD)

mtp

The throughput between client and server, as measured by the client and MUST be rounded to the nearest 100 kbps. This value, however derived, SHOULD be the value that the client is using to make its next Adaptive Bitrate switching decision. If the client is connected to multiple servers concurrently, it must take care to report only the throughput measured against the receiving server. If the client has multiple concurrent connections to the server, then the intent is that this value communicates the aggregate throughput the client sees across all those connections.

Supported Collectors	4
Data type	number
Number Type	Int
Unit	kbps

Next Object Request (CMCD)

nor

Relative path of the next object to be requested. This can be used to trigger pre-fetching by the CDN. This MUST be a path relative to the current request. This string MUST be URLEncoded [5]. The client SHOULD NOT depend upon any pre-fetch action being taken - it is merely a request for such a pre-fetch to take place.

Supported Collectors	2
Data type	string
Number Type	Not set

Next Range Request (CMCD)

nrr

If the next request will be a partial object request, then this string denotes the byte range to be requested. If the ‘nor’ field is not set, then the object is assumed to match the object currently being requested. The client SHOULD NOT depend upon any pre-fetch action being taken – it is merely a request for such a pre-fetch to take place. Formatting is similar to the HTTP Range header, except that the unit MUST be ‘byte’, the ‘Range:’ prefix is NOT required and specifying multiple ranges is NOT allowed. Valid combinations are: "-" "-" "-"

Supported Collectors	0
Data type	string
Number Type	Not set

Object Duration (CMCD)

d

The playback duration in milliseconds of the object being requested. If a partial segment is being requested, then this value MUST indicate the playback duration of that part and not that of its parent segment. This value can be an approximation of the estimated duration if the explicit value is not known.

Supported Collectors	4
Data type	number
Number Type	Int
Unit	milliseconds

Object Type (CMCD)

ot

The media type of the current object being requested: m = text file, such as a manifest or playlist a = audio only v = video only av = muxed audio and video i = init segment c = caption or subtitle tt = ISOBMFF timed text track k = cryptographic key, license or certificate. o = other If the object type being requested is unknown, then this key MUST NOT be used.

Supported Collectors	4
Data type	string
Number Type	Not set
Permitted Values	value list

Playback Rate (CMCD)

pr

1 if real-time, 2 if double speed, 0 if not playing. SHOULD only be sent if not equal to 1.

Supported Collectors	3
Data type	number
Number Type	Short

Request ID (CMCD)

rid

A unique identifier that is established to track an individual media object request made from the client to a CDN.

Supported Collectors	6
Data type	string
Number Type	Not set

Requested Maximum Throughput (CMCD)

rtp

The requested maximum throughput that the client considers sufficient for delivery of the asset. Values MUST be rounded to the nearest 100kbps. For example, a client would indicate that the current segment, encoded at 2Mbps, is to be delivered at no more than 10Mbps, by using rtp=10000. Note: This can benefit clients by preventing buffer saturation through over-delivery and can also deliver a community benefit through fair-share delivery. The concept is that each client receives the throughput necessary for great performance, but no more. The CDN may not support the rtp feature.

Supported Collectors	2
Data type	number
Number Type	Int
Unit	kbps

Session ID (CMCD)

sid

A GUID identifying the current playback session. A playback session typically ties together segments belonging to a single media asset. Maximum length is 64 characters. It is RECOMMENDED to conform to the UUID specification [7].

Supported Collectors	6
Data type	string
Number Type	Not set

Startup (CMCD)

su

Key is included without a value if the object is needed urgently due to startup, seeking or recovery after a buffer-empty event. The media SHOULD not be rendering when this request is made. This key MUST not be sent if it is FALSE.

Supported Collectors	3
Data type	bool
Number Type	Not set
Permitted Values	value list

Stream Type (CMCD)

st

Describes if the content being streamed is Live or On Demand.

Supported Collectors	3
Data type	string
Number Type	Not set
Permitted Values	value list

Streaming Format (CMCD)

sf

The streaming format that defines the current request. d = MPEG DASH h = HTTP Live Streaming (HLS) s = Smooth Streaming o = other If the streaming format being requested is unknown, then this key MUST NOT be used.

Supported Collectors	4
Data type	string
Number Type	Not set
Permitted Values	value list

Top Bitrate (CMCD)

tb

The highest bitrate rendition in the manifest or playlist that the client is allowed to play, given current codec, licensing and sizing constraints.

Supported Collectors	4
Data type	number
Number Type	Int
Unit	kbps

Version (CMCD)

v

The version of the CMCD specification used for interpreting the defined key names and values.

Supported Collectors	3
Data type	number
Number Type	Short

User

Content Session ID

content_session_id

A unique id for the current video playback session.

Supported Collectors	23
Data type	string
Number Type	Not set
Required	true
Permitted Values	UUID

Dolby Millicast

Dolby Millicast Metadata All

vendor_metadata_all

Dolby Millicast Metadata All

Supported Collectors	1
Number Type	Not set
Required	true

Fluxdata

Audible Content Playback Duration (App Session)

playback_duration_content_audible_app_ms

Cumulative playback duration where Media Type == 'content' AND volume_level_percent is greater than 0 in an app session

Supported Collectors

Audio Track

current_audio_track

The active audio track

Supported Collectors	10
Device Platforms	Browser,Console,DTV,Mobile

Bandwidth

bandwidth_kbps

Estimated network bandwidth as derived from the player

Supported Collectors	13
Device Platforms	Browser,Console,DTV,Mobile

Buffer Duration (Content Session)

buffer_duration_ms

Cumulative buffering time during a content session

Supported Collectors	15
Device Platforms	Browser,Console,DTV,Mobile

Buffer Length

buffer_length_ms

The buffer length associated with the media objects being requested.

Supported Collectors	16
Device Platforms	Browser,Console,DTV,Mobile,Server API

Buffer Start Recency (Content Session)

time_since_last_buffer_start_ms

Time since last "Buffer Start" event for the current content session

Supported Collectors	13
Device Platforms	Browser,Console,DTV,Mobile

Content Buffer Duration (App Session)

buffer_duration_content_app_ms

The cumulative time content buffered in an app session

Supported Collectors

Content Buffer Duration (Content Session)

buffer_duration_content_ms

Cumulative buffering time during a content session when 'media type' equals 'content'

Supported Collectors	19
Device Platforms	Browser,Console,DTV,Mobile

Content Buffer Start Recency (Content Session)

time_since_last_buffer_start_content_ms

Time since last "Buffer Start" event where "Media Type" equals "content" for the current content session

Supported Collectors	20
Device Platforms	Browser,Console,DTV,Mobile

Content Error Count (App Session)

num_errors_content

Count of errors during an app session where 'media type' equals 'content'

Supported Collectors	15
Device Platforms	Browser,Console,DTV,Mobile

Content Media Request Count (App Session)

num_requests_content

Count of 'media request' events where 'media type' equals 'content' during an app session

Supported Collectors	22
Device Platforms	Browser,Console,DTV,Mobile

Content Media Request Recency (Content Session)

time_since_request_content_ms

Time since "Media Request" event where "Media Type" equals "content"

Supported Collectors	22
Device Platforms	Browser,Console,DTV,Mobile

Content Milestone Recency (Content Session)

time_since_last_milestone_content_ms

Time since last "Milestone" event where "Media Type" equals "content"

Supported Collectors	20
Device Platforms	Browser,Console,DTV,Mobile

Content Pause Count (App Session)

num_pauses_content

Represents the cumulative total of user induced pauses across the app session at the time of the stop event.

Supported Collectors

Content Pause Duration (Content Session)

pause_duration_content_ms

The cumulative amount of time elapsed where the player was in a paused state during content playback of content session.

Supported Collectors	23
Device Platforms	Browser,Console,DTV,Mobile

Content Playback Duration (App Session)

playback_duration_content_app_ms

Cumulative playback duration where Media Type == 'content' in an app session

Supported Collectors

Content Playback Duration (Content Session)

playback_duration_content_ms

Cumulative playback time where media type equals 'content' during the current content session regardless of playback rate, excluding stalls, buffers or pauses.

Supported Collectors	23
Device Platforms	Browser,Console,DTV,Mobile

Content Playback Start Count (App Session)

num_content_plays

Count of 'playback start' events where 'media type' equals 'content' during an app session

Supported Collectors	22
Device Platforms	Browser,Console,DTV,Mobile

Content Playback Start Recency (Content Session)

time_since_started_content_ms

Time since "Playback Start" event where "Media Type" equals "content"

Supported Collectors	22
Device Platforms	Browser,Console,DTV,Mobile

Content Rendition Change Count (App Session)

num_content_rendition_changes_app

The number of rendition_change events where media_type=content in an app session

Supported Collectors

Content Seek Count (App Session)

num_seeks_content

Represents the cumulative total of user induced seeks (seek_start) across the app session at the time of the stop event.

Supported Collectors

Content Session Start Timestamp

content_session_start_ts_ms

Start time of a new content session within an app session.

Supported Collectors	22
Device Platforms	Browser,Console,DTV,Mobile

Content Stall Count (App Session)

stall_count_content_app

The number of stall events where Media Type == 'content' in an app session

Supported Collectors

Content Stall Count (Content Session)

stall_count_content

Count of stall events in a content session where 'media type' equals 'content'

Supported Collectors	19
Device Platforms	Browser,Console,DTV,Mobile

Content Stall Duration (App Session)

stall_duration_content_app_ms

Cumulative stall duration where Media Type == 'content' in an app session

Supported Collectors

Content Stall Duration (Content Session)

stall_duration_content_ms

Cumulative stall time during a content session when 'media type' equals 'content'

Supported Collectors	17
Device Platforms	Browser,Console,DTV,Mobile

Content Stall Start Recency (Content Session)

time_since_last_stall_start_content_ms

Time since last "Stall Start" event where "Media Type" equals "content"

Supported Collectors	21
Device Platforms	Browser,Console,DTV,Mobile

Content Startup Duration (Content Session)

time_to_first_frame_ms

Represents the same value that we already collect as startup_duration_content_ms but added to the stop event only, by content session

Supported Collectors

Error Count (App Session)

num_errors

Count of errors during an app session.

Supported Collectors	14
Device Platforms	Browser,Console,DTV,Mobile

Heartbeat Recency (Content Session)

time_since_last_heartbeat_ms

Time since last "Heartbeat" event for the current content session.

Supported Collectors	23
Device Platforms	Browser,Console,DTV,Mobile

HiFi Content Playback Duration (App Session)

playback_duration_content_hifi_app_ms

Cumulative playback duration where Media Type == 'content' AND Rendition Height >= Player Height in an app session

Supported Collectors

Pause Duration (Content Session)

pause_duration_ms

The cumulative amount of time elapsed where the player was in a paused state during a content session.

Supported Collectors	23
Device Platforms	Browser,Console,DTV,Mobile

Pause Recency (Content Session)

time_since_last_pause_ms

Time since last "Pause" event

Supported Collectors	22
Device Platforms	Browser,Console,DTV,Mobile

Playback Duration (Content Session)

playback_duration_ms

Elapsed time spent watching content and ads, regardless of playback rate, excluding stalls, buffers or pauses.

Supported Collectors	21
Device Platforms	Browser,Console,DTV,Mobile

Playback Rate

playback_rate

Playback speed relative to normal playback time (e.g., .5x, 1x, 1.5x, 2x)

Supported Collectors	19
Device Platforms	Browser,Console,DTV,Mobile

Player State

player_state

The player's playback state (idle, buffering, playing, paused, seeking)

Supported Collectors	23
Device Platforms	Browser,Console,DTV,Mobile
Permitted Values	value list

Player Viewable

player_viewable

Percentage of player visible is 50% or more

Supported Collectors	12
Device Platforms	Browser,Console
Permitted Values	value list

Player Viewable Percent

player_viewable_percent

Percentage of the player that is viewable on the screen

Supported Collectors	11
Device Platforms	Browser,Console

Playhead Position

playhead_position_sec

The point in the video timeline in seconds.

Supported Collectors	23
Device Platforms	Browser,Console,DTV,Mobile
Required	true

Playhead Position - Program Date Time

playhead_pdt_sec

The datetime value relative to media.currentTime for the active level Program Date Time if present

Supported Collectors	8
Device Platforms	Browser,Console,DTV,Mobile

Promo Playback Duration (Content Session)

playback_duration_promo_ms

Cumulative playback time that promo content during a content session regardless of playback rate, excluding stalls, buffers or pauses. Requires application to annotate content session with promo information.

Supported Collectors	5
Device Platforms	Browser,Console,DTV,Mobile

Rendition Audio Bitrate

rendition_audio_bitrate_kbps

The current audio bitrate

Supported Collectors	4
Device Platforms	Browser,Console,DTV,Mobile

Rendition Change Recency (Content Session)

time_since_last_rendition_change_ms

Time since last "Rendition Change" event

Supported Collectors	17
Device Platforms	Browser,Console,DTV,Mobile

Rendition Height

rendition_height

Height in pixels of the current video rendition

Supported Collectors	17
Device Platforms	Browser,Console,DTV,Mobile

Rendition Name

rendition_name

Name of the current rendition from the player if available. If not, "[height]p".

Supported Collectors	17
Device Platforms	Browser,Console,DTV,Mobile

Rendition Video Bitrate

rendition_video_bitrate_kbps

Target bitrate of the current video rendition from the manifest.

Supported Collectors	16
Device Platforms	Browser,Console,DTV,Mobile

Rendition Width

rendition_width

Width in pixels of the current video rendition

Supported Collectors	17
Device Platforms	Browser,Console,DTV,Mobile

Seek Start Recency (Content Session)

time_since_last_seek_start_ms

Time since last "Seek Start" event.

Supported Collectors	15
Device Platforms	Browser,Console,DTV,Mobile

Stall Count (Content Session)

stall_count

Count of stall events in a content session

Supported Collectors	13
Device Platforms	Browser,Console,DTV,Mobile

Stall Duration (Content Session)

stall_duration_ms

Cumulative stall time during a content session

Supported Collectors	19
Device Platforms	Browser,Console,DTV,Mobile

Stall Start Recency (Content Session)

time_since_last_stall_start_ms

Time since last "Stall Start" event.

Supported Collectors	21
Device Platforms	Browser,Console,DTV,Mobile

Startup Duration (Content Session)

time_to_first_frame_plus_ad_delay_ms

Represents the same value that we already collect as startup_duration_total_ms but added to the stop event only, by content session

Supported Collectors

Subtitle Track

current_subtitles

The active subtitle or closed captioning track

Supported Collectors	13
Device Platforms	Browser,Console,DTV,Mobile

Viewable Content Playback Duration (App Session)

playback_duration_content_viewable_app_ms

Cumulative playback duration where Media Type == 'content' AND and player_viewable was true in an app session

Supported Collectors

Volume

volume_level_percent

The current playback volume

Supported Collectors	15
Device Platforms	Browser,Mobile