YouTube Analytics: Most-used fields
The table below gives information about most-used fields that you can import from YouTube Analytics. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
Estimated Minutes WatchedestimatedMinutesWatchedMetric
The total number of minutes that users watched videos from the specified channel, content owner, video, or playlist.
Estimated RevenueestimatedRevenueMetric
The total estimated revenue from all sales sources, including ads and YouTube Premium.
Red ViewsredViewsMetric
The number of times a video was viewed by YouTube Premium (formerly YouTube Red) members.
ageGroupDimension
The age group of the viewers (e.g., '18-24', '25-34').
age_groupDimension
The age group of the viewers (e.g., '18-24', '25-34'). This is a core dimension used to aggregate data.
annotationClickThroughRateMetric
The click-through rate for annotations, calculated as clicks per impression.
annotationClickableImpressionsMetric
The number of impressions for annotations that were clickable.
annotationClicksMetric
The number of clicks on annotations during video playback.
annotationClosableImpressionsMetric
The number of annotations displayed to viewers that included a close button, allowing viewers to dismiss them.
annotationCloseRateMetric
The close rate for annotations, calculated as closes per impression.
annotationClosesMetric
The number of times annotations were closed by viewers.
annotationImpressionsMetric
The total number of annotation impressions shown to viewers.
annotation_click_through_rateMetric
The click-through rate for annotations, calculated as the ratio of annotations that viewers clicked to the total number of clickable annotation impressions.
annotation_clickable_impressionsMetric
The number of annotations that were displayed on a video and were available for viewers to click.
annotation_clicksMetric
The total number of clicks on annotations during video playback.
annotation_closable_impressionsMetric
The number of annotations displayed to viewers that included a close button, allowing them to dismiss the annotation.
annotation_close_rateMetric
The close rate for annotations, calculated as the ratio of annotations that viewers closed to the total number of annotation impressions.
annotation_closesMetric
The total number of times annotations were closed by viewers.
annotation_impressionsMetric
The total number of annotation impressions shown to viewers.
audienceWatchRatioMetric
A measurement of audience retention, indicating the percentage of viewers still watching at a given point in the video.
averageTimeInPlaylistMetric
The average time, in seconds, a viewer spent watching playlist videos after arriving at the playlist.
averageViewDurationMetric
The average length, in seconds, of video playbacks. For playlist reports, it indicates the average length of video playbacks within the playlist context.
averageViewPercentageMetric
The average percentage of a video that viewers watched during playbacks.
average_view_duration_percentageMetric
The average percentage of a video that viewers watched. This is an alternative representation of averageViewPercentage.
average_view_duration_secondsMetric
The average length, in seconds, of video playbacks. This is an alternative representation of averageViewDuration.
brandingSettingsDimension
Encapsulates information about the branding settings of a YouTube channel.
brandingSettings.channel.countryDimension
The country associated with the YouTube channel, as specified in its branding settings.
brandingSettings.channel.descriptionDimension
The description of the YouTube channel, as specified in its branding settings.
brandingSettings.channel.keywordsDimension
Keywords associated with the YouTube channel, used for discoverability and specified in its branding settings.
brandingSettings.channel.titleDimension
The title of the YouTube channel as defined in its branding settings. This title has a maximum length of 30 characters.
brandingSettings.channel.unsubscribedTrailerDimension
The ID of the video that serves as the channel trailer for unsubscribed viewers, specified in the channel's branding settings.
brandingSettings.image.bannerExternalUrlDimension
The external URL of the banner image used for the channel's branding.
cardClickRateMetric
The click rate for cards, calculated as clicks per card impression.
cardClicksMetric
The number of clicks on cards displayed during video playback.
cardImpressionsMetric
The number of times cards were displayed during video playback.
cardTeaserClickRateMetric
The click rate for card teasers, calculated as clicks per card teaser impression.
cardTeaserClicksMetric
The number of clicks on card teasers displayed during video playback.
cardTeaserImpressionsMetric
The number of times card teasers were displayed to viewers.
card_click_rateMetric
The click-through rate for cards, calculated as the ratio of card clicks to card impressions.
card_clicksMetric
The number of times that cards were clicked during video playback.
card_impressionsMetric
The number of times cards were displayed. When the card panel is opened, an impression is logged for each of the video's cards.
card_teaser_click_rateMetric
The click-through-rate for card teasers, calculated as the ratio of clicks on card teasers to the total number of card teaser impressions.
card_teaser_clicksMetric
The number of clicks on card teasers. Clicks on the card icon are attributed to the last teaser displayed to the user.
card_teaser_impressionsMetric
The number of times that card teasers were displayed. A single video view can generate multiple teaser impressions.
channel_descriptionDimension
The public description of the YouTube channel.
channel_hidden_subscriber_countMetric
A boolean value indicating whether the YouTube channel's subscriber count is hidden from public view.
channel_idDimension
The unique identifier for the YouTube channel.
channel_nameDimension
The public name or title of the YouTube channel.
channel_published_atDimension
The date and time when the YouTube channel was created.
channel_subscriber_countMetric
The number of subscribers a YouTube channel has, rounded down to three significant figures.
channel_video_countMetric
The total number of public videos uploaded to the YouTube channel.
channel_view_countMetric
The total number of times all videos across the YouTube channel have been viewed.
commentsMetric
The number of comments made on the video.
contentDetails.captionDimension
Indicates whether captions are available for the video.
contentDetails.definitionDimension
Indicates whether the video is available in high definition (HD) or only in standard definition (SD).
contentDetails.dimensionDimension
Indicates whether the video is available in 3D or in 2D.
contentDetails.durationMetric
The duration of the video.
contentDetails.hasCustomThumbnailDimension
Indicates whether the video uploader has provided a custom thumbnail image for the video. This property is only visible to the video owner.
contentDetails.relatedPlaylists.likesDimension
The ID of the playlist that contains the videos liked by the channel.
contentDetails.relatedPlaylists.uploadsDimension
The ID of the playlist that contains all videos uploaded by the channel.
contentOwnerDetailsDimension
Encapsulates channel data relevant for YouTube Partners linked with the channel, including content owner ID and linking time.
countryDimension
The country where the viewers were located.
country_codeDimension
The two-letter ISO-3166-1 country code associated with the metrics in the report.
cpmMetric
Estimated gross revenue per thousand ad impressions.
creatorContentTypeDimension
This dimension identifies the type of YouTube content (e.g., video, Shorts, live stream, Story) associated with user activity metrics.
dateDimension
The specific date for which the analytics data is reported, provided in YYYY-MM-DD format.
date_isoDimension
The date associated with the metrics, formatted according to ISO 8601.
dayDimension
The specific date for which the report data is provided, representing a day-level granularity.
deviceTypeDimension
The type of device on which the video was viewed (e.g., desktop, mobile, tablet, TV).
device_typeDimension
The category of device used for viewing (e.g., 'desktop', 'mobile').
dislikesMetric
The number of negative ratings (dislikes) received for the video.
elapsedVideoTimeRatioMetric
The point in the video playback, expressed as a ratio, at which retention data is measured.
engagedViewsMetric
The number of times the channel's videos have been viewed past the initial seconds, indicating viewer engagement.
engaged_viewsMetric
The number of times the channel's videos have been viewed past the initial seconds.
estimatedAdRevenueMetric
Estimated revenue from YouTube-sold advertising.
estimatedRedMinutesWatchedMetric
The number of minutes that YouTube Premium members watched videos.
etagDimension
An identifier used for resource caching and conditional requests. It helps determine if a resource has changed, reducing bandwidth and API quota usage.
fileDetails.fileTypeDimension
The uploaded file's type as detected by YouTube's video processing engine. This data is typically only retrievable by the video owner.
genderDimension
The gender of the viewers (e.g., 'male', 'female', 'unknown').
grossRevenueMetric
The estimated gross revenue from all sales sources before any YouTube deductions.
idDimension
A unique identifier for a YouTube resource, such as a channel, video, or playlist.
insightPlaybackLocationDetailDimension
Detailed information about the specific location where the video playback occurred.
insightPlaybackLocationTypeDimension
The general category of playback location for the video.
insightTrafficSourceDetailDimension
Detailed information about the specific traffic source that led viewers to the video or channel.
insightTrafficSourceTypeDimension
The type of traffic source that led viewers to the video or channel.
kindDimension
Identifies the type of API resource. For example, a channel resource will have the value 'youtube#channel'.
likesMetric
The number of positive ratings (likes) received for the video.
liveOrOnDemandDimension
Indicates whether the video content viewed was a live stream or an on-demand video.
live_or_on_demandDimension
Indicates whether the user activity occurred during a live broadcast or for an on-demand video.
localizationsDimension
Provides localized metadata for the channel in different languages, allowing for multilingual titles and descriptions.
monetizedPlaybacksMetric
The number of times a video playback occurred and showed at least one ad impression.
monthDimension
The month in which the user activity occurred.
operatingSystemDimension
The operating system on which the video was viewed (e.g., Windows, macOS, Android, iOS).
operating_systemMetric
The operating system of the device used for viewing.
playbackBasedCpmMetric
Estimated gross revenue per thousand playbacks where at least one ad impression occurred.
playback_location_typeMetric
The general type of location where the video playback occurred (e.g., watch page, embedded player).
playlistAverageViewDurationMetric
The average length, in seconds, that viewers watched individual videos within the context of a playlist. This metric includes data for playlist videos owned by other channels.
playlistEstimatedMinutesWatchedMetric
The total number of minutes users watched videos while they were played in the context of a playlist.
playlistStartsMetric
The number of times viewers initiated the playback of a playlist.
playlistViewsMetric
The total number of views that occurred when videos were watched in the context of a playlist.
playlist_idDimension
The unique identifier for a YouTube playlist.
playlist_saves_addedMetric
The net number of times that users saved a playlist.
playlist_saves_removedMetric
The number of times that videos were removed from any YouTube playlists, including both the video owner's playlists and other channels' playlists. This also includes removals from default playlists like 'Watch Later'.
playlist_startsMetric
The number of times that viewers initiated playback of a playlist. This metric only includes playlist views that occurred on the web.
playlist_titleDimension
The title of the YouTube playlist.
red_viewsMetric
The number of views by YouTube Premium members.
red_watch_time_minutesMetric
The number of minutes YouTube Premium members watched videos.
relativeRetentionPerformanceMetric
A metric showing how well a video retains viewers at a specific point compared to other YouTube videos of similar length.
report_dateDimension
The date on which the user activity or report data occurred.
sharesMetric
The number of times the video was shared.
sharingServiceDimension
The service through which the video was shared (e.g., 'Facebook', 'Twitter').
snippet.categoryIdMetric
The YouTube category ID assigned to the video.
snippet.channelIdDimension
The unique ID of the channel that published the video.
snippet.channelTitleDimension
The title of the channel that published the video.
snippet.countryDimension
The country associated with the YouTube channel, visible in the channel's basic details.
snippet.customUrlDimension
The custom URL of the YouTube channel, if set by the channel owner.
snippet.defaultLanguageDimension
The default language for the channel's metadata, used for the snippet's title and description.
snippet.descriptionDimension
The public description of the YouTube resource, such as a channel or video. For channels, it has a maximum length of 1000 characters.
snippet.localizedDimension
Contains localized title and description for the channel, or the default language version if no specific localization is available.
snippet.localized.descriptionDimension
The localized description of the YouTube channel.
snippet.localized.titleDimension
The localized title of the YouTube channel.
snippet.publishedAtDimension
The date and time when the video was published.
snippet.tagsDimension
A list of keyword tags associated with the video.
snippet.thumbnailsDimension
Contains a collection of thumbnail images for the channel in various resolutions (default, medium, high).
snippet.thumbnails.default.heightMetric
The height of the default resolution thumbnail image for the channel.
snippet.thumbnails.default.urlDimension
The URL of the default resolution thumbnail image for the channel.
snippet.thumbnails.default.widthMetric
The width of the default resolution thumbnail image for the channel.
snippet.thumbnails.high.heightMetric
The height of the high-resolution thumbnail image for the channel.
snippet.thumbnails.high.urlDimension
The URL of the high-resolution thumbnail image for the channel.
snippet.thumbnails.high.widthMetric
The width of the high-resolution thumbnail image for the channel.
snippet.thumbnails.medium.heightMetric
The height of the medium-resolution thumbnail image for the channel.
snippet.thumbnails.medium.urlDimension
The URL of the medium-resolution thumbnail image for the channel.
snippet.thumbnails.medium.widthMetric
The width of the medium-resolution thumbnail image for the channel.
snippet.thumbnails.standard.urlDimension
The URL of the standard resolution thumbnail image for the video.
snippet.titleDimension
The public title of the YouTube resource, such as a channel or video.
statistics.commentCountMetric
The total number of comments for the video.
statistics.dislikeCountMetric
The total number of dislikes for the video.
statistics.favoriteCountMetric
The total number of times the video was marked as a favorite.
statistics.hiddenSubscriberCountDimension
A boolean value indicating whether the channel's subscriber count is hidden from public view. If true, the subscriber count will not be available.
statistics.likeCountMetric
The total number of likes for the video.
statistics.subscriberCountMetric
The number of subscribers a YouTube channel has, rounded down to three significant figures.
statistics.videoCountMetric
The total number of public videos uploaded to the channel.
statistics.viewCountMetric
The total number of times all videos on a channel have been viewed, or the total views for a specific video.
statusDimension
Contains important information about the channel's status, including privacy, linking, long video eligibility, and 'made for kids' designations.
status.publicStatsViewableDimension
Indicates whether the extended video statistics, such as view count and ratings, on the video's watch page are publicly viewable.
status.publishAtDimension
The date and time when the video is scheduled to be published or was made public. This can differ from the upload time if the video was initially private and later set to public.
subscribedStatusDimension
Indicates whether the user activity metrics are associated with viewers subscribed to the channel.
subscribed_statusDimension
Indicates whether the viewers were subscribed to the channel at the time of activity.
subscribersGainedMetric
The number of new subscriptions gained for the channel.
subscribersLostMetric
The number of subscriptions lost for the channel.
subscribers_gainedMetric
The number of times that users subscribed to a channel.
subscribers_lostMetric
The number of times that users unsubscribed from a channel.
topicDetailsDimension
Encapsulates information about Freebase topics and categories associated with the channel, helping to categorize its content.
topicDetails.topicCategoriesDimension
A list of Wikipedia URLs that describe the primary content categories of the channel.
topicDetails.topicIdsDimension
A list of Freebase topic IDs associated with the channel, providing granular categorization of its content.
traffic_source_detailDimension
Provides additional context and detailed information about the traffic source that led viewers to the video content. For instance, it specifies the Channel ID if the traffic originated from a YouTube channel, or the Video ID if it came from a suggested video, or the type of advertisement if the source was YouTube advertising.
traffic_source_typeMetric
The general type of traffic source that led viewers to the video or channel (e.g., YouTube search, external website).
video_descriptionDimension
The description of the video.
video_durationDimension
The duration of the video.
video_idDimension
The unique identifier for the YouTube video.
video_nameDimension
The title or name of the YouTube video.
video_published_atDimension
The date and time when the video was published.
video_published_dateDimension
The date when the video was published.
video_thumbnail_impressionsMetric
The total number of times a video thumbnail was displayed to viewers. This metric is available in Reach reports, which provide statistics related to how often video thumbnails are shown and their corresponding click-through rates.
video_thumbnail_impressions_ctrMetric
The click-through rate (CTR) for video thumbnails, representing the percentage of times viewers watched a video after seeing its thumbnail.
videosAddedToPlaylistsMetric
The number of times videos were added to a YouTube playlist.
videosRemovedFromPlaylistsMetric
The number of times videos were removed from a YouTube playlist.
videos_added_to_playlistsMetric
The number of times that videos were added to any YouTube playlists, including both the video owner's playlists and other channels' playlists. This includes additions to default playlists like 'Watch Later'.
videos_removed_from_playlistsMetric
The number of times that videos were removed from any YouTube playlists, including both the video owner's playlists and other channels' playlists. This includes removals from default playlists like 'Watch Later'.
viewerPercentageMetric
The percentage of viewers who were logged into their YouTube accounts when watching the video or playlist.
viewsMetric
The total number of times the video, channel, or playlist was viewed.
watch_time_minutesMetric
The total number of minutes users watched videos.
youtubeProductDimension
The YouTube product where the activity occurred (e.g., 'YouTube', 'YouTube Kids', 'YouTube Music').