Events
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
Mute
event
Released in version 1.23
Triggered when the player volume has been reduced to zero.
Applicable for: Ads, 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
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
Unmute
event
Released in version 1.23
Triggered the player audio has been reactivated.
Applicable for: Ads, Content, Live, VOD
Node Location: event.type
FluxData
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: Ads, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Example Value: 80.26
Unit: percentage
Max Decimals: 3
Scale: 0 .. 100
numberOfVideos
fluxdata
Released in version 1.20
The amount of unique videos watched during the current viewing session
Applicable for: Ads, Content, Live, VOD
Field Type: numeric
Node Location: event.metrics
Example Value: 2
Unit: videos
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: Ads, Content, Live, VOD
Field Type: string
Node Location: event.metrics
Permitted Values: any
Example Value: Ready
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
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: Ads, 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: Ads, 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: Ads, Content, Live, VOD
Field Type: string
Node Location: root
Permitted Values: UUID
Example Value: 3bba4192-8105-4498-ae34-587154d56fa6
User Details
client_ip
metadata
Released in version 1.19
IP address of the user's device
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: user_details
Permitted Values: IP address
Example Value: 173.19.65.222
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: Ads, 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: Ads, Content, Live, VOD
Field Type: bool
Node Location: player
Permitted Values: value list
Example Value: true
Value List: true, false
isMuted
metadata
Released in version 1.23
True if player is muted.
Applicable for: Ads, 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: Ads, Content, Live, VOD
Field Type: string
Node Location: player
Permitted Values: any
Example Value: 1
Device
os
metadata
Released in version 1.19
Operating System of the user's device
Applicable for: Ads, 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: Ads, 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: Ads, Content, Live, VOD
Field Type: string
Node Location: video
Permitted Values: any
title
metadata
Released in version 1.23
Provides the title of current asset being played
Applicable for: Ads, Content, Live, VOD
Field Type: string
Node Location: video
Permitted Values: any
Example Value: What About Bob?
Location
city
metadata
Released in version 1.19
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
Example Value: Santa Rosa Beach
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: Ads, Content, Live, VOD
Field Type: string
Node Location: geo_location
Permitted Values: 2 letter code
Example Value: US
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: Ads, Content, Live, VOD
Field Type: string
Node Location: geo_location
Permitted Values: 2 letter code
Example Value: FL
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: Ads, 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: Ads, Content, Live, VOD
Field Type: string
Node Location: network
Permitted Values: any
Example Value: MEDIACOM
|
Comments
0 comments
Article is closed for comments.