This page lists reports that channel owners can retrieve with the YouTube Analytics API. Channel reports provide user activity metrics for a specified channel and measure things like video views, ratings, and subscription counts. - [Video reports](https://developers.google.com/youtube/analytics/channel_reports#video-reports) provide statistics for all user activity related to a channel's videos. - [Playlist reports](https://developers.google.com/youtube/analytics/channel_reports#playlist-reports) provide statistics that are specifically related to video views that occur in the context of a playlist. - [Ad performance reports](https://developers.google.com/youtube/analytics/channel_reports#ad-performance-reports) contain metrics related to revenue and ad performance. They use the [adType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#adType) dimension to group metrics based on the types of ads that ran during video playbacks. The [ad performance reports](https://developers.google.com/youtube/analytics/channel_reports#Ad_Performance_Reports) section explains the two types of ad performance metrics that the API supports. ## Retrieving a report To retrieve a channel report, you must set the `https://developers.google.com/youtube/analytics/v1#Parameters` parameter value in your API request to one of the following values: - `channel==MINE` -- The API returns data for the authenticated user's YouTube channel. - `channel==CHANNEL_ID` -- Set `CHANNEL_ID` to the [unique channel ID](https://developers.google.com/youtube/data/reference/rest/v3/channels#id) of the channel for which you are retrieving data. The user authorizing the request must be the owner of the channel. The channel ID is currently a string that begins with the letters `UC`, though its format is subject to change. (You can find your channel's ID on the [advanced account settings](https://www.youtube.com/account_advanced) page for your YouTube channel, or you can retrieve your channel's ID programmatically using the YouTube Data API's `https://developers.google.com/youtube/data/reference/rest/v3/channels/list` method.) ### Authorization All YouTube Analytics API requests must be authorized. The [Authorization guide](https://developers.google.com/youtube/reporting/guides/authorization) explains how to use the OAuth 2.0 protocol to retrieve authorization tokens. YouTube Analytics API requests use the following authorization scopes: | Scope | Description | |---|---| | https://www.googleapis.com/auth/yt-analytics.readonly | View YouTube Analytics reports for your YouTube content. This scope provides access to user activity metrics, like view counts and rating counts. | | https://www.googleapis.com/auth/yt-analytics-monetary.readonly | View YouTube Analytics monetary reports for your YouTube content. This scope provides access to user activity metrics and to estimated revenue and ad performance metrics. | | https://www.googleapis.com/auth/youtube | Manage your YouTube account. In the YouTube Analytics API, channel owners use this scope to manage YouTube Analytics groups and group items. | | https://www.googleapis.com/auth/youtubepartner | View and manage YouTube assets and associated content on YouTube. In the YouTube Analytics API, content owners use this scope to manage YouTube Analytics groups and group items. | **Note:** Estimated revenue and ad performance metrics are supported for channel reports. To access these metrics, your request must be authorized with the `https://www.googleapis.com/auth/yt-analytics-monetary.readonly` scope. Additionally, the authenticated user's channel must be a member of the YouTube Partner Program. Requesting monetary metrics for a channel that is not in the YouTube Partner Program results in a `403 Forbidden` error. In the report tables throughout this page, metrics marked with an asterisk (\*) are monetary metrics that require this scope and monetization status. ### Filters The tables that explain the supported reports identify the filters that can be used for each report. In the tables, filters shown in parentheses are optional. For example, for the filtering option `video(,country)`, the [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video) filter is required, and the [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country) filter is optional. The API also supports the ability to specify multiple values for the `https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video` and `https://developers.google.com/youtube/analytics/v1/dimsmets/dims#playlist` filters. If you do specify multiple values for one of these filters, you can also add that filter to the list of dimensions that you specify for the request. This is true even if the filter is not listed as a supported dimension for a particular report. See the `https://developers.google.com/youtube/analytics/v1#filters` parameter definition for a complete explanation of how to filter API results for a specific value or set of values. ### Understanding report tables This section explains the formatting and terminology used in the tables that define reports that the API supports. The following table lists the dimensions, metrics, and filters supported for the playback details video report using the time dimension and the [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage) metric. Property Value Dimensions: Use 0 or more [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) Use 0 or 1 [day](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#day), [month](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#month) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage) Filters: Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Use 0 or more [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) The table contains two rows for dimensions, one row for metrics, and three rows for filters. For dimensions and filters, values from each row can be combined in an API request as long as the combination follows the usage rules in the table. So, for example, valid `dimensions` parameter values for this report include: - `dimensions=day` - `dimensions=day,subscribedStatus` - `dimensions=month,subscribedStatus,youtubeProduct` - `dimensions=month,youtubeProduct` However, the parameter value `day,month` is invalid because it uses two time-based dimensions, and the request must use either 0 or 1. While report tables define supported dimensions, metrics, and filters, the API enforces cross-parameter constraints. Querying unsupported or mutually exclusive combinations (such as combining incompatible geographic filters or omitting required parameters) causes an HTTP `400 badRequest` error with the message `The query is not supported`. Review individual report tables on this page for specific restrictions that apply to each report. #### Report table terminology Tables use the following terminology to indicate whether dimensions are required or optional: - These terms mean a value is required: - **Required:** You must include the value. - **Use exactly 1:** You must include one value from the group. - **Use 1 or more:** You can include any or all values from the group, but you must include at least one. - These terms mean a value is optional: - **Optional:** You have the option of include the value. - **Use 0 or 1:** You have the option of including one value from the group. - **Use 0 or more:** You have the option of including any or all values from the group. ## Video reports ### Basic stats #### Basic user activity statistics This report provides statistics related to users' actions on a channel. You can filter the report to only return data for a specific video or country. Property Value Dimensions: \[None\] Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews), [comments](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#comments), [likes](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#likes), [dislikes](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#dislikes), [videosAddedToPlaylists](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#videosAddedToPlaylists), [videosRemovedFromPlaylists](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#videosRemovedFromPlaylists), [shares](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#shares), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage), [annotationClickThroughRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate), [annotationCloseRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloseRate), [annotationImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationImpressions), [annotationClickableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions), [annotationClosableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions), [annotationClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClicks), [annotationCloses](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloses), [cardClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClickRate), [cardTeaserClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate), [cardImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardImpressions), [cardTeaserImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions), [cardClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClicks), [cardTeaserClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks), [subscribersGained](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#subscribersGained), [subscribersLost](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#subscribersLost), [estimatedRevenue](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRevenue)\*, [estimatedAdRevenue](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedAdRevenue)\*, [grossRevenue](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#grossRevenue)\*, [estimatedRedPartnerRevenue](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedPartnerRevenue)\*, [monetizedPlaybacks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#monetizedPlaybacks)\*, [playbackBasedCpm](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playbackBasedCpm)\*, [adImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#adImpressions)\*, [cpm](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cpm)\* Filters: Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) #### Basic user activity statistics for U.S. states This report provides statistics for a particular U.S. state or the District of Columbia. Note that this report only supports a subset of the metrics available in the country-specific report described above. Property Value Dimensions: \[None\] Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage), [annotationClickThroughRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate), [annotationCloseRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloseRate), [annotationImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationImpressions), [annotationClickableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions), [annotationClosableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions), [annotationClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClicks), [annotationCloses](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloses), [cardClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClickRate), [cardTeaserClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate), [cardImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardImpressions), [cardTeaserImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions), [cardClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClicks), [cardTeaserClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks) Filters: Required [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) ### Time-based #### User activity by country for specific time periods This report provides statistics related to user actions on a channel for specific time intervals. You can filter the report to only return data for a specific video or country. Property Value Dimensions: Use exactly 1 [day](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#day), [month](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#month) Optional [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews), [comments](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#comments), [likes](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#likes), [dislikes](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#dislikes), [videosAddedToPlaylists](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#videosAddedToPlaylists), [videosRemovedFromPlaylists](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#videosRemovedFromPlaylists), [shares](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#shares), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage), [annotationClickThroughRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate), [annotationCloseRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloseRate), [annotationImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationImpressions), [annotationClickableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions), [annotationClosableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions), [annotationClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClicks), [annotationCloses](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloses), [cardClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClickRate), [cardTeaserClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate), [cardImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardImpressions), [cardTeaserImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions), [cardClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClicks), [cardTeaserClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks), [subscribersGained](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#subscribersGained), [subscribersLost](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#subscribersLost), [uniques](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#uniques), [estimatedRevenue](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRevenue)\*, [estimatedAdRevenue](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedAdRevenue)\*, [grossRevenue](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#grossRevenue)\*, [estimatedRedPartnerRevenue](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedPartnerRevenue)\*, [monetizedPlaybacks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#monetizedPlaybacks)\*, [playbackBasedCpm](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playbackBasedCpm)\*, [adImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#adImpressions)\*, [cpm](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cpm)\* Filters: Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) #### User activity in U.S. states for specific time periods This report provides statistics related to user activity for a particular U.S. state or the District of Columbia. Note that this report only supports a subset of the metrics available in the country-specific report described above. Property Value Dimensions: Use exactly 1 [day](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#day), [month](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#month) Optional [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage), [annotationClickThroughRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate), [annotationCloseRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloseRate), [annotationImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationImpressions), [annotationClickableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions), [annotationClosableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions), [annotationClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClicks), [annotationCloses](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloses), [cardClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClickRate), [cardTeaserClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate), [cardImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardImpressions), [cardTeaserImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions), [cardClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClicks), [cardTeaserClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks) Filters: Required [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) ### User geography #### User activity by country This report provides statistics related to user activity on a country-by-country basis for a channel. You can filter the report to only return data for a specific video. Property Value Dimensions: Required [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country) Optional [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews), [comments](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#comments), [likes](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#likes), [dislikes](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#dislikes), [videosAddedToPlaylists](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#videosAddedToPlaylists), [videosRemovedFromPlaylists](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#videosRemovedFromPlaylists), [shares](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#shares), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage), [annotationClickThroughRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate), [annotationCloseRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloseRate), [annotationImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationImpressions), [annotationClickableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions), [annotationClosableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions), [annotationClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClicks), [annotationCloses](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloses), [cardClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClickRate), [cardTeaserClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate), [cardImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardImpressions), [cardTeaserImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions), [cardClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClicks), [cardTeaserClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks), [subscribersGained](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#subscribersGained), [subscribersLost](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#subscribersLost), [estimatedRevenue](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRevenue)\*, [estimatedAdRevenue](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedAdRevenue)\*, [grossRevenue](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#grossRevenue)\*, [estimatedRedPartnerRevenue](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedPartnerRevenue)\*, [monetizedPlaybacks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#monetizedPlaybacks)\*, [playbackBasedCpm](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playbackBasedCpm)\*, [adImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#adImpressions)\*, [cpm](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cpm)\* Filters: Use 0 or 1 [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) #### User activity by province This report provides user activity statistics for U.S. states and the District of Columbia. For this report, you must set the `filters` parameter value to `country==US`. Property Value Dimensions: Required [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province) Optional [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage), [annotationClickThroughRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate), [annotationCloseRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloseRate), [annotationImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationImpressions), [annotationClickableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions), [annotationClosableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions), [annotationClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClicks), [annotationCloses](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloses), [cardClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClickRate), [cardTeaserClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate), [cardImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardImpressions), [cardTeaserImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions), [cardClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClicks), [cardTeaserClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks) Filters: Required [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country)==US Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) #### User activity by city (\<= 250 results) **Note:** This report requires you to set the `maxResults` parameter to an integer value of `250` or less. Unlike most other reports, this report also requires you to specify a value for the `sort` request parameter. This report provides user activity statistics by city. Property Value Dimensions: Required [city](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#city) Use 0 or more [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType), [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus) **Note:** If you include the [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province) dimension, you must also use the `https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country==US` filter. Use 0 or 1 [day](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#day), [month](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#month) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage) Filters: Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Sorting options: -[views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views) -[estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched) #### User activity by DMA This report provides user activity statistics by Designated Market Area (DMA). For this report, you must either set the `filters` parameter value to `country==US` or filter to a particular province (U.S. state). Property Value Dimensions: Required [dma](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#dma) Use 0 or 1 [day](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#day) [month](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#month) [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType) [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews) [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views) [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched) [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration) [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage) Filters: Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country)==US [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video) [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Sorting options: -[views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views) -[estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched) ### Playback details Playback detail reports provide statistics related to the following viewing attributes: - Was the view of a live video broadcast or an on-demand video? - Was the viewer subscribed to the channel that owns the video? - On which YouTube product did the view occur? **Note:** The [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand) dimension and filter cannot be used in conjunction with the [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage) metric. As such, each of the following subsections lists two reports. One report supports the [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand) dimension (and filter), while the other supports the [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage) metric. #### User activity by subscribed status This report provides user activity metrics for subscribed and unsubscribed viewers. Statistics can be grouped by time period ([day](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#day) or [month](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#month)), and the report can also be filtered by [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), or [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent). Property Value Dimensions: Use 0 or more [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus) Use 0 or 1 [day](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#day), [month](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#month) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews), [likes](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#likes), [dislikes](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#dislikes), [videosAddedToPlaylists](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#videosAddedToPlaylists), [videosRemovedFromPlaylists](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#videosRemovedFromPlaylists), [shares](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#shares), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage), [annotationClickThroughRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate), [annotationCloseRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloseRate), [annotationImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationImpressions), [annotationClickableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions), [annotationClosableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions), [annotationClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClicks), [annotationCloses](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloses), [cardClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClickRate), [cardTeaserClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate), [cardImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardImpressions), [cardTeaserImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions), [cardClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClicks), [cardTeaserClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks) Filters: Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Optional [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus) #### User activity by subscribed status for provinces This report provides user activity metrics for subscribed and unsubscribed viewers in U.S. states or the District of Columbia. This report supports fewer metrics than the previous report. Property Value Dimensions: Use 0 or more [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus) Use 0 or 1 [day](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#day), [month](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#month) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage), [annotationClickThroughRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate), [annotationCloseRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloseRate), [annotationImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationImpressions), [annotationClickableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions), [annotationClosableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions), [annotationClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClicks), [annotationCloses](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloses), [cardClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClickRate), [cardTeaserClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate), [cardImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardImpressions), [cardTeaserImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions), [cardClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClicks), [cardTeaserClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks) Filters: Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Use 0 or more [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus) #### Playback details with optional time dimension The time dimension -- [day](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#day) or [month](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#month) -- is optional for these reports because, regardless, you need to use the `startDate` and `endDate` request parameters to specify the date range that the report will cover. The dimension, if present, indicates that you want data in the report to be aggregated by day, month, etc. ##### Playback details with optional time dimension and [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand) statistics This report provides playback detail statistics for specific time intervals. It supports the [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand) dimension (and filter). Property Value Dimensions: Use 0 or more [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType), [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) Use 0 or 1 [day](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#day), [month](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#month) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration) Filters: Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Use 0 or more [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) ##### Playback details with optional time dimension and [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage) metric This report provides playback detail statistics for specific time intervals. It supports the [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage) metric. Property Value Dimensions: Use 0 or more [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) Use 0 or 1 [day](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#day), [month](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#month) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage) Filters: Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Use 0 or more [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) #### Playback details by country ##### Playback details by country with [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand) statistics This report provides playback detail statistics on a country-by-country basis. It supports the [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand) dimension (and filter). Property Value Dimensions: Required [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country) Use 0 or more [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType), [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration) Filters: Use 0 or 1 [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Use 0 or more [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) ##### Playback details by country with [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage) metric The following report is similar to the previous one. It adds support for the [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage) metric, but it does not support [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand) as a dimension or a filter. Property Value Dimensions: Required [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country) Use 0 or more [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage) Filters: Use 0 or 1 [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Use 0 or more [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) #### Playback details by province ##### Playback details by province with [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand) statistics This report provides playback detail statistics for U.S. states and the District of Columbia. It supports the [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand) dimension (and filter). Property Value Dimensions: Required [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province) Use 0 or more [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType), [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration) Filters: Required [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country)`==US` Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Use 0 or more [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) ##### Playback details by province with [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage) metric The following report is similar to the previous one. It adds support for the [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage) metric, but it does not support [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand) as a dimension or a filter. Property Value Dimensions: Required [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province) Use 0 or more [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage) Filters: Required [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country)`==US` Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Use 0 or more [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) ### Playback locations #### Video playback location report This report provides statistics related to the type of page or application where video playbacks occurred. Property Value Dimensions: Required [insightPlaybackLocationType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#Playback_Location_Dimensions) Use 0 or more [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType), [day](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#day), [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched) Filters: Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Use 0 or more [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus) #### Playback location detail (\<= 25 results) **Note:** This report requires you to set the `maxResults` parameter to an integer value of `25` or less. Unlike most other reports, this report also requires you to specify a value for the `sort` request parameter. This report identifies the embedded video players that generated the most views or viewing time for a channel's videos. Property Value Dimensions: Required [insightPlaybackLocationDetail](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#insightPlaybackLocationDetail) Optional [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched) Filters: Required [insightPlaybackLocationType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#Playback_Location_Dimensions)`==EMBEDDED` Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Use 0 or more [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus) Sorting options: -[views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views) -[estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched) ### Traffic sources #### Traffic source This report aggregates viewing statistics based on the manner in which viewers reached your video content. For example, it identifies the number of views that stemmed from a Google search or from a link to a related video. **Note:** This report returns an error if the product of **# of queried videos** X **# of days in date range** exceeds 50,000. For example, a query that retrieves data for 500 video IDs can request data for a maximum of 100 days. To reduce the number of rows that a request returns, split your query into multiple queries that specify fewer videos or set shorter date ranges. Property Value Dimensions: Required [insightTrafficSourceType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#Traffic_Source_Dimensions) Use 0 or more [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType), [day](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#day), [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched) Filters: Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Use 0 or more [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus) #### Traffic source detail (\<= 25 results) **Note:** This report requires you to set the `maxResults` parameter to an integer value of `25` or less. Unlike most other reports, this report also requires you to specify a value for the `sort` request parameter. This report aggregates viewing statistics based on the referrers that generated the most views for the channel's content. Referrers are categorized by traffic source type, and the [insightTrafficSourceDetail](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#insightTrafficSourceDetail) dimension's definition identifies the traffic sources for which the report is available. For example, if you set the [insightTrafficSourceType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#Traffic_Source_Dimensions) filter to `ADVERTISING`, the report will list the types of ads that generated the most views or viewing time for the channel's content. Property Value Dimensions: Required [insightTrafficSourceDetail](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#insightTrafficSourceDetail) Optional [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched) Filters: Required [insightTrafficSourceType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#Traffic_Source_Dimensions) (see note below table) Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Use 0 or more [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus) Sorting options: -[views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views) -[estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched) **Note:** This report is only supported for specific traffic sources. `VIDEO_REMIXES`, `NOTIFICATION`, `END_SCREEN`, `CAMPAIGN_CARD`, `VIDEO_REMIXES`, and `NO_LINK_EMBEDDED` traffic sources are some of the unsupported ones. ### Device type and operating system #### Device type This report aggregates viewing statistics based on the manner in which viewers reached your video content. For example, it identifies the number of views that occurred on mobile devices or game consoles. Property Value Dimensions: Required [deviceType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#deviceType) Use 0 or more [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType), [day](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#day), [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched) Filters: Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Use 0 or more [operatingSystem](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#operatingSystem), [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) #### Operating system This report aggregates viewing statistics based on viewers' operating systems. For example, it identifies the number of views that occurred on Android devices or on PlayStations. Property Value Dimensions: Required [operatingSystem](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#operatingSystem) Use 0 or more [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType), [day](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#day), [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched) Filters: Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Use 0 or more [deviceType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#deviceType), [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) #### Operating system and device type This report aggregates viewing statistics based on viewers' operating systems and device types. For example, it identifies the number of views that occurred on Android tablets or on Windows desktop devices. Property Value Dimensions: Required [deviceType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#deviceType), [operatingSystem](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#operatingSystem) Use 0 or more [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType), [day](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#day), [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched) Filters: Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Use 0 or more [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) ### Viewer demographics This report aggregates viewing statistics based on viewers' age group and gender. Property Value Dimensions: Use 1 or more [ageGroup](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#ageGroup), [gender](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#gender) Use 0 or more [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType), [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus) Metrics: Use 1 or more [viewerPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#viewerPercentage) Filters: Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Use 0 or more [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus) **Note:** The [viewerPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#viewerPercentage) values in this report are not normalized for different values or combinations of values for playback detail dimensions ([subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), or [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct)). For example, a report that uses the [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus) dimension returns [viewerPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#viewerPercentage) data adding up to 100 percent for subscribed views *and* [viewerPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#viewerPercentage) data adding up to 100 percent for unsubscribed views. (The total value of all [viewerPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#viewerPercentage) fields in the report is 200 percent.) You can use filters to ensure that the report only contains [viewerPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#viewerPercentage) data for one value (or combination of values) for playback detail dimensions. ### Engagement and content sharing This report provides statistics showing how frequently the channel's videos were shared on different social platforms. Property Value Dimensions: Required [sharingService](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#sharingService) Use 0 or more [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus) Metrics: Use 1 or more [shares](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#shares) Filters: Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Optional [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus) ### Audience retention This report measures a video's ability to retain its audience and also shows how often specific parts of a video were watched. The `https://developers.google.com/youtube/analytics/v1/dimsmets/dims#elapsedVideoTimeRatio` dimension measures the amount of the video that has elapsed for the corresponding metric values. The metrics can be broken down into two categories: - **Audience retention** These metrics show how well the video retains its audience. - `https://developers.google.com/youtube/analytics/v1/dimsmets/mets#audienceWatchRatio` is a ratio that compares the number of times a portion of a video has been watched to the total number of views of the video. - `https://developers.google.com/youtube/analytics/v1/dimsmets/mets#relativeRetentionPerformance` shows how well a video retains viewers during playbacks relative to other YouTube videos of a similar length. - **Granular watch statistics** These metrics provide information about how often specific parts of a video were watched. - `https://developers.google.com/youtube/analytics/v1/dimsmets/mets#startedWatching` indicates how often viewers started watching a video during a particular segment of the video. - `https://developers.google.com/youtube/analytics/v1/dimsmets/mets#stoppedWatching` indicates how often viewers stopped watching a video during a particular segment of the video. - `https://developers.google.com/youtube/analytics/v1/dimsmets/mets#totalSegmentImpressions` indicates how often a particular sgement of the video was viewed. **Note:** This report does not support the ability to specify a comma-separated list of values for the `video` filter; the value must specify a single video ID. Property Value Dimensions: Required [elapsedVideoTimeRatio](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#elapsedVideoTimeRatio) Metrics: Use 1 or more [audienceWatchRatio](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#audienceWatchRatio) [relativeRetentionPerformance](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#relativeRetentionPerformance) [startedWatching](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#startedWatching) [stoppedWatching](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#stoppedWatching) [totalSegmentImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#totalSegmentImpressions) Filters: Required [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video) Use 0 or more [audienceType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#audienceType) [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus) [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) ### Concurrent viewers (for livestreams) This report shows the concurrent viewers at a given position for a single live-streamed video. The filter specifies the video. The position dimension generally represents a single minute. Property Value Dimensions: Use 0 or 1 [livestreamPosition](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#livestreamPosition) Metrics: Use 1 or more [averageConcurrentViewers](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageConcurrentViewers) [peakConcurrentViewers](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#peakConcurrentViewers) Filters: Required [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video) ### Top videos **Note:** These reports require you to set the `maxResults` parameter to an integer value of `200` or less. Before January 1, 2013 data is only available for the top 10 videos. Unlike most other reports, these reports also require you to specify a value for the `sort` request parameter. #### Top videos with optional regional filters (\<= 200 results) This report lists the channel's top videos. The report can be filtered to list top videos by [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), or [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent). Property Value Dimensions: Required [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video) Optional [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews), [comments](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#comments), [likes](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#likes), [dislikes](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#dislikes), [videosAddedToPlaylists](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#videosAddedToPlaylists), [videosRemovedFromPlaylists](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#videosRemovedFromPlaylists), [shares](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#shares), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage), [annotationClickThroughRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate), [annotationCloseRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloseRate), [annotationImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationImpressions), [annotationClickableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions), [annotationClosableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions), [annotationClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClicks), [annotationCloses](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloses), [cardClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClickRate), [cardTeaserClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate), [cardImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardImpressions), [cardTeaserImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions), [cardClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClicks), [cardTeaserClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks), [subscribersGained](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#subscribersGained), [subscribersLost](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#subscribersLost), [estimatedRevenue](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRevenue)\*, [estimatedAdRevenue](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedAdRevenue)\*, [grossRevenue](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#grossRevenue)\*, [estimatedRedPartnerRevenue](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedPartnerRevenue)\*, [monetizedPlaybacks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#monetizedPlaybacks)\*, [playbackBasedCpm](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playbackBasedCpm)\*, [adImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#adImpressions)\*, [cpm](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cpm)\* Filters: Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Sorting options: -[views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views) -[redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews) -[estimatedRevenue](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRevenue) -[estimatedRedPartnerRevenue](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedPartnerRevenue) -[estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched) -[estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched) -[subscribersGained](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#subscribersGained) -[subscribersLost](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#subscribersLost) #### Top videos by state (\<= 200 results) This report lists the channel's top videos in a particular U.S. state or the District of Columbia. Note that this report only supports a subset of the metrics available in the country-specific report described above. Property Value Dimensions: Required [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video) Optional [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage), [annotationClickThroughRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate), [annotationCloseRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloseRate), [annotationImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationImpressions), [annotationClickableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions), [annotationClosableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions), [annotationClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClicks), [annotationCloses](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloses), [cardClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClickRate), [cardTeaserClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate), [cardImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardImpressions), [cardTeaserImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions), [cardClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClicks), [cardTeaserClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks) Filters: Required [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province) Optional [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus) Sorting options: -[views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views) -[redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews) -[estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched) -[estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched) #### Top videos for subscribed or unsubscribed viewers(\<= 200 results) This report lists the channel's top videos for subscribed or unsubscribed viewers. The report can be filtered to list top videos by [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), or [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent). The previous report lets you retrieve the top videos in a particular U.S. state for subscribed or unsubscribed viewers, but it supports fewer metrics than this report. Property Value Dimensions: Required [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video) Optional [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews), [likes](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#likes), [dislikes](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#dislikes), [videosAddedToPlaylists](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#videosAddedToPlaylists), [videosRemovedFromPlaylists](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#videosRemovedFromPlaylists), [shares](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#shares), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage), [annotationClickThroughRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickThroughRate), [annotationCloseRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloseRate), [annotationImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationImpressions), [annotationClickableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClickableImpressions), [annotationClosableImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClosableImpressions), [annotationClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationClicks), [annotationCloses](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#annotationCloses), [cardClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClickRate), [cardTeaserClickRate](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClickRate), [cardImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardImpressions), [cardTeaserImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserImpressions), [cardClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardClicks), [cardTeaserClicks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cardTeaserClicks) Filters: Optional [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus) Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Sorting options: -[views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views) -[redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews) -[estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched) -[estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched) #### Top videos by YouTube Product (\<= 200 results) This report lists the channel's top videos and supports playback detail and geographic filters. This report is similar to the previous one, but it supports fewer metrics and adds support for the [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) filter. Property Value Dimensions: Required [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video) Optional [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage) Filters: Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Use 0 or more [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) Sorting options: -[views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views) -[redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews) -[estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched) -[estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched) #### Top videos with playback detail filters (\<= 200 results) This report lists the channel's top videos, filtering by any or all of the playback detail dimensions: [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), and [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct). Unlike the previous report, this one supports the [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand) filter and does not support the [averageViewPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewPercentage) metric. Property Value Dimensions: Required [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video) Optional [creatorContentType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#creatorContentType) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration) Filters: Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) Use 0 or more [liveOrOnDemand](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#liveOrOnDemand), [subscribedStatus](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subscribedStatus), [youtubeProduct](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#youtubeProduct) Sorting options: -[views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views) -[redViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#redViews) -[estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched) -[estimatedRedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedRedMinutesWatched) ## Playlist reports Playlist reports contain metrics related to user activity related to videos in the channel owner's playlists. Two versions of these reports are available, and, for each available report, the following sections contain a description of each version: #### Aggregated video metrics These metrics provide user activity and impression metrics that are aggregated for all videos in the playlist that are also owned by the channel that owns the playlist. Metrics for videos owned by other channels are not computed in the aggregation. As a result, if a channel creates a playlist that contains only videos owned by other channels, reports for those playlists will not provide values for these metrics. See the [supported playlist metrics](https://developers.google.com/youtube/analytics/channel_reports#supported-playlist-metrics) section for a list of aggregated video metrics that YouTube supports. #### In-playlist metrics These metrics reflect user activity and engagement in the context of the playlist page. These metrics include views for all videos in the playlist, regardless of which channel owns them, but only counts views that occurred in the playlist context. #### Supported playlist metrics | Metric type | Metrics | |---|---| | Aggregated video metrics | [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration) | | In-playlist metrics | [playlistViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistViews), [playlistEstimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched), [playlistAverageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration), [playlistSaves](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistSaves), [playlistStarts](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistStarts), [viewsPerPlaylistStart](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart), [averageTimeInPlaylist](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist) | ### Basic stats This report provides statistics related to users' interactions with the videos in the channel's playlists. You can filter the report to only return data for a specific playlist. Property Value Dimensions: \[None\] Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageTimeInPlaylist](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist), [playlistAverageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration), [playlistEstimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched), [playlistSaves](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistSaves), [playlistStarts](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistStarts), [playlistViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistViews), [viewsPerPlaylistStart](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart) Filters: Use exactly 1 [playlist](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#playlist), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) ### Time-based This report provides statistics related to users' interactions with the videos in the channel's playlists. You can filter the report to only return data for a specific playlist. Property Value Dimensions: Use exactly 1 [day](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#day), [month](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#month) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageTimeInPlaylist](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist), [playlistAverageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration), [playlistEstimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched), [playlistSaves](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistSaves), [playlistStarts](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistStarts), [playlistViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistViews), [viewsPerPlaylistStart](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart) Filters: Use exactly 1 [playlist](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#playlist), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) ### User geography #### Playlist activity by country This report provides statistics related to interactions that users in a particular country have with the videos in the channel's playlists. Property Value Dimensions: Required [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration) Filters: Use exactly 1 [playlist](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#playlist), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Use 0 or 1 [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent) #### Playlist activity by province This report provides playlist activity statistics for U.S. states and the District of Columbia. For this report, you must filter results to return data only for the United States. Property Value Dimensions: Required [province](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration) Filters: Required [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country)`==US` Use exactly 1 [playlist](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#playlist), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) ### Playback locations This report provides statistics related to the type of page or application where playbacks of your playlist videos occurred. Property Value Dimensions: Required [insightPlaybackLocationType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#Playback_Location_Dimensions) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageTimeInPlaylist](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist), [playlistAverageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration), [playlistEstimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched), [playlistStarts](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistStarts), [playlistViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistViews), [viewsPerPlaylistStart](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart) Filters: Use exactly 1 [playlist](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#playlist), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) #### Playback location detail (\<= 25 results) **Note:** This report requires you to set the `maxResults` parameter to a integer value of `25` or less. Unlike most other reports, this report also requires you to specify a value for the `sort` request parameter. This report identifies the embedded video players that generated the most views or viewing time for the videos in the channel's playlists. Property Value Dimensions: Required [insightPlaybackLocationDetail](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#insightPlaybackLocationDetail) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageTimeInPlaylist](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist), [playlistAverageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration), [playlistEstimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched), [playlistStarts](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistStarts), [playlistViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistViews), [viewsPerPlaylistStart](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart) Filters: Required [insightPlaybackLocationType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#Playback_Location_Dimensions)`==EMBEDDED` Use exactly 1 [playlist](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#playlist), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Sorting options: -[playlistViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistViews) -[playlistEstimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched) -[playlistStarts](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistStarts) ### Traffic sources This report aggregates viewing statistics based on how viewers reached your playlist content. For example, it identifies the number of views that stemmed from a Google search. Property Value Dimensions: Required [insightTrafficSourceType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#Traffic_Source_Dimensions) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageTimeInPlaylist](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist), [playlistAverageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration), [playlistEstimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched), [playlistSaves](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistSaves), [playlistStarts](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistStarts), [playlistViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistViews), [viewsPerPlaylistStart](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart) Filters: Use exactly 1 [playlist](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#playlist), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) #### Traffic source detail (\<= 25 results) **Note:** This report requires you to set the `maxResults` parameter to a integer value of `25` or less. Unlike most other reports, this report also requires you to specify a value for the `sort` request parameter. This report aggregates viewing statistics based on the referrers that generated the most views for the videos in the channel's playlists. Referrers are categorized by traffic source type, and the [insightTrafficSourceDetail](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#insightTrafficSourceDetail) dimension's definition identifies the traffic sources for which the report is available. For example, if you set the [insightTrafficSourceType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#Traffic_Source_Dimensions) filter to `ADVERTISING`, the report will list the types of ads that generated the most views or viewing time for the channel's playlists. Property Value Dimensions: Required [insightTrafficSourceDetail](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#insightTrafficSourceDetail) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageTimeInPlaylist](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist), [playlistAverageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration), [playlistEstimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched), [playlistSaves](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistSaves), [playlistStarts](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistStarts), [playlistViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistViews), [viewsPerPlaylistStart](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart) Filters: Required [insightTrafficSourceType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#Traffic_Source_Dimensions)`==ADVERTISING` (or another supported value) Use exactly 1 [playlist](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#playlist), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Sorting options: -[playlistViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistViews) -[playlistEstimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched) -[playlistStarts](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistStarts) **Note:** This report is only supported for specific traffic sources. `VIDEO_REMIXES`, `NOTIFICATION`, `END_SCREEN`, `CAMPAIGN_CARD`, `VIDEO_REMIXES`, and `NO_LINK_EMBEDDED` traffic sources are some of the unsupported ones. ### Device type and operating system #### Device type This report aggregates viewing statistics based on how viewers reached the videos in your playlists. For example, it identifies the number of views that occurred on mobile devices or game consoles. Property Value Dimensions: Required [deviceType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#deviceType) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageTimeInPlaylist](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist), [playlistAverageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration), [playlistEstimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched), [playlistStarts](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistStarts), [playlistViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistViews), [viewsPerPlaylistStart](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart) Filters: Use exactly 1 [playlist](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#playlist), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) #### Operating system This report aggregates viewing statistics based on viewers' operating systems. For example, it identifies the number of views that occurred on Android devices or on PlayStations. Property Value Dimensions: Required [operatingSystem](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#operatingSystem) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageTimeInPlaylist](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist), [playlistAverageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration), [playlistEstimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched), [playlistStarts](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistStarts), [playlistViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistViews), [viewsPerPlaylistStart](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart) Filters: Use exactly 1 [playlist](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#playlist), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) #### Operating system and device type This report aggregates viewing statistics based on viewers' operating systems and device types. For example, it identifies how many views occurred on Android tablets or Windows desktop devices. Property Value Dimensions: Required [deviceType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#deviceType), [operatingSystem](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#operatingSystem) Metrics: Use 1 or more [engagedViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#engagedViews), [views](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#views), [estimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#estimatedMinutesWatched), [averageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageViewDuration), [averageTimeInPlaylist](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist), [playlistAverageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration), [playlistEstimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched), [playlistStarts](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistStarts), [playlistViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistViews), [viewsPerPlaylistStart](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart) Filters: Use exactly 1 [playlist](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#playlist), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) ### Viewer demographics Property Value Dimensions: Use 1 or more [ageGroup](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#ageGroup), [gender](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#gender) Metrics: Required [viewerPercentage](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#viewerPercentage) Filters: Use exactly 1 [playlist](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#playlist), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) ### Top playlists **Note:** These reports require you to set the `maxResults` parameter to an integer value of `200` or less. Before January 1, 2013 data is only available for the top 10 playlists. Unlike most other reports, these reports also require you to specify a value for the `sort` request parameter. This report lists the channel's top playlists based on the specified filtering and sorting criteria. Property Value Dimensions: Required [playlist](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#playlist) Metrics: Use 1 or more [averageTimeInPlaylist](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#averageTimeInPlaylist), [playlistAverageViewDuration](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistAverageViewDuration), [playlistEstimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched), [playlistSaves](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistSaves), [playlistStarts](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistStarts), [playlistViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistViews), [viewsPerPlaylistStart](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#viewsPerPlaylistStart) Sorting options: -[playlistViews](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistViews) -[playlistEstimatedMinutesWatched](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistEstimatedMinutesWatched) -[playlistStarts](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playlistStarts) ## Membership reports ### Membership cancellations This report provides statistics showing why users canceled their channel memberships. Property Value Dimensions: Use 0 or 1 [membershipsCancellationSurveyReason](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#membershipsCancellationSurveyReason) Metrics: Required [membershipsCancellationSurveyResponses](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#membershipsCancellationSurveyResponses) ## Ad performance reports **Note:** Ad performance reports require an authorization token that grants access to the `https://www.googleapis.com/auth/yt-analytics-monetary.readonly` scope. Ad performance reports provide impression-based metrics for ads that ran during video playbacks. These metrics account for each ad impression, and each video playback can yield multiple impressions. The impression-based ad performance metrics are: - [grossRevenue](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#grossRevenue) - [adImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#adImpressions) - [cpm](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cpm) In addition, some [video reports](https://developers.google.com/youtube/analytics/channel_reports#video-reports) support the following playback-based ad performance metrics. However, these metrics are not included in ad performance reports. - [playbackBasedCpm](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#playbackBasedCpm) - [monetizedPlaybacks](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#monetizedPlaybacks) ### Ad performance by ad type Property Value Dimensions: Required [adType](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#adType) Optional [day](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#day) Metrics: Use 1 or more [grossRevenue](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#grossRevenue), [adImpressions](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#adImpressions), [cpm](https://developers.google.com/youtube/analytics/v1/dimsmets/mets#cpm) Filters: Use 0 or 1 [video](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#video), [group](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#group) Use 0 or 1 [country](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country), [continent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#continent), [subContinent](https://developers.google.com/youtube/analytics/v1/dimsmets/dims#subContinent)