Dimensions and Metrics

Last updated on Oct 11, 2021

Dimensions are attributes that can be used to describe and organize non-numerical data. Examples include country, browser, language, and CDN.

Metrics are the quantitative measurements of numerical data associated with dimensions. For example, metrics for the dimension browser might include the number of visits, the average time on site, and the bounce rate.

Contents



Choose from the following tabs to view the available dimensions and metrics.

Dimensions

This section describes all dimensions available within the Analytics package.


Type

Dimension

Description

GEO

City

Filters your data by the city in which the video content is being consumed based on the geographical location of their IP address.

Country

Filters your data by the country in which the video content is being consumed based on the geographical location of their IP address.

Region

Filters your data by the region in which the video content is being consumed based on the geographical location of their IP address.

Network

ISP

Filters your data by the end-user's Internet Service Provider.

Connection Type

Filters your data by the type of connection being used to play video content whether it's through 3G, 4GG or wifi.

CDN

Filters your data by the Content Delivery Network being used to deliver the video content to the end-user.

CDN Node Host

Filters your data by the service/company being used to host your CDN Node Host.

CDN Request Type

Filters your data by the CDN request type used to retrieve content from the Content Delivery Network hosting the content.

ASN

Filters your data by the Autonomous System Number associated with the network that is in charge of the video traffic.

Content























Title

Filters your data by information sorted on media content filenames. From here, you can extract information regarding the most popular files and the end-user's engagement ratio to that content.

Domain

Filters your data by which resource domain was used to access the video content. Use this dimension to refine your content to see precise data, such as which domains are receiving the most traffic or the most errors.

Streaming Protocol

Allows you to divide your data between various streaming protocols (HTTP, RTSP, MMS, TCP, etc.) in use along your platform’s delivery stream

Streaming Type

Displays the streaming type, whether it is a Video on Demand, or LIVE.

DRM

Filters your data by the Digital Rights

Management technology being used to encrypt and protect ad content.

Video Codec

Filters your data by the video codec used within the container format.

Audio Codec

Filters your data by the audio codec used within the container format.

Settings Codec

Filters by the different encoding settings the customer has set in the encoder.

Profile Codec

Filters your data by codec profiles that target specific classes of application. Filter your views by their codec profile to see content with specific requirements.

Container Format

Filters your data by the container format of the content file.

Contracted Resolution

Filters your data by commercialized resolution, with the objective to distinguish the consumption of customers with different resolution contracts (e.g., Netflix plans with access to SD, HD or UHD qualities).

Package

Filters your data by a specific package such as Warner Bros, Paramount, Disney, Netflix, HBO, among others.

Saga

Filters your data by a specific saga, known as a collection of related films in succession that share the same fictional universe, or are marketed as a series. Note, saga dimensions for VOD movies are equivalent to VOD tv shows.

Program

Filters your data by a specific program production that features a particular person or work or topic.

TV Show

Filters your data by a specific TV show. Note, saga dimensions for VOD movies are equivalent to VOD tv shows.

Season

Filters your data by a specific season or sequence of related series

programmes, such as first, second or third season of a specific series.

Title Episode

Filters your data by a specific content channel.

Channel

Filters your data by the channel being tuned into to view content.

Content ID

Filters your data by a specific content ID (internal content identifier code specifically set by each customer).

IMDB ID

Filters your data by a specific IMBD ID.

Gracenote ID

Filters your data by a specific gracenote ID.

Content Type

Filters your data by a specific content type such as trailer, main, extra, clip, preview.

Content Genre

Filters your data by a specific content genre such as romance, thriller, fantasy, among many others.

Language

Filters your data by the language a user sets when watching content. Note, we take into account the last language recorded when completing a view.

Subtitles

Filters your data by the subtitle a user sets when watching content. Note, we take into account the last subtitle recorded when completing a view.

Contracted Quality Resolution

Filters your data by a specific package quality contracted, also known as commercialized resolution, with the objective to distinguish the consumption of customers with different resolution contracts (e.g. platform plans with access to SD, HD or UHD qualities).

Playback Type

Filters your data by a specific playback type, such as VOD, LIVE, catch-up, offline. Note, VOD, LIVE and off-line are automatically detected by our technology whereas catch up needs to be input by each customer.

