# Metric and Dimensions Dictionary

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

{% tabs %}
{% tab title="Metrics" %}

<table><thead><tr><th width="145">Metric Name</th><th width="244"> Metric (API)</th><th width="313">Description</th></tr></thead><tbody><tr><td>Attempts</td><td>attempts</td><td>Number of actions to play content, recorded when an ONLOAD event is received from the player (e.g., user presses PLAY).</td></tr><tr><td>Views</td><td>views</td><td>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.</td></tr><tr><td>Video Startup Failure(Startup Failure)</td><td>failurerate</td><td>Defines how many times or how often playback attempts are terminated during video startup before the first video frame is shown, excluding Business Exceptions.</td></tr><tr><td>Video Durations</td><td>totalduration</td><td>Total duration of video </td></tr><tr><td>Total Startup Failures</td><td>totalstartupfailure</td><td>Number of sessions where video playback did not start</td></tr><tr><td>Concurrent Sessions</td><td>concurviewavg</td><td>Number of ongoing playback sessions</td></tr><tr><td>Unique Viewers</td><td>uniqueviewercount</td><td>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.</td></tr><tr><td>Unique Subscribers</td><td>uniquesubscribercount</td><td>Unique number of subscriberids  who initiated at least one Play event over the selected time period, regardless of the number of Views or Attempts. </td></tr><tr><td>Plays</td><td>viewercount</td><td>Number of playback attempts resulting in the first frame of video being displayed to the user.</td></tr><tr><td>Ended Plays</td><td>endedplays</td><td>Number of plays that ended during selected interval</td></tr><tr><td>Watchtime</td><td>watchtime</td><td>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.</td></tr><tr><td>Playtime</td><td>playdur</td><td>Total duration spent viewing content, including buffering events, excluding ad plays, and accounting for seek behavior.</td></tr><tr><td>Traffic</td><td>cbrsize</td><td>Volume of data downloaded by customers during a session, aggregated over the selected time range.</td></tr><tr><td>Average Plays / Viewer</td><td>playperunique</td><td>Average number of video playback sessions per unique viewer</td></tr><tr><td>Average Playtime / Viewer</td><td>playtimeperunique</td><td>Average time watched per unique viewer</td></tr><tr><td>Fatal Errors</td><td>fatalerrors</td><td>Total number of fatal errors that prevent video playback, excluding Business Exceptions (included in PFP calculation).</td></tr><tr><td>Errors</td><td>erros</td><td>Total number of errors encountered during playback Attempts, including both fatal and non-fatal errors (e.g., Business Exceptions, technical issues).</td></tr><tr><td>Business Error Rate(BER)</td><td>businesserrorpc</td><td><p></p><p>Percentage of playback Attempts marked as Business Exceptions, which are excluded from Video Startup Failures and PFP calculations.<br>Formula: <code>BER = B</code><sub><code>e</code></sub><code>/ S</code><sub><code>e</code></sub><code> × 100</code><br>Where:</p><ul><li><em>B</em><sub><em>e</em></sub> = Total number of Business Exception errors</li><li><em>S</em><sub><em>e</em></sub>= Total number of ended sessions</li></ul></td></tr><tr><td>Playback Failure Precentage (PFP)</td><td>fatalerrorpc</td><td>Percentage of playback Attempts that result in fatal errors, preventing the video from playing (includes Startup Failures and other critical failures, excluding Business Exceptions).</td></tr><tr><td>Startup Delay</td><td>latency</td><td>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).</td></tr><tr><td>Rebuffering Ratio</td><td>bufferingratio</td><td><p>Percentage of total watchtime spent buffering, including Startup Delay.<br>Formula: <code>Buffering Ratio = T</code><sub><code>b</code></sub><code>/T</code><sub><code>w</code></sub><code> × 100</code><br>Where:</p><ul><li><em>T</em><sub><em>b</em></sub> = Total buffering time (seconds)</li><li><em>T</em><sub><em>w</em></sub> = Total watchtime (seconds)</li></ul><p>Example: For a 60-minute Playtime with a 5% Buffering Ratio, 3 minutes are spent on buffering </p></td></tr><tr><td>Rebuffering Time</td><td>sumbuffwait</td><td><p>Percentage of total Playtime spent buffering, including Startup Delay.<br>Formula: <code>Buffering Ratio = (T</code><sub><code>b</code></sub><code> + T</code><sub><code>sd</code></sub><code>)/T</code><sub><code>p</code></sub><code> × 100</code><br>Where:</p><ul><li><em>T</em><sub><em>b</em></sub> = Total buffering time (seconds)</li><li><em>T</em><sub><em>sd</em></sub> = Startup Delay (seconds)</li><li><em>T</em><sub><em>p</em></sub> = Total Playtime (seconds)</li></ul><p>Example: For a 60-minute Playtime with a 5% Buffering Ratio, 3 minutes are spent on buffering and Startup Delay.</p></td></tr><tr><td>Rebuffering Wait Count</td><td>buffcount</td><td><p></p><p>Total number of times a session experiences buffering events during playback.<br>Average Buffering Wait Count: <code>Avg BWC = B</code><sub><code>w</code></sub><code>S</code><br>Where:</p><ul><li><em>B</em><sub><em>w</em></sub> = Total Buffering Wait Count across all sessions</li><li><em>S</em> = Total number of sessions</li></ul></td></tr><tr><td>Connection Induced Rebuffering Ratio (CIRR)</td><td>bufferingratiocirr</td><td><p></p><p>Proportion of time spent buffering due to network issues relative to total watch time.<br>Formula: <code>CIRR = T</code><sub><code>b /</code></sub><code>T</code><sub><code>w</code></sub><code> *100</code><br>Where:</p><ul><li><em>T</em><sub><em>b</em></sub> = Total buffering time caused by network issues (seconds)</li><li><em>T</em><sub><em>w</em></sub>= Total watch time (seconds)</li></ul></td></tr><tr><td>Video Rebuffering Ratio (VRT)</td><td>bufferingratiovrt</td><td><p></p><p>Percentage of time (in seconds) after a user initiates seeking until the video begins playing again.<br>Formula: <code>VRT = T</code><sub><code>r/</code></sub><code>T</code><sub><code>w</code></sub><code> × 100</code><br>Where:</p><ul><li><em>T</em><sub><em>r</em></sub> = Buffering time from seek completion to playback resumption (seconds)</li><li><em>T</em><sub><em>s</em></sub> = Total watchtime (seconds)</li></ul></td></tr><tr><td>Exit Before Video Start (EBVS)</td><td>startupabandonmentrate</td><td>Measures the number of playback attempts that terminated before the video started playing (i.e., before the first frame is displayed).</td></tr><tr><td>VDS Active</td><td>isvdsactive</td><td>Total time where Audio for accessibility support was switched on</td></tr><tr><td>Subtitle Active</td><td>issubtitleactive</td><td>Total time where subtitles were switched on</td></tr><tr><td>Q Metric</td><td>qualityofexperience</td><td><p></p><p>An overall score (0-100) measuring user experience during video playback, factoring in latency and buffering penalties, adjusted by a session factor.<br>Formula: <code>Q = S</code><sub><code>f</code></sub><code> × (1 - W</code><sub><code>l</code></sub><code> × P</code><sub><code>l</code></sub><code>) × (1 - W</code><sub><code>b</code></sub><code> × P</code><sub><code>b</code></sub><code>) × 100</code><br>Where:</p><ul><li><em>P</em><sub><em>l</em></sub><em> = 1 - e</em><sup><em>-k</em><sub><em>l</em></sub><em> × L</em></sup> = Latency penalty</li><li><em>P</em><sub><em>b</em></sub><em> = 1 - e</em><sup><em>-k</em><sub><em>b</em></sub><em> × B</em></sup> = Buffering penalty</li><li><em>W</em><sub><em>l</em></sub> = Weight for latency penalty</li><li><em>W</em><sub><em>b</em></sub> = Weight for buffering penalty</li><li><em>k</em><sub><em>l</em></sub> = Latency decay constant</li><li><em>k</em><sub><em>b</em></sub> = Buffering decay constant</li><li><em>L</em> = Latency (e.g., Startup Delay in seconds)</li><li><em>B</em> = Buffering Ratio</li><li><em>S</em><sub><em>f</em></sub> = Session factor (context-specific multiplier)</li></ul></td></tr><tr><td>Smoothness Score</td><td>smoothnessscore</td><td><p></p><p>A score (0-100) indicating playback smoothness, based on the frequency of buffering events and the buffering ratio.<br>Formula: <code>S = 1√(1 + (B</code><sub><code>w</code></sub><code> / k)</code><sup><code>2</code></sup><code>) × 50 + e</code><sup><code>-k</code><sub><code>b</code></sub><code> × B</code></sup><code> × 50</code><br>Where:</p><ul><li><em>B</em><sub><em>w</em></sub> = Buffering Wait Count (number of buffering events)</li><li><em>B</em> = Buffering Ratio</li><li><em>k</em> = Scaling constant for buffering wait count</li><li><em>k</em><sub><em>b</em></sub> = Buffering decay constant</li></ul></td></tr><tr><td>Signal Strength</td><td>signalstrength</td><td>Average WiFi signal strength</td></tr><tr><td>Wifi Data Rate</td><td>wifidatarate</td><td>WiFi connection max data rate</td></tr><tr><td>Wifi SSID</td><td>wifissid</td><td>WiFi Service Set Identifier (SSID)</td></tr><tr><td>Bitrate</td><td>cbrbitrate</td><td>Average bitrate experienced during a video stream, calculated only for played segments.</td></tr><tr><td>Bandwidth</td><td>bandwidth</td><td>Average bandwidth of the last set of segment. Sent in every statistical payload( every 30s )</td></tr><tr><td>Average bitrate upscale %</td><td>bitrateupscalepct</td><td>Average % of all bitrate upscales per session. Averaged over all sessions.</td></tr><tr><td>Average bitrate downscale %</td><td>bitratedownscalepct</td><td>Average % of all bitrate downscales per session. Averaged over all sessions.</td></tr><tr><td>Max bitrate downscale %</td><td>maxbitratedownscalepct</td><td>Max % of all bitrate downscales per session. Averaged over all sessions.</td></tr><tr><td>Max bitrate upscale %</td><td>maxbitrateupscalepct</td><td>Max % of all bitrate upscales per session. Averaged over all sessions.</td></tr><tr><td>Average resolution upscale %</td><td>resupscalepct</td><td>Average % of all resolution upscales per session. Averaged over all sessions.</td></tr><tr><td>Average downscale upscale %</td><td>resdownscalepct</td><td>Average % of all resolution downscales per session. Averaged over all sessions.</td></tr><tr><td>Max resolution upscale %</td><td>maxresupscalepct</td><td>Max % of all resolution upscales per session. Averaged over all sessions.</td></tr><tr><td>Max resolution downscale %</td><td>maxresdownscalepct</td><td>Max % of all resolution downscales per session. Averaged over all sessions.</td></tr><tr><td>Request failure count</td><td>rf&#x3C;video | audio | pir | drm | init | encryption | mainfest>count</td><td>Count of specific request failure events</td></tr></tbody></table>
{% endtab %}

