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

Metrics

Metric Name	Metric (API)	Description
Attempts	attempts	Number of actions to play content, recorded when an ONLOAD event is received from the player (e.g., user presses PLAY).
Views	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 on specifc devices who initiated at least one Play event over the selected time period, regardless of the number of Views or Attempts. The users are calculated using the subscriberid , deviceid ( if available) and user agent details.
Unique Subscribers	uniquesubscribercount	Unique number of subscriberids 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
Watchtime	watchtime	Total time spent in viewing the video , including buffering time, ad view time , time spent in seeking. It excludes the time spent in a paused state.
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	fatalerrors	Total number of fatal errors that prevent video playback, excluding Business Exceptions (included in PFP calculation).
Errors	erros	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)	businesserrorpc	Percentage of playback Attempts marked as Business Exceptions, which are excluded from Video Startup Failures and PFP calculations. Formula: BER = Be/ Se × 100 Where: Be = Total number of Business Exception errors Se= Total number of ended sessions
Playback Failure Precentage (PFP)	fatalerrorpc	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	Average value for the time taken for the first frame of video to be displayed after a user clicks “play” (includes auto-start or auto-play scenarios).
Rebuffering Ratio	bufferingratio	Percentage of total watchtime spent buffering, including Startup Delay. Formula: Buffering Ratio = Tb/Tw × 100 Where: Tb = Total buffering time (seconds) Tw = Total watchtime (seconds) Example: For a 60-minute Playtime with a 5% Buffering Ratio, 3 minutes are spent on buffering
Rebuffering Time	sumbuffwait	Percentage of total Playtime spent buffering, including Startup Delay. Formula: Buffering Ratio = (Tb + Tsd)/Tp × 100 Where: Tb = Total buffering time (seconds) Tsd = Startup Delay (seconds) Tp = Total Playtime (seconds) Example: For a 60-minute Playtime with a 5% Buffering Ratio, 3 minutes are spent on buffering and Startup Delay.
Rebuffering Wait Count	buffcount	Total number of times a session experiences buffering events during playback. Average Buffering Wait Count: Avg BWC = BwS Where: Bw = Total Buffering Wait Count across all sessions S = Total number of sessions
Connection Induced Rebuffering Ratio (CIRR)	bufferingratiocirr	Proportion of time spent buffering due to network issues relative to total watch time. Formula: CIRR = Tb /Tw *100 Where: Tb = Total buffering time caused by network issues (seconds) Tw= Total watch time (seconds)
Video Rebuffering Ratio (VRT)	bufferingratiovrt	Percentage of time (in seconds) after a user initiates seeking until the video begins playing again. Formula: VRT = Tr/Tw × 100 Where: Tr = Buffering time from seek completion to playback resumption (seconds) Ts = Total watchtime (seconds)
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. Formula: Q = Sf × (1 - Wl × Pl) × (1 - Wb × Pb) × 100 Where: Pl = 1 - e-kl × L = Latency penalty Pb = 1 - e-kb × B = Buffering penalty Wl = Weight for latency penalty Wb = Weight for buffering penalty kl = Latency decay constant kb = Buffering decay constant L = Latency (e.g., Startup Delay in seconds) B = Buffering Ratio Sf = Session factor (context-specific multiplier)
Smoothness Score	smoothnessscore	A score (0-100) indicating playback smoothness, based on the frequency of buffering events and the buffering ratio. Formula: S = 1√(1 + (Bw / k)2) × 50 + e-kb × B × 50 Where: Bw = Buffering Wait Count (number of buffering events) B = Buffering Ratio k = Scaling constant for buffering wait count kb = Buffering decay constant
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	cbrbitrate	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 )
Average bitrate upscale %	bitrateupscalepct	Average % of all bitrate upscales per session. Averaged over all sessions.
Average bitrate downscale %	bitratedownscalepct	Average % of all bitrate downscales per session. Averaged over all sessions.
Max bitrate downscale %	maxbitratedownscalepct	Max % of all bitrate downscales per session. Averaged over all sessions.
Max bitrate upscale %	maxbitrateupscalepct	Max % of all bitrate upscales per session. Averaged over all sessions.
Average resolution upscale %	resupscalepct	Average % of all resolution upscales per session. Averaged over all sessions.
Average downscale upscale %	resdownscalepct	Average % of all resolution downscales per session. Averaged over all sessions.
Max resolution upscale %	maxresupscalepct	Max % of all resolution upscales per session. Averaged over all sessions.
Max resolution downscale %	maxresdownscalepct	Max % of all resolution downscales per session. Averaged over all sessions.
Request failure count	rf<video | audio | pir | drm | init | encryption | mainfest>count	Count of specific request failure events

