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.
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.
Video related metrics and dimensions
Attempts
attempts
Number of actions to play content, recorded when an ONLOAD event is received from the player (e.g., user presses PLAY).
Views
Ongoing Play events over the selected time period. Typically exceeds the number of Play events, as it tracks continuous activity rather than just successful starts.
Video Startup Failure(Startup Failure)
failurerate
Defines how many times or how often playback attempts are terminated during video startup before the first video frame is shown, excluding Business Exceptions.
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
The number of distinct users who initiated at least one Play event over the selected time period, regardless of the number of Views or Attempts.
Plays
viewercount
Number of playback attempts resulting in the first frame of video being displayed to the user.
Ended Plays
endedplays
Number of plays that ended during selected interval
Playtime
playdur
Total duration spent viewing content, including buffering events, excluding ad plays, and accounting for seek behavior.
Traffic
cbrsize
Volume of data downloaded by customers during a session, aggregated over the selected time range.
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
Total number of fatal errors that prevent video playback, excluding Business Exceptions (included in PFP calculation).
Errors
Total number of errors encountered during playback Attempts, including both fatal and non-fatal errors (e.g., Business Exceptions, technical issues).
Business Error Rate(BER)
Percentage of playback Attempts marked as Business Exceptions, which are excluded from Video Startup Failures and PFP calculations.
Playback Failure Precentage(PFP)
Percentage of playback Attempts that result in fatal errors, preventing the video from playing (includes Startup Failures and other critical failures, excluding Business Exceptions).
Startup Delay
latency
Time taken for the first frame of video to be displayed after a user clicks “play” (includes auto-start or auto-play scenarios).
Buffering Ratio
bufferingratio
Percentage of total Playtime spent buffering, including Startup Delay.
Buffering Wait Count
Total number of times a session experiences buffering events during playback.
Connection Induced Rebuffering Ratio (CIRR)
sumbuffwaitcirr
Proportion of time spent buffering due to network issues relative to total viewing time.
Video Rebuffering Ratio (VRT)
sumbuffwaitvrt
Percentage of time (in seconds) after a user initiates seeking until the video begins playing again.
Exit Before Video Start (EBVS)
startupabandonmentrate
Measures the number of playback attempts that terminated before the video started playing (i.e., before the first frame is displayed).
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
An overall score (0-100) measuring user experience during video playback, factoring in latency and buffering penalties, adjusted by a session factor.
Smoothness Score
A score (0-100) indicating playback smoothness, based on the frequency of buffering events and the buffering ratio.
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 experienced during a video stream, calculated only for played segments.
Bandwidth
bandwidth
Average bandwidth of the last set of segment. Sent in every statistical payload( every 30s )
Ads related metrics and dimensions
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
The number of times an advertisement is loaded and displayed to a user, regardless of whether it was fully played or interacted with.
Ad View Time
adviewtime
Total time in seconds where ads were viewed by users
Ad Plays
adplay
The number of times an advertisement successfully starts playing, reaching at least the first frame of the ad content.
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
Percentage of ad impressions that result in a user click.
Smartquery Query Parameters
Subscriber Insight
subscriberdetails
Provides subscriber details when used as a parameter with Smartquery API
Content Path
contentpath
Provides content path details when used as a parameter with Smartquery API
Average Viewer Time
avgviewertime
Gives average viewer time
Bounce Rate
getbouncerate
Gives bounce rate
Happy Viewers
gethappyviewers
Gives number of happy users
Inactive Users
getinactiveusers
Provides number of inactive users
QoE Buckets
getqoebuckets
TBD
Network Type Compare
nwtypecompare
TBD
Series Path
seriespath
TBD
Additional Metrics & Dimensions that are calculated but not visible on Smartsights are as follows
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 experienced during a video stream, calculated only for played segments.
Sessions
concurviewavg
Total number of sessions
Peak Concurrent Sessions
concurviewpeak
Maximum number of concurrent sessions
Peak Concurrent Viewers
The maximum number of viewers watching simultaneously, sampled at intervals below the selected time range: hourly for multi-day data, every 5 minutes for single-day data, and every 1 minute for real-time data.
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
Average Latency
avglatency
Avg of sum of latency
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
Ad Duration
adduration
Total duration of advertisements played during a session, measured in seconds, excluding any buffering or interruptions specific to ad playback.
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
Last updated
Was this helpful?