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
Channel	Channel		dimension
Date	Date		dimension
Estimated Revenue	estimatedRevenue		dimension
Playlist Views	playlistViews		metric
Red Views	redViews		metric
Subscribers Gained	subscribersGained		metric
Subscribers Lost	subscribersLost		metric
Video Publish Date	Video Publish Date		dimension
ageGroup	ageGroup	This dimension identifies the age group of the logged-in users associated with the report data.	dimension
age_group	age_group		dimension
annotationClickThroughRate	annotationClickThroughRate	The ratio of annotations that viewers clicked to the total number of clickable annotation impressions.	metric
annotationClickableImpressions	annotationClickableImpressions	The number of annotations that appeared and could be clicked.	metric
annotationClicks	annotationClicks	The number of clicked annotations.	metric
annotationClosableImpressions	annotationClosableImpressions	The number of annotations that appeared and could be closed.	metric
annotationCloseRate	annotationCloseRate	The ratio of annotations that viewers closed to the total number of annotation impressions.	metric
annotationCloses	annotationCloses	The number of closed annotations.	metric
annotationImpressions	annotationImpressions	The total number of annotation impressions.	metric
annotation_click_through_rate	annotation_click_through_rate		metric
annotation_clickable_impressions	annotation_clickable_impressions		metric
annotation_clicks	annotation_clicks		metric
annotation_closable_impressions	annotation_closable_impressions		metric
annotation_close_rate	annotation_close_rate		metric
annotation_closes	annotation_closes		metric
annotation_impressions	annotation_impressions		metric
asset_id	asset_id		dimension
audienceWatchRatio	audienceWatchRatio	The absolute ratio of viewers watching the video at the given point in the video. The ratio 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 elapsedVideoTimeRatio dimension identifies the portion of the video to which the metric corresponds.	metric
audienceWatchRatio_r100	audienceWatchRatio_r100		metric
audienceWatchRatio_r25	audienceWatchRatio_r25		metric
audienceWatchRatio_r50	audienceWatchRatio_r50		metric
audienceWatchRatio_r75	audienceWatchRatio_r75		metric
averageTimeInPlaylist	averageTimeInPlaylist		metric
averageViewPercentage	averageViewPercentage	The average percentage of a video watched during a video playback.	metric
average_view_duration_percentage	average_view_duration_percentage		metric
average_view_duration_seconds	average_view_duration_seconds		metric
cardClickRate	cardClickRate	The click-through-rate for cards, which is calculated as the ratio of card clicks to card impressions.	metric
cardClicks	cardClicks	The number of times that cards were clicked.	metric
cardImpressions	cardImpressions	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
cardTeaserClickRate	cardTeaserClickRate	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
cardTeaserClicks	cardTeaserClicks	The number of clicks on card teasers. Card icon clicks are attributed to the last teaser displayed to the user.	metric
cardTeaserImpressions	cardTeaserImpressions	The number of times that card teasers were displayed. A video view can generate multiple teaser impressions.	metric
card_click_rate	card_click_rate		metric
card_clicks	card_clicks		metric
card_impressions	card_impressions		metric
card_teaser_click_rate	card_teaser_click_rate		metric
card_teaser_clicks	card_teaser_clicks		metric
card_teaser_impressions	card_teaser_impressions		metric
channel	channel		dimension
channel_comment_count	channel_comment_count		dimension
channel_description	channel_description		dimension
channel_hidden_subscriber_count	channel_hidden_subscriber_count		dimension
channel_id	channel_id	The ID that YouTube uses to uniquely identify the channel.	dimension
channel_name	channel_name		dimension
channel_published_at	channel_published_at		dimension
channel_subscriber_count	channel_subscriber_count		dimension
channel_video_count	channel_video_count		dimension
channel_view_count	channel_view_count		dimension
claimed_status	claimed_status		dimension
comments	comments	The number of times that users commented on a video.	metric
contentDetails.caption	contentDetails.caption		dimension
contentDetails.definition	contentDetails.definition		dimension
contentDetails.dimension	contentDetails.dimension		dimension
contentDetails.duration	contentDetails.duration		metric
country	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.	dimension
country_code	country_code		dimension
cpm	cpm		metric
date	date		dimension
date_iso	date_iso		dimension
day	day	When you use this dimension, data in the report is aggregated on a daily basis and each row contains data for one day. You can use other dimensions to break down the data even further. For example, a traffic source report can aggregate daily viewing statistics based on the manner in which users reach your videos.	dimension
deviceType	deviceType	This dimension identifies the physical form factor of the device on which the view occurred.	dimension
device_type	device_type		metric
dislikes	dislikes	The number of times that users indicated that they disliked a video by giving it a negative rating.	metric
elapsedVideoTimeRatio	elapsedVideoTimeRatio	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.	metric
elapsedVideoTimeRatio_r100	elapsedVideoTimeRatio_r100		metric
elapsedVideoTimeRatio_r25	elapsedVideoTimeRatio_r25		metric
elapsedVideoTimeRatio_r50	elapsedVideoTimeRatio_r50		metric
elapsedVideoTimeRatio_r75	elapsedVideoTimeRatio_r75		metric
end_date	end_date		dimension
end_screen_element_click_rate	end_screen_element_click_rate		metric
end_screen_element_clicks	end_screen_element_clicks		metric
end_screen_element_impressions	end_screen_element_impressions		metric
end_screen_element_type	end_screen_element_type		metric
estimatedAdRevenue	estimatedAdRevenue		dimension
estimatedRedMinutesWatched	estimatedRedMinutesWatched	The number of minutes that YouTube Red members watched a video.	metric
etag	etag		dimension
fileDetails.audioStreams	fileDetails.audioStreams		dimension
fileDetails.videoStreams	fileDetails.videoStreams		dimension
gender	gender	This dimension identifies the gender of the logged-in users associated with the report data.	dimension
grossRevenue	grossRevenue		dimension
id	id		dimension
insightPlaybackLocationType	insightPlaybackLocationType	Data in the report is aggregated based on the type of page or application where video playbacks occurred.	dimension
insightTrafficSourceType	insightTrafficSourceType	Data in the report is aggregated based on the referrer type, which describes the manner in which users reached the video. Possible values for this dimension are:	dimension
kind	kind		dimension
likes	likes	The number of times that users indicated that they liked a video by giving it a positive rating.	metric
liveOrOnDemand	liveOrOnDemand	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.	dimension
live_or_on_demand	live_or_on_demand		dimension
month	month	Data in the report is aggregated by calendar month. As with daily reports, you can use other filters to segment the data even further. In the report, dates are listed in YYYY-MM format.	dimension
operating_system	operating_system		metric
partner_revenue	partner_revenue		metric
partner_revenue_auction	partner_revenue_auction		metric
partner_revenue_partner_sold_partner_served	partner_revenue_partner_sold_partner_served		metric
partner_revenue_partner_sold_youtube_served	partner_revenue_partner_sold_youtube_served		metric
partner_revenue_reserved	partner_revenue_reserved		metric
playlistAverageViewDuration	playlistAverageViewDuration		metric
playlist_id	playlist_id		dimension
playlist_title	playlist_title		dimension
processingDetails.thumbnailsAvailability	processingDetails.thumbnailsAvailability		dimension
red_views	red_views		metric
red_watch_time_minutes	red_watch_time_minutes		metric
relativeRetentionPerformance	relativeRetentionPerformance	A measurement that shows how well a video retains viewers during playbacks in comparison to all YouTube videos of similar length. The metric has a value between 0 and 1 that identifies the video’s relative retention performance at a given point in the video. The point in the video is provided by the elapsedVideoTimeRatio dimension.	metric
shares	shares	The number of times that users shared a video through the Share button.	metric
sharingService	sharingService	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.	dimension
snippet.categoryId	snippet.categoryId		metric
snippet.channelId	snippet.channelId		dimension
snippet.channelTitle	snippet.channelTitle		dimension
snippet.description	snippet.description		dimension
snippet.localized.title	snippet.localized.title		dimension
snippet.publishedAt	snippet.publishedAt		dimension
snippet.tags	snippet.tags		dimension
snippet.thumbnails	snippet.thumbnails		dimension
snippet.thumbnails.standard.url	snippet.thumbnails.standard.url		dimension
snippet.title	snippet.title		dimension
start_date	start_date		dimension
statistics.commentCount	statistics.commentCount		metric
statistics.dislikeCount	statistics.dislikeCount		metric
statistics.favoriteCount	statistics.favoriteCount		metric
statistics.likeCount	statistics.likeCount		metric
statistics.viewCount	statistics.viewCount		metric
status.publishAt	status.publishAt		dimension
subscribedStatus	subscribedStatus	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.	dimension
subscribed_status	subscribed_status		dimension
subscribers_gained	subscribers_gained		metric
subscribers_lost	subscribers_lost		metric
uploader_type	uploader_type		dimension
video	video	video identifier	dimension
video_description	video_description		dimension
video_duration	video_duration		dimension
video_id	video_id		dimension
video_name	video_name		dimension
video_published_at	video_published_at		dimension
video_published_date	video_published_date		dimension
video_title	video_title		dimension
videosAddedToPlaylists	videosAddedToPlaylists	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.	metric
videosRemovedFromPlaylists	videosRemovedFromPlaylists	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.	metric
videos_added_to_playlists	videos_added_to_playlists		metric
videos_removed_from_playlists	videos_removed_from_playlists		metric
view_type	view_type		dimension
viewerPercentage	viewerPercentage		metric
watch_time_minutes	watch_time_minutes		metric
youtubeProduct	youtubeProduct	This dimension identifies the YouTube service on which the user activity occurred. Data for this dimension is available as of July 18, 2015.	dimension
youtube_revenue_split	youtube_revenue_split		metric
youtube_revenue_split_auction	youtube_revenue_split_auction		metric
youtube_revenue_split_partner_sold_partner_served	youtube_revenue_split_partner_sold_partner_served		metric
youtube_revenue_split_partner_sold_youtube_served	youtube_revenue_split_partner_sold_youtube_served		metric
youtube_revenue_split_reserved	youtube_revenue_split_reserved		metric