Dimensions

Dimension Name	Dimension (API)	Description
Subscriber ID	subscriberid	UniqueIdentifer for each user
Subscriber Type	subscribertype	Type of user
Subscriber Tag	subscribertag	A tag associated with a subscriber
Country	country	Name of the Country the video was viewed at
City	city	Name of the City the video was viewed at
Region	region	Name of. the Region where the vcideo was viewed at
CDN	cdn	CDN used to serve the video
ASN	asn	Area Service Network
ISP	isp	Internet Service Provider
Device	device	Name of the Device
Platform	platform	Name of the device platform
Browser	browser	Broswer used user for playback
Domain	domainname	Domain used for streaming
Content Type	contenttype	The type of content played
Media Type	mediatype	A or AV. ( for Audio Only and Audio+VIdeo Streams)
Asset ID	assetid	Unique identifier for the Asset
Asset Name	assetname	Name of the Asset
Video ID	videoid	Unique ID for the Video
Series Title	seriestitle	Title of the show or series
Episode Number	episodenumber	Number of the episode
Season	season	Season number
Player Name	player	Video player user for playback
Player Version	playerversion	Version of the player
Audio Codec	audiocodec	Audio codec used by the player
Video Codec	videocodec	Video codec used by the player
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
Sub Property ID	subpropertyid	Sub property ID to identify various services
Experiment Name	experimentname	Name of experiment
Source Type	sourcetype	Type of source used
Error Key	key	Error type
Error Category	category	Error category - is it a STARTUP_FATAL or IN_STREAM_FATAL etc
Error Code	errorcode	Error code if it exists
Browser Version	browserversion	Browser version
Player Resolution	playerres	Player resolution
Platform Version	platformversion	Platform version
User Agent	useragent	User agent string
Latitude	latitude	Coordinates
Longitude	longitude	Coordinates
Has Ads	hasad	Contains ads
Has Startup Failure	hasstartupfailure	Contains video startup failure
Has Fatal Error	hasfatalerror	Contains fatal error - playback failure
Has Business Error	hasbusinesserror	Contains business error
DRM Protection	drm	DRM type
Brand	brand	Device brand
Model	model	Device model
IP Address	ipaddress	Masked ip address
Screen Resolution	screenres	Screen Resolution
Stream Resolution	streamres	Stream Resolution
Source URL	sourceurl	Source URL
Is Live Stream	islive	Is this a live stream
Media Type	mediatype	Media type metadata
SDK Version	sdkversion	SDK Version Number
Custom Tag 1-20	customtag1 - customtag20	Custom tags
Stream Format	streamformat	Formal of the stream
Genre	genre	Comma separated genre list
Base Player Name	baseplayername	Name of the Base Player ( e.g.Exoplayer )
Base Player Version	baseplayerversion	Version of the Base Player
Device Capabilities	devicecapabilities	Device capability list ( e.g SDR, HDR+,HLG etc )

Ads related metrics and dimensions

Ad Metric

Metric Name	Metric (API)	Description
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.

Ad dimensions

Dimension Name	Dimension (API)	Description
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
Ad Universion ID	aduniversalid	Universal ID of the AF
Ad Creative URL	adurl	URL of the Ad Creative

Smartquery Query Parameters

Query Name	Query (API)	Description
Subscriber Insight	subscriberdetails	Provides subscriber 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

---