Track video playback quality and viewer engagement through the ApsaraVideo Player SDK. Key metrics include playback failure rate, first frame time, and buffering rate.
Deprecation notice: Alibaba Cloud has deprecated this feature. The upgraded Playback Quality Monitoring (New) supports multi-dimensional metrics (buffering rate, network latency, playback success rate) with improved data visualization.
Metrics
QoS metrics
Quality of Service (QoS) metrics measure the playback quality of your application.
|
Metric |
Calculation |
Description |
|
video views |
Total playback initiations through the ApsaraVideo Player SDK. |
A view is counted when your application first calls the |
|
actual views |
actual views = Total video views - Total playback failures - Total startup bounces |
Startup bounces are typically negligible. |
|
first frame time (ms) |
Time from playback request to first frame render. |
Not recorded if playback fails to start. |
QoE metrics
Quality of Experience (QoE) metrics measure user viewing behavior in your application.
|
Metric |
Calculation |
Description |
|
visitors |
Count of unique UUIDs generated by the ApsaraVideo Player SDK. |
Active users of your application using the ApsaraVideo Player SDK. On mobile clients, users are identified by device ID. |
|
average video views per viewer |
average video views per viewer = Total video views / Total visitors |
- |
|
average video duration (seconds) |
AVG (video duration) |
Average duration of all videos played. |
Prerequisites
-
ApsaraVideo Player SDK V5.4.9.2 or later for Android or iOS, or V2.16.0 or later for Web. Download ApsaraVideo Player SDK.
-
A valid license for the Android, iOS, or Web SDK. Obtain a license.
-
The log reporting feature of the ApsaraVideo Player SDK is enabled (enabled by default).
-
Optional: Pass a
traceIdwhen creating a player instance to enable single-point tracing for user- and device-level playback diagnostics. Basic features of ApsaraVideo Player SDK for Android, Basic features of ApsaraVideo Player SDK for iOS, and API operations.
Limitations
Playback data is available for the last three days. Queries cannot span multiple days.
Procedure
-
Log on to the ApsaraVideo VOD console.
-
In the left-side navigation pane, choose Data Center > Playback Quality Monitoring.
-
View metric data across different dimensions.
The Application Overview tab displays four metric panels: video views, actual views, first frame time (ms), and visitors. Switch between QoS Perspective, QoE Perspective, and Operational Data Statistics tabs for different views.
Filter and query data by the following dimensions:
-
Device type, operating system, resolution, and network type.
-
Custom time range within the last three days.
-
Click New Filter Condition to add filters such as SDK version, video format, hardware decoding, carrier, domain name, and province. Save frequently used filter rules for reuse.
Condition
Description
SDK version
The player SDK version in your application.
video format
Video encoding format, such as HLS or FLV.
hardware decoding
Whether hardware decoding is enabled.
carrier
The network carrier.
domain name
Server address hosting the video content.
country
The viewer's country.
province
The viewer's province in China.
-