Release Notes |
Data Points
Amazon IVS
Events
- Seek End (content) - Event is fired when the player stops moving the playhead position to jump to a specific point on the timeline. This event includes attributes Seek Start Point & Seek End Point to mark the starting & ending points of a seek event.
- Seek Start (content) - This event records when the user interacts with time controls within the player to move forward or backward in the video timeline. It can be triggered by dragging the scrub bar or auto advancing using controls exposed by the app.
- Seek End Point - The ending point of a seek event, representing the content timecode in milliseconds. Value will appear as an attribute on Seek End events
- Seek Start Point - The starting point of a seek event, representing the content timecode in milliseconds. Value will appear as an attribute on Seek End events
- App Session ID - Unique identifier for the user's current Datazoom session. Session will persist as long as the user is viewing content uninterrupted. A 20 minute pause in activity will close the session.
Bitmovin
Fluxdata
- Time Since Last Buffer Start - Time interval since Buffer Start event began during playback.
- Ad Blocker - States whether an Ad Blocker was detected or not.
- Ready State - Identifies the current ready state of the audio/video
Bitmovin (Roku)
Fluxdata
- Stall Duration - Ads - The cumulative amount of time elapsed where the user's playback of Ads has been interrupted by an unexpected video stall due to buffer depletion.
Chromecast
Events
- Milestone (content) - Fired when the playheadPosition passes a predetermined percentile milestone of the video's duration. This event is used for both Ads & Content. Current milestones are fired at the 10, 25, 50, 75, 90 & 95 percentiles.
- Rendition Change (content) - When the Player's Adaptive Bitrate Streaming upshifts or downshifts during Content Playback to a different quality level available in the manifest. This event includes absShift attribute identifying the direction of the change.
- Seek End (content) - Event is fired when the player stops moving the playhead position to jump to a specific point on the timeline. This event includes attributes Seek Start Point & Seek End Point to mark the starting & ending points of a seek event.
- Seek Start (content) - This event records when the user interacts with time controls within the player to move forward or backward in the video timeline. It can be triggered by dragging the scrub bar or auto advancing using controls exposed by the app.
Fluxdata
- Content Session Start Timestamp - Start time of a new Content Session for the current user session. Typically a new Content Session begins with a Playback Request.
- Event Count - Incremental counter of the events generated during a user session. This field is valuable for ensuring proper sequencing of events and detecting any potential data loss.
- Number of Content Plays - The amount of content assets that started playback during the current user app session.
- Number of Content Requests - The amount of content assets requested during the current user 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.
- 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.
- ABS Shift - Describes the direction of the rendition change that occurred during Adaptive Bitrate Streaming. Values ‘up’ or ‘down’ depends on the value of the previous rendition. 'absShift' is an attribute of the Rendition Change event.
- App Session Start Timestamp - Start time of the current user session
- Milestone Percent (content) - Number indicating the percentage milestone represented by the event fired. Attribute of Milestone events.
- Player Height - Height dimension in pixels of the current playback area.
- Player Width - Width dimension in pixels of the current playback area.
- Seek End Point - The ending point of a seek event, representing the content timecode in milliseconds. Value will appear as an attribute on Seek End events
- Seek Start Point - The starting point of a seek event, representing the content timecode in milliseconds. Value will appear as an attribute on Seek End events
- Source - Returns the URL of the current media file
- Streaming Type - Describes if the content being streamed is Live or On Demand.
Dash.js
Fluxdata
- Bandwidth - Amount of estimated network bandwidth currently available to the end user's device.
- Buffer Duration - Cumulative time that content has been buffering during the current Content Session.
- Buffer Duration - Content - Cumulative time that content has been buffering during content playback in current Content Session.
- Playback Duration - Cumulative time that content & ads have been playing during the Content Session. Excludes time accrued while user pauses content or buffering.
- Playback Duration - Content - Cumulative time that content has been playing during the current video Content Session. Excludes time accrued while user pauses content or buffering.
- Playback Rate - The speed of the audio/video playback. Describes the speed that the video is played back to the user in relation to normal playback time. .5x, 1x, 1.5x, 2x
- Player State - Returns the player's current playback state. (Idle, buffering, playing, paused)
- Stall Duration - The cumulative amount of time elapsed where the user's playback has been interrupted by an unexpected video stall due to buffer.
- 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.
- 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 Buffer Start - Time interval since Buffer Start event began during playback.
- Time Since Last Buffer Start - Content - Time interval since Buffer Start event began during content playback, reported in milliseconds. Value is reset to zero at the start of a new video View or when another Buffer Start event occurs.
- Time Since Last Heartbeat - Time interval since Heartbeat was last sent for the current content session.
- Time Since Last Stall Start - Time interval since Stall Start event began, reported in milliseconds. Value is reset to zero at the start of a new video View or when another Stall Start event occurs.
- Time Since Last Stall Start - Content - Time interval since Stall Start event began during content playback.
- Client Timestamp - Client side timestamp of the event in epoch milliseconds
- Seek End Point - The ending point of a seek event, representing the content timecode in milliseconds. Value will appear as an attribute on Seek End events
- Seek Start Point - The starting point of a seek event, representing the content timecode in milliseconds. Value will appear as an attribute on Seek End events
- 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.
HLS.js
- Seek End Point - The ending point of a seek event, representing the content timecode in milliseconds. Value will appear as an attribute on Seek End events
- Seek Start Point - The starting point of a seek event, representing the content timecode in milliseconds. Value will appear as an attribute on Seek End events
HTML5
- Seek End Point - The ending point of a seek event, representing the content timecode in milliseconds. Value will appear as an attribute on Seek End events
- Seek Start Point - The starting point of a seek event, representing the content timecode in milliseconds. Value will appear as an attribute on Seek End events
Roku
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.
- Playback Duration - Ads - Cumulative time that ads have been playing during the current Content Session. Excludes time accrued while user pauses content or buffering.
- Player State - Returns the player's current playback state. (Idle, buffering, playing, paused)
- ABS Shift - Describes the direction of the rendition change that occurred during Adaptive Bitrate Streaming. Values ‘up’ or ‘down’ depends on the value of the previous rendition. 'absShift' is an attribute of the Rendition Change event.
- Ad Partner (Roku) - Name of the partner showing the ad.
- Wrapper ID (Roku) - Ad IDs used for wrapper ads. The IDs returned starts at the inline ad (innermost) and traverses to the outermost wrapper ad.
- Wrapper Systems (Roku) - Ad systems used for wrapper ads. The ad systems returned starts at the inline ad and traverses to the outermost wrapper ad.
Shaka Player
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.
- 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.
- 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 Duration (CMCD) - 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.
- 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.
- 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.