Contents x
    Metrics and dimensions
    • 18 Jan 2024
    • Print
    Contents

    Metrics and dimensions

    • Updated on 18 Jan 2024
    • Print
    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