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 impressions for annotations that could be closed by the viewer.	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
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.channel.description	brandingSettings.channel.description	The description of the YouTube channel 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
channel_comment_count	channel_comment_count	The total number of comments made on the channel. This field is deprecated in the YouTube Data API.	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.caption	contentDetails.caption	Indicates whether the video has captions enabled (‘true’ or ‘false’).	dimension
contentDetails.definition	contentDetails.definition	The video’s definition, indicating its resolution (e.g., ‘sd’ for standard definition, ‘hd’ for high definition).	dimension
contentDetails.dimension	contentDetails.dimension	The video’s dimension, indicating if it’s 2D or 3D.	dimension
contentDetails.duration	contentDetails.duration	The length of the video in ISO 8601 format (e.g., ‘PT15M3S’ for 15 minutes and 3 seconds).	metric
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		dimension
date	date	The specific date associated with the metrics in each report row, typically 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
fileDetails.audioStreams	fileDetails.audioStreams	Detailed information about the audio streams present in the video file.	dimension
fileDetails.videoStreams	fileDetails.videoStreams	Detailed information about the video streams present in the video file.	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.	metric
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
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
processingDetails.thumbnailsAvailability	processingDetails.thumbnailsAvailability	Indicates the current availability status of video thumbnails after processing.	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
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.customUrl	snippet.customUrl	The custom URL of 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.title	snippet.localized.title	The localized title of the video, available in a specific language.	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 map of thumbnail images for the video, with different sizes and resolutions.	dimension
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.	metric
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.privacyStatus	status.privacyStatus	The privacy status of the video or playlist (e.g., public, private, unlisted).	dimension
status.publishAt	status.publishAt	The scheduled date and time for the video to be published. This field is primarily for private videos.	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	Information about the topics associated with the video, derived from content classification.	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).	dimension
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
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