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. Additionally, there exists a subset of metrics reserved exclusively for video sessions optimized for Quality Bitrate Resolution (QBR).

Video related metrics and dimensions

Metrics

Metric Name	Description	Metric (API)
Attempts	No of sessions created regardless of video playback	attempts
Startup Failures	Percentage of attempts where video playback did not start	failurerate
Video Durations	Total duration of video	totalduration
Total Startup Failures	No of sessions where video playback did not start	totalstartupfailure
Sessions	Number of ongoing playback sessions	concurviewavg
Unique Viewers	Number of unique viewers	uniqueviewercount
Plays	Number of attempts the first frame of the video has been seen by a user.	viewercount
Playtime	Total amount of time a video was played	playdur
Traffic	Data downloaded during playback	cbrsize
Average Plays / Viewer	Average number of video playback sessions per unique viewer	playperunique
Average Playtime / Viewer	Average time watched per unique viewer.	playtimeperunique
Errors	Total number of errors during video playback (Fatal & Non-Fatal.)	errors
Startup Delay	Average time from an attempt to play the video to the first frame of video being displayed	latency
Buffering Ratio	Percentage of video viewing time spent in re-buffering	bufferingratio
Connection Induced Rebuffering Ratio (CIRR)	Percentage of video viewing time spent in re-buffering due to connection related issues	sumbuffwaitcirr
Exit Before Video Start	Percentage of video playback sessions that were abandoned before first frame of the video would load	startupabandonmentrate
VDS Active	Total time where Audio for accessibility support was switched on.	isvdsactive
Subtitle Active	Total time where subtitles were switched on.	issubtitleactive
Q Metric	Viewer’s quality of experience, on a scale of 0-5, where 0 is lowest and 5 is highest	qualityofexperience
Signal Strength	Average WiFi signal strength	signalstrength
Wifi Data Rate	WiFi connection max data rate	wifidatarate
Wifi SSID	WiFi Service Set Identifier (SSID)	wifissid
Bitrate	Average bitrate of the last set of segments. Sent in every statistical payload ( every 30s )	bitrate
Bandwidth	Average bandwidth of the last set of segment. Sent in every statistical payload( every 30s )	bandwidth

Dimensions

Dimension name	Dimension Description	Dimension (API)	Collection type
Subscriber Type	Type of user	subscribertype	Manual
Country	Name of the Country the video was viewed at.	country	Automatic
City	Name of the City the video was viewed at.	city	Automatic
CDN	CDN used to serve the video	cdn	Automatic
Device	Name of the Device	device	Automatic
Platform	Name of the device platform	platform	Automatic
Domain	Domain used for streaming	domainname	Manual
Asset ID	Unique identifier for the Asset	assetid	Manual
Asset Name	Name of the Asset	assetname	Manual
Video ID	Unique ID for the Video	videoid	Manual
Subscriber ID	UniqueIdentifer for each user	subscriberid	Manual
Browser	Broswer used user for playback	browser	Automatic
Player Name	Video player user for playback	player	Manual
Content Type	The type of content played	contenttype	Manual
Audio Codec	Audio codec used by the player	audiocodec	Automatic
Video Codec	Video codec used by the player	videocodec	Automatic
Player Version	Version of the player	playerversion	Manual
Media Type	A or AV. ( for Audio Only and Audio+VIdeo Streams)	mediatype	Automatic
Device ID	Unique identifier of the device	deviceid	Manual
App Name	Application Name	appname	Manual
App Version	Application Version	appversion	Manual
Device Marketing Name	Generic name of the device	devicemarketingname	Manual
Video Quality	Resolution of the video	videoquality	Automatic

Ads related metrics and dimensions

Ad Metric

Metric	Description	Metric (API)
Ad Fill Rate	The percentage of ad impressions that are played back successfully	adfillrate
Ad Impressions	Number of ads watched by users	adimpression
Ad View Time	Total time in seconds where ads were viewed	adviewtime
Ad Play	Number af ads played by users	adplay
Ad Errors	Number of ad errors	aderror
Ad Blocks	Number of ads blocked	adblock
Ad Startup Delay	Delay is the time taken for the ad to start playing back	adlatency
Ad Buffering Ratio	Ad Buffering Ratio is the percentage of ad viewing time spent in buffering	adbufferingratio
Ad Abandons	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	adstartupabandonmentrate
25% Complete	This indicates the percentage of ads played to 25% of the duration of the ad	adfirstquartilepct
50% Complete	This indicates the percentage of ads played to 50% of the duration of the ad	adsecondquartilepct
75% Complete	This indicates the percentage of ads played to 75% of the duration of the ad	adthirdquartilepct
100% Complete	This indicates the percentage of ads played to 100% of the duration of the ad	adcompletionrate
Ad Skipped	The percentage of ads that were skipped by the user.	adskippercentage
Click through ratio	The percentage of ads that were clicked by the user	adclickthroughrate

Ad dimensions

		Dimension (API)	Collection Type
Asset ID	Unique ID of AD asset	assetid	Manual
Asset Name	Name of the AD	assetname	Manual
CDN	CDN used by the AD	cdn	Automatic
Device	Name of the Device AD was played on	device	Automatic
Platform	Name of the platform AD was played on	platform	Automatic
Player Name	Video Player used by AD	player	Manual
Ad Server	Server user for AD	adserver	Automatic
Ad Position	Position of the AD - [Pre | Mid | Post]	adposition	Automatic
Pod Index	Location of the pod	adpodindex	Automatic
AD Position in POD	Position of the Ad in a Pod	aspositioninpod	Automatic
Pod Length	Total duration of the AD Pod	adpodlength	Automatic
Ad ID	Identifier of the AD	adid	Automatic
Video ID	ID of the Video where AD was played	videoid	Manual

