Out-of-the-box Metrics & Dimensions

Here is a list of out-of-the-box metrics and dimensions that are automatically collected by the Video Analytics adapter.

Metrics

METRIC	DESCRIPTION
Unique Users (#)	A count of unique users for a selected time range. Unique users are defined as the unique combination of Device, IP Address, and User ID (in case it is reported by the plugin).
Subscribers (#)	A unique count of User IDs for the selected time range.
Stops (#)	A count of stop events which represent the end of a play in the selected time range. This metric can be used to highlight peaks in stops which might represent outages.
Plays vs Completion Rate	It 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.
Plays vs Jointime	Distribution of Playtime across predefined Join Time buckets. This engagement metric provides detail on how the Join Time metric affects the time users spend watching each video.
Plays vs BitRate	Distribution of Playtime across predefined Bitrate buckets. This engagement metric provides detail on how bitrate affects the total time users spend watching for each video.
Plays vs Playtime	Distribution of play events across predefined Playtime buckets. This metric defines how many plays per each Playtime bucket.
Plays vs Buffer Ratio	Distribution of Playtime across predefined buffer ratio buckets. This engagement metric provides detail on how buffer ratio affects the total time users spend watching each video. Generally, views affected by lower buffer ratios last longer than views affected by higher buffer ratio.
Plays vs Playtime	Distribution of play events across predefined Avg. Playtime buckets. This metric defines how many plays per Avg. Playtime bucket.
Healthy Plays (>30sec) (#)	A count of plays without error events that have a playtime longer than 30 seconds.
Bandwidth (Gbps) (Σ)	A sum of the amount of data in Gbps transmitted during the selected time range. This metric is calculated as the aggregation of all bitrates consumed and is expressed in Gbps.
Plays (#)	A count of all play attempts received by the player for the selected time range. This may include auto-plays which do not represent intentional user action.
Plays Initiated (#)	A count of all plays for which playback has initiated, for at least one video frame.
Concurrent Plays (#)	A count of plays consuming video at any point in the minute selected. For granularities larger than 1 minute, this metric represents an approximation of the average concurrent plays per minute.
Active Plays (#)	A count of plays which are still consuming video at the end of the minute selected. For granularities larger than 1 minute, this metric represents an approximation of the average active plays per minute.
EBVS (#)	A count of plays which have ended without crashing before the first frame of video has been displayed. EBVS stands for Exit Before Video Start.
EBVS (%)	A percentage of plays which have ended without crashing before the first frame of video has been displayed. EBVS stands for Exit Before Video Start.
Avg. Time before EBVS	An average of the time between a play starting and an EBVS (Exit Before Video Start).
Avg. Pause Time	An average of the time each play spends paused for the selected time range.
Avg. Seek Time	An average of the loading time associated with seek events for all plays for the selected time range.
Effective Playtime (Σ)	A sum of playing time associated with video being watched for all plays for the time range selected. Join time, seek time, buffer time and pause time are excluded.
Playtime (Σ)	A sum of playing time for all plays for the time range selected.
Seek (#)	A count of seek events in the selected time range.
Traffic (Σ)	An aggregate of the traffic (GB) being streamed for all initiated plays. This metric is calculated for all players reporting bitrate consumed for the selected time range.
Avg. Bitrate (Mbps)	An average of the bitrate in Mbps consumed by players during plays, for the time range selected.
Avg. Buffer Duration	An average of buffer duration in seconds for all plays for the selected time range. The average buffer duration is calculated by taking the sum of all buffer time and dividing by the count of buffer events.
Avg. Join Time	An average in seconds of the time from a play starting to when the first frame is shown, also referred to as initial buffer. 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.
Avg. Throughput	An average of the bits per second that can be delivered successful for the selected time range.
Buffer Ratio	A percentage of playtime consumed by rebuffering. This metric is obtained by dividing the buffering time by the total playtime. Initial join buffer (join time) is not included.
Buffer Time (Σ)	A sum of the time associated with buffer events for all plays. This does not include plays' initial buffer, or join time.
Happiness Score	A numeric score out of 10 based on quality parameters and view length. Plays lasting less than 10s are assigned a score of 0.
Playback Stalls (%)	The playback stalls value is 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.
Errors (#)	A sum of all error events impacting plays, including startup errors and in-stream errors, for the selected time range.
Interruptions (#)	A count of buffer events impacting initiated plays.
Interruptions (%)	A ratio showing the rate of buffer events impacting plays for the selected time range. This metric is calculated by dividing the number of buffer events by concurrent plays.
Rebuffered Plays (%)	A percentage of rebuffered plays compared to all plays. Rebuffered plays are plays which have experienced at least one buffer event (interruption) and have a playtime of at least 1 minute.
Avg. Completion Rate (%)	An average of the percentage of media duration consumed. This is calculated as an average of effective playtime divided by media duration, as a percentage, for all plays in the selected time range.
Avg. Media Duration	An average of the duration associated with plays, which is usually only reported for VoD content which has a specified duration.
Crashes due to In-Stream Errors (#)	A count of all play crashes caused by in-stream errors for the selected time range. In-stream errors is a metric that shows the number of errors suffered by successfully initiated plays.
Crashes due to In-Stream Errors (%)	A percentage of concurrent play crashes caused by in-stream errors per minute. In-stream errors is a metric that shows the number of errors suffered by successfully initiated plays. Plays can have multiple in-stream errors at any point during the stream, therefore using concurrent plays as a base provides an accurate measure of the real-time impact.
Crashes due to Startup Errors (#)	A count of all play crashes due to startup errors for the selected time range. Startup errors is a metric that shows the number of errors occurred before initiating a play. Initiated plays is the count of all plays for which playback has initiated, for at least one video frame.
Crashes due to Startup Errors (%)	A percentage of all play crashes due to startup errors for the selected time range. Startup errors is a metric that shows the number of errors occurred before initiating a play. Initiated plays is the count of all plays for which playback has been initiated, for at least one video frame.
In-Stream Error (#)	A count of all in-stream errors for the selected time range. In-stream errors is a metric that shows the number of errors suffered by successfully initiated plays.
In-Stream Error (%)	A percentage of concurrent plays impacted by in-stream errors per minute. In-stream errors is a metric that shows the number of errors suffered by successfully initiated plays. Plays can have multiple in-stream errors at any point during the stream, therefore using concurrent plays as a base provides an accurate measure of the real-time impact.
Startup Error (#)	A count of play attempts resulting in a startup error, for the selected time range. Startup errors occur before the first frame of video is shown.
Startup Error (%)	A percentage of play attempts resulting in a startup error, for the selected time range. Startup errors is a metric that shows the number of errors occurred before initiating a play. Initiated plays is the count of all plays for which playback has initiated, for at least one video frame.
Unique_Device_ID (#)	A unique count of device ID for play or session events for the selected time range.
Playtime vs Join Time	Distribution of Playtime across predefined Join Time buckets. This engagement metric provides detail on how the Join Time metric affects the time users spend watching each video.
Playtime vs Buffer Ratio	Distribution of Playtime across predefined buffer ratio buckets. This engagement metric provides detail on how buffer ratio affects the total time users spend watching each video. Generally, views affected by lower buffer ratios last longer than views affected by higher buffer ratio.
Playtime vs Bitrate	Distribution of Playtime across predefined Bitrate
Abandoning Plays (<60sec) (#)	A count of plays which have initiated but ended without error in the first 60 seconds of playback.
Peak Concurrent Plays (#)	A maximum of concurrent plays within one minute for the time range selected.
Switches per View	The total number of switches (defined as the number of new resolutions, bitrates, renditions, CDNs) your audience had in one playback, independently if it switches back to a former value.
Renditions per View	The total number of times your audience experiences a change of rendition within a single playback session. Whether the rendition changes from the highest quality to the lowest quality or just a slight change, this will always count as one switch.
Rendition Switches (#)	A count of switches between different renditions during playback across your audience, including switches back to previously seen renditions.

Dimensions

DIMENSION	DESCRIPTION
Play Head	Filter your data by the last play head position for a given time range.
Start Time	Filter your data by the start time of a video session.
End Time	Filter your data by the end time of a video session.
Country	Filter your data by the country in which the video content is being consumed based on the geographical location of their IP address.
City	Filter your data by the city in which the video content is being consumed based on the geographical location of their IP address.
Zip/Postal Code	Filter your data by the postal code in which the video content is being consumed based on the geographical location of their IP address.
State/Province	Filter your data by the state/province in which the video content is being consumed based on the geographical location of their IP address.
Region	Filter your data by the region in which the video content is being consumed based on the geographical location of their IP address.
Latitude	Filter your data by latitude coordinates in which the video content is being consumed, based on the geographical location of their IP address.
Longitude	Filter your data by longitude coordinates in which the video content is being consumed, based on the geographical location of their IP address.
ISP	Filter your data by the end-user's Internet Service Provider.
Connection Type	Filter your data by the type of connection being used to play video content, whether it's through 3G, 4G, or Wi-Fi.
CDN	Filter your data by the Content Delivery Network being used to deliver the video content to the end-user.
ASN	Filter your data by the Autonomous System Number associated with the network that is in charge of the video traffic.
Viewing Mode	Filter your data based on the mode in which content is being consumed. For example, if you would like to only see data being viewed through streaming or offline, this is the right dimension for you. This dimension is automatically populated based on the offline option.
Streaming Protocol	Filter and divide your data between various streaming protocols (HTTP, RTSP, MMS, TCP, etc.) in use along your platform’s delivery stream.
Resource Domain	Filter your data based on the extended domain of the resource being viewed. This shouldn't be confused with the simple domain URL of the website hosting the video player.
Media Resource	Filter your data per media resource.
Content Playback Type	Filter your data by a specific playback type, such as VOD, LIVE, catch-up, offline. Note, VOD, LIVE, and offline are automatically detected by our technology, whereas catch-up needs to be input by each customer.
User Type	Filter your data by the type of user that is consuming video content. The values accepted for this dimension are Registered/Unregistered User, depending on if the user ID value is sent or not.
Device	Filter 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 Codavel Panel.
Device Type	Filter your data by the type of device being used to stream content, whether it's a TV, PC, Mobile, or any other.
Device Vendor	Filter your data by the organization that brands the device being used to stream video content.
Device Model	Filter your data by the model of the device being used to stream video content.
Browser	Filter 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.
Browser Version	Filter 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	Filter your data by the Operating System being used to stream the video content.
OS Version	Filter your data by the version of the Operating System being used to stream the video content.
Plugin Version	Filter your data by the version of the plugin version of the plugins reporting data to the Codavel Panel.
Player	Filter your data by the video player being used to play video content.
Player Version	Filter your data by the version of the play being used to play video content.
Rendition	Filter your data by the rendition data of the view. This allows you to understand how many users are consuming content at each rendition quality.
Error Name	Filter your data by various error names. Each error has an associated code and this dimension allows you to focus on specific platform anomalies.
Error Description	Filter your data by the description of the error. Each error has an associated description and will help you filter your data by errors that are better understood with descriptions than codes.
Playback Status	Filter by this dimension to identify which views are Healthy Plays, EBVS, Plays with In-stream Error, or Plays with Startup Errors.
Crash Status	Filter your data based on whether the view has crashed or not, as well as what type of crash. Possible values: No Crash, Startup Error Crash, or In-stream Error Crash.
IP	Filter your data based on the Internet Protocol being used to deliver content to the end-user.
Happiness Score	Filter all metrics by our unique Happiness Score metric. All metrics are scored based on QoE parameters, which are decided by our intelligent system.
IP Version	Filter 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.
Avg. Bitrate	An average of the bitrate in Mibps or Mbps consumed by players during plays, for the time range selected.