Video Playback Failures Technical

Video playback failure occurs when video play terminates due to a playback error, such as video file corruption, insufficient streaming resources, or a sudden interruption in the video stream. The Video Playback Failures Technical (VPF-T) metric is an important measure of service quality and audience engagement impacted by performance and playback issues.

Updated 2026-07-27 video-playback-failure-technical

Note: VPFs with errors that match the configured business errors are not counted as VPF-T, but count towards the Video Playback Failures Business (VPF- B) metric so you can distinguish actual technical issues from video playback failures due to business logic issues, such as user limits and playback restrictions. For more details, see Video Playback Failures and Video Playback Failures Business.

Conviva's VPF-T metric can be displayed as a sum or a percentage of the cumulative Ended Plays that terminated with a VPF-T  error in the selected interval. 

As a percentage, VPF-T is the sum of the Ended Plays with VPF-T that terminated with a VPF-T in the selected time period. 

You can use the VPF-T metric to monitor the proportion of ended plays that terminate with VPF-T errors. A high VPF-T count or percentage, or a significant increase in this metric can be an early indication of declining overall player performance or the likelihood of increased fatal playback errors not related to business rules. 

Several conditions must be met for the VPF-T calculation to count a session towards the VPF-T metric:

  • A fatal error is received from the Conviva device library after playback started (after the first i-frame is rendered).
  • The session ends and the total playing time from the playback error to the session end is not more than the last reported buffer length. Buffer Length is reported by device libraries. When not available, a default buffer length of 150 seconds (2.5 minutes) is used. 
  • The playback failure is not related to a configured business logic error.

VPF-T is available in the following formats:

  • Video Playback Failures Technical summary: the number of ended plays with VPF during the selected time period.
  • Video Playback Failures Technical % time series: a time series for the selected time period, where each point is the VPF-T ratio for all Ended Plays during that specific interval.

Note: Conviva lists all the VPF errors the player reports within 90 seconds of the failure in the order in which they were reported. Modifying the player error reporting and error message text can help to clarify which error caused the failure.

Distribution

  • Video Playback Failures  Distribution (only available in the Custom dashboard): each bucket shows the number of Plays that ended with VPF-T within the defined range. This distribution can help you to understand the impact of VPF-T and illustrates the play durations when VPF-T occurred the most.

Related Details

Metric Details Description
Dashboards and Metric Presentation
  • Trends

  • Real-Time

  • MetricLens

  • Error Analysis

  • Viewer Sessions

  • Diagnostics

Dimensions Analyze this metric by specific dimensions to understand the impact and narrow the root cause analysis. For example, filtering for specific ISP and player dimensions can narrow the root cause of the VPF-T to a known provider and player type.
Diagnostics

View detailed information about the VPF in selected time ranges. You can also apply Filters to see where failures are occurring, for example by CDN/Resource and ASN, and which assets are affected most often. For more information, see Diagnostics.

Manual Alerts

Receive alerts when VPF-T errors occur. For more information, see Alerts.

AI Alerts Yes.
Metric Adjustments

None.

For more metric definitions, see the Metric Dictionary.