Events
Ad Complete
event
Released in version 1.50
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 Impression
event
Released in version 1.50
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 Request
event
Released in version 1.50
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
Buffer Start
event
Released in version 1.54
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
Released in version 1.20
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
Content Loaded
event
Released in version 1.53.1
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
Released in version 1.51.2
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: Ad, Content, Live, VOD
Node Location: event.type
Datazoom Loaded
event
Released in version 1.51.2
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.
Applicable for: Ad, Content, Live, VOD
Node Location: event.type
Heartbeat
event
Released in version 1.51.2
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
Milestone
event
Released in version 1.53.1
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, VOD
Node Location: event.type
Mute
event
Released in version 1.23
Triggered when the player volume has been reduced to zero.
Applicable for: Ad, Content, Live, VOD
Node Location: event.type
Pause
event
Released in version 1.17
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
Released in version 1.17
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
Released in version 1.20
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
Released in version 1.48
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
Released in version 1.48
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
Released in version 1.20
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
Released in version 1.20
The media is no longer blocked from playback, and has started playing.
Applicable for: Content, Live, VOD
Node Location: event.type
Resume
event
Released in version 1.20
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
Released in version 1.54
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
Released in version 1.54
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
Stall Start
event
Released in version 1.54
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
Released in version 1.54
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
Unmute
event
Released in version 1.23
Triggered the player audio has been reactivated.
Applicable for: Ad, Content, Live, VOD
Node Location: event.type
FluxData
bitrate
fluxdata
Released in version 1.51.2
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: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Example Value: 3127
Unit: kb/s
Max Decimals: 0
bufferFill
fluxdata
Released in version 1.17
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: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Example Value: 80.26
Unit: percentage
Max Decimals: 3
Scale: 0 .. 100
numberOfAds
fluxdata
Released in version 1.50
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
Example Value: 3
Unit: ads
Max Decimals: 0
numberOfVideos
fluxdata
Released in version 1.20
The amount of unique content assets watched during the current viewing session.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Example Value: 2
Unit: videos
Max Decimals: 0
playbackDuration
fluxdata
Released in version 1.48
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
Example Value: 2468
Unit: milliseconds
Max Decimals: 0
playerState
fluxdata
Released in version 1.20
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: Ad, Content, Live, VOD
Field Type: string
Node Location: event.metrics
Permitted Values: any
Example Value: Ready
playheadPosition
fluxdata
Released in version 1.48
Returns the current point in the video timeline in seconds.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Example Value: 10.135
Unit: seconds
Max Decimals: 3
renditionAudioBitrate
fluxdata
Released in version 1.55
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
Example Value: 300
Unit: kb/s
Max Decimals: 0
renditionHeight
fluxdata
Released in version 1.55
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: Ad, Content, Live, VOD, Ad
Field Type: numeric
Node Location: event.metrics
Example Value: 720
Unit: pixels
Max Decimals: 0
renditionName
fluxdata
Released in version 1.55
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: Ad, Content, Live, VOD, Ad
Field Type: string
Node Location: event.metrics
Permitted Values: any
Example Value: 720p
renditionVideoBitrate
fluxdata
Released in version 1.55
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: Ad, Content, Live, VOD, Ad
Field Type: numeric
Node Location: event.metrics
Example Value: 3000
Unit: k/bits per second
Max Decimals: 0
renditionWidth
fluxdata
Released in version 1.55
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: Ad, Content, Live, VOD, Ad
Field Type: numeric
Node Location: event.metrics
Example Value: 1280
Unit: pixels
Max Decimals: 0
timeSinceStarted
fluxdata
Released in version 1.24
Time interval since current content playback began., reported in milliseconds
Applicable for: Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Example Value: 37
Unit: milliseconds
Max Decimals: 0
timeSincePaused
fluxdata
Released in version 1.24
Time interval since content playback was paused., reported in milliseconds
Applicable for: Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Example Value: 37
Unit: milliseconds
Max Decimals: 0
timeSinceRequested
fluxdata
Released in version 1.24
Time interval since content playback was requested, reported in milliseconds
Applicable for: Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Example Value: 37
Unit: milliseconds
Max Decimals: 0
viewStartTimestamp
fluxdata
Released in version 1.51.2
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
Example Value: 1589903189
Unit: milliseconds
Max Decimals: 0
Event Attributes
milestonePercent
metadata
Released in version 1.53.1
Number indicating the percentage milestone represented by the event fired. Attribute of Content Milestone & Ad Milestone
Applicable for: Ad, Content, VOD
Field Type: numeric
Node Location: event.attributes
Permitted Values: any
Example Value: 0.75
Unit: percentage
Max Decimals: 2
Scale: 0 .. 1
seekStartPoint
metadata
Released in version 1.54
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
Example Value: 5678
Unit: milliseconds
Max Decimals: 0
seekEndPoint
metadata
Released in version 1.54
The ending 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
Example Value: 8910
Unit: milliseconds
Max Decimals: 0
Message Metadata
configuration_id
metadata
Released in version 1.37
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: Ad, Content, Live, VOD
Field Type: string
Node Location: root
Permitted Values: UUID
Example Value: 3bba4192-8105-4498-ae34-587154d56fa6
connector_list
metadata
Released in version 1.37
List of the Connectors configured for this Collector via a Datazoom Data Pipe.
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: root
Permitted Values: comma separated list
Example Value: dz-connector-google-analytics,dz-connector-mixpanel
customer_code
metadata
Released in version 1.37
Unique identifier for the Datazoom customer that generated the event.
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: root
Permitted Values: UUID
Example Value: 3bba4192-8105-4498-ae34-587154d56fa6
event_id
metadata
Released in version 1.48
Unique identifier for each event message fired by a Collector or log file received by Datazoom.
Use Case
Provides a UUID that can be used for de-dupping records in the data platform or Connector.
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: root
Permitted Values: any
Example Value: 43DHE-EROILKER-EREOATE
timestamp
metadata
Released in version 1.48
Epoch UTC time of the event occurrence
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: event
Example Value: 1535971954488
Unit: epoch
Max Decimals: 0
type
metadata
Released in version 1.48
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: Ad, Content, Live, VOD
Field Type: string
Node Location: event
Permitted Values: any
User Details
client_ip
metadata
Released in version 1.19
IP address of the user's device
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: user_details
Permitted Values: IP address
Example Value: 173.19.65.222
session_id
metadata
Released in version 1.48
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: Ad, Content, Live, VOD
Field Type: string
Node Location: user_details
Permitted Values: any
Example Value: 43DHE-EROILKER-EREOATE
sessionStartTimestamp
metadata
Released in version 1.55
Start time of the current user session
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: user_details
Example Value: 1535971954488
Unit: epoch
Max Decimals: 0
viewId
metadata
Released in version 1.48
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
Example Value: 3bba4192-8105-4498-ae34-587154d56fa6-4
Player
controls
metadata
Released in version 1.20
Whether the controls are available for user interaction in the player. (i.e. Play/Pause/Seek)
Applicable for: Ad, Content, Live, VOD
Field Type: bool
Node Location: player
Permitted Values: value list
Example Value: false
Value List: true, false
defaultMuted
metadata
Released in version 1.23
Sets or returns whether the audio/video should be muted by default
Applicable for: Ad, Content, Live, VOD
Field Type: bool
Node Location: player
Permitted Values: value list
Example Value: true
Value List: true, false
defaultPlaybackRate
metadata
Released in version 1.53.1
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: Ad, Content, Live, VOD
Field Type: numeric
Node Location: player
Example Value: 0.5
Unit: percentage
Max Decimals: 2
isMuted
metadata
Released in version 1.23
True if player is muted.
Applicable for: Ad, Content, Live, VOD
Field Type: bool
Node Location: player
Permitted Values: value list
Example Value: true
Value List: true, false
loop
metadata
Released in version 1.20
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
Example Value: false
Value List: true, false
readyState
metadata
Released in version 1.20
Returns the current ready state of the audio/video
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: player
Permitted Values: any
Example Value: 1
Device
device_id
metadata
Released in version 1.54
Unique identifier of the user's device.
Use Case
This can be used as a proxy for User if user is anonymous.
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: device
Permitted Values: any
deviceMfg
metadata
Released in version 1.54
Manufacturer of the user's device. Not always available.
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: device
Permitted Values: any
Example Value: Apple
deviceName
metadata
Released in version 1.54
Name of the device model used by the viewer
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: device
Permitted Values: any
Example Value: iPad Mini 4
deviceType
metadata
Released in version 1.48
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: Ad, Content, Live, VOD
Field Type: string
Node Location: device
Permitted Values: value list
Example Value: pc
Value List: pc, mobile, tablet, ott device, tv, game console, wearable
os
metadata
Released in version 1.19
Operating System of the user's device
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: device
Permitted Values: any
Example Value: OS X
osVersion
metadata
Released in version 1.19
Version of Operating System being used during the session
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: device
Permitted Values: any
Example Value: 10.14
Video
description
metadata
Released in version 1.23
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: Ad, Content, Live, VOD
Field Type: string
Node Location: video
Permitted Values: any
duration
metadata
Released in version 1.48
The total length of the media file, reported in decimal seconds
Applicable for: Ad, Content, VOD
Field Type: numeric
Node Location: video
Example Value: 25.49
Unit: seconds
Max Decimals: 3
playerHeight
metadata
Released in version 1.55
Height dimension in pixels of the current playback area.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: video
Permitted Values: any
Example Value: 1080
Unit: pixels
Max Decimals: 0
playerWidth
metadata
Released in version 1.55
Width dimension in pixels of the current playback area.
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: video
Permitted Values: any
Example Value: 1920
Unit: pixels
Max Decimals: 0
source
metadata
Released in version 1.51.2
Returns the URL of the current media file
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: video
Permitted Values: URL
Example Value: http://...
title
metadata
Released in version 1.23
Provides the title of current asset being played
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: video
Permitted Values: any
Example Value: What About Bob?
videoType
metadata
Released in version 1.48
Is this Ad or Content?
Applicable for: Ad, Content, Live, VOD, Ad
Field Type: string
Node Location: video
Permitted Values: value list
Example Value: Ad
Value List: Ad, Content
Location
city
metadata
Released in version 1.19
The city or town where the user is located
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: geo_location
Permitted Values: any
Example Value: Santa Rosa Beach
country
metadata
Released in version 1.55
Full name of the user's country
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: geo_location
Permitted Values: any
Example Value: United States
countryCode
metadata
Released in version 1.19
The country from which the browser initiated the event. For a list of country codes, see ISO 3166-1 alpha-2 .
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: geo_location
Permitted Values: 2 letter code
Example Value: US
latitude
metadata
Released in version 1.48
Location information for the user
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: geo_location
Example Value: 30.3659
Unit: degrees
Max Decimals: 4
Scale: -90 .. 90
longitude
metadata
Released in version 1.48
Location information for the user
Applicable for: Ad, Content, Live, VOD
Field Type: numeric
Node Location: geo_location
Example Value: -86.2458
Unit: degrees
Max Decimals: 4
Scale: -180 .. 180
region
metadata
Released in version 1.55
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: Ad, Content, Live, VOD
Field Type: string
Node Location: geo_location
Permitted Values: any
Example Value: Florida
regionCode
metadata
Released in version 1.19
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: Ad, Content, Live, VOD
Field Type: string
Node Location: geo_location
Permitted Values: 2 letter code
Example Value: FL
zipCode
metadata
Released in version 1.55
The specific administrative division within a country where the event occurred. In the United States, zip codes correspond to postal region locator
Applicable for: Ad, Content, Live, VOD
Field Type: string
Node Location: geo_location
Permitted Values: any
Example Value: 32459
Network
asn
metadata
Released in version 1.19
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: Ad, Content, Live, VOD
Field Type: string
Node Location: network
Permitted Values: any
Example Value: AS30036 Mediacom Communications Corp
asnOrganization
metadata
Released in version 1.19
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: Ad, Content, Live, VOD
Field Type: string
Node Location: network
Permitted Values: any
Example Value: MEDIACOM
isp
metadata
Released in version 1.55
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: Ad, Content, Live, VOD
Field Type: string
Node Location: network
Permitted Values: any
Example Value: Mediacom Communications Corp
Custom
customMetadata
metadata
Released in version 1.51.2
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: Ad, Content, Live, VOD
Node Location: custom
|
Comments
0 comments
Article is closed for comments.