User Detail

User Type

Filters your data by the type of user that is consuming video content. This can be a premium user or a free user, for example.

Tracking

User ID

Filters your data by the User ID relevant to the end-user. This dimension will allow you to see the data of a singular user.

Transaction ID

Filters your data by the transaction ID of the content being viewed. Please note this dimension is only applicable if a transaction Id is present.

IP

Filters your data based on the Internet Protocol being used to deliver content to the end-user.

IP Version

Filters your data by the Internet Protocol version being used to deliver video content to the end-user. For example, if you have users whose origin IP address is in v6, you will be able to filter out all these views.

Happiness Score

Filters all metrics by our unique Happiness Score metric. All metrics are scored based on QOE parameters which are decided by our intelligent system.

Device / Browser / OS

Device

Filters your data by the device being used to stream the video content. Device is gathered using the user agent of the requests that are communicating with the Analytics package.

Device Type

Filters your data by the type of device being used to stream content whether it's a TV, PC, Mobile or any other.

Device Vendor

Filters your data by the organization that brands the device being used to stream video content.

Device Model

Filters your data by the model of the device being used to stream video content.

Browser

Filters your data by the browser being used to stream the video content. This dimension is only applicable when being viewed on a device capable of utilizing browsers.

Browser Version

Filters your data by the version of the browser being used to stream the video content. This dimension is only applicable when being viewed on a device capable of utilizing browsers.

OS

Filters your data by the Operating System being used to stream the video content. This dimension is only applicable when being viewed on a device capable of utilizing Operating Systems.

OS Version

Filters your data by the version of the Operating System being used to stream the video content. This dimension is only applicable when being viewed on a device capable of utilizing Operating Systems.

User Agent

Filters your data by the user agent that is relative to the device being used to play video content.

Plugin Version

Filters your data by the version of the plugin version of the plugins reporting data to the Analytics package. This dimension is especially useful to A/B test plugins, also, to distinguish between views reported from native Apps or web views in mobile.

Player

Filters your data by the video player being used to play video content.

Player Version

Filters your data by the version of the play being used to play video content.

App Version

Filters your data by the version of the app being used within the play. For example, filter your data by version 2.1.6 to see all customers consuming content with this version of the app.

App Name

Filters your data by the name of the application being used to deliver content.

Player Name

Filters your data by the name of the video player being used to play content.

Errors

Error Code

Filters your data by various error codes. Each error has an associated code and this dimension will allow you to focus on specific platform anomalies.

Crash Status

Filters your data by the type of error which caused a crash, whether it’s a Startup Error Crash or an In-stream Error Crash.

Metrics

This section describes all metrics available within the Analytics package.

Session Metrics

These are metrics that involve data extracted outside of video playback. 

Type

Metric

Description

Session














Active Users On Site

Number of active users on the site.

Bounce Rate

The ratio of how many users bounce.

Total Sessions

Global amount of started sessions inside your application. The Analytics package understands a session has started the moment a user lands on one of your pages and starts navigating through the entire app. A session may contain different video views and many different navigation and custom events (clicks, banner impressions...). Video playback experiences are not counted for this metric.

Avg. Session Time

Average time length of a session. The Analytics package understands a session has started the moment a user lands in one of your pages and starts navigating through the entire app. A session may contain different video views and many different navigation and custom events (clicks, banner impressions...). Video playback experiences are not counted on this metric.

Pages per Session

Average number of pages seen per session. For web apps, a page is the visited URL; while on native mobile apps, it is the number of screens shown. The Analytics package understands a session has started the moment a user lands in one of your pages and starts navigating through the entire app. A session may contain different video views and many different navigation and custom events (clicks, banner impressions...).

Video Consumption Ratio

Percentage of time videos have been consumed over the total session time. The Analytics package understands a session has started the moment a user lands on one of your pages and starts navigating through the entire app. A session may contain different video views and many different navigation and custom events (clicks, banner impressions...).

Unique User Sessions

Number of Unique Users on an ongoing session. The Analytics package understands a session has started the moment a user lands on one of your pages and starts navigating through the entire app. A session may contain different video views and many different navigation and custom events (clicks, banner impressions...).

Concurrent Sessions

