YouTube: supported dimensions & metrics
Channel detailed statistics
Dimensions
| Group | Name | Description |
|---|---|---|
| Account | Account Id | The ID for a YouTube channel. |
| Account | Account name | Name for a YouTube channel. |
| Report | Date | Report date. |
Metrics
| Group | Name | Description |
|---|---|---|
| Performance | Views | This metric specifies the number of times that a video was viewed. |
| Performance | Watch time (minutes) | The number of minutes that users watched videos for the specified channel, content owner, video, or playlist. |
| Performance | Average view duration | The average length, in seconds, of video playbacks. As of December 13, 2021, this metric excludes looping clips traffic. In a playlist report, the metric indicates the average length, in seconds, of video playbacks that occurred in the context of a playlist. |
| Performance | Average view percentage | The average percentage of a video watched during a video playback. |
| Interactions | Likes | The number of times that users indicated that they liked a video by giving it a positive rating. |
| Interactions | Shares | The number of times that users shared a video through the Share button. |
| Interactions | Comments | The number of times that users commented on a video. |
| Interactions | Dislikes | The number of times that users indicated that they disliked a video by giving it a negative rating. |
| Premium | YouTube Premium views | The number of times that a video was viewed by YouTube Premium (previously known as YouTube Red) members. |
| Premium | YouTube Premium watch time (minutes) | The number of minutes that YouTube Premium (previously known as YouTube Red) members watched a video. |
| Cards | Card click rate | The click-through rate for cards, which is calculated as the ratio of card clicks to card impressions. |
| Cards | Card clicks | The number of times that cards were clicked. |
| Cards | Card impressions | The number of times cards were displayed. When the card panel is opened, a card impression is logged for each of the video's cards. |
| Cards | Card teaser click rate | The click-through rate for card teasers, which is calculated as the ratio of clicks on card teasers to the total number of card teaser impressions. |
| Cards | Card teaser clicks | The number of clicks on card teasers. Card icon clicks are attributed to the last teaser displayed to the user. |
| Cards | Card teaser impressions | The number of times that card teasers were displayed. A video view can generate multiple teaser impressions. |
| Annotations | Clickable impressions | The number of annotations that appeared and could be clicked. |
| Annotations | Clicks | The number of clicked annotations. |
| Annotations | CTR | The ratio of annotations that viewers clicked to the total number of clickable annotation impressions. The YouTube Help Center has more information about creating annotations and using link annotations. |
| Annotations | Closable impressions | The number of annotations that appeared and could be closed. |
| Annotations | Close rate | The ratio of annotations that viewers closed to the total number of annotation impressions. |
| Annotations | Closes | The number of closed annotations. |
| Annotations | Impressions | The total number of annotation impressions. |
| Playlist | Videos added to playlist | The number of times that videos were added to any YouTube playlists. The videos could have been added to the video owner's playlist or to other channels' playlists. The metric value does include the number of times that videos were added to default playlists like the "Watch Later" playlist. However, it does not count playlists that a video is automatically added to, such as a channel's uploads playlist or a user's watch history. This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, and then adds it again, the metric value reflects the video being added to a playlist twice. Data for this metric is not available for dates before October 1, 2014. |
| Playlist | Videos removed from playlist | The number of times that videos were removed from any YouTube playlists. The videos could have been removed from the video owner's playlist or from other channels' playlists. The metric value includes the number of times that videos were removed from default playlists like the "Watch Later" playlist. This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, adds it again, and then removes it again, the metric value reflects the video being removed from a playlist twice. Data for this metric is not available for dates before October 1, 2014. |
Channel statistics by content and subscriber type
Dimensions
| Group | Name | Description |
|---|---|---|
| Account | Account Id | The ID for a YouTube channel. |
| Account | Account name | Name for a YouTube channel. |
| Report | Date | Report date. |
| Content | Content type | This dimension identifies the type of content associated with the user activity metrics in the data row. Data for this dimension is available for dates beginning January 1, 2019. Values:
|
| Audience | Subscription status | This dimension indicates whether the user activity metrics in the data row are associated with viewers who were subscribed to the video's or playlist's channel. Possible values are SUBSCRIBED and UNSUBSCRIBED. Note that the dimension value is accurate as of the time that the user activity occurs. For example, suppose a user has not subscribed to a channel and watches one of that channel's videos, then subscribes to the channel and watches another video, all on the same day. The channel's report indicates that one view has a subscribedStatus value of SUBSCRIBED, and one view has a subscribedStatus value of UNSUBSCRIBED. |
Metrics
This report has all metrics as in "Channel detailed statistics", except "Interactions: Comments" metric and all metrics from "Playlist" and "Annotations" groups.
Video detailed statistics
Dimensions
| Group | Name | Description |
|---|---|---|
| Account | Account Id | The ID for a YouTube channel. |
| Account | Account name | Name for a YouTube channel. |
| Report | Date | Report date. |
| Video | Video Id | The ID of a YouTube video. |
| Video | Video title | The video's title. |
| Video | Video description | The video's description. |
| Video | Video duration | The length of the video. The property value is an ISO 8601 duration. For example, for a video that is at least one minute long and less than one hour long, the duration is in the format PT#M#S, in which the letters PT indicate that the value specifies a period of time, and the letters M and S refer to length in minutes and seconds, respectively. The # characters preceding the M and S letters are both integers that specify the number of minutes (or seconds) of the video. For example, a value of PT15M33S indicates that the video is 15 minutes and 33 seconds long. If the video is at least one hour long, the duration is in the format PT#H#M#S, in which the # preceding the letter H specifies the length of the video in hours and all of the other details are the same as described above. If the video is at least one day long, the letters P and T are separated, and the value's format is P#DT#H#M#S. Please refer to the ISO 8601 specification for complete details. |
| Video | Video type | Video type: shorts or regular. Defined by Coupler.io based on video duration—videos less than 1 minute long are classified as shorts. YouTube API does not return this info for videos right now (source). |
| Video | Video link | Link to video. |
| Video | Thumbnail URL | URL of thumbnail image. |
| Video | Video published at | The date and time that the video was published. Note that this time might be different than the time that the video was uploaded. For example, if a video is uploaded as a private video and then made public at a later time, this property will specify the time that the video was made public. There are a couple of special cases: If a video is uploaded as a private video and the video metadata is retrieved by the channel owner, then the property value specifies the date and time that the video was uploaded. If a video is uploaded as an unlisted video, the property value also specifies the date and time that the video was uploaded. In this case, anyone who knows the video's unique video ID can retrieve the video metadata. |
| Video | Tags | A list of keyword tags associated with the video. |
| Video | Thumbnail height | Thumbnail image height. |
| Video | Thumbnail width | Thumbnail image width. |
Metrics
| Group | Name | Description |
|---|---|---|
| Performance | Views | Number of times that a video was viewed. |
| Performance | Watch time (minutes) | The number of minutes that users watched videos for the specified channel, content owner, video, or playlist. |
| Performance | Average view duration | The average length, in seconds, of video playbacks. As of December 13, 2021, this metric excludes looping clips traffic. In a playlist report, the metric indicates the average length, in seconds, of video playbacks that occurred in the context of a playlist. |
| Performance | Average view percentage | The average percentage of a video watched during a video playback. |
| Interactions | Likes | The number of times that users indicated that they liked a video by giving it a positive rating. |
| Interactions | Shares | The number of times that users shared a video through the Share button. |
| Interactions | Comments | The number of times that users commented on a video. |
| Interactions | Dislikes | The number of times that users indicated that they disliked a video by giving it a negative rating. |
| Premium | YouTube Premium views | The number of times that a video was viewed by YouTube Premium (previously known as YouTube Red) members. |
| Premium | YouTube Premium watch time (minutes) | The number of minutes that YouTube Premium (previously known as YouTube Red) members watched a video. |
| Cards | Card click rate | The click-through rate for cards, which is calculated as the ratio of card clicks to card impressions. |
| Cards | Card clicks | The number of times that cards were clicked. |
| Cards | Card impressions | The number of times cards were displayed. When the card panel is opened, a card impression is logged for each of the video's cards. |
| Cards | Card teaser click rate | The click-through rate for card teasers, which is calculated as the ratio of clicks on card teasers to the total number of card teaser impressions. |
| Cards | Card teaser clicks | The number of clicks on card teasers. Card icon clicks are attributed to the last teaser displayed to the user. |
| Cards | Card teaser impressions | The number of times that card teasers were displayed. A video view can generate multiple teaser impressions. |
| Annotations | Clickable impressions | The number of annotations that appeared and could be clicked. |
| Annotations | Clicks | The number of clicked annotations. |
| Annotations | CTR | The ratio of annotations that viewers clicked to the total number of clickable annotation impressions. The YouTube Help Center has more information about creating annotations and using link annotations. |
| Annotations | Closable impressions | The number of annotations that appeared and could be closed. |
| Annotations | Close rate | The ratio of annotations that viewers closed to the total number of annotation impressions. |
| Annotations | Closes | The number of closed annotations. |
| Annotations | Impressions | The total number of annotation impressions. |
| Playlist | Videos added to playlist | The number of times that videos were added to any YouTube playlists. The videos could have been added to the video owner's playlist or to other channels' playlists. The metric value does include the number of times that videos were added to default playlists like the "Watch Later" playlist. However, it does not count playlists that a video is automatically added to, such as a channel's uploads playlist or a user's watch history. This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, and then adds it again, the metric value reflects the video being added to a playlist twice. Data for this metric is not available for dates before October 1, 2014. |
| Playlist | Videos removed from playlist | The number of times that videos were removed from any YouTube playlists. The videos could have been removed from the video owner's playlist or from other channels' playlists. The metric value includes the number of times that videos were removed from default playlists like the "Watch Later" playlist. This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, adds it again, and then removes it again, the metric value reflects the video being removed from a playlist twice. Data for this metric is not available for dates before October 1, 2014. |
đź’” YouTube API does no return video metrics available in YouTube Studio analytics in Reach group, so these metrics not available in Coupler.io: Impressions, Impressions click-through rate, Shown in feed, Viewed (vs. swiped away), Unique viewers, Average views per viewer, New viewers, Returning viewers.
Video statistics by content and subscriber type
Dimensions
| Group | Name | Description |
|---|---|---|
| Account | Account Id | The ID for a YouTube channel. |
| Account | Account name | Name for a YouTube channel. |
| Report | Date | Report date. |
| Video | Video Id | The ID of a YouTube video. |
| Video | Video title | The video's title. |
| Video | Video description | The video's description. |
| Video | Video duration | The length of the video. The property value is an ISO 8601 duration. For example, for a video that is at least one minute long and less than one hour long, the duration is in the format PT#M#S, in which the letters PT indicate that the value specifies a period of time, and the letters M and S refer to length in minutes and seconds, respectively. The # characters preceding the M and S letters are both integers that specify the number of minutes (or seconds) of the video. For example, a value of PT15M33S indicates that the video is 15 minutes and 33 seconds long. If the video is at least one hour long, the duration is in the format PT#H#M#S, in which the # preceding the letter H specifies the length of the video in hours and all of the other details are the same as described above. If the video is at least one day long, the letters P and T are separated, and the value's format is P#DT#H#M#S. Please refer to the ISO 8601 specification for complete details. |
| Video | Video type | Video type: shorts or regular. Defined by Coupler.io based on video duration—videos less than 1 minute long are classified as shorts. YouTube API does not return this info for videos right now (source). |
| Video | Video link | Link to video. |
| Video | Thumbnail URL | URL of thumbnail image. |
| Content | Content type | This dimension identifies the type of content associated with the user activity metrics in the data row. Data for this dimension is available for dates beginning January 1, 2019. Values: LIVE_STREAM - The viewed content was a YouTube livestream. SHORTS - The viewed content was a YouTube Short. STORY - The viewed content was a YouTube Story. VIDEO_ON_DEMAND - The viewed content was a YouTube video that does not fall under one of the other dimension values. UNSPECIFIED - The content type of the viewed content is unknown. |
| Audience | Subscription status | This dimension indicates whether the user activity metrics in the data row are associated with viewers who were subscribed to the video's or playlist's channel. Possible values are SUBSCRIBED and UNSUBSCRIBED. Note that the dimension value is accurate as of the time that the user activity occurs. For example, suppose a user has not subscribed to a channel and watches one of that channel's videos, then subscribes to the channel and watches another video, all on the same day. The channel's report indicates that one view has a subscribedStatus value of SUBSCRIBED, and one view has a subscribedStatus value of UNSUBSCRIBED. |
| Video | Video published at | The date and time that the video was published. Note that this time might be different than the time that the video was uploaded. For example, if a video is uploaded as a private video and then made public at a later time, this property will specify the time that the video was made public. There are a couple of special cases: If a video is uploaded as a private video and the video metadata is retrieved by the channel owner, then the property value specifies the date and time that the video was uploaded. If a video is uploaded as an unlisted video, the property value also specifies the date and time that the video was uploaded. In this case, anyone who knows the video's unique video ID can retrieve the video metadata. |
| Video | Tags | A list of keyword tags associated with the video. |
| Video | Thumbnail height | Thumbnail image height. |
| Video | Thumbnail width | Thumbnail image width. |
Metrics
This report has all metrics as in "Video detailed statistics", except "Interactions: Comments" metric and all metrics from "Playlist" and "Annotations" groups.
Channel subscribers
Dimensions
| Group | Name | Description |
|---|---|---|
| Account | Account Id | The ID for a YouTube channel. |
| Account | Account name | Name for a YouTube channel. |
| Report | Date | Report date. |
| Video | Video Id | The ID of a YouTube video. |
| Video | Video title | The video's title. |
| Video | Video description | The video's description. |
| Video | Video duration | The length of the video. The property value is an ISO 8601 duration. For example, for a video that is at least one minute long and less than one hour long, the duration is in the format PT#M#S, in which the letters PT indicate that the value specifies a period of time, and the letters M and S refer to length in minutes and seconds, respectively. The # characters preceding the M and S letters are both integers that specify the number of minutes (or seconds) of the video. For example, a value of PT15M33S indicates that the video is 15 minutes and 33 seconds long. If the video is at least one hour long, the duration is in the format PT#H#M#S, in which the # preceding the letter H specifies the length of the video in hours and all of the other details are the same as described above. If the video is at least one day long, the letters P and T are separated, and the value's format is P#DT#H#M#S. Please refer to the ISO 8601 specification for complete details. |
| Video | Video published at | The date and time that the video was published. Note that this time might be different than the time that the video was uploaded. For example, if a video is uploaded as a private video and then made public at a later time, this property will specify the time that the video was made public. There are a couple of special cases:
|
| Video | Thumbnail height | Thumbnail image height. |
| Video | Thumbnail width | Thumbnail image width. |
| Video | Thumbnail URL | URL of thumbnail image. |
| Video | Tags | A list of keyword tags associated with the video. |
| Content | Content type | This dimension identifies the type of content associated with the user activity metrics in the data row. Data for this dimension is available for dates beginning January 1, 2019.
|
Metrics
| Group | Name | Description |
|---|---|---|
| Interactions | Subscribers gained | The number of times that users subscribed to a channel. Channels can gain or lose subscribers in several places, including the video watch page, the channel page, and the guide that appears on the YouTube home page. In channel reports, this metric includes subscribers gained from any of these places. However, in reports that use either the video dimension or the filter parameter to restrict the response to only include data for a particular video, the subscribersGained metric will only include statistics from the specified video's watch page. |
| Interactions | Subscribers lost | The number of times that users unsubscribed from a channel. Data for this metric is reported similarly to the subscribersGained metric. In channel reports, this metric includes subscribers lost through any mechanism through which users can unsubscribe from a channel. However, in reports that use either the video dimension or the filter parameter to restrict the response to only include data for a particular video, this metric only includes users who unsubscribed from the specified video's watch page. |
Traffic sources
Dimensions
| Group | Name | Description |
|---|---|---|
| Account | Account Id | The ID for a YouTube channel. |
| Account | Account name | Name for a YouTube channel. |
| Report | Date | Report date. |
| Content | Traffic source type | Data in the report is aggregated based on the referrer type, which describes the manner in which users reached the video. Learn more |
| Content | Content type | This dimension identifies the type of content associated with the user activity metrics in the data row. Data for this dimension is available for dates beginning January 1, 2019. Values LIVE_STREAM - The viewed content was a YouTube livestream. SHORTS - The viewed content was a YouTube Short. STORY - The viewed content was a YouTube Story. VIDEO_ON_DEMAND - The viewed content was a YouTube video that does not fall under one of the other dimension values. UNSPECIFIED - The content type of the viewed content is unknown. |
| Content | Live or on demand video | This dimension indicates whether the user activity metrics in the data row are associated with views of a live broadcast. Data for this dimension is available for dates beginning April 1, 2014. Values LIVE - The row's data describes user activity that occurred during a live broadcast. ON_DEMAND - The row's data describes user activity that did not occur during a live broadcast. |
| Audience | Subscription status | This dimension indicates whether the user activity metrics in the data row are associated with viewers who were subscribed to the video's or playlist's channel. Possible values are SUBSCRIBED and UNSUBSCRIBED. Note that the dimension value is accurate as of the time that the user activity occurs. For example, suppose a user has not subscribed to a channel and watches one of that channel's videos, then subscribes to the channel and watches another video, all on the same day. The channel's report indicates that one view has a subscribedStatus value of SUBSCRIBED, and one view has a subscribedStatus value of UNSUBSCRIBED. |
| Video | Video Id | The ID of a YouTube video. |
| Video | Video title | The video's title. |
| Video | Video description | The video's description. |
| Video | Video duration | The length of the video. The property value is an ISO 8601 duration. For example, for a video that is at least one minute long and less than one hour long, the duration is in the format PT#M#S, in which the letters PT indicate that the value specifies a period of time, and the letters M and S refer to length in minutes and seconds, respectively. The # characters preceding the M and S letters are both integers that specify the number of minutes (or seconds) of the video. For example, a value of PT15M33S indicates that the video is 15 minutes and 33 seconds long. If the video is at least one hour long, the duration is in the format PT#H#M#S, in which the # preceding the letter H specifies the length of the video in hours and all of the other details are the same as described above. If the video is at least one day long, the letters P and T are separated, and the value's format is P#DT#H#M#S. Please refer to the ISO 8601 specification for complete details. |
| Video | Video published at | The date and time that the video was published. Note that this time might be different than the time that the video was uploaded. For example, if a video is uploaded as a private video and then made public at a later time, this property will specify the time that the video was made public. There are a couple of special cases: If a video is uploaded as a private video and the video metadata is retrieved by the channel owner, then the property value specifies the date and time that the video was uploaded. If a video is uploaded as an unlisted video, the property value also specifies the date and time that the video was uploaded. In this case, anyone who knows the video's unique video ID can retrieve the video metadata. |
| Video | Thumbnail height | Thumbnail image height. |
| Video | Thumbnail width | Thumbnail image width. |
| Video | Thumbnail URL | URL of thumbnail image. |
| Video | Tags | A list of keyword tags associated with the video. |
Metrics
| Group | Name | Description |
|---|---|---|
| Performance | Views | This metric metric specifies the number of times that a video was viewed. |
| Performance | Watch time (minutes) | The number of minutes that users watched videos for the specified channel, content owner, video, or playlist. |
Custom
Dimensions
| Group | Name | Description |
|---|---|---|
| Audience | Age | This dimension identifies the age group of the logged-in users associated with the report data. The API uses the following age groups: age13-17 age18-24 age25-34 age35-44 age45-54 age55-64 age65- |
| Audience | Gender | This dimension identifies the gender of the logged-in users associated with the report data. Valid values are female, male, and user_specified. |
| Audience | City | The estimated city associated with the metrics in the report row. Data for this dimension is available for dates beginning January 1, 2022. |
| Audience | Country | The country associated with the metrics in the report row. The dimension value is a two-letter ISO-3166-1 country code, such as US, CN (China), or FR (France). The country code ZZ is used to report metrics for which YouTube could not identify the associated country. |
| Audience | Province (available for US country only) | The U.S. state or territory associated with the metrics in the report row. The dimension value is an ISO 3166-2 code that identifies a U.S. state or the District of Columbia, such as US-MI (Michigan) or US-TX (Texas). The province code US-ZZ is used to report metrics for which YouTube could not identify the associated U.S. state. Note: This dimension does not support ISO 3166-2 values that identify U.S. outlying areas since those territories also have their own ISO 3166-1 country codes. It also does not support subdivisions of countries other than the United States. |
| Audience | Device type | This dimension identifies the physical form factor of the device on which the view occurred. The following list identifies the device types for which the API returns data. You can also use the deviceType dimension as a filter to restrict an operating system report to only contain data for a specific type of device. DESKTOP GAME_CONSOLE MOBILE TABLET TV UNKNOWN_PLATFORM |
| Audience | Operating system | This dimension identifies the software system of the device on which the view occurred. The following list identifies the operating systems for which the API returns data. You can also use the operatingSystem as a filter to restrict a device type report to only contain data for a specific operating system. ANDROID BADA BLACKBERRY CHROMECAST DOCOMO FIREFOX HIPTOP IOS KAIOS LINUX MACINTOSH MEEGO NINTENDO_3DS OTHER PLAYSTATION PLAYSTATION_VITA REALMEDIA SMART_TV SYMBIAN TIZEN VIDAA WEBOS WII WINDOWS WINDOWS_MOBILE XBOX |
| Audience retention | Elapsed video time ratio | This dimension specifies the ratio of the elapsed portion of the video to the video's length. Retention dimensions and metrics are used to measure audience retention over time, and the elapsedVideoTimeRatio dimension is the time measurement. For example, a value of 0.4 indicates that the corresponding report data shows retention data after 40 percent of the video has elapsed. The API returns 100 data points for each video with ratio values ranging from 0.01 to 1.0. The times at which data is measured during video playbacks are equally spaced for each video. This means that for a two-minute video, the interval between data points is 1.2 seconds. However, for a two-hour video, the interval between data points is 72 seconds. The dimension's value denotes the exclusive end of the interval. |
| Engagement | Sharing service | This dimension identifies the service that was used to share videos. Videos can be shared on YouTube (or via the YouTube player) using the "Share" button. Learn more |
| Period | Day | Report date. |
| Period | Month | Report date. |
| Playback | Subscription status | This dimension indicates whether the user activity metrics in the data row are associated with viewers who were subscribed to the video's or playlist's channel. Possible values are SUBSCRIBED and UNSUBSCRIBED. Note that the dimension value is accurate as of the time that the user activity occurs. For example, suppose a user has not subscribed to a channel and watches one of that channel's videos, then subscribes to the channel and watches another video, all on the same day. The channel's report indicates that one view has a subscribedStatus value of SUBSCRIBED, and one view has a subscribedStatus value of UNSUBSCRIBED. |
| Playback | Content type | This dimension identifies the type of content associated with the user activity metrics in the data row. Data for this dimension is available for dates beginning January 1, 2019. Values: LIVE_STREAM: The viewed content was a YouTube livestream. SHORTS: The viewed content was a YouTube Short. STORY: The viewed content was a YouTube Story. VIDEO_ON_DEMAND: The viewed content was a YouTube video that does not fall under one of the other dimension values. UNSPECIFIED: The content type of the viewed content is unknown. |
| Playback | Live or on demand | This dimension indicates whether the user activity metrics in the data row are associated with views of a live broadcast. Data for this dimension is available for dates beginning April 1, 2014. Values: LIVE: The row's data describes user activity that occurred during a live broadcast. ON_DEMAND: The row's data describes user activity that did not occur during a live broadcast. |
| Playback | YouTube product | This dimension identifies the YouTube service on which the user activity occurred. Data for this dimension is available as of July 18, 2015. Values: CORE: The user activity that did not occur in one of the specialty YouTube applications (YouTube Gaming, YouTube Kids, or YouTube Music). Exception: User activity that occurred in YouTube Music before March 1, 2021, is included in CORE. GAMING: The user activity occurred in YouTube Gaming. KIDS: The user activity occurred in YouTube Kids. MUSIC: The user activity occurred in YouTube Music on or after March 1, 2021. Data prior to March 1, 2021 is included in CORE. Real-time data is not recorded. UNKNOWN: The user activity occurred prior to July 18, 2015. |
| Playback locations | Insight playback location detail | Data is aggregated based on the page where the player is located. Note that this report is only supported for views that occurred in embedded players, and it identifies the embedded players that generated the most views for a specified video. Thus, it provides a more fine-grained view than the playback location report by identifying the URLs or applications associated with the top embedded players. |
| Playback locations | Insight playback location type | Data in the report is aggregated based on the type of page or application where video playbacks occurred. Learn more |
| Playlist | Playlist | The ID of a YouTube playlist. |
| Traffic sources | Insight traffic source detail | Data in the report is aggregated based on the referrers that generated the most views for a specified video and a specified traffic source type. The following list identifies the traffic sources for which this report is available. For each traffic source, the list identifies the information that the insightTrafficSourceDetail dimension provides. |
| Traffic sources | Insight traffic source type | Data in the report is aggregated based on the referrer type, which describes the manner in which users reached the video. Learn more |
| Video | Video Id | The ID of a YouTube video. Available automatically when you select "Video" dimension. |
| Video | Video title | The video's title. Available automatically when you select "Video" dimension. |
| Video | Video description | The video's description. Available automatically when you select "Video" dimension. |
| Video | Video duration | The length of the video. Available automatically when you select "Video" dimension. The property value is an ISO 8601 duration. For example, for a video that is at least one minute long and less than one hour long, the duration is in the format PT#M#S, in which the letters PT indicate that the value specifies a period of time, and the letters M and S refer to length in minutes and seconds, respectively. The # characters preceding the M and S letters are both integers that specify the number of minutes (or seconds) of the video. For example, a value of PT15M33S indicates that the video is 15 minutes and 33 seconds long. If the video is at least one hour long, the duration is in the format PT#H#M#S, in which the # preceding the letter H specifies the length of the video in hours and all of the other details are the same as described above. If the video is at least one day long, the letters P and T are separated, and the value's format is P#DT#H#M#S. Please refer to the ISO 8601 specification for complete details. |
| Video | Video published at | The date and time that the video was published. Available automatically when you select "Video" dimension. Note that this time might be different than the time that the video was uploaded. For example, if a video is uploaded as a private video and then made public at a later time, this property will specify the time that the video was made public. There are a couple of special cases: If a video is uploaded as a private video and the video metadata is retrieved by the channel owner, then the property value specifies the date and time that the video was uploaded. If a video is uploaded as an unlisted video, the property value also specifies the date and time that the video was uploaded. In this case, anyone who knows the video's unique video ID can retrieve the video metadata. |
| Video | Thumbnail height | Thumbnail image height. Available automatically when you select "Video" dimension. |
| Video | Thumbnail width | Thumbnail image width. Available automatically when you select "Video" dimension. |
| Video | Thumbnail URL | URL of thumbnail image. Available automatically when you select "Video" dimension. |
| Video | Tags | A list of keyword tags associated with the video. Available automatically when you select "Video" dimension. |
Metrics
| Group | Name | Description |
|---|---|---|
| Annotations | Annotation click through rate | The ratio of annotations that viewers clicked to the total number of clickable annotation impressions. The YouTube Help Center has more information about creating annotations and using link annotations. |
| Annotations | Annotation clickable impressions | The number of annotations that appeared and could be clicked. |
| Annotations | Annotation clicks | The number of clicked annotations. |
| Annotations | Annotation closable impressions | The number of annotations that appeared and could be closed. |
| Annotations | Annotation close rate | The ratio of annotations that viewers closed to the total number of annotation impressions. |
| Annotations | Annotation closes | The number of closed annotations. |
| Annotations | Annotation impressions | The total number of annotation impressions. |
| Audience retention | Audience watch ratio | The absolute ratio of viewers watching the video at a given point. It is calculated by comparing the number of times a portion of a video has been watched to the total number of views of the video. The ratio can be greater than 1 if viewers watch the same portion more than once. |
| Audience retention | Relative retention performance | A measurement of how well a video retains viewers during playbacks compared to all YouTube videos of similar length. The value ranges from 0 to 1, with 0 indicating worse retention than other videos and 1 indicating better retention. A median value of 0.5 indicates average performance. |
| Audience retention | Started watching | The number of times a particular segment of the video was the first segment seen during a video playback. |
| Audience retention | Stopped watching | The number of times a particular segment of the video was the last segment seen during a video playback. |
| Audience retention | Total segment impressions | The number of times a particular segment of a video was viewed. A viewer can watch the same segment multiple times in the same playback. |
| Cards | Card click rate | The click-through rate for cards, which is calculated as the ratio of card clicks to card impressions. |
| Cards | Card clicks | The number of times that cards were clicked. |
| Cards | Card impressions | The number of times cards were displayed. When the card panel is opened, a card impression is logged for each of the video's cards. |
| Cards | Card teaser click rate | The click-through rate for card teasers, which is calculated as the ratio of clicks on card teasers to the total number of card teaser impressions. |
| Cards | Card teaser clicks | The number of clicks on card teasers. Card icon clicks are attributed to the last teaser displayed to the user. |
| Cards | Card teaser impressions | The number of times that card teasers were displayed. A video view can generate multiple teaser impressions. |
| Interactions | Comments | The number of times that users commented on a video. |
| Interactions | Dislikes | The number of times that users indicated that they disliked a video by giving it a negative rating. |
| Interactions | Likes | The number of times that users indicated that they liked a video by giving it a positive rating. |
| Interactions | Shares | The number of times that users shared a video through the Share button. |
| Interactions | Subscribers gained | The number of times that users subscribed to a channel. Channels can gain or lose subscribers in several places, including the video watch page, the channel page, and the guide that appears on the YouTube home page. In channel reports, this metric includes subscribers gained from any of these places. However, in reports that use either the video dimension or the filter parameter to restrict the response to only include data for a particular video, the subscribersGained metric will only include statistics from the specified video's watch page. |
| Interactions | Subscribers lost | The number of times that users unsubscribed from a channel. Data for this metric is reported similarly to the subscribersGained metric. In channel reports, this metric includes subscribers lost through any mechanism through which users can unsubscribe from a channel. However, in reports that use either the video dimension or the filter parameter to restrict the response to only include data for a particular video, this metric only includes users who unsubscribed from the specified video's watch page. |
| Performance | Average view duration | The average length, in seconds, of video playbacks. As of December 13, 2021, this metric excludes looping clips traffic. In a playlist report, the metric indicates the average length, in seconds, of video playbacks that occurred in the context of a playlist. |
| Performance | Average view percentage | The average percentage of a video watched during a video playback. |
| Performance | Watch time (minutes) | The number of minutes that users watched videos for the specified channel, content owner, video, or playlist. |
| Performance | Viewer percentage | The percentage of viewers who were logged in when watching the video or playlist. |
| Performance | Views | This metric represents different numbers in different types of reports:
|
| Playlist | Average time in playlist | The estimated average amount of time, in minutes, that a viewer viewed videos in a playlist after the playlist was initiated. Note that this metric includes only playlist views that occurred on the web. |
| Playlist | Playlist starts | The number of times that viewers initiated playback of a playlist. Note that this metric includes only playlist views that occurred on the web. |
| Playlist | Videos added to playlists | The number of times that videos were added to any YouTube playlists. The videos could have been added to the video owner's playlist or to other channels' playlists. The metric value does include the number of times that videos were added to default playlists like the "Watch Later" playlist. However, it does not count playlists that a video is automatically added to, such as a channel's uploads playlist or a user's watch history. This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, and then adds it again, the metric value reflects the video being added to a playlist twice. Data for this metric is not available for dates before October 1, 2014. |
| Playlist | Videos removed from playlists | The number of times that videos were removed from any YouTube playlists. The videos could have been removed from the video owner's playlist or from other channels' playlists. The metric value includes the number of times that videos were removed from default playlists like the "Watch Later" playlist. This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, adds it again, and then removes it again, the metric value reflects the video being removed from a playlist twice. Data for this metric is not available for dates before October 1, 2014. |
| Playlist | Views per playlist start | The average number of video views that occurred each time a playlist was initiated. Note that this metric includes only playlist views that occurred on the web. |
| Playlist | Playlist average view duration | The estimated average length, in seconds, watched per playlist view. Note that this metric represents the average length of views of individual videos within a playlist; the averageTimeInPlaylist metric, by contrast, represents the average time each viewer spends watching the playlist as a whole. This metric includes data for playlist videos that are owned by other channels. |
| Playlist | Playlist watch time (minutes) | The number of minutes that users watched the playlist content as a part of the playlist. Watch time that occurred in other contexts—for example, watch time from views that occurred when viewers were watching the same video as part of other playlists—is not counted. This metric includes data for playlist videos that are owned by other channels. |
| Playlist | Playlist views | The number of times that videos in the playlist were viewed in the context of that playlist. This metric includes data for playlist videos that are owned by other channels. |
| Playlist | Playlist saves | The net number of times that users saved a playlist. This metric returns a net change number, meaning that if a user saves a playlist, removes it from the list of saved playlists, and saves it again, the metric value reflects one playlist save being added. |
| Premium | YouTube Premium watch time (minutes) | The number of minutes that YouTube Premium (previously known as YouTube Red) members watched a video. |
| Premium | YouTube Premium views | The number of times that a video was viewed by YouTube Premium (previously known as YouTube Red) members. |
đź‘€ Metrics and dimensions returned by custom report depend on your importer settings. This list contains all metrics and dimensions that Coupler.io supports. Note: not all dimensions & metrics are compatible with each other due to YouTube API limits.