Views by Traffic Source in a Country

This query provides analytics data about how viewers from a specific country are finding your YouTube videos, breaking down views and engagement metrics by different traffic sources. Data shows how viewers discover and interact with your content in different regions.

Example Output

Parameters

Dimension

The dimension is set to "Traffic Source Type" which breaks down metrics by how viewers discovered your videos.

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:

• Examples:
  • "-views" for sorting by views in descending order.
  • "-estimatedMinutesWatched" for sorting by watch time in descending order.
  • "-averageViewDuration" for sorting by average view duration in descending order.

Tip: You can find the technical names of the metrics you can sort by when you click on the chart symbol at the bottom of the Parameters section.

Filters

Defines specific data criteria:

• Required filter to specify the target country:
  • Example: "country==US" for United States
  • Can use any valid ISO country code (GB, DE, JP, etc.)

Columns

• Dimension: Type of traffic source (e.g., YouTube search, suggested videos, external websites).

• Views: Total number of video views from each traffic source in the specified country.

• Estimated Minutes Watched: The estimated total number of minutes that viewers from the specified country spent watching videos from each traffic source.

• Average View Duration: Average length of time viewers from the specified country watched videos from each traffic source, measured in minutes.

Notes

• Results show data filtered by the specified country code
• Traffic sources include:
  • YouTube search
  • Suggested videos
  • Channel pages
  • External websites
  • Social media platforms
  • YouTube playlists
  • YouTube browse features
  • Notifications
  • Direct or unknown traffic
• Different traffic sources may show varying levels of engagement
• Understanding traffic sources by country can help optimize content distribution and promotional strategies for specific regions