Events
Ad Break Start
event
Fired at the beginning of an advertising pod, signifies that content has been delayed while the advertisements are played.
Applicable for: Live, VOD, Ad
Node Location: event.type
Ad Break End
event
Fired at the end of an advertising pod, signifies that the advertisements have ended and content is ready to resume.
Applicable for: Live, VOD, Ad
Node Location: event.type
Ad Click
event
Triggered when the user interacts with an advertisement
Use Case
How many users clicked on a call-to-action link for a given ad?
Applicable for: Live, VOD, Ad
Node Location: event.type
Ad Complete
event
Fired when an ad completes playing back
Use Case
What percentage of users watched the entire ad?
Applicable for: Live, VOD, Ad
Node Location: event.type
Ad Error
event
Thrown if an error occurs during ad playback or retrieval of an ad
Use Case
How many errors occurred in the video player during ad playback?
Applicable for: Live, VOD, Ad
Node Location: event.type
Ad Impression
event
Fired when an Ad impression is recorded by the video player.
Use Case
Count how many times a single ad was presented to a user.
Applicable for: Live, VOD, Ad
Node Location: event.type
Ad Loaded
event
Fired when the ad is fully loaded into the player & ready to begin playback.
Applicable for: Ad
Node Location: event.type
Ad Pause
event
Fired when the ad is paused. Depending on your implementation pausing an ad may not be allowed.
Use Case
Track the number of times a user decided to pause an ad during playback.
Applicable for: Live, VOD, Ad
Node Location: event.type
Ad Play
event
Fired whenever an ad starts playing or when an ad is unpaused.
Applicable for: Live, VOD, Ad
Node Location: event.type
Ad Rendition Change
event
When the Player's Adaptive Bitrate Streaming upshifts or downshifts during Content Playback to a different quality level available in the manifest.
Use Case
How often does an ad change quality during playback due to network bandwidth conditions?
Applicable for: Live, VOD, Ad
Node Location: event.type
Ad Request
event
When ad is requested from the ad server.
Use Case
Compare how many ads were requested versus how many were actually played to get a delivery percentage.
Applicable for: Live, VOD, Ad
Node Location: event.type
Ad Resume
event
When playback of the ad is resumed after being paused.
Use Case
What percentage of users continued watching the ad after initially pausing playback?
Applicable for: Live, VOD, Ad
Node Location: event.type
Ad Skip
event
This event is triggered when a user chooses to skip the currently playing ad and go directly to the content..
Use Case
Calculate a percentage of users who completed entire playback of the ad vs those who chose not to watch it.
Applicable for: Live, VOD, Ad
Node Location: event.type
Audio Track Changed
event
This event signifies when the user has chosen to switch to a different audio track during playback.
Use Case
Count the number of times that users choose an alternate language audio track instead of the default language.
Applicable for: Ads, Content, Live, VOD
Node Location: event.type
Buffer Start
event
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.
Use Case
Monitor the number of delays of user playback caused by waiting for video to load.
Applicable for: Ad, Content, Live, VOD
Node Location: event.type
Buffer End
event
Event is fired when video starts playing again after a buffer is completed.
Use Case
Compare the number of times video successfully resumed playing after buffering with the total number of Buffering events to see what percentage of buffers were irrecoverable.
Applicable for: Content, Live, VOD
Node Location: event.type
Cast Start
event
Fired when a user sends a stream from their local device to a remote screen.
Use Case
Calculate how often users of the application choose to watch their video on a remote device.
Applicable for: Ads, Content, Live, VOD
Node Location: event.type
Cast End
event
Fired when a user ends streaming on a remote screen & returns playback to their local device.
Use Case
Calculate how long a video session was streamed on a remote device.
Applicable for: Ads, Content, Live, VOD
Node Location: event.type
Content Loaded
event
Fired when the video is fully loaded into the player & ready to begin playback.
Use Case
Part of the startup sequence of video playback so you can identify time taken to complete each step.
Applicable for: Content, Live, VOD
Node Location: event.type
Custom Event
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.
Use Case
Record that a user entered a comment on the video during playback. Capture a button from outside the player that was pressed by the user during video playback.
Applicable for: Ads, Content, Live, VOD
Node Location: event.type
Error
event
Thrown if an error occurs during content playback or retrieval of the video
Use Case
How many errors occurred in the video player during content playback?
Applicable for: Content, Live, VOD
Node Location: event.type
Exit Fullscreen
event
Triggered when user exits fullscreen mode during video playback
Use Case
Used to determine how often users are switching from in-page playback to a full screen experience.
Applicable for: Ads, Content, Live, VOD
Node Location: event.type
Fullscreen
event
Triggered when user enters fullscreen mode during video playback
Use Case
Used to determine how often users are switching from in-page playback to a full screen experience.
Applicable for: Ads, Content, Live, VOD
Node Location: event.type
Heartbeat
event
Periodic event that contains all of the selected FluxData metrics fired at the specified Heartbeat interval.
Use Case
This heartbeat event can be used for creating time-series charts tracking a user's quality of experience during their playback session.
Applicable for: Ad, Content, Live, VOD
Node Location: event.type
Idle
event
This event signifies that the video player has reached an state where there is no present activity. The user has stopped playback or the video player is loaded and waiting for the next piece of content to be selected.
Use Case
Use this event to track activities a user may be performing on other parts of the app while the video player is inactive.
Applicable for: Ads, Content, Live, VOD
Node Location: event.type
Milestone
event
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.
Use Case
What percentage of users made it to various checkpoints in the video timeline.
Applicable for: Ad, Content, Live, VOD
Node Location: event.type
Mute
event
Triggered when the player volume has been reduced to zero.
Applicable for: Ads, Content, Live, VOD
Node Location: event.type
Pause
event
Event is fired when user hits the Pause button and chooses to temporarily halt video playback.
Applicable for: Content, Live, VOD
Node Location: event.type
Play
event
Event is fired when a user initiates video playback.
Use Case
Count the number of playback attempts within the app & compare against successful video starts.
Applicable for: Content, Live, VOD
Node Location: event.type
Play Request
event
Event signifies the video player requests the video from the server. The trigger could be 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
Use Case
Identify problems that may be occurring in the video player which prevent successful playback after a user requests a video
Applicable for: Content, Live, VOD
Node Location: event.type
Playback Start
event
This event is fired when the video starts playing & is viewable by the user.
Use Case
Use this to determine the period of time between a user pressing play and the same user viewing their content
Applicable for: Ad, Content, Live, VOD
Node Location: event.type
Playback Complete
event
This event signifies that the video player has reached the end of the currently playing content.
Use Case
Compare the number of Play Requests with the number of Playback Complete events to get a percentage of users who watched the entire video.
Applicable for: Content, VOD
Node Location: event.type
Player Ready
event
Signifies when the player has been initialized and is ready for playback. This is the earliest point at which any API calls should be made
Applicable for: Content, Live, VOD
Node Location: event.type
Playing
event
The media is no longer blocked from playback, and has started playing.
Applicable for: Content, Live, VOD
Node Location: event.type
Quality Change Request
event
This event signifies when the user selects a different preferred playback quality. This is usually represented as a High, Med, Low setting that the user can select depending on their network capability. This event is different than Rendition Change which is fired automatically as video quality is adjusted dynamically as a response to actual network conditions.
Use Case
How many users proactively decide to select a lower quality level to presumably improve playback performance.
Applicable for: Ad, Content, Live, VOD
Node Location: event.type
Rendition Change
event
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.
Use Case
How often does an video change quality during playback due to network bandwidth conditions?
Applicable for: Content, Live, VOD
Node Location: event.type
Resize
event
Fired when the player's on-page dimensions have changed. Is not fired in response to a fullscreen change.
Use Case
Understand how many users are changing the video player dimensions during video playback.
Applicable for: Ads, Content, Live, VOD
Node Location: event.type
Resume
event
This event is fired when the user hits the play button after pausing video during playback.
Use Case
Compare the amount of time elapsed between user hitting the Pause event and then resuming playback.
Applicable for: Content, Live, VOD
Node Location: event.type
Seek Start
event
Event records when the user interacts with content timeline by moving the playhead position forward or backwards to jump to a specific point on the timeline.
Use Case
Count the number of times users choose to seek to another part of the video.
Applicable for: Ad, Content, Live, VOD
Node Location: event.type
Seek End
event
Event is fired when the user stops moving the playhead position forward or backwards to jump to a specific point on the timeline. This event includes attributes seekStartPoint & seekEndPoint to mark the starting & ending points of a seek event, representing the content timecode in milliseconds
Use Case
Determine what parts of a video were skipped over or re-watched frequently.
Applicable for: Ad, Content, Live, VOD
Node Location: event.type
Session End
event
Event is fired after a user session is considered closed. This would happen after playback & user interactions have ceased for 20 mins.
Applicable for: Ads, Content, Live, VOD
Node Location: event.type
Stall Start
event
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 is also considered a Buffer Start so both events will fire.
Use Case
Monitor the number of interruptions of user playback caused by waiting for video to load.
Applicable for: Ad, Content, Live, VOD
Node Location: event.type
Stall End
event
Event fired when video starts playing again after a stall and the buffer has been replenished and playback resumes.
Use Case
Compare the number of times video successfully resumed playing after an interruption with the total number of Stall events to see what percentage of interruptions were irrecoverable.
Applicable for: Ad, Content, Live, VOD
Node Location: event.type
Subtitle Change
event
Fired when the user enables or disables subtitles or closed captions.
Applicable for: Content, Live, VOD, Ad
Node Location: event.type
Unmute
event
Triggered the player audio has been reactivated.
Applicable for: Ads, Content, Live, VOD
Node Location: event.type
Volume Change
event
Triggered when the player increases or decreases the audio level of the video.
Applicable for: Ads, Content, Live, VOD
Node Location: event.type
FluxData
bandwidth
fluxdata
Amount of estimated network bandwidth currently available to the end user's device.
Use Case
Am I delivering a higher quality video asset to the user than their network connection can handle?
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Unit: bits per second
Max Decimals: 0
bitrate
fluxdata
The bits per second of the currently selected asset from the video manifest. This is a proxy for quality and a good determinant of overall delivery costs/network consumption.
Use Case
What is the average bitrate of all videos delivered to my users?
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Unit: kb/s
Max Decimals: 0
bufferFill
fluxdata
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.
Use Case
Are buffering events directly related to low and frequent bufferFill levels?
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Unit: percentage
Max Decimals: 3
Scale: 0 .. 100
currentAudioTrack
fluxdata
Identifies which audio track available for the content has been selected by the user. Multiple audio tracks are usually used for alternate languages. Values returned may vary by content publisher & player.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: event.metrics
Permitted Values: any
currentCaptions
fluxdata
Identifies which subtitle or closed captioning track available for the content has been selected by the user. Multiple captioning tracks are usually used for alternate languages. Values returned may vary by content publisher & player.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: event.metrics
Permitted Values: any
engagementDuration
fluxdata
Cumulative time that user has been engaged with the page, including time spent not viewing video.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
engagementDurationAds
fluxdata
Cumulative time the player has spent playing and buffering Ads.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
engagementDurationContent
fluxdata
Cumulative time the player has spent playing and buffering Content.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
numberOfAds
fluxdata
Running count of the number of ads played during the user's current session.
Use Case
Analyze if the number of ads shown directly affects the length of a viewer's session.
Applicable for: Ad, Live, VOD
Field Type: numeric
Node Location: event.metrics
Unit: ads
Max Decimals: 0
numberOfErrors
fluxdata
Running count of the number of errors that have occurred during the user's current session.
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Unit: errors
Max Decimals: 0
numberOfVideos
fluxdata
The amount of unique videos watched during the current viewing session
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Unit: videos
Max Decimals: 0
playbackDuration
fluxdata
Cumulative time that content & ads have been playing during the current video View. Excludes time accrued while user pauses content or buffering. Value is reset to zero at the start of a new video View.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
playbackDurationAds
fluxdata
Cumulative time that ads have been playing during the current video View. Excludes time accrued while user pauses content or buffering.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
playbackDurationContent
fluxdata
Cumulative time that content has been playing during the current video Session View. Excludes time accrued while user pauses content.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
playbackRate
fluxdata
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
Use Case
If users prefer to watch your content at a sped up rate, does this mean you should alter the type of content you produce?
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Unit: percentage
Max Decimals: 2
playbackStallCount
fluxdata
Number of times the user's playback has been interrupted by an unexpected video stall due to buffer depletion during a View.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: count
Max Decimals: 0
playbackStallCountAds
fluxdata
Number of times the user's playback of Ads has been interrupted by an unexpected video stall due to buffer depletion during a View.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: count
Max Decimals: 0
playbackStallCountContent
fluxdata
Number of times the user's playback of Content has been interrupted by an unexpected video stall due to buffer depletion during a View.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: count
Max Decimals: 0
playbackStallDuration
fluxdata
The cumulative amount of time elapsed where the user's playback has been interrupted by an unexpected video stall due to buffer depletion during a View.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
playbackStallDurationAds
fluxdata
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 during a View.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
playbackStallDurationContent
fluxdata
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 during a View.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
playerState
fluxdata
Returns the player's current playback state. (Idle, buffering, playing, paused)
Use Case
Correlate the current state of the video player with other activities or actions that are occurring with the user during a session.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: event.metrics
Permitted Values: any
playerViewable
fluxdata
Is 50% or more of the player visible on the screen at the time of event?
Applicable for: Ad, Content, Live, VOD
Field Type: bool
Node Location: event.metrics
Permitted Values: value list
Value List: true, false
playerViewablePercent
fluxdata
The percentage of the player that is viewable on the screen at the time of event
Use Case
Determine your own threshold of viewability by getting the exact amount of the video is within view of the user.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: percentage
Max Decimals: 3
Scale: 0 .. 100
playheadPosition
fluxdata
Returns the current point in the video timeline in seconds.
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Unit: seconds
Max Decimals: 3
renditionAudioBitrate
fluxdata
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.
Use Case
Use rendition attributes to determine if the correct version of the video is being delivered to the client to match the users bandwidth, device & resolution.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: kb/s
Max Decimals: 0
renditionHeight
fluxdata
Height in pixels of the rendition being played. The manifest may contain multiple versions (i.e. renditions) of the video encoded at varying qualities to support varying network conditions.
Use Case
Use rendition attributes to determine if the correct version of the video is being delivered to the client to match the users bandwidth, device & resolution.
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Unit: pixels
Max Decimals: 0
renditionName
fluxdata
Standardized name to represent the rendition currently being played.
Use Case
Use rendition attributes to determine if the correct version of the video is being delivered to the client to match the users bandwidth, device & resolution.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: event.metrics
Permitted Values: any
renditionVideoBitrate
fluxdata
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.
Use Case
Use rendition attributes to determine if the correct version of the video is being delivered to the client to match the users bandwidth, device & resolution.
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Unit: k/bits per second
Max Decimals: 0
renditionWidth
fluxdata
Width of the rendition being played. The manifest may contain multiple versions (i.e. renditions) of the video encoded at varying qualities to support varying network conditions.
Use Case
Use rendition attributes to determine if the correct version of the video is being delivered to the client to match the users bandwidth, device & resolution.
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Unit: pixels
Max Decimals: 0
timeSinceStarted
fluxdata
Time interval since current content playback began., reported in milliseconds
Applicable for: Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Unit: milliseconds
Max Decimals: 0
timeSinceAdStarted
fluxdata
Time interval since advertisement started playing, reported in milliseconds
Applicable for: Ad, Live, VOD
Field Type: numeric
Node Location: event.metrics
Unit: milliseconds
Max Decimals: 0
timeSinceAdBreakStart
fluxdata
Time interval since the current pod of advertisements began., reported in milliseconds. Value is reset to zero at the start of a new video View or when Ad Break Start event occurs.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
timeSinceAdBufferStart
fluxdata
Time interval since Buffer Start event began during advertisement playback, reported in milliseconds. Value is reset to zero at the start of a new video View or when another Buffer Start event occurs.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
timeSinceAdPaused
fluxdata
Time interval since advertisement was paused, reported in milliseconds
Applicable for: Ad, Live, VOD
Field Type: numeric
Node Location: event.metrics
Unit: milliseconds
Max Decimals: 0
timeSinceAdRequested
fluxdata
Time interval since advertisement was requested, reported in milliseconds
Applicable for: Ad, Live, VOD
Field Type: numeric
Node Location: event.metrics
Unit: milliseconds
Max Decimals: 0
timeSinceAdSeekStart
fluxdata
Time interval since the occurrence of an Ad Seek Start event, reported in milliseconds. Value is reset to zero at the start of a new video View or when Ad Seek Start event occurs.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
timeSinceAdStallStart
fluxdata
Time interval since Stall Start event began during advertisement playback, reported in milliseconds. Value is reset to zero at the start of a new video View or when another Stall Start event occurs.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
timeSinceBufferStart
fluxdata
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.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
timeSinceLastAd
fluxdata
Time interval since the last advertisement completed., reported in milliseconds
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Unit: milliseconds
Max Decimals: 0
timeSinceLastAdHeartbeat
fluxdata
Time interval since Heartbeat event was last sent for an advertisement, reported in milliseconds. Value is reset to zero at the start of a new video View or when another Ad Heartbeat event occurs.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
timeSinceLastAdMilestone
fluxdata
Time interval since Heartbeat event was last sent for content, reported in milliseconds. Value is reset to zero at the start of a new video View or when another Heartbeat event occurs.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
timeSinceLastHeartbeat
fluxdata
Time interval since Heartbeat was last sent for the current content, reported in milliseconds
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
timeSinceLastMilestone
fluxdata
Time interval since Heartbeat event was last sent for content, reported in milliseconds. Value is reset to zero at the start of a new video View or when another Heartbeat event occurs.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
timeSinceLastRenditionChange
fluxdata
Time interval since content playback shifted to a different available quality version from the manifest., reported in milliseconds
Applicable for: Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Unit: milliseconds
Max Decimals: 0
timeSincePaused
fluxdata
Time interval since content playback was paused., reported in milliseconds
Applicable for: Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Unit: milliseconds
Max Decimals: 0
timeSinceRequested
fluxdata
Time interval since content playback was requested, reported in milliseconds
Applicable for: Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Unit: milliseconds
Max Decimals: 0
timeSinceSeekStart
fluxdata
Time interval since the occurrence of a Seek Start event, reported in milliseconds. Value is reset to zero at the start of a new video View or when Seek Start event occurs.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
timeSinceStallStart
fluxdata
Time interval since Stall 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 Stall Start event occurs.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
totalBufferTime
fluxdata
Cumulative time that content has been buffering during the current Session View. Reset the totalBufferTime when a new video starts during the session.
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Unit: milliseconds
Max Decimals: 0
viewStartTimestamp
fluxdata
Start time of a new video view for the current user session. (Epoch UTC). Typically a new View begins with a Playback Request.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
volumeLevel
fluxdata
The current playback volume as a whole number percentage.
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Unit: percentage
Max Decimals: 0
Scale: 0 .. 100
Event Attributes
absShift
metadata
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.
Use Case
Monitor how often the video player is downshifting video quality to account for network conditions.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: event.attributes
Permitted Values: value list
Value List: up, down
errorCode
metadata
Error object representing a code explicitly identified by the player
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: event.attributes
Permitted Values: any
errorMsg
metadata
Error object representing a message about the error explicitly identified by the player
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: event.attributes
Permitted Values: any
milestonePercent
metadata
Number indicating the percentage milestone represented by the event fired. Attribute of Content Milestone & Ad Milestone
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.attributes
Permitted Values: any
Unit: percentage
Max Decimals: 2
Scale: 0 .. 1
seekStartPoint
metadata
The starting point of a seek event, representing the content timecode in milliseconds. Value will appear as an attribute on Seek End events
Use Case
Determine where in the video timeline a user began a seek.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.attributes
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
seekEndPoint
metadata
The starting point of a seek event, representing the content timecode in milliseconds. Value will appear as an attribute on Seek End events
Use Case
Determine how much video time was covered during a user's seek event or if the seek was forward or backwards.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.attributes
Permitted Values: any
Unit: milliseconds
Max Decimals: 0
Message Metadata
timestamp
metadata
Epoch UTC time of the event occurrence
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: root
Unit: epoch
Max Decimals: 0
configuration_id
metadata
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.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: root
Permitted Values: UUID
connector_list
metadata
List of the Connectors configured for this Collector via a Datazoom Data Pipe.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: root
Permitted Values: comma separated list
customer_code
metadata
Unique identifier for the Datazoom customer that generated the event.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: root
Permitted Values: UUID
event_id
metadata
Unique identifier for each event message fired by a Collector.
Use Case
Provides a UUID that can be used for de-dupping records in the data platform or Connector.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: root
Permitted Values: any
type
metadata
Name of the event that describes the message
Use Case
event.type will be the key way to search for various events generated by the user.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: event
Permitted Values: any
CDN Data
cdn
metadata
Content Distribution Network name
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: cdn
Permitted Values: any
User Details
client_ip
metadata
IP address of the user's device
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: user_details
Permitted Values: IP address
session_id
metadata
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.
Use Case
This is the primary identifier for grouping events generated by Datazoom for analysis and unique user counts.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: user_details
Permitted Values: any
sessionStartTimestamp
metadata
Start time of the current user session
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: user_details
Unit: epoch
Max Decimals: 0
sessionEndTimestamp
metadata
End time of the current user session
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: user_details
Unit: epoch
Max Decimals: 0
user_agent
metadata
Contains a number of tokens that refer to various aspects of the request, including the user's browser name and version, rendering engine, device’s model number, operating system and its version, etc.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: user_details
Permitted Values: any
viewId
metadata
A unique id for the current video. It is composed of the session_id and an incremental number (1, 2, 3…). Watching the same video during multiple points in a session will create distinct viewId for each view.
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: user_details
Permitted Values: UUID incremented
Player
autoStart
metadata
Returns whether the audio/video should start playing as soon as it is loaded
Applicable for: Content, Live, VOD
Field Type: bool
Node Location: player
Permitted Values: value list
Value List: true, false
controls
metadata
Whether the controls are available for user interaction in the player. (i.e. Play/Pause/Seek)
Applicable for: Ads, Content, Live, VOD
Field Type: bool
Node Location: player
Permitted Values: value list
Value List: true, false
defaultMuted
metadata
Sets or returns whether the audio/video should be muted by default
Applicable for: Ads, Content, Live, VOD
Field Type: bool
Node Location: player
Permitted Values: value list
Value List: true, false
defaultPlaybackRate
metadata
Sets or returns the default 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
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: player
Unit: percentage
Max Decimals: 2
fullscreen
metadata
Is the player in fullscreen mode?
Applicable for: Ads, Content, Live, VOD
Field Type: bool
Node Location: player
Permitted Values: value list
Value List: true, false
isMuted
metadata
True if player is muted.
Applicable for: Ads, Content, Live, VOD
Field Type: bool
Node Location: player
Permitted Values: value list
Value List: true, false
loop
metadata
Returns whether the audio/video is programmed to start over again when finished
Applicable for: Content, Live, VOD
Field Type: bool
Node Location: player
Permitted Values: value list
Value List: true, false
playerName
metadata
States which video player that generated the event
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: player
Permitted Values: any
playerVersion
metadata
States the version of the video player that generated the event
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: player
Permitted Values: any
preload
metadata
Sets or returns whether the audio/video should be loaded when the page loads
Applicable for: Ads, Content, Live, VOD
Field Type: bool
Node Location: player
Permitted Values: value list
Value List: true, false
readyState
metadata
Returns the current ready state of the audio/video
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: player
Permitted Values: any
streamingProtocol
metadata
What streaming format is being used for the content?
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: player
Permitted Values: value list
Value List: MPEG-DASH, HLS, HDS, Smooth, WebRTC, RTMP, RTSP, Flash, MP4, MPEG2-TS, 3GPP, Quicktime, AVI, Windows Media
streamingType
metadata
Describes if the content being streamed is Live or on demand.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: player
Permitted Values: value list
Value List: Live, VOD
subtitles
metadata
Describes if subtitles are current enabled for playback.
Applicable for: Ad, Live, Content, VOD
Field Type: bool
Node Location: player
Permitted Values: value list
Value List: true, false
Device
adTrackingOptOut
metadata
States if the user has opted out of advertising tracking on their device. Not applicable to web.
Use Case
This field can be used to omit users who don't send back personal information from certain types of analysis.
Applicable for: Live, VOD, Ad
Field Type: bool
Node Location: device
Permitted Values: value list
Value List: true, false
advertisingId
metadata
Advertising ID is a user resettable ID assigned by the device or operating environment for advertising purposes (e.g. targeting, frequency capping). The key difference between a Device ID and an Advertising ID is that advertising IDs can be reset by the user at any time. Examples include Apple's IDFA and Android's AAID.
Applicable for: Live, VOD, Ad
Field Type: string
Node Location: device
Permitted Values: any
browser
metadata
Web browser being used during the session
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: device
Permitted Values: any
browserHeight
metadata
The height of the end user's browser window at the time when the event occurred.
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: device
Unit: pixels
Max Decimals: 0
browserVersion
metadata
Version of web browser being used during the session
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: device
Permitted Values: any
browserWidth
metadata
The width of the end user's browser window at the time when the version occurred.
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: device
Unit: pixels
Max Decimals: 0
cookiesEnabled
metadata
Does the user's browser have cookies enabled?
Applicable for: Ads, Content, Live, VOD
Field Type: bool
Node Location: device
Permitted Values: value list
Value List: true, false
device_id
metadata
Unique identifier of the user's device.
Use Case
This can be used as a proxy for User if user is anonymous.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: device
Permitted Values: any
deviceMfg
metadata
Manufacturer of the user's device. Not always available.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: device
Permitted Values: any
deviceName
metadata
Name of the device model used by the viewer
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: device
Permitted Values: any
deviceType
metadata
Describes the type of device being used during the session. phone, tablet, desktop, connected device, game console
Use Case
Can be used to group attributes by device platform type for better understanding of app performance on different platforms.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: device
Permitted Values: value list
Value List: pc, mobile, tablet, ott device, tv, game console, wearable
orientation
metadata
The directional orientation that the user is holding their mobile device
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: device
Permitted Values: value list
Value List: landscape, portrait
os
metadata
Operating System of the user's device
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: device
Permitted Values: any
osVersion
metadata
Version of Operating System being used during the session
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: device
Permitted Values: any
Video
assetId
metadata
Unique identifier of the content shown. This may be produced by the CMS or publishing system.
Use Case
This identifier will allow an analyst to group events from various users & various sessions that are all viewing the same content or ad asset.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: video
Permitted Values: any
description
metadata
A brief description of the content being played, this description may be internal to the CMS or may be displayed to the end user as part of their effort to select content to view.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: video
Permitted Values: any
duration
metadata
The total length of the media file, reported in decimal seconds
Applicable for: Ads, Content, VOD
Field Type: numeric
Node Location: video
Unit: seconds
Max Decimals: 3
frameRate
metadata
The frames per second of the current video encoding.
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: video
Unit: frames per second
Max Decimals: 2
playerHeight
metadata
Height dimension in pixels of the current playback area.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: video
Permitted Values: any
Unit: pixels
Max Decimals: 0
playerWidth
metadata
Width dimension in pixels of the current playback area.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: video
Permitted Values: any
Unit: pixels
Max Decimals: 0
source
metadata
Returns the URL of the current media file
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: video
Permitted Values: URL
title
metadata
Provides the title of current asset being played
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: video
Permitted Values: any
videoType
metadata
Is this Ad or Content?
Applicable for: Ads, Content, Live, VOD, Ad
Field Type: string
Node Location: video
Permitted Values: value list
Value List: Ad, Content
Location
city
metadata
The city or town where the user is located
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: geo_location
Permitted Values: any
country
metadata
Full name of the user's country
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: geo_location
Permitted Values: any
countryCode
metadata
The country from which the browser initiated the event. For a list of country codes, see ISO 3166-1 alpha-2 .
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: geo_location
Permitted Values: 2 letter code
latitude
metadata
Location information for the user
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: geo_location
Unit: degrees
Max Decimals: 4
Scale: -90 .. 90
longitude
metadata
Location information for the user
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: geo_location
Unit: degrees
Max Decimals: 4
Scale: -180 .. 180
region
metadata
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.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: geo_location
Permitted Values: any
regionCode
metadata
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.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: geo_location
Permitted Values: 2 letter code
zipCode
metadata
The specific administrative division within a country where the event occurred. In the United States, zip codes correspond to postal region locator
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: geo_location
Permitted Values: any
Network
asn
metadata
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
Use Case
ASN is a proxy for the customer's ISP which can be used for analyzing usage by ISP to identify problems that might be related a specific part of the ISP infrastructure.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: network
Permitted Values: any
asnOrganization
metadata
The organization that owns the Autonomous System Number. Often an ISP, sometimes a private company or institution.
Use Case
ASN is a proxy for the customer's ISP which can be used for analyzing usage by ISP to identify problems that might be related to the ISP
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: network
Permitted Values: any
connectionType
metadata
The type of network connection currently being used to access the content
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: network
Permitted Values: value list
Value List: WiFi, Mobile, LAN
isp
metadata
Name of the end-user's internet service provider.
Use Case
Can be used for analyzing usage by ISP to identify problems that might be related to the ISP
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: network
Permitted Values: any
Page
dzSdkVersion
metadata
Version number of the Datazoom SDK that generated the event message.
Use Case
Used for troubleshooting data issues or isolating data differences stemming from alternate versions of the SDK used.
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: page
Permitted Values: Any
pageTitle
metadata
The Title of the page from which the view originated.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: page
Permitted Values: any
pageUrl
metadata
The address of the page from which the view originated.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: page
Permitted Values: URL
referrerUrl
metadata
The URL of the page that loaded before the event occurred.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: page
Permitted Values: URL
siteDomain
metadata
URL Domain of the site hosting the video player.
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: page
Permitted Values: any
Ad Data
adBlocker
metadata
Whether an Ad Blocker was detected or not.
Applicable for: Ad, Content, Live, VOD
Field Type: bool
Node Location: ad
Permitted Values: value list
Value List: True,False
adCampaignId
metadata
Unique identifier of the advertising campaign that the current ad belongs to.
Use Case
Used to group different ad creative versions that are related as part of an overall campaign.
Applicable for: Live, VOD, Ad
Field Type: string
Node Location: ad
Permitted Values: any
adClickUrl
metadata
URL opened when the user interacts with an ad during playback.
Applicable for: Live, VOD, Ad
Field Type: string
Node Location: ad
Permitted Values: URL
adCreativeId
metadata
Creative ID of the ad shown.
Use Case
Creative ID is used to identify the same ad displayed across different sites.
Applicable for: Live, VOD, Ad
Field Type: string
Node Location: ad
Permitted Values: any
adId
metadata
ID of the ad shown.
Applicable for: Live, VOD, Ad
Field Type: string
Node Location: ad
adPartner
metadata
Name of the partner showing the ad.
Use Case
Understand the source, publisher or advertiser who is responsible for displaying the ad on the service.
Applicable for: Live, VOD, Ad
Field Type: string
Node Location: ad
Permitted Values: any
adPosition
metadata
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.
Applicable for: Live, VOD, Ad
Field Type: string
Node Location: ad
Permitted Values: value list
Value List: pre, mid, post
adSkipped
metadata
Shows if user chose to skip the ad during playback
Applicable for: Live, VOD, Ad
Field Type: bool
Node Location: ad
Permitted Values: value list
Value List: true, false
adSystem
metadata
The source ad server information included in the ad response.
Applicable for: Ad
Field Type: string
Node Location: ad
Permitted Values: any
adTimeOffset
metadata
Returns the content time offset at which the current ad pod was scheduled. For pods in VOD streams with dynamically inserted ads, stream time is returned.
Applicable for: Ad
Field Type: numeric
Node Location: ad
Permitted Values: any
Unit: seconds
advertiserName
metadata
The advertiser name as defined by the serving party.
Applicable for: Ad
Field Type: string
Node Location: ad
Permitted Values: any
creativeId
metadata
Retrieves the ID of the selected creative for the ad.
Applicable for: Ad
Field Type: string
Node Location: ad
Permitted Values: any
dealId
metadata
Returns the first deal ID present in the wrapper chain for the current ad, starting from the top. Returns the empty string if unavailable.
Applicable for: Ad
Field Type: string
Node Location: ad
Permitted Values: any
innerError
metadata
Returns the error that occurred during processing, or null if this information is unavailable.
Applicable for: Ad
Field Type: string
Node Location: ad
Permitted Values: any
skipTimeOffset
metadata
The number of seconds of playback before the ad becomes skippable. -1 is returned for non skippable ads or if this is unavailable.
Applicable for: Ad
Field Type: numeric
Node Location: ad
Permitted Values: any
Unit: seconds
wrapperCreativeIds
metadata
Selected creative IDs used for wrapper ads. The creative IDs returned starts at the inline ad and traverses to the outermost wrapper ad. An empty array is returned if there are no wrapper ads.
Applicable for: Ad
Field Type: array of string
Node Location: ad
Permitted Values: any
wrapperId
metadata
Ad IDs used for wrapper ads. The IDs returned starts at the inline ad (innermost) and traverses to the outermost wrapper ad. An empty array is returned if there are no wrapper ads.
Applicable for: Ad
Field Type: array of string
Node Location: ad
Permitted Values: any
wrapperSystems
metadata
Ad systems used for wrapper ads. The ad systems returned starts at the inline ad and traverses to the outermost wrapper ad. An empty array is returned if there are no wrapper ads.
Applicable for: Ad
Field Type: array of string
Node Location: ad
Permitted Values: any
Custom
customMetadata
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.
Applicable for: Ads, Content, Live, VOD
Node Location: custom
|
Comments
0 comments
Article is closed for comments.