---

Additional Metrics & Dimensions that are calculated but not visible on Smartsights are as follows

Video Metrics

Metric	SmartSight UI	Description
audienceengagement	Audience Engagement	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
bufferingbucket	Re-Buffering Ratio Distribution	Buffering ratio distribution. This is only available for completed and ended sessions
bufferingratio	Re-Buffering Ratio	Ratio of sumbuffwait to playdur
buffwait	Average Buffering	Average buffering duration
cbrbitrate	Bitrate	Average bitrate of sessions
concurviewavg	Sessions	Total number of sessions
concurviewpeak	Peak Concurrent Sessions	Maximum number of concurrent sessions
domainname	Domain	Web domain where the player is hosted; applicable only for web-based players
downshiftcount	Downshifts	Count of switches to a lower bitrate representation
engagementbuckettrend	Audience Abandonment Trend	audienceengagement normalized to the total number of sessions
latencybucket	Startup Delay Distribution	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
mode	QBR Mode	Optimization mode for QBR-enabled players; one of QBRDisabled, QBRCostsave, QBRBitsave, QBRQuality
signalstrength	n/a	Average WiFi signal strength
sumbuffwait	Total Buffering	Total time (in seconds) spent re-buffering
startupabandonmentrate	EBVS	Percentage of exits before video start to attempts
uniqueviewercount	Unique Viewers	Count of unique viewers with active session
upshiftcount	Upshifts	Count of switches to a higher bitrate representation

Video Dimensions

Dimension name	Dimension (to be used in API)	Description
Metric	Dimension	Description
contenttype	all (quicker), microscope	Type of the content (eg. trailer, movie, episode etc)
seriestitle	all (quicker), microscope	Title of the show or series
episodenumber	allall (quicker), microscope	Episode number
season	all (quicker), microscope	Season of the show or series
genre	all (quicker), microscope	A comma separated list of all the genres associated with a content
impactedsessions	all (quicker), microscope	Count of sessions impacted by alert. Applicable to Quality of Experience-based Alerts
isp	microscope	ISP used during video session
latitude	all (quicker), microscope	Latitude during video session
longitude	all (quicker), microscope	Longitude during video session
nwtype	all (quicker), microscope	Device network connection type (e.g., WiFi, Cellular, LTE, etc.)
region	all (quicker), microscope	Region or state location during video session
scrnres	all (quicker), microscope	Device screen resolution (VGA, HD, 4K, etc.)
sessionid	microscope	MediaMelon-assigned session identifier
subscribertag	all (quicker), microscope	Unique identifier of the subscriber that does not contain any sensitive information, which is returned in un-hashed plain text
subscribertype	all (quicker), microscope	Subscriber type
trending	all (quicker), microscope	Assets that are gaining more audience over time in terms of new plays and increasing play time

Ad Metrics

adblockpercentage	Blocked Rate	Ratio of adblock to adrequest
adclick	Clicks	Number of times a viewer clicked an ad
adcomplete	Complete	Number of ads completed playing
adcompletionrate	Completion Rate	Ratio of adcomplete to adplay
adcreative	n/a	Advertisement MIME type
adduration	n/a	Average ad duration
adstartupabandonmentrate	Ad Abandons	Number of Ads abandoned
adfirstquartilepct	25% Complete	Ads which have completed 25% playback
adsecondquartilepct	50% Complete	Ads which have completed 50% playback
adthirdquartilepct	75% Complete	Ads which have completed 75% playback
adcompletionrate	100% Complete	Ads which have completed 100% playback
aderrorpercentage	n/a	Ratio of aderror to adrequest
adrequest	Ad Request	ount of requests made to the ad server
adskippercentage	Skipped (%)	Ratio of adskip to adplay
adviewtime	Average Ad View Time	Average time (in seconds) until an ad was closed, skipped or completed

Ad Dimensions

adclient	client	The Ad framework or service through which the ad is served.
adid	ad	Ad identifier extracted from the ad tag
adposition	position	Ad position in the video session, one of “pre” “mid”, or “post” (indicating before, during or after respectively)

Common Metrics (QBR-optimized video streams)

These metrics are available for QBR-enabled streams.

Metric	SmartSight UI	Description
cbrbitrate	Bitrate	Original (CBR) bitrate in Mbps
countqualimp	n/a	Count of instances where QBR selected a higher quality segment vs CBR
countqualred	n/a	Count of instances where QBR selected a lower quality segment vs CBR
pctbitssaved	Bits Saved	Percentage of bandwidth saved by QBR
qbrbitrate	QBR Bitrate	QBR bitrate in Mbps
qualcbr	Original Avg iMOS	Original (CBR) quality score (iMOS value)
qualperbitcbr	Original Quality Density	Original (CBR) quality density
qualperbitqbr	QBR Quality Density	QBR quality density
qualqbr	QBR iMOS	QBR quality score (iMOS value)
qbrsize	QBR Traffic	Actual data downloaded (in MB) with QBR optimization; equal to cbrsize when QBR not used

Dimension-specific Metrics (QBR-optimized video sessions)

These metrics are available for QBR-enabled streams.

Metric	Dimension	Description
profile	profile	Representation index of the video being played
res	res	Stream resolution of the video being played