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

Video Metrics

Metric Name

Metric Key

Description

Concurrency supported?

Metric Key for available aggregates (not supported in concurrency mode)

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

Video Dimensions

Ad Metrics & Dimensions

Ad Metrics

Metric Name

Metric Key

Description

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 Dimensions