Release Notes |
Data Points
Bitmovin (Roku)
- Ad Creative ID (Roku) - Creative ID of the ad shown.
Chromecast
Events
- Ad Skip (Google IMA) - This event is triggered when a user chooses to skip the currently playing ad and go directly to the content..
Fluxdata
- Time Since Content Request - Time interval since content playback was requested.
- Time Since Content Started - Time interval since current content playback began.
- Time Since Last Milestone - Content - Time interval since Milestone event was last sent for content.
- Time Since Last Pause - Time interval since content playback was paused., reported in milliseconds
- Time Since Last Rendition Change - Time interval since content playback shifted to a different available quality version from the manifest., reported in milliseconds
- Time Since Last Stall Start - Content - Time interval since Stall Start event began during content playback.
- Ad Break ID - UUID to denote the specific ad break. This can be used to tie events together that occurred during a specific ad break.
- Ad ID (Google IMA) - Identifier of the ad asset shown.
- Ad Position (Google IMA) - Where the ad appears in relation to the video content. Pre-roll ads run before the content, mid-roll ads run during the middle of the content & post-roll ads run after the content has completed streaming.
- Ad Session ID - A Datazoom generated UUID to denote the specific ad asset playback. This can be used to tie events together that occurred during a specific ad item.
Dash.js
FluxData
- Current Audio Track - Identifies which available audio track has been selected by the user. Multiple audio tracks are usually used for alternate languages. Values returned may vary by content publisher & player.
- Current Subtitles - Identifies which available subtitle or closed captioning track has been selected by the user. Multiple captioning tracks are usually used for alternate languages. Values returned may vary by content publisher & player.
- Playback Duration - Ads - Cumulative time that ads have been playing during the current Content Session. Excludes time accrued while user pauses content or buffering.
- Time Since Last Milestone - Content - Time interval since Milestone event was last sent for content.
- Time Since Last Pause - Time interval since content playback was paused., reported in milliseconds
- Time Since Last Seek Start - Time interval since the occurrence of a Seek Start event.
- Volume Level - The current playback volume as a whole number percentage.
- Autostart - Returns whether the audio/video should start playing as soon as it is loaded
- Cookies Enabled - Does the user's browser have cookies enabled?
- Default Muted - Identifies whether the audio/video should be muted by default
- Muted - Returns True if player is muted.
- Page Title - The title of the page from which the event originated.
- Page URL - The address of the page from which the event originated.
- Player Height - Height dimension in pixels of the current playback area.
- Player Width - Width dimension in pixels of the current playback area.
- Referrer URL - The URL of the page the user visited before coming to the active page.
ExoPlayer
Fluxdata
- Engagement Duration - Cumulative time that user has been engaged with the app or site, including time spent not viewing video.
- Pause Duration - Content - The cumulative amount of time elapsed where the player was in a paused state during Content playback of Content Session.
- Mobile Connection - Specifies if a user is on a mobile connection as determined by their IP address.
- Timezone Name - The name of the user's timezone where the event originated based on their IP address.
- Timezone Offset - The difference in hours, relative to UTC, of the user's timezone.
HLS.js
Fluxdata
- Buffer Duration - Cumulative time that content has been buffering during the current Content Session.
- Buffer Length - The amount of media currently stored in the player buffer waiting to be played.
- Number of Errors - Running count of the number of errors that have occurred during the user's current session.
- Number of Errors - Content - Running count of the number of errors that have occurred while content is playing during the user's current session.
- Playback Duration - Cumulative time that content & ads have been playing during the Content Session. Excludes time accrued while user pauses content or buffering.
- Stall Count - Number of times the user's playback has been interrupted by an unexpected video stall due to buffer depletion.
- Stall Count - Content - Number of times the user's playback of Content has been interrupted by an unexpected video stall due to buffer depletion.
- Stall Duration - The cumulative amount of time elapsed where the user's playback has been interrupted by an unexpected video stall due to buffer.
- Duration - The total length of the media file, reported in decimal seconds
- Startup Duration - Total - This timer represents the total time a user spent waiting for content to begin playback excluding any time spent viewing pre-roll ads.
- Streaming Protocol - What streaming format is being used for the content?
- Streaming Type - Describes if the content being streamed is Live or On Demand.
Roku
Events
- Stop - When the player has entered a stopped state due to any reason such as the user hitting a stop button, backgrounding the app, user switches content or the content has ended playback.
Fluxdata
- Bandwidth - Amount of estimated network bandwidth currently available to the end user's device.
- Pause Duration - The cumulative amount of time elapsed where the player was in a paused state during a Content Session.
- Pause Duration - Content - The cumulative amount of time elapsed where the player was in a paused state during Content playback of Content Session.
- Rendition Audio Bitrate - Target audio encoding bitrate of the currently selected rendition from the manifest. The manifest may contain multiple versions (i.e. renditions) of the asset encoded at varying qualities to support varying network conditions. This data point returns the audio bitrate value stated in the manifest for the currently playing rendition. Only available if the manifest contains discrete ad & video tracks.
- Rendition Height - Height in pixels of the video rendition being played. The manifest may contain multiple versions (i.e. renditions) of the video encoded at varying qualities to support varying network conditions.
- Rendition Name - Standardized name to represent the rendition currently being played.
- Rendition Width - Width in pixels of the video rendition being played. The manifest may contain multiple versions (i.e. renditions) of the video encoded at varying qualities to support varying network conditions.
- Player Height - Height dimension in pixels of the current playback area.
- Player Width - Width dimension in pixels of the current playback area.
- Subtitles - Describes if subtitles are currently enabled for playback.
- Timezone Name - The name of the user's timezone where the event originated based on their IP address.
- Timezone Offset - The difference in hours, relative to UTC, of the user's timezone.
- Wrapper Creative IDs (Roku) - Selected creative IDs used for wrapper ads. The creative IDs returned starts at the inline ad and traverses to the outermost wrapper ad.
THEOplayer
Events
- Media Object Request (content) - 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.
Fluxdata
- Stall Duration - Content - The cumulative amount of time elapsed where the user's playback of Content has been interrupted by an unexpected video stall due to buffer depletion.
- Buffer Length (CMCD) - The buffer length associated with the media object being requested.
- Buffer Starvation (CMCD) - 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.
- Content ID (CMCD) - A unique string identifying the current content.
- Deadline (CMCD) - 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.
- Encoded Bitrate (CMCD) - 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.
- Measured throughput (CMCD) - 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.
- Object Type (CMCD) - 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.
- Playback Rate (CMCD) - 1 if real-time, 2 if double speed, 0 if not playing. SHOULD only be sent if not equal to 1.
- Request ID (CMCD) - A unique identifier that is established to track an individual media object request made from the client to a CDN.
- Requested Maximum Throughput (CMCD) - 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.
- Session ID (CMCD) - 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].
- Startup (CMCD) - 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.
- Stream Type (CMCD) - Describes if the content being streamed is Live or On Demand.
- Streaming Format (CMCD) - 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.
- Top Bitrate (CMCD) - The highest bitrate rendition in the manifest or playlist that the client is allowed to play, given current codec, licensing and sizing constraints.
- Version (CMCD) - The version of the CMCD specification used for interpreting the defined key names and values.
|
---|
Comments
0 comments
Article is closed for comments.