Metrics and dimensions
  • 18 Jan 2024

Metrics and dimensions


Article summary

Metrics and dimensions

Why do we use metrics and dimensions?

The analytics tool uses metrics and dimensions to help filter data and help you interpret your data.

Definitions

Metrics are quantifiable measures that track and assess the status of a specific business process, such as video plays, unique users or average playtime.

They can be aggregated and are sums or averages. As well, they can be counted, collected or combined to return a single value.

Available metrics are listed and described in this table.

Dimensions are descriptive attributes or characteristics of data that can be assigned different values. They include locations, devices and operating systems.

Dimensions can be used to further analyze metrics.

As an example, you can use the country or region dimension to find out more about the unique users of a video.

Available dimensions are listed and described in this table.

Table - Metrics in analytics

AUDIENCE - Core metrics

Name

Definition

Plays
views

Aggregates all play attempts in the last time frame regardless of whether or not the playback carried on.

Plays Initiated
successfulPlays

Aggregated metric for all video play attempts that have successfully initiated a playback of at least one video frame.

Concurrent Plays
concurrent

Reports the amount of views where at least one frame of the video is reproduced in the specified time range, independently if it started or finished inside or outside of that time range.

Active Plays
activeSessions

Metric showing a cross-section of all concurrent plays consuming video and sustained until the end of the minute evaluated.

Unique Users
uniques

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).

Playtime
hours

Aggregate number of hours being streamed on the platform. For example, if there are 60 plays connected during the last minute of consuming video, that will count as 1 hour streamed in the last minute.

Stops
stops

Metric that records the total number of views terminated. That metric shows all stops being received in the platform in real time.

Traffic
traffic

Aggregate number of traffic (GB) being streamed in all initiated plays. Aggregate number of traffic (GB) being streamed by all players reporting bitrate consumed for the specified interval.

Avg. Playtime
playtime

Reports the average playtime for all views registered in the platform over time.

AUDIENCE - Advanced metrics

Name

Definition

Traffic P2P
p2pTraffic

Aggregate number of traffic (GB) being streamed in all initiated plays. Aggregate number of traffic (GB) being streamed by all players reporting bitrate consumed for the specified interval.

Effective Playtime
effectiveHours

Aggregate 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.

Avg. Effective Playtime
effectiveTime

Effective Playtime is 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.

Avg. Effective Playtime by UU
uniqueEffectivetime

Effective Playtime by UU is the average view time for each Unique User in 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.

Avg. Playtime by UU
uniquePlaytime

Average playtime for all Unique Users registered on the platform.

Avg. Seek Time
seekTime

Average of all the seek time of all views registered on the platform.

Avg. Pause Time
pauseTime

Pause time is the average pause time for each playback. For example, if looking at an hourly granularity, this metric will show the average pause time per view for a specific hour.

Number of Seeks
seeks

Metric that shows the absolute number of seek events registered on the platform.

Unique Device ID
uniqueDeviceIDs

Number of unique devices consuming video for a selected period with a defined granularity. The device ID dimension should be filled in to have this metric available.

Abandoning Plays (<60sec)
abandonUsers

Number of plays that have initiated the stream successfully but have abandoned before the first minute of the experience without triggering any error.

Peak Concurrent Plays
peakConcurrent

Metric showing a snapshot of the peak concurrent plays for any granularity within a given period of time.

CONTENT

Name

Definition

Avg. Completion Rate
completionRate

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.

Plays vs Completion Rate
viewsVsCompletionRate

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. Media Duration
mediaDuration

Average length of all the VOD content being consumed on the platform. For Live content, a large majority of Players do not report the Media Duration.

Table - Dimensions in analytics

The following tables list the different dimensions that you can use for filtering.

Core dimensions

GEO

Name (API Code)

Defintion

City
city

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

Country
country

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

Region
region

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

ZIP / CP Code
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.

NETWORK

NAME (API Code)

Definition

ISP
isp

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

Connection Type
connectiontype

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

CDN
cdn

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

CDN Node Host
cdnnodehost

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

CDN Request Type
nodetype

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

DEVICE

NAME (API Code)

Definition

Device
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 analytics suite.

Player Name
player

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

CONTENT

NAME (API Code)

Definition

Title
title

Filter your data based on the title of the content being consumed. With this dimension you can focus on a single title and monitor its performance.

Domain
domain

Filter your data by the domain name of the content URL. With this dimension, you can focus on video content from a specific domain name.

Streaming Protocol
streaming_protocol

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

Channel
content_channel

Filter your data by the channel name in your VideoManager Pro account.

Content ID
content_id

Filter your data by the video ID in your VideoManager Pro account.

Channel ID

Filter your data by channel ID in your VideoManager Pro account.

Group ID

Filter your data by ownership Group ID in your VideoManager Pro account. 

Player ID

Filter your data by player ID in your VideoManager Pro account.

Access Source

Filter your data by web page from which viewers accessed your video.

Referrer

Filter your data by the last website from which your viewers accessed your video.

Advanced Dimensions by Category

DEVICE

NAME (API Code)

Definition

Device Type
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
device_vendor

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

Device Model
device_model

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

Browser
browser

Filter 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
browser_ver

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
os

Filter 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
os_version

Filter 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.

RENDITIONS

NAME (API Code)

Definition

Rendition
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.

Rendition Bitrate
rendition_bitrate

Rendition Informed Bitrate.

Rendition Resolution
resolution

Rendition Informed Resolution.


Was this article helpful?

What's Next