Release Notes |
Data Points
Bitmovin
Events
- Ad Impression (Google IMA) - Fired when an Ad impression is recorded by the video player.
Fluxdata
- 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 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 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.
- 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.
Bitmovin (Android)
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.
- DZ SDK Version - Version number of the Datazoom SDK that generated the event message.
- Media Type (Content) - Specifies whether the event relates to an Ad or Content asset.
Bitmovin (Roku)
Events
- Buffer End (Content) - Event is fired when video starts playing again after a buffer is completed.
- Buffer Start (Content) - 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.
- Media Loaded (Content) - Fired when the video is fully loaded into the player & ready to begin playback.
- 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.
- Playback Complete (Content) - This event signifies that the video player has reached the end of the currently playing content.
- Playing (Content) - The media is no longer blocked from playback, and has started playing. Fired when playback resumes from Stall, Buffering or Seek.
- 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.
- 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 - Cumulative time that content & ads have been playing during the Content Session. Excludes time accrued while user pauses content or buffering.
- 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 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 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 Rendition Change - Time interval since content playback shifted to a different available quality version from the manifest., reported in milliseconds
- Time Since Last Seek Start - Time interval since the occurrence of a Seek Start event.
- Duration - The total length of the media file, reported in decimal seconds
- Milestone Percent (Content) - Number indicating the percentage milestone represented by the event fired. Attribute of Milestone events.
- 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 Protocol - What streaming format is being used for the content?
- Streaming Type - Describes if the content being streamed is Live or On Demand.
- 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.
Brightcove
Events
- Ad Break End (Google IMA) - Fired at the end of an advertising break, signifies that the advertisements have ended and content is ready to resume.
- Ad Break Start (Google IMA) - Fired at the beginning of an advertising break, signifies that content has been delayed while the advertisements are played.
- Ad Click (Google IMA) - Triggered when the user interacts with an advertisement
- Ad Impression (Google IMA) - Fired when an Ad impression is recorded by the video player.
- Ad Skip (Google IMA) - This event is triggered when a user chooses to skip the currently playing ad and go directly to the content..
- Buffer End (Ad) (Google IMA) - Event is fired when video starts playing again after a buffer is completed.
- Buffer End (Content) - 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.
- Buffer Start (Content) - 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.
- Custom Event - Add any user or system behavioral event to the Datazoom data stream. Requires custom coding on the page or in the app by customer developer.
- 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.
- Heartbeat - Periodic event that provides updated insight into all of the selected FluxData metrics fired at the specified Heartbeat interval.
- Media Loaded (Ad) (Google IMA) - Fired when the video is fully loaded into the player & ready to begin playback.
- Media Loaded (Content) - 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.
- 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 (Ad) (Google IMA) - This event signifies that the video player has reached the end of the currently playing content.
- Playback Complete (Content) - 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.
- 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 (Ad) (Google IMA) - The media is no longer blocked from playback, and has started playing. Fired when playback resumes from Stall, Buffering or Seek.
- 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.
- 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 End (Content) - 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.
- 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
- 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 - Ads - Cumulative time that content has been buffering during ad playback in current Content Session.
- Buffer Duration - Content - Cumulative time that content has been buffering during content playback in current Content Session.
- 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.
- 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.
- 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.
- 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 Last Buffer Start - Time interval since Buffer Start event began during playback.
- Time Since Last Buffer Start - Ad - Time interval since Buffer Start event began during advertisement 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.
- 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 Creative ID (Google IMA) - Creative ID of the ad shown.
- Ad Duration - The length of the advertisement in seconds.
- 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.
- Ad System (Google IMA) - The source ad server information included in the ad response.
- Ad Time Offset (Google IMA) - Returns the point in time during the content playback at which the current ad pod was scheduled to appear. For pods in VOD streams with dynamically inserted ads, stream time is returned.
- Advertiser Name (Google IMA) - The advertiser name as defined by the serving party.
- 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
- 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
- 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.
- 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 .
- Custom Metadata - Customers can add any user or system data to the Datazoom data stream. Requires custom coding on the page or in the app by customer developer.
- Customer Code - Unique identifier for the Datazoom customer that generated the event.
- 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.
- Duration - The total length of the media file, reported in decimal seconds
- 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
- Media Type (Ad) (Google IMA) - Specifies whether the event relates to an Ad or Content asset.
- 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.
- 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
- Skip Time Offset (Google IMA) - The number of seconds of playback before the ad becomes skippable. -1 is returned for non skippable ads or if this is unavailable.
- 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.
- Timestamp - Time of the event occurrence in Epoch UTC milliseconds.
- 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
Fluxdata
- 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 - Ads - Cumulative time that ads have been playing during the current Content Session. Excludes time accrued while user pauses content or buffering.
- 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 Seek Start - Time interval since the occurrence of a Seek Start event.
- 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.
- Asset ID - Unique identifier of the content shown. This may be produced by the CMS or publishing system.
- Client Timestamp - Client side timestamp of the event in epoch milliseconds
- Duration - The total length of the media file, reported in decimal seconds
- Page Title - The title of the page from which the event originated.
- Page URL - The address of the page from which the event originated.
- Site Domain - URL Domain of the site hosting the video player.
- Source - Returns the URL of the current media file
- 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.
- 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.
Events
- Ad Break End (Google IMA) - Fired at the end of an advertising break, signifies that the advertisements have ended and content is ready to resume.
- Ad Break Start (Google IMA) - Fired at the beginning of an advertising break, signifies that content has been delayed while the advertisements are played.
- 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.
- 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 Time Offset (Google IMA) - Returns the point in time during the content playback at which the current ad pod was scheduled to appear. For pods in VOD streams with dynamically inserted ads, stream time is returned.
Roku
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 (Ad) (Roku) - 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
- 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.
- Milestone Percent (Content) - Number indicating the percentage milestone represented by the event fired. Attribute of Milestone events.
- 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.
tvOS
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.
- Milestone (Ad) (Google IMA) - 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.
FluxData
- Number of Content Requests - The amount of content assets requested during the current user 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.
- Milestone Percent (Ad) (Google IMA) - 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.
- 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.
Video.js
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.
- App Session Start Timestamp - Start time of the current user session
- Duration - The total length of the media file, reported in decimal seconds
|
---|
Comments
0 comments
Article is closed for comments.