{% tab title="Dimensions" %}

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

### Ads related metrics and dimensions

{% tabs %}
{% tab title="Ad Metric" %}

<table><thead><tr><th width="140.66666666666666">Metric Name</th><th width="252">Metric (API)</th><th>Description</th></tr></thead><tbody><tr><td>Ad Fill Rate</td><td>adfillrate</td><td>Percentage of number of ads served divided by the total number of ad requests that the server makes</td></tr><tr><td>Ad Impressions</td><td>adimpression</td><td>The number of times an advertisement is loaded and displayed to a user, regardless of whether it was fully played or interacted with.</td></tr><tr><td>Ad View Time</td><td>adviewtime</td><td>Total time in seconds where ads were viewed by users</td></tr><tr><td>Ad Plays</td><td>adplay</td><td>The number of times an advertisement successfully starts playing, reaching at least the first frame of the ad content.</td></tr><tr><td>Ad Errors</td><td>aderror</td><td>Number of ad errors that occurred anytime during an ad’s lifecycle</td></tr><tr><td>Ad Blocks</td><td>adblock</td><td>Number of ads blocked</td></tr><tr><td>Ad Startup Delay</td><td>adlatency</td><td>Ad Startup Delay is the time taken for the ad to start playing back </td></tr><tr><td>Ad Buffering Ratio</td><td>adbufferingratio</td><td>Ad Buffering Ratio is the percentage of ad viewing time spent in buffering</td></tr><tr><td>Ad Abandons</td><td>adstartupabandonmentrate</td><td>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</td></tr><tr><td>25% Complete</td><td>adfirstquartilepct</td><td>This indicates the percentage of ads played to 25% of the duration of the ad</td></tr><tr><td>50% Complete</td><td>adsecondquartilepct</td><td>This indicates the percentage of ads played to 50% of the duration of the ad</td></tr><tr><td>75% Complete</td><td>adthirdquartilepct</td><td>This indicates the percentage of ads played to 75% of the duration of the ad</td></tr><tr><td>100% Complete</td><td>adcompletionrate</td><td>This indicates the percentage of ads played to 100% of the duration of the ad</td></tr><tr><td>Ad Skipped</td><td>adskippercentage</td><td>The percentage of ads that were skipped by the user.</td></tr><tr><td>Click through ratio</td><td>adclickthroughrate</td><td>Percentage of ad impressions that result in a user click.</td></tr></tbody></table>
{% endtab %}

