Traffic from Subscription for a Video

This query provides detailed metrics about traffic coming from subscriber notifications and feeds for a specific YouTube video. It helps you understand how your subscribers are discovering and engaging with your content through YouTube's subscription system.

Example Output

Parameters

Dimension

Specifies the traffic source detail:

• insightTrafficSourceDetail: Shows detailed information about subscription-based traffic sources.

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:

• Example:
  • "-estimatedMinutesWatched" for sorting by watch time in descending order.

Filters

Required filter combination:

• video==VIDEO_ID;insightTrafficSourceType==SUBSCRIBER
• Replace VIDEO_ID with the ID of a video from your channel.

Maximum Results

Enter a number between 1 and 200 to control the number of results returned (default is 10).

Columns

• Dimension: The specific subscription-based traffic source (e.g., notification bell, subscription feed).

• Views: Number of views received from subscribers through various subscription features.

• Estimated Minutes Watched: The estimated total number of minutes that subscribers spent watching your video through subscription-based discovery.

• Average View Duration: Average time subscribers spent watching your content when discovering it through subscription features, measured in minutes.

Notes

• This query specifically focuses on traffic from subscribers, helping you understand how effectively your videos are reaching your subscriber base.
• Results are typically sorted by watch time to show the most engaging subscription-based traffic sources.
• Understanding subscription traffic can help optimize video publishing times and notification strategies.