Release Notes |
Data Points
Events
- Error - Thrown if an error occurs during content playback or retrieval of the video
- Heartbeat - Periodic event that provides updated insight into all of the selected FluxData metrics fired at the specified Heartbeat interval.
- Milestone - 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.
- Pause - 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 - This event signifies that the video player has reached the end of the currently playing content.
- Playback Start - This event is fired when the video starts playing for the user, also known as First Frame.
- Resume - This event is fired when the user begins playing again after pausing the video during playback.
Fluxdata
- 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.
- Error Code - Error object representing a code explicitly identified by the player
- Error Message - Error object representing a message about the error explicitly identified by the player
- Milestone Percent - Number indicating the percentage milestone represented by the event fired. Attribute of Milestone events.
Dash.js
Fluxdata
- Engagement Duration - Cumulative time that user has been engaged with the page, including time spent not viewing video.
- Number of Content Plays - The amount of content assets watched during the current user 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.
- 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 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.
- 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.
- Player Name - States which video player generated the event
- Player Version - States the version of the video player that generated the event
- 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.
- Source - Returns the URL of the current media file
- Startup Duration - Content - This timer represents the total time a user spent waiting for content to begin playback excluding any time related to requesting, loading or playing pre-roll ads.
ExoPlayer
Events
- Player Ready - Signifies when the player has been initialized and is ready for playback.
- 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.
- City - The city or town where the user is located
- Client IP Address - IP address of the user's device
- Configuration ID - Datazoom Collector configuration ID. Allows customers to differentiate data on the Connector from different Collectors. This could be useful for separating test content from production data.
- 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 .
- Customer Code - Unique identifier for the Datazoom customer that generated the event.
- Device ID - Unique identifier of the user's device.
- DZ SDK Version - Version number of the Datazoom SDK that generated the event message.
- 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.
- Event Type - Name of the event that describes the type of user or system behavior that caused the event to fire.
- ISP - Name of the end-user's internet service provider.
- Latitude - Location information for the user
- Longitude - Location information for the user
- OS Name - Operating System of the user's device
- OS Version - Version of Operating System being used during the session
- 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.
- Timestamp - Time of the event occurrence in Epoch UTC milliseconds.
HTML5
Events
- Ad Impression (Google IMA) - Fired when an Ad impression is recorded by the video player.
- Media Loaded (Ad) (Google IMA) - Fired when the video is fully loaded into the player & ready to begin playback.
- Media Request (Ad) (Google IMA) - 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.
- Playback Complete (Ad) (Google IMA) - This event signifies that the video player has reached the end of the currently playing content.
- Playback Start (Ad) (Google IMA) - This event is fired when the video starts playing for the user, also known as First Frame.
- Playing (Ad) (Google IMA) - The media is no longer blocked from playback, and has started playing. Fired when playback resumes from Stall, Buffering or Seek.
- Stall End (Content) - Event fired when video starts playing again after a stall and the buffer has been replenished and playback resumes.
- Stall Start (Content) - 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 - Content - Cumulative time that content has been buffering during content playback in current Content Session.
- 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.
- 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.
Roku
Events
- Ad Break Start (Roku) - Fired at the beginning of an advertising break, signifies that content has been delayed while the advertisements are played.
- 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 (Content) - This event signifies that the video player has reached the end of the currently playing content.
Fluxdata
- Buffer Fill - Percent utilization of playback buffer for storing video segments before they are shown by the video player. A bufferFill near 100% indicates that the video segments are downloading quickly enough to keep pace with the video playback of the user & should produce minimal buffering interruptions.
- Ad Duration - The length of the advertisement in seconds.
- 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.
- App Session Start Timestamp - Start time of the current user session
- Milestone Percent (Ad) (Roku) - Number indicating the percentage milestone represented by the event fired. Attribute of Milestone 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.
THEOplayer
Fluxdata
- 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.
- Buffer Fill - Percent utilization of playback buffer for storing video segments before they are shown by the video player. A bufferFill near 100% indicates that the video segments are downloading quickly enough to keep pace with the video playback of the user & should produce minimal buffering interruptions.
- Number of Content Plays - The amount of content assets watched during the current user 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.
- Playback Duration - Cumulative time that content & ads have been playing during the Content Session. Excludes time accrued while user pauses content or buffering.
- 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.
|
---|
Comments
0 comments
Article is closed for comments.