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 Watched estimatedMinutesWatched Metric
The total number of minutes that users watched videos from the specified channel, content owner, video, or playlist.
Estimated Revenue estimatedRevenue Metric
The total estimated revenue from all sales sources, including ads and YouTube Premium.
Red Views redViews Metric
The number of times a video was viewed by YouTube Premium (formerly YouTube Red) members.
ageGroup Dimension
The age group of the viewers (e.g., '18-24', '25-34').
age_group Dimension
The age group of the viewers (e.g., '18-24', '25-34'). This is a core dimension used to aggregate data.
annotationClickThroughRate Metric
The click-through rate for annotations, calculated as clicks per impression.
annotationClickableImpressions Metric
The number of impressions for annotations that were clickable.
annotationClicks Metric
The number of clicks on annotations during video playback.
annotationClosableImpressions Metric
The number of annotations displayed to viewers that included a close button, allowing viewers to dismiss them.
annotationCloseRate Metric
The close rate for annotations, calculated as closes per impression.
annotationCloses Metric
The number of times annotations were closed by viewers.
annotationImpressions Metric
The total number of annotation impressions shown to viewers.
annotation_click_through_rate Metric
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_impressions Metric
The number of impressions for annotations that appeared and could be clicked by viewers.
annotation_clicks Metric
The total number of clicks on annotations during video playback.
annotation_closable_impressions Metric
The number of annotations displayed to viewers that included a close button, allowing them to dismiss the annotation.
annotation_close_rate Metric
The close rate for annotations, calculated as the ratio of annotations that viewers closed to the total number of annotation impressions.
annotation_closes Metric
The total number of times annotations were closed by viewers.
annotation_impressions Metric
The total number of annotation impressions shown to viewers.
audienceWatchRatio Metric
A measurement of audience retention, indicating the percentage of viewers still watching at a given point in the video.
averageTimeInPlaylist Metric
The average time, in seconds, a viewer spent watching playlist videos after arriving at the playlist.
averageViewDuration Metric
The average length, in seconds, of video playbacks. For playlist reports, it indicates the average length of video playbacks within the playlist context.
averageViewPercentage Metric
The average percentage of a video that viewers watched during playbacks.
average_view_duration_percentage Metric
The average percentage of a video that viewers watched. This is an alternative representation of averageViewPercentage.
average_view_duration_seconds Metric
The average length, in seconds, of video playbacks. This is an alternative representation of averageViewDuration.
brandingSettings Dimension
Encapsulates information about the branding settings of a YouTube channel.
brandingSettings.channel.country Dimension
The country associated with the YouTube channel, as specified in its branding settings.
brandingSettings.channel.description Dimension
The description of the YouTube channel, as specified in its branding settings.
brandingSettings.channel.keywords Dimension
Keywords associated with the YouTube channel, used for discoverability and specified in its branding settings.
brandingSettings.channel.title Dimension
The title of the YouTube channel as defined in its branding settings. This title has a maximum length of 30 characters.
brandingSettings.channel.unsubscribedTrailer Dimension
The ID of the video that serves as the channel trailer for unsubscribed viewers, specified in the channel's branding settings.
brandingSettings.image.bannerExternalUrl Dimension
The external URL of the banner image used for the channel's branding.
cardClickRate Metric
The click rate for cards, calculated as clicks per card impression.
cardClicks Metric
The number of clicks on cards displayed during video playback.
cardImpressions Metric
The number of times cards were displayed during video playback.
cardTeaserClickRate Metric
The click rate for card teasers, calculated as clicks per card teaser impression.
cardTeaserClicks Metric
The number of clicks on card teasers displayed during video playback.
cardTeaserImpressions Metric
The number of times card teasers were displayed to viewers.
card_click_rate Metric
The click-through rate for cards, calculated as the ratio of card clicks to card impressions.
card_clicks Metric
The number of times that cards were clicked during video playback.
card_impressions Metric
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_rate Metric
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_clicks Metric
The number of clicks on card teasers. Clicks on the card icon are attributed to the last teaser displayed to the user.
card_teaser_impressions Metric
The number of times that card teasers were displayed. A single video view can generate multiple teaser impressions.
channel_description Dimension
The public description of the YouTube channel.
channel_hidden_subscriber_count Metric
A boolean value indicating whether the YouTube channel's subscriber count is hidden from public view.
channel_id Dimension
The unique identifier for the YouTube channel.
channel_name Dimension
The public name or title of the YouTube channel.
channel_published_at Dimension
The date and time when the YouTube channel was created.
channel_subscriber_count Metric
The number of subscribers a YouTube channel has, rounded down to three significant figures.
channel_video_count Metric
The total number of public videos uploaded to the YouTube channel.
channel_view_count Metric
The total number of times all videos across the YouTube channel have been viewed.
comments Metric
The number of comments made on the video.
contentDetails.duration Metric
The duration of the video.
contentDetails.relatedPlaylists.likes Dimension
The ID of the playlist that contains the videos liked by the channel.
contentDetails.relatedPlaylists.uploads Dimension
The ID of the playlist that contains all videos uploaded by the channel.
contentOwnerDetails Dimension
Encapsulates channel data relevant for YouTube Partners linked with the channel, including content owner ID and linking time.
country Dimension
The country where the viewers were located.
country_code Dimension
The two-letter ISO-3166-1 country code associated with the metrics in the report.
cpm Metric
Estimated gross revenue per thousand ad impressions.
creatorContentType Dimension
This dimension identifies the type of YouTube content (e.g., video, Shorts, live stream, Story) associated with user activity metrics.
date Dimension
The specific date for which the analytics data is reported, provided in YYYY-MM-DD format.
date_iso Dimension
The date associated with the metrics, formatted according to ISO 8601.
day Dimension
The specific date for which the report data is provided, representing a day-level granularity.
deviceType Dimension
The type of device on which the video was viewed (e.g., desktop, mobile, tablet, TV).
device_type Dimension
The category of device used for viewing (e.g., 'desktop', 'mobile').
dislikes Metric
The number of negative ratings (dislikes) received for the video.
elapsedVideoTimeRatio Metric
The point in the video playback, expressed as a ratio, at which retention data is measured.
engagedViews Metric
The number of times the channel's videos have been viewed past the initial seconds, indicating viewer engagement.
engaged_views Metric
The number of times the channel's videos have been viewed past the initial seconds.
estimatedAdRevenue Metric
Estimated revenue from YouTube-sold advertising.
estimatedRedMinutesWatched Metric
The number of minutes that YouTube Premium members watched videos.
etag Dimension
An identifier used for resource caching and conditional requests. It helps determine if a resource has changed, reducing bandwidth and API quota usage.
gender Dimension
The gender of the viewers (e.g., 'male', 'female', 'unknown').
grossRevenue Metric
The estimated gross revenue from all sales sources before any YouTube deductions.
id Dimension
A unique identifier for a YouTube resource, such as a channel, video, or playlist.
insightPlaybackLocationDetail Dimension
Detailed information about the specific location where the video playback occurred.
insightPlaybackLocationType Dimension
The general category of playback location for the video.
insightTrafficSourceDetail Dimension
Detailed information about the specific traffic source that led viewers to the video or channel.
insightTrafficSourceType Dimension
The type of traffic source that led viewers to the video or channel.
kind Dimension
Identifies the type of API resource. For example, a channel resource will have the value 'youtube#channel'.
likes Metric
The number of positive ratings (likes) received for the video.
liveOrOnDemand Dimension
Indicates whether the video content viewed was a live stream or an on-demand video.
live_or_on_demand Dimension
Indicates whether the user activity occurred during a live broadcast or for an on-demand video.
localizations Dimension
Provides localized metadata for the channel in different languages, allowing for multilingual titles and descriptions.
monetizedPlaybacks Metric
The number of times a video playback occurred and showed at least one ad impression.
month Dimension
The month in which the user activity occurred.
operatingSystem Dimension
The operating system on which the video was viewed (e.g., Windows, macOS, Android, iOS).
operating_system Metric
The operating system of the device used for viewing.
playbackBasedCpm Metric
Estimated gross revenue per thousand playbacks where at least one ad impression occurred.
playback_location_type Metric
The general type of location where the video playback occurred (e.g., watch page, embedded player).
playlistAverageViewDuration Metric
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.
playlistEstimatedMinutesWatched Metric
The total number of minutes users watched videos while they were played in the context of a playlist.
playlistStarts Metric
The number of times viewers initiated the playback of a playlist.
playlistViews Metric
The total number of views that occurred when videos were watched in the context of a playlist.
playlist_id Dimension
The unique identifier for a YouTube playlist.
playlist_saves_added Metric
The net number of times that users saved a playlist.
playlist_saves_removed Metric
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_starts Metric
The number of times that viewers initiated playback of a playlist. This metric only includes playlist views that occurred on the web.
playlist_title Dimension
The title of the YouTube playlist.
red_views Metric
The number of views by YouTube Premium members.
red_watch_time_minutes Metric
The number of minutes YouTube Premium members watched videos.
relativeRetentionPerformance Metric
A metric showing how well a video retains viewers at a specific point compared to other YouTube videos of similar length.
report_date Dimension
The date on which the user activity or report data occurred.
shares Metric
The number of times the video was shared.
sharingService Dimension
The service through which the video was shared (e.g., 'Facebook', 'Twitter').
snippet.categoryId Metric
The YouTube category ID assigned to the video.
snippet.channelId Dimension
The unique ID of the channel that published the video.
snippet.channelTitle Dimension
The title of the channel that published the video.
snippet.country Dimension
The country associated with the YouTube channel, visible in the channel's basic details.
snippet.customUrl Dimension
The custom URL of the YouTube channel, if set by the channel owner.
snippet.defaultLanguage Dimension
The default language for the channel's metadata, used for the snippet's title and description.
snippet.description Dimension
The public description of the YouTube resource, such as a channel or video. For channels, it has a maximum length of 1000 characters.
snippet.localized Dimension
Contains localized title and description for the channel, or the default language version if no specific localization is available.
snippet.localized.description Dimension
The localized description of the YouTube channel.
snippet.localized.title Dimension
The localized title of the YouTube channel.
snippet.publishedAt Dimension
The date and time when the video was published.
snippet.tags Dimension
A list of keyword tags associated with the video.
snippet.thumbnails Dimension
Contains a collection of thumbnail images for the channel in various resolutions (default, medium, high).
snippet.thumbnails.default.height Metric
The height of the default resolution thumbnail image for the channel.
snippet.thumbnails.default.url Dimension
The URL of the default resolution thumbnail image for the channel.
snippet.thumbnails.default.width Metric
The width of the default resolution thumbnail image for the channel.
snippet.thumbnails.high.height Metric
The height of the high-resolution thumbnail image for the channel.
snippet.thumbnails.high.url Dimension
The URL of the high-resolution thumbnail image for the channel.
snippet.thumbnails.high.width Metric
The width of the high-resolution thumbnail image for the channel.
snippet.thumbnails.medium.height Metric
The height of the medium-resolution thumbnail image for the channel.
snippet.thumbnails.medium.url Dimension
The URL of the medium-resolution thumbnail image for the channel.
snippet.thumbnails.medium.width Metric
The width of the medium-resolution thumbnail image for the channel.
snippet.thumbnails.standard.url Dimension
The URL of the standard resolution thumbnail image for the video.
snippet.title Dimension
The public title of the YouTube resource, such as a channel or video.
statistics.commentCount Metric
The total number of comments for the video.
statistics.dislikeCount Metric
The total number of dislikes for the video.
statistics.favoriteCount Metric
The total number of times the video was marked as a favorite.
statistics.hiddenSubscriberCount Dimension
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.likeCount Metric
The total number of likes for the video.
statistics.subscriberCount Metric
The number of subscribers a YouTube channel has, rounded down to three significant figures.
statistics.videoCount Metric
The total number of public videos uploaded to the channel.
statistics.viewCount Metric
The total number of times all videos on a channel have been viewed, or the total views for a specific video.
status Dimension
Contains important information about the channel's status, including privacy, linking, long video eligibility, and 'made for kids' designations.
subscribedStatus Dimension
Indicates whether the user activity metrics are associated with viewers subscribed to the channel.
subscribed_status Dimension
Indicates whether the viewers were subscribed to the channel at the time of activity.
subscribersGained Metric
The number of new subscriptions gained for the channel.
subscribersLost Metric
The number of subscriptions lost for the channel.
subscribers_gained Metric
The number of times that users subscribed to a channel.
subscribers_lost Metric
The number of times that users unsubscribed from a channel.
topicDetails Dimension
Encapsulates information about Freebase topics and categories associated with the channel, helping to categorize its content.
topicDetails.topicCategories Dimension
A list of Wikipedia URLs that describe the primary content categories of the channel.
topicDetails.topicIds Dimension
A list of Freebase topic IDs associated with the channel, providing granular categorization of its content.
traffic_source_detail Dimension
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_type Metric
The general type of traffic source that led viewers to the video or channel (e.g., YouTube search, external website).
video_description Dimension
The description of the video.
video_duration Dimension
The duration of the video.
video_id Dimension
The unique identifier for the YouTube video.
video_name Dimension
The title or name of the YouTube video.
video_published_at Dimension
The date and time when the video was published.
video_published_date Dimension
The date when the video was published.
video_thumbnail_impressions Metric
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_ctr Metric
The click-through rate (CTR) for video thumbnails, representing the percentage of times viewers watched a video after seeing its thumbnail.
videosAddedToPlaylists Metric
The number of times videos were added to a YouTube playlist.
videosRemovedFromPlaylists Metric
The number of times videos were removed from a YouTube playlist.
videos_added_to_playlists Metric
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_playlists Metric
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'.
viewerPercentage Metric
The percentage of viewers who were logged into their YouTube accounts when watching the video or playlist.
views Metric
The total number of times the video, channel, or playlist was viewed.
watch_time_minutes Metric
The total number of minutes users watched videos.
youtubeProduct Dimension
The YouTube product where the activity occurred (e.g., 'YouTube', 'YouTube Kids', 'YouTube Music').