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.

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