{% tab title="Ad dimensions" %}

<table><thead><tr><th width="197">Dimension Name</th><th width="181">Dimension (API)</th><th>Description</th><th data-hidden>Collection Type</th></tr></thead><tbody><tr><td>Ad Server</td><td>adserver</td><td>Server user for AD</td><td>Automatic</td></tr><tr><td>Ad Position</td><td>adposition</td><td>Position of the AD - [Pre | Mid | Post] </td><td>Automatic</td></tr><tr><td>Pod Index</td><td>adpodindex</td><td>Location of the pod </td><td>Automatic</td></tr><tr><td>AD Position in POD</td><td>aspositioninpod</td><td>Position of the Ad in a Pod</td><td>Automatic</td></tr><tr><td>Pod Length</td><td>adpodlength</td><td>Total duration of the AD Pod</td><td>Automatic</td></tr><tr><td>Ad ID</td><td>adid</td><td>Identifier of the AD</td><td>Automatic</td></tr><tr><td>Ad Universion ID</td><td>aduniversalid</td><td>Universal ID of the AF</td><td>Manual</td></tr><tr><td>Ad Creative URL</td><td>adurl</td><td>URL of the Ad Creative</td><td></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

### Smartquery Query Parameters

<table><thead><tr><th width="165.66666666666666">Query Name</th><th width="256">Query (API)</th><th>Description</th></tr></thead><tbody><tr><td>Subscriber Insight</td><td>subscriberdetails</td><td>Provides subscriber details when used as a parameter with Smartquery API  </td></tr><tr><td>Average Viewer Time</td><td>avgviewertime</td><td>Gives average viewer time</td></tr><tr><td>Bounce Rate </td><td>getbouncerate</td><td>Gives bounce rate</td></tr><tr><td>Happy Viewers</td><td>gethappyviewers</td><td>Gives number of happy users</td></tr><tr><td>Inactive Users</td><td>getinactiveusers</td><td>Provides number of inactive users</td></tr></tbody></table>

***