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 |
The ID for a YouTube channel. |
dimension |
Date |
Date |
The date associated with the metrics in each report row, formatted as YYYY-MM-DD. |
dimension |
Estimated Revenue |
estimatedRevenue |
The total estimated net revenue from all advertising sources and YouTube Premium sales. |
dimension |
Playlist Views |
playlistViews |
The number of times the playlist was viewed. |
metric |
Red Views |
redViews |
The number of times a video was viewed by YouTube Premium (formerly YouTube Red) members. |
metric |
Subscribers Gained |
subscribersGained |
The number of times users subscribed to a channel. |
metric |
Subscribers Lost |
subscribersLost |
The number of times users unsubscribed from a channel. |
metric |
Video Publish Date |
Video Publish Date |
The date when the video was published. |
dimension |
ageGroup |
ageGroup |
The age group of viewers. |
dimension |
age_group |
age_group |
The age group of viewers. |
dimension |
annotationClickThroughRate |
annotationClickThroughRate |
The click-through rate for annotations, calculated as annotation clicks divided by annotation clickable impressions. |
metric |
annotationClickableImpressions |
annotationClickableImpressions |
The number of annotations that appeared on a video and were available for viewers to click. |
metric |
annotationClicks |
annotationClicks |
The number of clicks on annotations. |
metric |
annotationClosableImpressions |
annotationClosableImpressions |
The number of annotations that appeared on a video and were available for viewers to close. |
metric |
annotationCloseRate |
annotationCloseRate |
The rate at which viewers closed annotations, calculated as annotation closes divided by annotation closable impressions. |
metric |
annotationCloses |
annotationCloses |
The number of times viewers closed annotations. |
metric |
annotationImpressions |
annotationImpressions |
The total number of annotation impressions. |
metric |
annotation_click_through_rate |
annotation_click_through_rate |
The click-through rate for annotations, calculated as annotation clicks divided by annotation clickable impressions. |
metric |
annotation_clickable_impressions |
annotation_clickable_impressions |
The number of annotations that appeared on a video and were available for viewers to click. |
metric |
annotation_clicks |
annotation_clicks |
The number of clicks on annotations. |
metric |
annotation_closable_impressions |
annotation_closable_impressions |
The number of annotations that appeared on a video and were available for viewers to close. |
metric |
annotation_close_rate |
annotation_close_rate |
The rate at which viewers closed annotations, calculated as annotation closes divided by annotation closable impressions. |
metric |
annotation_closes |
annotation_closes |
The number of times viewers closed annotations. |
metric |
annotation_impressions |
annotation_impressions |
The total number of annotation impressions. |
metric |
asset_id |
asset_id |
The ID of an asset managed in YouTube’s Content ID system. |
dimension |
audienceWatchRatio |
audienceWatchRatio |
The absolute ratio of viewers watching the video at a specific point in its playback, relative to the total number of views. |
metric |
audienceWatchRatio_r100 |
audienceWatchRatio_r100 |
The absolute ratio of viewers still watching the video at 100% completion. This metric indicates how well the video retains its audience until the very end. |
metric |
audienceWatchRatio_r25 |
audienceWatchRatio_r25 |
The absolute ratio of viewers still watching the video at 25% completion. This metric helps understand initial audience engagement. |
metric |
audienceWatchRatio_r50 |
audienceWatchRatio_r50 |
The absolute ratio of viewers still watching the video at 50% completion. This metric provides insight into mid-video audience retention. |
metric |
audienceWatchRatio_r75 |
audienceWatchRatio_r75 |
The absolute ratio of viewers still watching the video at 75% completion. This metric indicates audience retention towards the latter part of the video. |
metric |
averageTimeInPlaylist |
averageTimeInPlaylist |
The average amount of time viewers spent watching videos within a playlist. |
metric |
averageViewPercentage |
averageViewPercentage |
The average percentage of a video that viewers watched. |
metric |
average_view_duration_percentage |
average_view_duration_percentage |
The average percentage of a video that viewers watched. |
metric |
average_view_duration_seconds |
average_view_duration_seconds |
The average length of time, in seconds, that viewers watched a video. |
metric |
cardClickRate |
cardClickRate |
The click-through rate for cards. |
metric |
cardClicks |
cardClicks |
The number of clicks on cards. |
metric |
cardImpressions |
cardImpressions |
The total number of times cards were displayed. |
metric |
cardTeaserClickRate |
cardTeaserClickRate |
The click-through rate for card teasers. |
metric |
cardTeaserClicks |
cardTeaserClicks |
The number of clicks on card teasers. |
metric |
cardTeaserImpressions |
cardTeaserImpressions |
The total number of times card teasers were displayed. |
metric |
card_click_rate |
card_click_rate |
The click-through rate for cards. |
metric |
card_clicks |
card_clicks |
The number of clicks on cards. |
metric |
card_impressions |
card_impressions |
The total number of times cards were displayed. |
metric |
card_teaser_click_rate |
card_teaser_click_rate |
The click-through rate for card teasers. |
metric |
card_teaser_clicks |
card_teaser_clicks |
The number of clicks on card teasers. |
metric |
card_teaser_impressions |
card_teaser_impressions |
The total number of times card teasers were displayed. |
metric |
channel |
channel |
The ID for a YouTube channel. |
dimension |
channel_comment_count |
channel_comment_count |
The total number of comments across all videos on the channel. |
metric |
channel_description |
channel_description |
The description of the channel. |
dimension |
channel_hidden_subscriber_count |
channel_hidden_subscriber_count |
Indicates whether the channel’s subscriber count is publicly visible. |
metric |
channel_id |
channel_id |
The unique ID that YouTube uses to identify the channel. |
dimension |
channel_name |
channel_name |
The title or name of the channel. |
dimension |
channel_published_at |
channel_published_at |
The date and time when the channel was created. |
dimension |
channel_subscriber_count |
channel_subscriber_count |
The number of subscribers to the channel. |
metric |
channel_video_count |
channel_video_count |
The total number of videos uploaded to the channel. |
metric |
channel_view_count |
channel_view_count |
The total number of times the channel’s videos have been viewed. |
metric |
claimed_status |
claimed_status |
The claiming status of content in content owner reports. |
dimension |
comments |
comments |
The number of times users commented on a video. |
metric |
contentDetails.caption |
contentDetails.caption |
Indicates whether the video has captions. |
dimension |
contentDetails.definition |
contentDetails.definition |
The video’s default high-definition (HD) status (e.g., ‘hd’, ‘sd’). |
dimension |
contentDetails.dimension |
contentDetails.dimension |
The video’s dimension, indicating if it is 2D or 3D. |
dimension |
contentDetails.duration |
contentDetails.duration |
The duration of the video. |
metric |
country |
country |
The country associated with the metrics in the report. |
dimension |
country_code |
country_code |
The two-letter ISO-3166-1 country code associated with the metrics in the report. |
dimension |
cpm |
cpm |
The estimated average cost-per-thousand impressions for ads served on the content. |
metric |
date |
date |
The date associated with the metrics in each report row, formatted as YYYY-MM-DD. |
dimension |
date_iso |
date_iso |
The date in ISO 8601 format (YYYY-MM-DD). |
dimension |
day |
day |
The date associated with the metrics in each report row, formatted as YYYY-MM-DD. |
dimension |
deviceType |
deviceType |
The device type on which the video was played. |
dimension |
device_type |
device_type |
The device type on which the video was played. |
metric |
dislikes |
dislikes |
The number of times users indicated that they disliked a video. |
metric |
elapsedVideoTimeRatio |
elapsedVideoTimeRatio |
The fraction of the video’s total duration that has elapsed. |
metric |
elapsedVideoTimeRatio_r100 |
elapsedVideoTimeRatio_r100 |
The point in the video corresponding to 100% of its total elapsed time. This dimension is used to specify the portion of the video for which audience retention metrics are reported. |
metric |
elapsedVideoTimeRatio_r25 |
elapsedVideoTimeRatio_r25 |
The point in the video corresponding to 25% of its total elapsed time. This dimension is used to specify the portion of the video for which audience retention metrics are reported. |
metric |
elapsedVideoTimeRatio_r50 |
elapsedVideoTimeRatio_r50 |
The point in the video corresponding to 50% of its total elapsed time. This dimension is used to specify the portion of the video for which audience retention metrics are reported. |
metric |
elapsedVideoTimeRatio_r75 |
elapsedVideoTimeRatio_r75 |
The point in the video corresponding to 75% of its total elapsed time. This dimension is used to specify the portion of the video for which audience retention metrics are reported. |
metric |
end_date |
end_date |
The end date for fetching YouTube Analytics data, in YYYY-MM-DD format. |
dimension |
end_screen_element_click_rate |
end_screen_element_click_rate |
The rate at which viewers clicked on an end screen element. |
metric |
end_screen_element_clicks |
end_screen_element_clicks |
The number of clicks on end screen elements. |
metric |
end_screen_element_impressions |
end_screen_element_impressions |
The total number of times end screen elements were displayed. |
metric |
end_screen_element_type |
end_screen_element_type |
The type of end screen element that was displayed. |
metric |
estimatedAdRevenue |
estimatedAdRevenue |
The estimated net revenue from all Google-sold advertising sources. |
dimension |
estimatedRedMinutesWatched |
estimatedRedMinutesWatched |
The number of minutes that YouTube Premium (formerly YouTube Red) members watched videos. |
metric |
etag |
etag |
The Etag of the resource, used for optimistic locking. |
dimension |
fileDetails.audioStreams |
fileDetails.audioStreams |
Information about the video’s audio streams. This field is only available to the video owner. |
dimension |
fileDetails.videoStreams |
fileDetails.videoStreams |
Information about the video’s video streams. This field is only available to the video owner. |
dimension |
gender |
gender |
The gender of the viewers. |
dimension |
grossRevenue |
grossRevenue |
The total estimated gross revenue from all transactions. |
dimension |
id |
id |
A unique identifier for a YouTube entity, which can represent a video, channel, content owner, or report, depending on the context of the data request. |
dimension |
insightPlaybackLocationType |
insightPlaybackLocationType |
The type of page or application where video playbacks occurred. |
dimension |
insightTrafficSourceType |
insightTrafficSourceType |
The type of referrer that sent viewers to the video. |
dimension |
kind |
kind |
Identifies the API resource’s type (e.g., youtube#video, youtube#channel). |
dimension |
likes |
likes |
The number of times users indicated that they liked a video. |
metric |
liveOrOnDemand |
liveOrOnDemand |
Indicates whether the user activity metrics in the data row are associated with live broadcasts or on-demand content. |
dimension |
live_or_on_demand |
live_or_on_demand |
Indicates whether the user activity metrics in the data row are associated with live broadcasts or on-demand content. |
dimension |
month |
month |
The month associated with the metrics in the report. |
dimension |
operating_system |
operating_system |
The operating system on which the video was played. |
metric |
partner_revenue |
partner_revenue |
The total estimated net revenue from sales where a partner sold and delivered ads. |
metric |
partner_revenue_auction |
partner_revenue_auction |
The estimated net revenue from auction-sold partner-served ads. |
metric |
partner_revenue_partner_sold_partner_served |
partner_revenue_partner_sold_partner_served |
The estimated net revenue from partner-sold, partner-served ads. |
metric |
partner_revenue_partner_sold_youtube_served |
partner_revenue_partner_sold_youtube_served |
The estimated net revenue from partner-sold, YouTube-served ads. |
metric |
partner_revenue_reserved |
partner_revenue_reserved |
The estimated net revenue from reserved-sold partner-served ads. |
metric |
playlistAverageViewDuration |
playlistAverageViewDuration |
The average length of time, in seconds, that viewers watched videos in a playlist. |
metric |
playlist_id |
playlist_id |
The unique ID that YouTube uses to identify the playlist. |
dimension |
playlist_title |
playlist_title |
The title of the playlist. |
dimension |
processingDetails.thumbnailsAvailability |
processingDetails.thumbnailsAvailability |
Indicates the availability of video thumbnails during processing. This field is only available to the video owner. |
dimension |
red_views |
red_views |
The number of times a video was viewed by YouTube Premium (formerly YouTube Red) members. |
metric |
red_watch_time_minutes |
red_watch_time_minutes |
The total watch time, in minutes, from YouTube Premium (formerly YouTube Red) members. |
metric |
relativeRetentionPerformance |
relativeRetentionPerformance |
A measurement of how well a video retains viewers compared to all YouTube videos of similar length. |
metric |
shares |
shares |
The number of times users shared a video through the Share button. |
metric |
sharingService |
sharingService |
The service used to share the video (e.g., Facebook, Twitter). |
dimension |
snippet.categoryId |
snippet.categoryId |
The YouTube video category ID. |
metric |
snippet.channelId |
snippet.channelId |
The ID of the channel that uploaded the video or published the playlist. |
dimension |
snippet.channelTitle |
snippet.channelTitle |
The title of the channel that uploaded the video. |
dimension |
snippet.description |
snippet.description |
The description of the resource (video, channel, or playlist). |
dimension |
snippet.localized.title |
snippet.localized.title |
The localized title of the resource (channel or playlist). |
dimension |
snippet.publishedAt |
snippet.publishedAt |
The date and time when the resource (video, channel, or playlist) was published or created. |
dimension |
snippet.tags |
snippet.tags |
A list of keyword tags associated with the video. |
dimension |
snippet.thumbnails |
snippet.thumbnails |
A map of thumbnail images associated with the resource, available in different sizes. |
dimension |
snippet.thumbnails.standard.url |
snippet.thumbnails.standard.url |
The URL for the standard quality thumbnail image of the resource. |
dimension |
snippet.title |
snippet.title |
The title of the resource (video, channel, or playlist). |
dimension |
start_date |
start_date |
The start date for fetching YouTube Analytics data, in YYYY-MM-DD format. |
dimension |
statistics.commentCount |
statistics.commentCount |
The number of comments for the video. |
metric |
statistics.dislikeCount |
statistics.dislikeCount |
The number of times users indicated that they disliked the video. Requires authorization for public listing. |
metric |
statistics.favoriteCount |
statistics.favoriteCount |
The number of times the video has been marked as a favorite. |
metric |
statistics.hiddenSubscriberCount |
statistics.hiddenSubscriberCount |
Indicates whether the channel’s subscriber count is publicly visible. |
dimension |
statistics.likeCount |
statistics.likeCount |
The number of times users indicated that they liked the video. |
metric |
statistics.subscriberCount |
statistics.subscriberCount |
The number of subscribers to the channel. |
metric |
statistics.videoCount |
statistics.videoCount |
The total number of videos uploaded to the channel. |
metric |
statistics.viewCount |
statistics.viewCount |
The number of times the video or channel has been viewed. |
metric |
status.publishAt |
status.publishAt |
The date and time when a private video is scheduled to be published. This field is for videos with a private privacy status. |
dimension |
subscribedStatus |
subscribedStatus |
Indicates whether the user activity metrics are from viewers subscribed to the channel. |
dimension |
subscribed_status |
subscribed_status |
Indicates whether the user activity metrics are from viewers subscribed to the channel. |
dimension |
subscribers_gained |
subscribers_gained |
The number of times users subscribed to a channel. |
metric |
subscribers_lost |
subscribers_lost |
The number of times users unsubscribed from a channel. |
metric |
uploader_type |
uploader_type |
The type of content uploader (e.g., content owner or user). |
dimension |
video |
video |
The ID for a YouTube video. |
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 ID that YouTube uses to identify the video. |
dimension |
video_name |
video_name |
The title of the 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_title |
video_title |
The title of the video. |
dimension |
videosAddedToPlaylists |
videosAddedToPlaylists |
The number of times videos were added to YouTube playlists. |
metric |
videosRemovedFromPlaylists |
videosRemovedFromPlaylists |
The number of times videos were removed from YouTube playlists. |
metric |
videos_added_to_playlists |
videos_added_to_playlists |
The number of times videos were added to YouTube playlists. |
metric |
videos_removed_from_playlists |
videos_removed_from_playlists |
The number of times videos were removed from YouTube playlists. |
metric |
view_type |
view_type |
The type of content associated with the user activity metrics, such as a YouTube livestream, Short, Story, or a regular video. |
dimension |
viewerPercentage |
viewerPercentage |
The percentage of viewers who were logged in when watching the video or playlist. |
metric |
watch_time_minutes |
watch_time_minutes |
The total number of minutes that users watched videos. |
metric |
youtubeProduct |
youtubeProduct |
The YouTube product or property where activity occurred. |
dimension |
youtube_revenue_split |
youtube_revenue_split |
The estimated net revenue from YouTube-sold advertising sources. |
metric |
youtube_revenue_split_auction |
youtube_revenue_split_auction |
The estimated net revenue from auction-sold YouTube-served ads. |
metric |
youtube_revenue_split_partner_sold_partner_served |
youtube_revenue_split_partner_sold_partner_served |
Estimated revenue generated from ads where the ad inventory was sold by a YouTube partner and also served by that partner. This is a component of overall estimated revenue metrics. |
metric |
youtube_revenue_split_partner_sold_youtube_served |
youtube_revenue_split_partner_sold_youtube_served |
Estimated revenue generated from ads where the ad inventory was sold by a YouTube partner, but the ad was served by YouTube (e.g., through AdSense). This is a component of overall estimated revenue metrics. |
metric |
youtube_revenue_split_reserved |
youtube_revenue_split_reserved |
The estimated net revenue from reserved-sold YouTube-served ads. |
metric |