Metric and Dimensions Dictionary
Reference values for SmartSight video and ad metrics and dimensions.
List of metrics (metrics) and dimensions (aggby) available to use as query parameters.
Video Metrics & Dimensions
Plays
viewercount
Playback attempts where the first video frame appears.
--
Started views
attempts
Playback attempts recorded.
--
Ended plays
endedplays
Plays that gracefully ended.
--
Concurrent views (CCV) Ended Views
concurviewavg
Number of active playback sessions for CCV and Number of ended playback sessions for Ended Views.
This number includes distinct sessions active in the time range requested. The status of the view can be RUNNING, ENDED, DROPPED and others statues.
--
Playtime (mins)
playdur
Total time viewers spent watching content and ads combined.
--
Avg Audience Playtime (mins)
avg_playtime_by_audience
Average Playtime per distinct viewer for all the views active in the requested time range.
--
Unique Subscribers
unique_subscribers
Number of distinct subscrberId values representing viewers.
--
Unique Devices
unique_devices
Number of distinct devices calculated by counting unique deviceid or computed by combining brand, model , and ipaddress
--
Anonymous Viewers
anonymous_viewers
Number of distinct viewers with no subscriberid value set on sessions and the viewer is uniquely identified by combining brand, model, and ipaddress.
Typically, Anonymous Viewer is considered to be viewer who has not logged in / authenticated.
--
Playback Score
qualityofexperience
Overall playback quality score from 0 to 100, based on startup time and buffering and playback success.
The value of 0 signifies extremely bad playback experience and a score of 100 signifies perfect viewing experience.
Average=avg_qualityofexperience
Median=median_qualityofexperience
Startup time (sec)
latency
Time Duration of a view between when the view started to the first video frame displayed to the viewer.
Average=avg_latency
Median=median_latency
P95=p95_latency
P99=p99_latency
Errors
errors
Number of errors encountered, including fatal and non-fatal error or business or technical error.
--
Fatal errors
fatalerrors
Errors that end the playback session.
--
Playback Failure %
fatalerrorpc
Percentage of playback sessions ended with a fatal error. Playback failures can happen at any time during playback ie. before the first video frame is displayed or afterwards.
--
Business Failure %
businesserrorpc
Percentage of playback sessions ended with a fatal error due to business rule exception. Playback failures can happen at any time during playback ie. before the first video frame is displayed or afterwards.
--
Startup Failure %
failurerate
Percentage of playback sessions ended with a fatal error before the first video frame is displayed.
--
Business Startup Failure %
businessvsfpc
Percentage of playback sessions ended with a fatal error before the first video frame is displayed due to business rule exception.
--
Resumed Play %
resumedplaypct
Percentage of playback sessions that did not start playing from the beginning of the video.
--
Exit before video start %
startupabandonmentrate
Percetange of sessions abandoned by the viewer before the first video frame is displayed.
--
Pause Count
pausecount
Number of times the video playback was paused.
Average=avg_pausecount
Median=median_pausecount
P95=p95_pausecount
P99=p99_pausecount
Pause Time (sec)
pauseduration
Total time video playback spent in a paused state.
Average=avg_pauseduration
Median=median_pauseduration
P95=p95_pauseduration
P99=p99_pauseduration
Buffer empty count
buffwaitcount
Total number of Buffer empty events. The most common reasons whenn the video player send a Buffer empty event can be for network connection related interrupts, seeking to a different segment of the video and pausing of playback for sufficient amount of time.
Average=avg_buffwaitcount
Median=median_buffwaitcount
P95=p95_buffwaitcount
P99=p99_buffwaitcount
Rebuffering Time (sec)
sumbuffwaitcirr
Total Interruption time caused by network connection issues. In other words, interruption not caused by any viewer action.
Average=avg_sumbuffwaitcirr
Median=median_sumbuffwaitcirr
P95=p95_sumbuffwaitcirr
P99=p99_sumbuffwaitcirr
Rebuffering %
cirrbufferingratio
Percentage of Watch Time interrupted after video starts. Interruptions due to viewer action like seeking to a different segment of the video or pausing the playback is not counted in calculating this metric.
--
Rebuffering Rate
rebufferingrate
Number of network related interruptions per min of playtime.
--
Seek count
seekcount
Average number of seeks per session.
Average=avg_seekcount
Median=median_seekcount
P95=p95_seekcount
P99=p99_seekcount
Seek Time (sec)
seektime
Time spent waiting for the video to resume when the viewer seeks to a different segment of the video. The time duration is inclusive of any time spend filling up the buffer (sumbuffwaitvrt) to resume playback.
Average=avg_seektime
Median=median_seektime
P95=p95_seektime
P99=p99_seektime
Seek Buffering Time %
vrtbufferingratio
Percentage of Watch Time spent waiting fill the buffer for the video to resume after the viewer seeks to the different segment of the video.
--
Buffering Time (sec)
sumbuffwait
Total Interruption time caused by any reason. For instance - network connection issues, viewer seeking, etc. The interruption time is inclusive of sumbuffwaitcirr and sumbuffwaitvrt
Average=avg_sumbuffwait
Median=median_sumbuffwait
P95=p95_sumbuffwait
P99=p99_sumbuffwait
Buffering Time %
bufferingratio
Percentage of Watch Time not watching the video after the video starts. Any time spent due to a viewer action like seeking to a different segment of the video excluding pause time is also counted in calculating this metric.
--
Views without Buffering %
sessionswithoutcirrbuffpc
Percentage of sessions with no interruptions due to network connection related issues. These sessions have sumbuffwaitcirr of 0s.
--
Smoothness Score
smoothnessscore
A score from 0 to 100 indicating playback smoothness. Smoothness is based on buffwaitcount value and sumbuffwait value.
A score of 100 means zero buffering.
Average=avg_smoothnessscore
Median=median_smoothnessscore
Weighted Avg Bitrate (Mbps)
qbrbitrate
Average delivered bitrate, weighted by playback time. The bitrate value used for this calculation is the advertized bitrate value in the Variant manifest file.
Average=avg_qbrbitrate
Median=median_qbrbitrate
P95=p95_qbrbitrate
P99=p99_qbrbitrate
Bitrate Upswitch Count
brupscale
Number of rendition changes where bitrate of the rendition increased.
Average=avg_brupscale
Median=median_brupscale
P95=p95_brupscale
P99=p99_brupscale
Bitrate Upswitch %
brupscalepct
Percentage representation of a new rendition's bitrate compared to the previous rendition's bitrate, weighted by the play duration. Because this metric strictly tracks upswitch rendition, the value is always greater than 100%.
--
Bitrate Downswitch Count
brdownscale
Number of rendition changes where bitrate of the rendition decreased.
Average=avg_brdownscale
Median=median_brdownscale
P95=p95_brdownscale
P99=p99_brdownscale
Bitrate Downswitch %
brdownscalepct
Percentage representation of a new rendition's bitrate compared to the previous rendition's bitrate, weighted by the play duration. Because this metric strictly tracks downswitch rendition, the value is always less than 100%.
--
Resolution Upswitch Count
resupscale
Number of rendition changes where resolution of the rendition increased.
Average=avg_resupscale
Median=median_resupscale
P95=p95_resupscale
P99=p99_resupscale
Resolution Upswitch %
resupscalepct
Percentage representation of a new rendition's resolution compared to the previous rendition's resolution, weighted by the play duration. Because this metric strictly tracks upswitch rendition, the value is always greater than 100%. The resolution value used for the percentage calculation is video width pixel count multiplied by video height pixel count.
--
Resolution Downswitch Count
resdownscale
Number of rendition changes where resolution of the rendition decreased.
Average=avg_resdownscale
Median=median_resdownscale
P95=p95_resdownscale
P99=p99_resdownscale
Resolution Downswitch %
resdownscalepct
Percentage representation of a new rendition's resolution compared to the previous rendition's resolution, weighted by the play duration. Because this metric strictly tracks downswitch rendition, the value is always less than 100%. The resolution value used for the percentage calculation is video width pixel count multiplied by video height pixel count.
--
Rendition Switches
renditionswitches
Number of rendition changes.
Average=avg_renditionswitches
Median=median_renditionswitches
P95=p95_renditionswitches
P99=p99_renditionswitches
Rendition Switch Rate
renditionswitchrate
Number of rendition changes per min of playtime.
--
Delivery Traffic (MB)
qbrsize
Total number of bytes delivered for playback.
Average=avg_qbrsize
Median=median_qbrsize
P95=p95_qbrsize
P99=p99_qbrsize
CDN Change Count
cdn_change_count
Number of CDN switches.
Average=avg_cdn_change_count
Median=median_cdn_change_count
P95=p95_cdn_change_count
P99=p99_cdn_change_count
CDN Change Rate
cdn_change_rate
Number of CDN switches per min of play duration.
--
Video Chunk Request Failure Count
rfvideocount
Number of requests for video chunks (or segments) with 4xx & 5xx HTTP response status.
Average=avg_rfvideocount
Median=median_rfvideocount
P95=p95_rfvideocount
P99=p99_rfvideocount
Audio Chunk Request Failure Count
rfaudiocount
Number of requests for audio chunks (or segments) with 4xx & 5xx HTTP response status.
Average=avg_rfaudiocount
Median=median_rfaudiocount
P95=p95_rfaudiocount
P99=p99_rfaudiocount
Manifest Request Failure Count
rfmanifestcount
Number of requests for manifest with 4xx & 5xx HTTP response status. Both Variant and Rendition manifest requests failure are counted.
Average=avg_rfmanifestcount
Median=median_rfmanifestcount
P95=p95_rfmanifestcount
P99=p99_rfmanifestcount
DRM Request Failure Count
rfencryptioncount
Number of requests for DRM Licenses with 4xx & 5xx HTTP response status.
Average=avg_rfencryptioncount
Median=median_rfencryptioncount
P95=p95_rfencryptioncount
P99=p99_rfencryptioncount
Video Track Init Request Failure Count
rfvideoinitcount
Number of requests for video init segment with 4xx & 5xx HTTP response status.
Average=avg_rfvideoinitcount
Median=median_rfvideoinitcount
P95=p95_rfvideoinitcount
P99=p99_rfvideoinitcount
Audio Track Init Request Failure Count
rfaudioinitcount
Number of requests for audio init segment with 4xx & 5xx HTTP response status.
Average=avg_rfaudioinitcount
Median=median_rfaudioinitcount
P95=p95_rfaudioinitcount
P99=p99_rfaudioinitcount
PIR Request Failure Count
rfpircount
Number of requests for PIR object with 4xx & 5xx HTTP response status. PIR stands for Playback information Request. Many applications makes API requests to get video playback information, like playback urls, player configuration and other control signals from the server before loading the video. This metric counts failed requests of this resource.
Average=avg_rfpircount
Median=median_rfpircount
P95=p95_rfpircount
P99=p99_rfpircount
App Name
appname
Name of the client application used for playback
App Version
appversion
Version string of the client application
Browser Name
browser
Browser used for playback (e.g. Chrome, Safari, Firefox)
Browser Version
browserversion
Version of the browser
Player Name
player
Video player name used by the client application
Player Version
playerversion
Version of the video player
Base Player Name
baseplayername
Name of the underlying player when a wrapper or adapter is used (e.g. ExoPlayer beneath a custom wrapper)
Base Player Version
baseplayerversion
Version of the underlying base player
Domain Name
domainname
Domain of the page on which the player was embedded
MediaMelon SDK Info
sdkversion
MediaMelon SDK Name and Version
Subscriber ID
subscriberid
Unique identifier for each viewer
Subscriber Type
subscribertype
Name of Subscription tier or type (e.g. premium, free, trial)
Audience Type
audience_type
Type of Viewer. Possible Values are Subscriber or Anonymous Viewer
Subscriber Tag
subscribertag
Custom label or tag associated with the subscriber
Asset ID
assetid
Unique identifier of the video asset
Asset Name
assetname
Human-readable title of the video asset
Video ID
videoid
Platform-level video identifier, distinct from the asset ID
Content Type
contenttype
Type of content being played (e.g. episode, clip, movie)
Series Title
seriestitle
Title of the show or series
Episode Number
episodenumber
Episode number within a series
Season
season
Season number of the series
Genre
genre
Comma-separated genre list for the asset
Media Type
mediatype
Typically used to indicate the stream type — A (Audio Only) or AV (Audio + Video).
Property ID
subpropertyid
Digital Property or Business Unit or Market identifier to segment traffic within a single account
Is Live Stream
islive
Boolean value indicating whether the session was a live stream (true) or VOD (false)
Device Type
device
Category of the Device (e.g. mobile, tablet, TV, desktop, console)
Device ID
deviceid
Unique identifier of the playback device
Device Marketing Name
devicemarketingname
Consumer-facing marketing name of the device model
Operating System
platform
Name of the operating system (e.g. Android, iOS, Windows, tvOS)
Operating System Version
platformversion
Version string of the operating system.
Device Brand
brand
Manufacturer brand of the playback device (e.g. Samsung, Apple)
Device Model Name
model
Technical model identifier of the device
Device capabilities
devicecapabilities
Comma separated list of device capability. Mediamelon SDK populates this dimension with the Video Dynamic Range (e.g SDR, HDR+,HDR10, HLG, etc.) supported on the device.
Country
country
Name of the Country that the viewer is located in.
Region
region
Name of the Region (typically name of the State) that the viewer is located in.
City
city
Name of the City that the viewer is located in.
ISP
isp
Name of Internet Service Provider (ISP) that the viewer is connected to watch the video.
ASN
asn
Globally Unique Identifier assigned to an Autonomous System, typically a network or ISP, to control and route traffic across the internet.
Connection type
nwtype
Network type that the viewer is connected too (e.g. cellular, wifi, satellite, cable/dsl, etc.)
Initial CDN
starting_cdn
The Initial CDN used to start the playback of the session. This dimension is not available in concurrency mode.
Last CDN
cdn
The Last CDN that delivered the last segment of the session.
Session ID
sessionid
Unique identifier assigned by the MediaMelon SDK for every session.
Experiment Name
experimentname
Name of the A/B test or experiment this session was assigned to
Fatal Error Category
fatal_error_category
Category of the fatal error. Possible Values are
- Technical Startup Failure
- Technical Mid-Stream Failure
- Business Exception Startup Failure
- Business Exception Mid-Stream Failure
- No Fatal Failure
Error Code
errorcode
Last Error code captured when there are errors in a session.
Error Description
errordescription
Description of the Last Error Code.
DRM
drmprotection
DRM system used for playing the video (e.g. Widevine, FairPlay, PlayReady)
Source Format
sourcetype
Streaming format used to play the video (e.g. HLS, DASH, MP4)
View Status
status
Final status of the session. Possible values are ENDED, DROPPED, RUNNING, STARTED , IN_AD, LOADED, IN_ERROR, STALLED
Contains Ads
hasad
Boolean value (true or false ) indicating whether the session played any ads.
Contains Pre-Roll Ads
hasprerollad
Boolean value (true or false ) indicating whether the session played pre-roll ads.
Contains Warning Errors
containswarning
Boolean value (true or false ) indicating whether the session had any errors marked as Warning.
Contains Ad Buffering
hasadbuffwait
Boolean value (true or false ) indicating whether the session had any interruptions when playing ads.
Video Codec
vcodec
Video codec of the video played.
Audio codec
acodec
Audio codec of the video played.
CDN Change Count Buckeet
cdn_change_count_bucket
Each Bucket indicating the corresponding number of CDN_CHANGE events occuring in a session. Possible values are Once, Twice, Thrice, 4-6 times and More than 6 times
Device Display Resolution
scrnres
Resolution of the display device used for playing the video.
DRM Level
drmlevel
Indicates the level of DRM protection used for the video played.
Encoding Service
encodingservice
Name of the encoding service used to encode/transcode the video content.
Exit Before Video Start
hasebvs
Whether the session ended as ebvs 1 or not 0
Player ID
playerid
Unique identifier for the video player instance. Typically this dimension is useful identifier for when the application or web page loads multiple player instances.
Preload
preload
Boolean value (true or false ) indicating whether the video was preloaded by the player before user-initiated play.
Resumed Play
resumedplay
Boolean value (true or false ) indicating whether the video playing started from the beginning of the content (false) or not (true).
View Session ID
viewsessionid
Customer defined unique identified for the session that can be correlated with the other datasets managed by the customer.
Custom tags 1-20
customtag1 to customtag20
Custom metadata tag as defined by the customer. MediaMelon supports upto 20 custom tags.
Ad Metrics & Dimensions
Ad Playtime (mins)
adviewtime
Total ad viewing time.
Unique Subscribers
ad_unique_subscriber
Number of distinct subscrberId values representing viewers who initiated playing an ad.
Unique Devices
ad_unique_devices
Number of distinct devices calculated by counting unique deviceid or computed by combining brand, model , and ipaddress that initiated playing an ad
Anonymous viewers
ad_anonymous_viewers
Number of distinct viewers with no subscriberid value set on a session and the viewer is uniquely identified by combining brand, model, and ipaddress that initiated playing an ad.
Typically, Anonymous Viewer is considered to be viewer who has not logged in / authenticated.
Unique Ads
unique_ads
Number of distinct Ads adid value.
Ad Impression
adimpression
Number of Ad Impression events representing the number of times an ad playing was initiated.
Ad Plays
adplay
Number of Ad Play events representing the number of times an ad started playing. An Ad is considered as started playing is when the first video frame of the ad is displayed to the viewer.
Ad Breaks
adbreakcount
Number of Ad Breaks (AD_BREAK_START) events.
Average Audience Ad Playtime
ad_playtime_by_audience
Avg Ad Playtime per Unique Viewer. A Viewer can be a valid subscriber or an anonymous viewer.
Average Audience Ad Impressions
ad_impressions_by_audience
Avg Number of Ad Impressions per unique viewer. A Viewer can be a valid subscriber or an anonymous viewer.
Average Device Ad Playtime
ad_playtime_by_device
Avg Ad Playtime per Unique Device. A Device is considerd unique when it has a distinct deviceid or computed by combining brand, model , and ipaddress
Average Device Ad impressions
ad_impressions_by_device
Avg Ad Impressions per Unique Device. A Device is considerd unique when it has a distinct deviceid or computed by combining brand, model , and ipaddress
Ad Fill Rate %
adfillrate
Ad Plays as a percentage of Ad Impressions. A value of 100% indicates that every ad played.
Ad Errors
aderror
Number of errors during an ad's lifecycle.
Ad Startup Time (sec)
adlatency
Time between ad request or ad impression to the first video frame of the ad. Ad Startup Time is available for Client-Side Ad Insertion (CSAI) or Pre-Roll Ad placement with Server-Side Ad Insertion (SSAI).
Ad Rebuffering %
adbufferingratio
Percentage of Ad viewing time spent buffering.
Ad Completion %
adcompletionrate
Percentage of ads played to 100%
Ad First Quartile %
adfirstquartilepct
Percentage of ads played atleast 25% of the ad duration
Ad midpoint %
adsecondquartilepct
Percentage of ads played atleast 50% of the ad duration
Ad third quartile %
adthirdquartilepct
Percentage of ads played atleast 75% of the ad duration
Ad Skipped %
adskippercentage
Percentage of ads skipped before completion
Ad Click Through %
adclickthroughrate
Percentage of ads with a viewer clicking on the ad.
Exit Before Pre-Roll Ad %
exitbeforeprerollad
Percentage of sessions the viewer abandoned before the first video frame of a pre-roll ad was displayed.
Ad ID
adid
Unique identifier of the ad. Typically the adid is unique to the Ad Server and it is not a globally unique identifier.
Ad Server Name
adserver
Name of the Ad Server used to deliver the ad.
Ad Break Placement
adposition
Position of the Ad. Possbile values are pre for pre-roll, mid for mid-roll and post for post-roll ads.
Ad Break Position Index
adpodindex
Position index of the Ad Break (aka Ad Pod) in a session. The index number starts with 0 typically representing pre-roll ad break.
Ad ID Position Index
adpodposition
Position of an ad in an Ad Break (aka Ad Pod). The position value starts with 0 indicating the ad is the first ad in the Ad Break.
Last updated