Release Notes |
Data Points
- Content Session ID - A unique id for the current video playback session.
Bitmovin
Events
- Buffer End (Ad) (Google IMA) - Event is fired when video starts playing again after a buffer is completed.
- Buffer Start (Ad) (Google IMA) - Buffer Start identifies anytime the player has to wait for the video buffer to fill with video segments . This event includes all visible buffering activity including during playback startup, connectivity issues or buffering that may occur when resuming after seek or pause.
- Resize (Ad) - Fired when the player's on-page dimensions have changed. This event is not fired in response to a Fullscreen change.
- Resize (Content) - Fired when the player's on-page dimensions have changed. This event is not fired in response to a Fullscreen change.
- Unmute (Ad) - Triggered when the player audio has been reactivated.
- Unmute (Content) - Triggered when the player audio has been reactivated.
- Volume Change (Ad) - Triggered when the player increases or decreases the audio level of the video.
- Volume Change (Content) - Triggered when the player increases or decreases the audio level of the video.
Fluxdata
- Buffer Duration - Ads - Cumulative time that content has been buffering during ad playback in current Content Session.
- Player State - Returns the player's current playback state. (Idle, buffering, playing, paused)
- Time Since Last Buffer Start - Ad - Time interval since Buffer Start event began during advertisement playback.
- Volume Level - The current playback volume as a whole number percentage.
- Referrer URL - The URL of the page the user visited before coming to the active page.
- Site Domain - URL Domain of the site hosting the video player.
Bitmovin (iOS)
Events
- Datazoom Loaded - Signifies that the Datazoom SDK has been loaded and activated. At this point, the video player can be instantiated or custom events can be sent by the application.
- Event ID - Unique identifier for each event message fired by a Collector or log file received by Datazoom. The string includes an incremental counter at the end to allow for sequencing the events from a user session.
Bitmovin (Roku)
Events
- Buffer End (Ad) (Roku) - Event is fired when video starts playing again after a buffer is completed.
- Buffer Start (Ad) (Roku) - Buffer Start identifies anytime the player has to wait for the video buffer to fill with video segments . This event includes all visible buffering activity including during playback startup, connectivity issues or buffering that may occur when resuming after seek or pause.
- Error (Ad) (Roku) - Thrown if an error occurs during content playback or retrieval of the video
- Media Loaded (Ad) (Roku) - Fired when the video is fully loaded into the player & ready to begin playback.
- Media Request (Ad) (Roku) - Event signifies the video player requests the video from the server. The could be triggered by the user clicking on a play button of a thumbnail. If the video is played automatically, this may be fired when the player starts loading.
- Milestone (Ad) (Roku) - 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.
- Playback Complete (Ad) (Roku) - This event signifies that the video player has reached the end of the currently playing content.
- Playback Start (Ad) (Roku) - This event is fired when the video starts playing for the user, also known as First Frame.
- Playing (Ad) (Roku) - The media is no longer blocked from playback, and has started playing. Fired when playback resumes from Stall, Buffering or Seek.
- Stall End (Ad) (Roku) - Event fired when video starts playing again after a stall and the buffer has been replenished and playback resumes.
- Stall Start (Ad) (Roku) - Stall Start event is triggered when playback of video stops because the buffer has been depleted causing an unexpected interruption for the user.
Fluxdata
- Stall Count - Number of times the user's playback has been interrupted by an unexpected video stall due to buffer depletion.
- Content Session ID - A unique id for the current video playback session.
- Error Code (Ad) (Roku) - Error object representing a code explicitly identified by the player
- Error Message (Ad) (Roku) - Error object representing a message about the error explicitly identified by the player
- Media Type (Ad) (Roku) - Specifies whether the event relates to an Ad or Content asset.
- Server Timestamp Offset - Time difference between the client side timestamp and the server side timestamp in milliseconds. A negative offset value would indicate that the Client is ahead of the server.
Brightcove
Fluxdata
- Buffer Length - The amount of media currently stored in the player buffer waiting to be played.
- Player Viewable - Is 50% or more of the player visible on the screen at the time of event?
- Player Viewable Percent - The percentage of the player that is viewable on the screen at the time of the event.
- 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 Ad Break Start - Time interval since the current pod of advertisements began.
- Time Since Last Ad Completed - Time interval since the last advertisement completed.
- Time Since Last Ad Request - Time interval since advertisement was requested.
- Time Since Last Ad Started - Time interval since advertisement started playing.
- Time Since Last Milestone - Ad - Time interval since Milestone event was last sent for ad.
- 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
- 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 Blocker - States whether an Ad Blocker was detected or not.
- Streaming Protocol - What streaming format is being used for the content?
- Streaming Type - Describes if the content being streamed is Live or On Demand.
Dash.js
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.
- Stall End (Ad) (Google IMA) - Event fired when video starts playing again after a stall and the buffer has been replenished and playback resumes.
- Stall Start (Ad) (Google IMA) - Stall Start event is triggered when playback of video stops because the buffer has been depleted causing an unexpected interruption for the user.
Fluxdata
- Buffer Duration - Ads - Cumulative time that content has been buffering during ad playback in current Content Session.
- Number of Ad Plays - Running count of the number of ads played during the user's current session.
- Stall Count - Ads - Number of times the user's playback of Ads has been interrupted by an unexpected video stall due to buffer depletion.
- 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.
- Time Since Last Ad Break Start - Time interval since the current pod of advertisements began.
- Time Since Last Ad Completed - Time interval since the last advertisement completed.
- Time Since Last Ad Request - Time interval since advertisement was requested.
- Time Since Last Ad Started - Time interval since advertisement started playing.
- Time Since Last Buffer Start - Ad - Time interval since Buffer Start event began during advertisement playback.
- Time Since Last Milestone - Ad - Time interval since Milestone event was last sent for ad.
- Time Since Last Stall Start - Ad - Time interval since Stall Start event began during advertisement playback.
- 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 Blocker - States whether an Ad Blocker was detected or not.
- Ad Duration - The length of the advertisement in seconds.
- Buffer Length (CMCD) - The buffer length associated with the media object being requested.
- 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.
- Next Object Request (CMCD) - 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.
- 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.
- 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].
- 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.
ExoPlayer
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.
Fluxdata
- Buffer Duration - Content - Cumulative time that content has been buffering during content playback in current Content Session.
- Buffer Length - The amount of media currently stored in the player buffer waiting to be played.
- 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.
- 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.
- Rendition Video Bitrate - Target bitrate of the currently selected video rendition from the manifest. The manifest may contain multiple versions (i.e. renditions) of the video encoded at varying qualities to support varying network conditions.
- 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 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.
- Time Since Last Stall Start - Content - Time interval since Stall Start event began during content playback.
- Autostart - Returns whether the audio/video should start playing as soon as it is loaded
- Content Session ID - A unique id for the current video playback session.
- Device Manufacturer - Manufacturer of the user's device.
- Device Name - Name of the device model used by the viewer.
- Device Type - Describes the type of device category being used during the session such as phone, tablet, desktop, connected device, game console, etc.
- Duration - The total length of the media file, reported in decimal seconds
- Orientation - The directional orientation that the user is holding their mobile device.
- Streaming Type - Describes if the content being streamed is Live or On Demand.
- Title - Provides the title of current asset being played
- User Agent - Contains a number of tokens that refer to aspects of the user device, including the user's browser name and version, rendering engine, device’s model number, operating system and its version, etc.
HLS.js
Events
- Heartbeat - Periodic event that provides updated insight into all of the selected FluxData metrics fired at the specified Heartbeat interval.
- Media Loaded (Content) - Fired when the video is fully loaded into the player & ready to begin playback.
- Media Request (Content) - Event signifies the video player requests the video from the server. The could be triggered by the user clicking on a play button of a thumbnail. If the video is played automatically, this may be fired when the player starts loading.
- Pause (Content) - Pause event is fired when the player enters a paused state. This can be triggered when the user hits the Pause button to temporarily halt video playback or it can occur as part of the player's normal state changes as media is loading, resuming or concluding.
- Playback Complete (Content) - This event signifies that the video player has reached the end of the currently playing content.
- Playback Start (Content) - This event is fired when the video starts playing for the user, also known as First Frame.
- Player Ready - Signifies when the player has been initialized and is ready for playback.
- Playing (Content) - The media is no longer blocked from playback, and has started playing. Fired when playback resumes from Stall, Buffering or Seek.
- 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
- Bandwidth - Amount of estimated network bandwidth currently available to the end user's device.
- Player State - Returns the player's current playback state. (Idle, buffering, playing, paused)
- Playhead Position - Returns the current point in the video timeline in seconds.
- Rendition Video Bitrate - Target bitrate of the currently selected video rendition from the manifest. The manifest may contain multiple versions (i.e. renditions) of the video encoded at varying qualities to support varying network conditions.
- Time Since Last Heartbeat - Time interval since Heartbeat was last sent for the current content session.
- ASN - Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end-user. Client ASN as determined from a lookup of the client IP
- ASN Org - The organization that owns the Autonomous System Number. Often an ISP, sometimes a private company or institution.
- Browser Name - Web browser being used during the session
- Browser Version - Version of web browser being used during the session
- City - The city or town where the user is located
- Client IP Address - IP address of the user's device
- Client Timestamp - Client side timestamp of the event in epoch milliseconds
- Content Session ID - A unique id for the current video playback session.
- Country - Full name of the user's country
- Country Code - The country from which the browser initiated the event. For a list of country codes, see ISO 3166-1 alpha-2 .
- Device ID - Unique identifier of the user's device.
- Device Type - Describes the type of device category being used during the session such as phone, tablet, desktop, connected device, game console, etc.
- ISP - Name of the end-user's internet service provider.
- Latitude - Location information for the user
- Longitude - Location information for the user
- Media Type (Content) - Specifies whether the event relates to an Ad or Content asset.
- OS Name - Operating System of the user's device
- OS Version - Version of Operating System being used during the session
- Player Name - States which video player generated the event
- Player Version - States the version of the video player that generated the event
- Postal Code - The specific administrative division within a country where the event occurred. In the United States, zip codes correspond to postal region locator
- Region - The specific administrative division within a country where the event occurred. In the United States, regions correspond to state names ; for example, Washington or New York.
- Region Code - The specific administrative division within a country where the event occurred. In the United States, regions correspond to state codes ; for example, WA or NY.
- User Agent - Contains a number of tokens that refer to aspects of the user device, including the user's browser name and version, rendering engine, device’s model number, operating system and its version, etc.
HTML5
Events
- Subtitle Change (Content) - Fired when the user enables or disables subtitles or closed captioning.
FluxData
- 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.
- Subtitles - Describes if subtitles are currently enabled for playback.
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.
- Volume Change (Ad) - Triggered when the player increases or decreases the audio level of the video.
tvOS
Events
- Error (Ad) (Google IMA) - Thrown if an error occurs during content playback or retrieval of the video
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.
- Time Since Last Ad Completed - Time interval since the last advertisement completed.
- Time Since Last Ad Started - Time interval since advertisement started playing.
- Time Since Last Milestone - Ad - Time interval since Milestone event was last sent for ad.
- 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.
- Error Code (Ad) (Google IMA) - Error object representing a code explicitly identified by the player
- Error Message (Ad) (Google IMA) - Error object representing a message about the error explicitly identified by the player
- 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].
Video.js
Events
- 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.
Fluxdata
- Buffer Length - The amount of media currently stored in the player buffer waiting to be played.
- Player Viewable - Is 50% or more of the player visible on the screen at the time of event?
- Player Viewable Percent - The percentage of the player that is viewable on the screen at the time of the event.
- 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.
- 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 Ad Break Start - Time interval since the current pod of advertisements began.
- Time Since Last Ad Completed - Time interval since the last advertisement completed.
- Time Since Last Ad Request - Time interval since advertisement was requested.
- Time Since Last Ad Started - Time interval since advertisement started playing.
- Time Since Last Milestone - Ad - Time interval since Milestone event was last sent for ad.
- 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
- 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 Blocker - States whether an Ad Blocker was detected or not.
- Browser Height - The height of the end user's browser window at the time when the event occurred.
- Browser Width - The width of the end user's browser window at the time when the version occurred.
- Streaming Protocol - What streaming format is being used for the content?
- Streaming Type - Describes if the content being streamed is Live or On Demand.
|
---|
Comments
0 comments
Article is closed for comments.