Device Type Metrics

This query provides performance metrics broken down by device type (e.g., mobile, desktop, tablet) for your YouTube channel content. It helps understand how viewers on different devices engage with your content.

Example Output

Parameters

Dimension

The dimension is set to "deviceType" which breaks down metrics by the type of device used to watch the content.

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)

Can be used to order results by different metrics:

• Examples:
  • "-estimatedMinutesWatched" for sorting by watch time in descending order
  • "-views" for sorting by views 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 (Optional)

Optional filters can be applied to narrow down the data:

• Example: "video==VIDEO_ID" to analyze device metrics for a specific video

Maximum Results

• API natively supports 50 results per page
• Can retrieve up to 500 results through pagination
• Default is set to 10 in the example

Columns

• Dimension: The type of device (e.g., MOBILE, DESKTOP, TABLET, TV, GAME_CONSOLE).

• Views: Total number of video views from each device type.

• Estimated Minutes Watched: The estimated total number of minutes that viewers spent watching videos on each device type.

• Average View Duration: Average length of time viewers on each device type watched the videos (in minutes).

Notes

• Data is automatically formatted in the sheet with timestamps and filters
• Results show how different devices contribute to your channel's overall performance
• Useful for optimizing content for specific device types
• The query provides insights into viewer behavior across different platforms