Metric and Dimensions Dictionary
MediaMelon utilizes its proprietary SDK to meticulously collect comprehensive data, facilitating the creation of a robust set of metrics for video analytics.
Last updated
MediaMelon utilizes its proprietary SDK to meticulously collect comprehensive data, facilitating the creation of a robust set of metrics for video analytics.
Last updated
Within our framework, a set of universally recognized metrics is consistently accessible across all dimensions, while certain metrics are exclusively relevant to specific dimensions. The tabular presentation encompasses both the metric values employed in the API and the user-friendly labels integrated into the SmartSight Graphical User Interface (GUI).
It is worth noting that the majority of these metrics remain accessible for all video sessions.
| Metric Name | Metric (API) | Description |
|---|---|---|
| Dimension Name | Dimension (API) | Description |
|---|---|---|
| Metric Name | Metric (API) | Description |
|---|---|---|
| Dimension Name | Dimension (API) | Description |
|---|---|---|
| Metric Name | Metric (API) | Description |
|---|---|---|
| Dimension (API) | Description |
|---|---|
| Metric Name | Metric (API) | Description |
|---|---|---|
| Dimension Name | Dimension (API) | Description |
|---|---|---|
Attempts
attempts
Number of sessions created regardless of video playback. An attempt is defined as an action made to playback a video (whether successful or not).
Startup Failures
failurerate
Percentage of playback attempts that failed to result in successful video playback due to errors and not user action
Video Durations
totalduration
Total duration of video
Total Startup Failures
totalstartupfailure
Number of sessions where video playback did not start
Concurrent Sessions
concurviewavg
Number of ongoing playback sessions
Unique Viewers
uniqueviewercount
Number of unique viewers, identified by devices
Plays
viewercount
Number of attempt to playback of video results in the first frame of the video being displayed to the user
Ended Plays
endedplays
Number of plays that ended during selected interval
Playtime
playdur
Total amount of time videos were played
Traffic
cbrsize
Total data downloaded during playback
Average Plays / Viewer
playperunique
Average number of video playback sessions per unique viewer
Average Playtime / Viewer
playtimeperunique
Average time watched per unique viewer
Fatal Errors
errors
Number of fatal errors during video playback
Startup Delay
latency
Average time from an attempt to play the video to the first frame of video being displayed
Buffering Ratio
bufferingratio
Percentage of the time spent between the rebuffering duration and the actual duration of video that played
Connection Induced Rebuffering Ratio (CIRR)
sumbuffwaitcirr
Percentage of total video viewing time (playtime plus all rebuffering) during which viewers experience non-seek buffering or connection induced rebuffering
Video Rebuffering Ratio (VRT)
sumbuffwaitvrt
Percentage of number of seconds after user initiated seeking until video begins playing
Exit Before Video Start (EBVS)
startupabandonmentrate
Percentage of video playback sessions that were abandoned by the user before first frame of the video was played. This excludes playback failures due to error.
VDS Active
isvdsactive
Total time where Audio for accessibility support was switched on
Subtitle Active
issubtitleactive
Total time where subtitles were switched on
Q Metric
qualityofexperience
Viewer’s quality of experience, on a scale of 0-5, where 0 is lowest and 5 is highest
Signal Strength
signalstrength
Average WiFi signal strength
Wifi Data Rate
wifidatarate
WiFi connection max data rate
Wifi SSID
wifissid
WiFi Service Set Identifier (SSID)
Bitrate
bitrate
Average bitrate of the last set of segments. Sent in every statistical payload ( every 30s )
Bandwidth
bandwidth
Average bandwidth of the last set of segment. Sent in every statistical payload( every 30s )
Subscriber Type
subscribertype
Type of user
Country
country
Name of the Country the video
was viewed at
City
city
Name of the City the video was
viewed at
CDN
cdn
CDN used to serve the video
Device
device
Name of the Device
Platform
platform
Name of the device platform
Domain
domainname
Domain used for streaming
Asset ID
assetid
Unique identifier for the Asset
Asset Name
assetname
Name of the Asset
Video ID
videoid
Unique ID for the Video
Subscriber ID
subscriberid
UniqueIdentifer for
each user
Browser
browser
Broswer used user for playback
Player Name
player
Video player user for playback
Content Type
contenttype
The type of content played
Audio Codec
audiocodec
Audio codec used by the player
Video Codec
videocodec
Video codec used by the player
Player Version
playerversion
Version of the player
Media Type
mediatype
A or AV. ( for Audio Only and Audio+VIdeo Streams)
Device ID
deviceid
Unique identifier of the device
App Name
appname
Application Name
App Version
appversion
Application Version
Device Marketing Name
devicemarketingname
Generic name of the device
Video Quality
videoquality
Resolution of the video
Ad Fill Rate
adfillrate
Percentage of number of ads served divided by the total number of ad requests that the server makes
Ad Impressions
adimpression
Number of times an ad is displayed on user's screen, regardless of whether the users interacted with it
Ad View Time
adviewtime
Total time in seconds where ads were viewed by users
Ad Plays
adplay
Number of times an ad impression was actually seen by users
Ad Errors
aderror
Number of ad errors that occurred anytime during an ad’s lifecycle
Ad Blocks
adblock
Number of ads blocked
Ad Startup Delay
adlatency
Ad Startup Delay is the time taken for the ad to start playing back
Ad Buffering Ratio
adbufferingratio
Ad Buffering Ratio is the percentage of ad viewing time spent in buffering
Ad Abandons
adstartupabandonmentrate
EBAS is the percentage of ads where the user abandoned the session before the Ad could begin to play. This excludes errors that caused start-up failures
25% Complete
adfirstquartilepct
This indicates the percentage of ads played to 25% of the duration of the ad
50% Complete
adsecondquartilepct
This indicates the percentage of ads played to 50% of the duration of the ad
75% Complete
adthirdquartilepct
This indicates the percentage of ads played to 75% of the duration of the ad
100% Complete
adcompletionrate
This indicates the percentage of ads played to 100% of the duration of the ad
Ad Skipped
adskippercentage
The percentage of ads that were skipped by the user.
Click through ratio
adclickthroughrate
The percentage of ads that were clicked by the user
Asset ID
assetid
Unique ID of AD asset
Asset Name
assetname
Name of the AD
CDN
cdn
CDN used by the AD
Device
device
Name of the Device AD was played on
Platform
platform
Name of the platform AD was played on
Player Name
player
Video Player used by AD
Ad Server
adserver
Server user for AD
Ad Position
adposition
Position of the AD - [Pre | Mid | Post]
Pod Index
adpodindex
Location of the pod
AD Position in POD
aspositioninpod
Position of the Ad in a Pod
Pod Length
adpodlength
Total duration of the AD Pod
Ad ID
adid
Identifier of the AD
Video ID
videoid
ID of the Video where AD was played
Audience Engagement
audienceengagement
Provides information about which portions of the video are being watched the most. The video length is divided into 10 buckets; the value in each bucket shows the number of sessions that played that percentage
Re-Buffering Ratio Distribution
bufferingbucket
Buffering ratio distribution. This is only available for completed and ended sessions
Re-Buffering Ratio
bufferingratio
Ratio of sumbuffwait to playdur
Average Buffering
buffwait
Average buffering duration
Bitrate
cbrbitrate
Average bitrate of sessions
Sessions
concurviewavg
Total number of sessions
Peak Concurrent Sessions
concurviewpeak
Maximum number of concurrent sessions
Domain
domainname
Web domain where the player is hosted; applicable only for web-based players
Downshifts
downshiftcount
Count of switches to a lower bitrate representation
Audience Abandonment Trend
engagementbuckettrend
audienceengagement normalized to the total number of sessions
Startup Delay Distribution
latencybucket
Latency Distribution of successful plays 10 - 0-1 sec
20 - 1-2 sec
30 - 2-3 sec
40 - 3-4 sec
50 - 4-5 sec
75 - 5-7.5 sec
100 - 7.5+ sec
QBR Mode
mode
Optimization mode for QBR-enabled players; one of QBRDisabled, QBRCostsave, QBRBitsave, QBRQuality
n/a
signalstrength
Average WiFi signal strength
Total Buffering
sumbuffwait
Total time (in seconds) spent re-buffering
EBVS
startupabandonmentrate
Percentage of exits before video start to attempts
Unique Viewers
uniqueviewercount
Count of unique viewers with active session
Upshifts
upshiftcount
Count of switches to a higher bitrate representation
contenttype
Type of the content (eg. trailer, movie, episode etc)
seriestitle
Title of the show or series
episodenumber
Episode number
season
Season of the show or series
genre
A comma separated list of all the genres associated with a content
impactedsessions
Count of sessions impacted by alert. Applicable to Quality of Experience-based Alerts
isp
ISP used during video session
latitude
Latitude during video session
longitude
Longitude during video session
nwtype
Device network connection type (e.g., WiFi, Cellular, LTE, etc.)
region
Region or state location during video session
scrnres
Device screen resolution (VGA, HD, 4K, etc.)
sessionid
MediaMelon-assigned session identifier
subscribertag
Unique identifier of the subscriber that does not contain any sensitive information, which is returned in un-hashed plain text
subscribertype
Subscriber type
trending
Assets that are gaining more audience over time in terms of new plays and increasing play time
Blocked Rate
adblockpercentage
Ratio of adblock to adrequest
Clicks
adclick
Number of times a viewer clicked an ad
Complete
adcomplete
Number of ads completed playing
Completion Rate
adcompletionrate
Ratio of adcomplete to adplay
n/a
adcreative
Advertisement MIME type
n/a
adduration
Average ad duration
Ad Abandons
adstartupabandonmentrate
Number of Ads abandoned
25% Complete
adfirstquartilepct
Ads which have completed 25% playback
50% Complete
adsecondquartilepct
Ads which have completed 50% playback
75% Complete
adthirdquartilepct
Ads which have completed 75% playback
100% Complete
adcompletionrate
Ads which have completed 100% playback
n/a
aderrorpercentage
Ratio of aderror to adrequest
Ad Request
adrequest
ount of requests made to the ad server
Skipped (%)
adskippercentage
Ratio of adskip to adplay
Average Ad View Time
adviewtime
Average time (in seconds) until an ad was closed, skipped or completed
client
adclient
The Ad framework or service through which the ad is served.
ad
adid
Ad identifier extracted from the ad tag
position
adposition
Ad position in the video session, one of “pre” “mid”, or “post” (indicating before, during or after respectively)