ApsaraVideo VOD:Playback quality dashboard

Prerequisites

Before you use the playback quality dashboard, ensure that the following prerequisites are met:

• You must use ApsaraVideo Player SDK. Ensure that your license is valid and that log reporting is enabled. Log reporting is enabled by default. The supported versions are Native SDK 7.6.0 or later and Web SDK 2.33.0 or later. Download ApsaraVideo Player SDK.

• Optional: Pass the traceId parameter when you create a player. You can then use single-point tracing to locate a specific user or device, analyze playback behavior, and quickly identify issues such as playback exceptions. For more information, see Quick start for Android, Quick start for iOS, and Web player API reference.

Features

The playback quality dashboard includes the Metric Trends, Quality of Service (QoS), and Quality of Experience (QoE) modules. The metrics for each module are listed below:

View metric trends

1. Log on to the ApsaraVideo VOD console.

2. In the navigation pane on the left, choose Data Center > Playback Quality (New).

3. On the Metric Trends tab, set the filter conditions as prompted.

   The filter conditions are described as follows:

   Note

   1. In General Configurations, confirm the License Region. This is your business region. The default region is Chinese mainland, Hong Kong, Macao, and Taiwan.

   2. In the application list, you can select Sample Demo to view sample data. The playback data for Sample Demo is preset.

   Condition	Description
   Application	Search for or select an application under your account from the drop-down list.
   Client type	Web or Native.
   System type	Select a system type from the drop-down list. By default, full data is displayed. The mappings are as follows: Web: includes Android, iOS, Harmony, Windows, MacOs, and Linux. Native: includes Android, iOS, and Harmony.
   Metric selection	Select the data metrics you want to view from the drop-down list. This includes all 23 metrics from the QoS and QoE modules. By default, eight metrics are selected, including fast startup rate, time to first frame, play failure rate, and plays.
   Time range	This feature supports period-over-period comparison. You can set a custom time range or select Last 7 Days, Last 14 Days, or Last 30 Days. Note The default time range is the last 7 days. You can select data from the last year. The time range for a single query cannot exceed one month.
   Granularity	The available granularities vary based on the selected or custom time range: If the query time is within 3 days, you can select 5 minutes, 1 hour, or 1 day. If the query time is between 3 and 7 days, you can select 1 hour or 1 day. If the query time is more than 7 days, you can select 1 day.

4. Click Query. The selected metrics are displayed as cards that show real-time data, period-over-period data, and data comparisons. You can also click any card to view the corresponding data as a chart below the card module.

View QoS and QoE data

1. Log on to the ApsaraVideo VOD console.

2. In the navigation pane on the left, choose Data Center > Playback Quality (New).

3. Select the QoS or QoE tab.

4. Set the filter conditions as prompted.

   Condition	Description
   Application	Search for or select an application under your account from the drop-down list.
   Client type	Web or Native.
   System type	Select a system type from the drop-down list. By default, full data is displayed. The mappings are as follows: Web: includes Android, iOS, Harmony, Windows, MacOs, and Linux. Native: includes Android, iOS, and Harmony.
   Metric selection	The metrics you can view vary based on the tab you select: QoS: You can view 10 metrics, such as fast startup rate, time to first frame, and play failure rate. By default, all are selected. QoE: You can view 13 metrics, such as plays, completions, and unique viewers. By default, all are selected.
   Time range	You can set a custom time range or select Last 7 Days, Last 14 Days, or Last 30 Days. Note The default time range is the last 7 days. You can select data from the last year. The time range for a single query cannot exceed one month.
   Granularity	The available granularities vary based on the selected or custom time range: If the query time is within 3 days, you can select 5 minutes, 1 hour, or 1 day. If the query time is between 3 and 7 days, you can select 1 hour or 1 day. If the query time is more than 7 days, you can select 1 day.

   The Dimension Selection setting lets you group and analyze data by dimensions, such as OS type and app version. You can specify up to three dimensions at a time. The details are as follows:

   Dimension	Description
   Application version	The version number of the current application.
   SDK version	The version number of the ApsaraVideo Player SDK integrated into the application. Supported versions include Native SDK 7.6.0 or later and Web SDK 2.33.0 or later.
   Encoding Format	The codec used for the video file. It includes the following three formats: H264 H265 H266
   Video format	The encapsulation specification used for the video file. It includes the following six formats: MP4 HLS DASH FLV MOV MKV
   Hardware decoding	Indicates whether hardware decoding was enabled during video decoding. The value is Yes or No.
   Network type	The technology used by the device to access the internet. It includes the following seven network types: NoActive WIFI 5G 4G 3G 2G Mobile
   Carrier	Distinguishes playback data by the service provider. It mainly includes the following 11 providers: CMCC TELECOM UNICOM BROADCAST OTHER_CN OVERSEAS GEHUA DR_PENG TOPWAY CERNET TIETONG
   Resolution	The resolution used by the video file. It includes the following six resolutions: Fault Domain (FD). LD SD HD 2K 4K For more information, see Parameters for media assets.
   Domain name	The address of the server where the video content is stored.
   Province	Narrows the playback data scope to a provincial administrative division.
   Error code	The error code generated when a problem occurs during video file playback. For more information, see Mobile error codes.

5. Click Query. The selected metrics are displayed as charts that show real-time data. You can also switch chart styles, refresh a single chart, and zoom in on a chart to view details.

Comparison of new and old versions

The new version of playback quality monitoring optimizes and expands on the original metrics to provide more comprehensive monitoring capabilities. For example:

• Metric trends: A new metric trends module is added that supports period-over-period analysis of data at multiple granularities. The general configuration module lets you select a business region for fine-grained data analysis.

• QoS metrics: More granular metrics are added to the original core metrics, such as playback failure rate, fast startup rate, and rebuffering rate. This helps you analyze playback performance with greater precision.

• QoE metrics: This module provides deeper insights into user experience data, such as completion rate and average playback duration per user. This helps operations teams better understand user behavior.

In addition, the new version supports filtering and querying data by multiple dimensions, such as client type, system type, resolution, and network type. You can also define custom filter conditions, such as SDK version, video format, and hardware decoding, for more fine-grained analysis.

The following table provides a detailed comparison of the metrics.

✔️ indicates that the metric is supported. ❌ indicates that the metric is not supported. — indicates that the metric is not applicable.