Audience Retention For A Video

This query provides detailed audience retention metrics for a specific video on your YouTube channel. It shows how well your video maintains viewer attention throughout its duration and how it performs compared to similar videos.

To retrieve data you have to replace VIDEO_ID with a video ID of a video from your channel in the filter field.

Tip: How can I find the video ID of a YouTube video?

Example Output

Parameters

Dimension

Fixed to elapsed video time ratio:

• Elapsed Video Time Ratio: Points throughout the video duration, represented as a ratio from 0 to 1.

Start Date

The beginning date for fetching analytics data in format YYYY-MM-DD (e.g., 2024-01-01).

• Cannot be in the future.

End Date

The end date for fetching analytics data in format YYYY-MM-DD (e.g., 2024-09-30).

• Cannot be in the future.
• Must be after Start Date.

Tip: For scheduled requests, you may need to update the date daily. Instead of specifying the date manually, you can use 'today' or 'yesterday' as the parameter. When the request runs, the date will automatically adjust to the desired day.

IDs

Specifies the channel for which to retrieve data.

• Options:
  • "channel==MINE": Fetches data for your own channel.
  • "channel==CHANNEL_ID": Retrieves data for a specific channel you own.

Sort (Optional)

Determines the order of results:

• Can sort by either audienceWatchRatio or relativeRetentionPerformance.

Filters

The filter is pre-set with two conditions:

• 'video==VIDEO_ID': Replace VIDEO_ID with the ID of a video from your channel.
• 'audienceType==ORGANIC': Specifies organic viewership (non-paid views).

Columns

• Dimension: The elapsed video time ratio (0.0 to 1.0, representing the percentage of video duration).

• Audience Watch Ratio: The percentage of viewers still watching at each point in the video, shown as a decimal between 0 and 1.

  • Example: 0.75 means 75% of viewers are still watching at that point.

• Relative Retention Performance: How your video's retention compares to YouTube videos of similar length.

  • Values above 1.0 indicate better-than-average retention.
  • Values below 1.0 indicate below-average retention.

Notes

• The elapsed video time ratio provides data points throughout the video duration, allowing you to identify exactly where viewers drop off.
• Relative retention performance helps you understand how your video performs compared to similar content on YouTube.
• The audienceType filter is set to ORGANIC to focus on natural viewer behavior.
• This query specifically analyzes a single video's retention metrics - you must provide a valid video ID in the filter.