Snapshot of all concurrent sessions in the application. The Analytics package understands a session has started the moment a user lands on one of your pages and starts navigating through the entire app. A session may contain different video views and many different navigation and custom events (clicks, banner impressions...). Video playback experiences are not counted for this metric.

Converted Sessions

Amount of sessions that have played at least one video stream. The Analytics package understands a session has started the moment a user lands on one of your pages and starts navigating through the entire app. A session may contain different video views and many different navigation and custom events (clicks, banner impressions...). Video playback experiences are not counted for this metric.

Unconverted Sessions

Amount of sessions that haven’t played a single video stream. The Analytics package understands a session has started the moment a user lands on one of your pages and starts navigating through the entire app. A session may contain different video views and many different navigation and custom events (clicks, banner impressions…).

Avg. Time to Video

Average time the user spends navigating through the application until a video playback is started.

Avg. Page Time

Average time spent on a single page for all sessions registered on the platform.

Pages (#)

Metric that shows the absolute number of pages viewed on the platform.

Plays per Session

Average amount of plays per session. The Analytics package understands a session has started the moment a user lands on one of your pages and starts navigating through the entire app. A session may contain different video views and many different navigation and custom events (clicks, banner impressions...).

Playback Metrics

These are metrics that involve data extracted during video playback.

Type

Metric

Definition

Audience

Plays

Aggregates all play attempts regardless of whether the play succeeded.

Plays initiated

Aggregates all video play attempts lasting at least one frame.

Concurrent Plays

Displays a snapshot of all concurrent plays consuming video. For granularities greater than a minute (five minutes, one hour, one day, one week, etc.) the total concurrent plays will represent the latest value in the given interval.

Active plays

Shows a cross section of all concurrent plays consuming video and sustained until the end of the minute evaluated

Unique Users

Displays a view of how many unique users were consuming video for a selected period with a defined granularity. Unique Users are defined as the unique number of Plays in a combination of Device, IP address and UserID (if reported in plugins).

Subscribers

Aggregates the unique userIDs registered on the platform for a given interval.

Playtime

Aggregates the hours streamed on the platform. For example, if there were 3600 plays within a given minute, this would be counted as 1 hour streamed during that minute.

Stops

Records the number of terminated views; understood as all stops occurring on the platform in real time.

Traffic

Aggregates traffic (in gigabytes) from all initiated plays and reports the bitrate for a given interval.

Avg. Playtime

Reports the average playtime for all views registered on the platform.

Avg. Effective Playtime

Displays the effective playtime (the average view time for each playback). This view time is computed without considering the Join Time, Buffer Time, Ads Time, Seek Time and Pause Time. So this metric shows the real time that the users have been engaged with the video.

Number of Seeks

Displays the absolute number of seek events registered on the platform.

Avg. Playtime by UU

Displays the average playtime for all unique users registered on the platform.

Avg. Effective Playtime by UU

Displays the effective playtime by unique user is the average view time for each unique user on the platform. This view time is computed without taking into account the Join Time, Buffer Time, Ads Time, Seek Time and Pause Time. So this metric shows the real time that the users have been engaged with the video.

Effective Playtime

Aggregates the number of hours being streamed on the platform. These hours are computed without considering the Join Time, Buffer Time, Ads Time, Seek Time and Pause Time. So this metric shows the real time that the users have been engaged with the video.

Peak Concurrent Plays

Shows the highest number of plays within any granularity during a given period of time.

Avg. Seek Time

Reports the average seek time for all views registered on the platform.

Quality


























Number of Errors

Reports the sum of play failures (errors registered upon player initialization, before being able to join the stream), in-stream failures (errors reported by the player during successfully initiated plays) and midstream crashes (errors reported by the player during successfully initiated plays and the play cannot be recovered).

Errors per Play

This metric reports the ratio of the sum of the number of errors as mentioned in Number of Errors, divided by the number of plays. This metric calculates the quality of performance of your service, taking into account the ratio of plays that encounter any form of error.

Exit Before Video Start “EBVS” (Total)

Reports the number of EBVS occurrences in a given interval. EBVS represents video connection attempts without registered errors that terminated before the first frame of video is displayed.

Exit Before Video Start “EBVS” (Ratio)

Reports the ratio of EBVS to play attempts for a given interval. This ratio is of EBVS from all users attempting a play. EBVS represents video connection attempts without registered errors that have terminated before the first frame of the video is displayed.

Join Time

Displays the time in seconds from when the player is initiated (either via user action or by autoplay) to when the first video content frame is played. 

If there are pre-roll ads, Join Time will be the total time from when the player is initiated to when the first frame of content is played, excluding the length time of pre-roll ads.

Interruptions (Total)

Aggregates the buffer events affecting initiated plays.

Interruptions (Ratio)

Reports the average rate of interruption affecting all sessions for a given interval. This is obtained by dividing the number of buffering events by concurrent plays. The interruptions ratio is a good measure of the frequency of buffers affecting users.

Buffer Ratio

Reports the ratio of length of time users have experienced buffering during a video session. The ratio is obtained by dividing the buffering time by the total playtime. When calculating the ratio, initial stream-join buffering is excluded. A buffer event occurs when the player attempts to play video segments that have not yet downloaded, in which case the player requests more data for playback and stores enough video data to enable the playback.

Buffer Time

Displays the sum of all the buffer time for all views registered on the platform over time.

In-Stream Failures (Total)

Reports number of in-stream failures in the period observed. In-stream failures are errors reported by the player during successfully initiated plays.

In-Stream Failures (Ratio)

Compares concurrent plays to determine how many errors are reported in-flight for concurrent plays. In-stream failures are errors reported by the player on successfully initiated plays.

Avg. Bitrate[1]

Indicates the average bitrate (in Mbps) of players during a playback session.

Bandwidth

Reports the total amount of data transmitted over a given interval, aggregating all bitrates consumed and expressed in Gbps.

Avg. Throughput

Indicates the maximum bits per second that can be delivered successfully.

Play Failures (Ratio)

Compares the play attempts for a given interval and shows a failure ratio of those attempting a play. Play failures are registered at player initialization when a stream is not joined.

Play Failures (Ratio) by UU

Displays the ratio of play failures to total play attempts over a given interval by a unique combination of userID, IP and device. Play failures are player initializations after which video stream cannot be joined.

Play Failures (Total)

Aggregates the play failures for a given interval, registered upon player initialization and before stream is joined.

Exit Before Video Start (EBVS) by UU

Displays the ratio of EBVS to total play attempts in a given interval using unique combinations of userID, IP and device. EBVS represents error-free video connection attempts that terminate before the first frame of the video is displayed.

Buffer Ratio by UU

Displays a ratio of buffering time for a given video using a unique combination of UserID, IP and device. Ratio is derived by dividing buffering time by total playtime. This excludes initial stream join buffer. A buffer event is when a player tries to play a section not yet downloaded, then requests more data for playback and stores enough to enable playback.

Rebuffered Plays

Indicates the play sessions that have been live for at least 60 seconds and have experienced at least one interruption.

Happiness Score

Displays the average happiness score for all plays across the platform. The score is an algorithm extracted from every view based on quality parameters and length of the view. Views below 10 seconds are given a score of 0.

Happiness scores range between 0 and 10 with 10 being excellent and 0 not being ranked.

In-Stream Failure Crash (#)

Aggregates in-stream failures for a given interval that result in video crashing. In-stream failures are errors reported by the player during successfully initiated plays.

Avg. Buffer Duration

Displays the average buffer duration in seconds for all views in the period observed. The average buffer duration is calculated by taking the sum total buffer time of all views and dividing this by the number of buffer events.

Avg. Time between Interruptions

Displays the average time between buffer events (interruptions) in seconds for all views in the period observed. The average time between interruptions is calculated by taking the sum total time between interruptions and dividing this by the total number of blocks in time between interruptions. Plays with only one interruption are not included in this calculation.

Avg. Time between Rendition Switches

Displays the average time between rendition switches for all views in the period observed. The average time between rendition switches is calculated by taking the sum total time between rendition switches and dividing this by the total number of renditions.

Playback Stalls

Displays the playback stalls value as calculated by taking the average buffer ratio for all views on the platform and dividing it by the average number of buffer events (interruptions) per view. For example, if your platform buffer ratio is 5% and the average number of buffer events per view is 2, the playback stall value would be 2.5%. The higher the playback stall value, the fewer interruptions views will have but the longer they will be.

Time to First Frame

Average time in seconds from when the player is initiated (either via user action or by autoplay) to when the first video frame is played, regardless of whether it is an ad or the video content. 

The Time to First Frame metric and the Join Time metric will have the same values if the view does not have prerolls ads. 

Engagement

Playtime vs Join Time

Reports the playtime distribution across predefined join-time buckets, detailing how the join-time metric affects users' time on video.

Playtime vs Buffer Ratio

Reports the distribution of playtime across predefined buffer ratio buckets. Details how buffer ratio affect users' total view time. Generally, views with lower buffer ratios last longer than views with higher buffer ratios.

Playtime vs Bitrate[1]

Reports the distribution of playtime across predefined bitrate buckets, detailing how bitrate affects the total time users spend on each video.

Plays vs Join Time

Displays the distribution of initiated plays across predefined Join Time ratio buckets. This engagement metric defines how many plays each Join Time bucket has on average, providing an idea on how Join Time distributes plays.

Plays vs Buffer Ratio


Displays the distribution of initiated plays across predefined buffer ratio buckets. This engagement metric shows how many plays fall on each Buffer Ratio bucket.  All views should ideally concentrate in the left side of the chart.

Plays vs Bitrate

Displays the distribution of initiated plays across predefined bitrate buckets. This engagement metric showcases how many initiated plays fall for each bitrate bucket.

Plays vs EBVS

Reports the distribution of plays across predefined wait-time buckets occurring before an EBVS, detailing users' average wait before seeing a video's first frame. Long start-up times cause user abandonment. Industry standards see 10% audience loss for each second of wait time after the first second.

Plays vs Playtime

Reports the distribution of play events across predefined playtime buckets, defining the number of plays for each playtime bucket.

Content

Avg. Media Duration

Displays the average duration of all VOD content consumed on the platform. For live content, most players do not report media length.

Plays vs Completion Rate

Displays how many plays reached each level of completion of the video being viewed within the time frame selected. Completion rate is understood as a percentage with 100% meaning the play reached the end of the video, showing at a glance how far into content you’re seeing the most user exits. This can be filtered to showcase how titles are consumed over various networks or devices.

Avg. Completion Rate

Displays the average completion rate of each view initiated within the time interval (dictated by your chosen granularity) over time. Completion rate is understood as a percentage with 100% meaning the play reached the end of the video. Since this metric can be filtered by any dimension, it can showcase how titles are consumed over different networks or devices.

Video Consumption

Displays percentage of users who started a video still viewing it at each point along a video play. Video length is displayed as a percentage of total video length. This metric is available for a maximum seven-day range.

Errors

Startup Error (#)

Counts the number of play attempts that result in a startup error for a selected period of time. Startup errors are registered at player initialization when a stream is not joined. This metric also includes all startup errors that lead to a view crash.

Startup Error (%)

Represents the percentage of total play attempts which result in a startup error for a selected period of time. Startup errors are registered at player initialization when a stream is not joined.

Startup Error Crash (#)

Counts the number of play attempts that result in a startup error which crashed and stopped the play. Startup errors are registered at player initialization when a stream is not joined.

Startup Error Crash (%)

Represents the percentage of total play attempts that result in a startup error which crashed and stopped the play. Startup errors are registered at player initialization when a stream is not joined.

In-Stream Error (#)

Counts the number of in-stream errors in the period observed. In-stream failures are errors reported by the player during playback of successfully initiated plays. This metric also includes all in-stream errors that lead to a view crash.

In-Stream Error (%)

Represents the percentage of initiated plays which contain at least one instream error in the period observed. In-stream errors are errors reported by the player during playback of successfully initiated plays. This metric also includes all in-stream errors that lead to a view crash.

In-Stream Error Crash (#)

Counts the number of in-stream errors which crashed and stopped the play in the period observed. In-stream errors are errors reported by the player during playback of successfully initiated plays.

In-Stream Error Crash

Represents the percentage of initiated (%)   plays that contain an in-stream error which crashed and stopped the play in the period observed. In-stream errors are errors reported by the player during playback of successfully initiated plays. This metric also includes all instream errors that lead to a crash.