Find out why viewers drop off
Use FastPix Video Data APIs to identify the causes of viewer churn — from low-engagement segments down to root-cause errors.
Use FastPix Video Data APIs to identify the causes of viewer churn — from low-engagement segments down to root-cause errors.
Business question: Identify causes of viewer churn.
Here’s the API workflow below:
Use the list breakdown values endpoint with the playing_time metric to find regions/devices with poor engagement:
The response data shows India (IN) as a low-engagement region because of low total content playing time.
Use list video views endpoint with a country=IN filter to retrieve all views from the region “India”:
This API request returns views with viewWatchTime included in each entry (even if not filterable).
Manually filter the response to isolate sessions with low viewWatchTime (e.g., <30 seconds).
Example client-side filtering:
You can use the get video view details endpoint to inspect individual sessions:
Based on the diagnosis of individual sessions, network errors are rampant. So the best idea would be to filter these views. To apply appropriate filter one can use listing the dimensions and it will list all the available dimensions.
From the response, you have all the dimensions to segment the data further. But, since you might want to further drill into the errors, you would need the error_code dimension for the next steps.
PLEASE NOTE
If you are already aware of the dimensions, then you can ignore this step or restrain from repeating this step again.
Since we already know that the issue is network errors we will check which ASN is facing more issue by breaking the error percentages across the ASN values using the list breakdown values API.
Here you can use the playback_failure_percentage metric ID and get the breakdown values for all the views with error_code as network_error. Further to know the error percentage across different ASN, use groupBy=asn.
This response shows two ASN names with the error percentages as 60% (0.6) and 40% (0.4) along with the total number of views affected by the error.
Outcome: If fragLoadError rises from missing files, encoding issues, or server misconfigurations, fixing those problems should take priority over CDN optimization. However, if network-related issues like latency, congestion, or routing inefficiencies are contributing factors, then optimizing your CDN setup for ASN AS18209 Atria Convergence Technologies Ltd., can help mitigate these problems and improve playback reliability.