All Products
Document Center

ApsaraVideo VOD:Playback quality monitoring

Last Updated:Mar 28, 2024

If you use ApsaraVideo Player SDK to play videos, you can use the playback quality monitoring feature to check the playback quality and statistics. The playback quality monitoring feature is implemented based on the event tracking data collected from ApsaraVideo Player SDK. You can use this feature to view playback quality metrics such as failure rate, instant playback rate, and stuttering rate.

Metric description

QoS metrics

Quality of service (QoS) metrics reflect the playback quality of your application.


Calculation method


Video Views (Times)

The total number of playbacks by the application. The number is calculated based on the number of times that ApsaraVideo Player SDK is invoked.

ApsaraVideo Player SDK is considered invoked the first time you call the prepare method in your application. In other scenarios, the playback is not considered a new count. For example, the play method is called again after the playback is paused or a video is played again after the first playback in the loop playback mode.

Actual Playback Quantity (Times)

Actual playbacks = Total playbacks - Total playback failures - Bounces

In most cases, bounces do not occur. You can ignore this item.

First Frame Time (Milliseconds)

The duration from the time when a user initiates a playback request to the time when the first frame appears.

If a startup failure occurs, no first frame time is collected.

QoE metrics

Quality of experience (QoE) metrics represent the playback statistics of users.


Calculation method


Visitors (Users)

Counts the total number of UUIDs that invoked ApsaraVideo Player SDK.

The total number of users who watched the video during the specified time range. Users on mobile devices are identified by device IDs.

Average Video Views Per Viewer (Times)

Average video playbacks per viewer = Total playbacks/Total viewers


Average Video Length (Seconds)

Calculates the average playback duration of all videos.

The average playback duration of all videos.


Before you use the playback quality monitoring feature, make sure that the following conditions are met:

  • ApsaraVideo Player SDK for Android or iOS V5.4.9.2 or later, or ApsaraVideo Player SDK for Web V2.16.0 or later is integrated. For more information about how to download the latest version of ApsaraVideo Player SDK, see ApsaraVideo Player SDK.

  • A valid license is required if you use ApsaraVideo Player SDK for Android or ApsaraVideo Player SDK for iOS. For more information, see Obtain a license. If you use ApsaraVideo Player SDK for Web, submit a request on Yida to enable the playback quality monitoring feature before you obtain the license. For more information, see license in the Usage notes topic.

  • The log reporting feature is enabled. By default, the feature is enabled for ApsaraVideo Player SDKs.

  • Optional: The traceId parameter is passed when you create a player. The traceId parameter is used for user identification. If you pass the traceId parameter, you can use the single-point tracing feature to quickly locate the user or device, analyze playback progress, and identify playback errors. For more information, see Single-point tracing. For more information about the parameter pass-through method, see Basic features of ApsaraVideo Player SDK for Android, Basic features of ApsaraVideo Player SDK for iOS, and API operations.


You can query only the playback data generated in the last three days. The time range on which a query is performed cannot exceed one day.


  1. Log on to the ApsaraVideo VOD console.

  2. In the left-side navigation pane, choose Data Center > Playback Quality Monitoring.

  3. View the metrics in each dimension.


    You can filter data based on the following conditions.

    • The client type, system type, resolution, and network type.

    • The time when the data was generated. You can query data that was generated within the previous three days.

    • The SDK version, video format, decoding method (software decoding or hardware decoding), Internet service provider (ISP), domain name, and province. You can click New Filter Condition to create a custom condition and save it for subsequent use.