YouTube metrics and dimensions

44 metrics76 dimensions

Search fields

ANNOTATIONS

annotationImpressions

Field label	Annotation impressions
Description	The total number of annotation impressions
Field type	metric
Data type	int.number.value

annotationClickableImpressions

Field label	Annotation clickable impressions
Description	The number of annotations that appeared and could be clicked
Field type	metric
Data type	int.number.value

annotationClosableImpressions

Field label	Annotation closable impressions
Description	The number of annotations that appeared and could be closed
Field type	metric
Data type	int.number.value

annotationClicks

Field label	Annotation clicks
Description	The number of clicked annotations
Field type	metric
Data type	int.number.value

annotationCloses

Field label	Annotation closes
Description	The number of closed annotations
Field type	metric
Data type	int.number.value

annotationClickThroughRate

Field label	Annotation click through rate
Description	The ratio of annotations that viewers clicked to the total number of clickable annotation impressions
Field type	metric
Data type	float.number.ratio

annotationCloseRate

Field label	Annotation close rate
Description	The ratio of annotations that viewers closed to the total number of annotation impressions
Field type	metric
Data type	float.number.ratio

AUDIENCE RETENTION

elapsedVideoTimeRatio

Field label	Elapsed video time ratio
Description	This dimension specifies the ratio of the elapsed portion of the video to the video's length
Field type	dimension
Data type	float.number.ratio

audienceWatchRatio

Field label	Audience watch ratio
Description	The absolute ratio of viewers watching the video at the given point in the video. Requires the 'Single video performance' report: pass the video via the video_id setting (see data_source_discovery) and add the Elapsed video time ratio (elapsedVideoTimeRatio) dimension. Cannot be combined with other metrics. A video filter or the Video ID dimension does NOT satisfy the video_id requirement
Field type	metric
Data type	float.number.ratio

relativeRetentionPerformance

Field label	Relative retention performance
Description	A measurement that shows how well a video retains viewers during playbacks in comparison to all YouTube videos of similar length. Requires the 'Single video performance' report: pass the video via the video_id setting (see data_source_discovery) and add the Elapsed video time ratio (elapsedVideoTimeRatio) dimension. Cannot be combined with other metrics. A video filter or the Video ID dimension does NOT satisfy the video_id requirement
Field type	metric
Data type	float.number.ratio

CARDS

cardImpressions

Field label	Card impressions
Description	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
Field type	metric
Data type	int.number.value

cardClicks

Field label	Card clicks
Description	The number of times that cards were clicked
Field type	metric
Data type	int.number.value

cardClickRate

Field label	Card click rate
Description	The click-through-rate for cards, which is calculated as the ratio of card clicks to card impressions
Field type	metric
Data type	float.number.ratio

cardTeaserImpressions

Field label	Card teaser impressions
Description	The number of times that card teasers were displayed. A video view can generate multiple teaser impressions
Field type	metric
Data type	int.number.value

cardTeaserClicks

Field label	Card teaser clicks
Description	The number of clicks on card teasers. Card icon clicks are attributed to the last teaser displayed to the user
Field type	metric
Data type	int.number.value

cardTeaserClickRate

Field label	Card teaser click rate
Description	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
Field type	metric
Data type	float.number.ratio

CHANNEL

channel

Field label	Channel ID
Description	Id of a channel
Field type	dimension
Data type	string.text.value

channel_title

Field label	Channel name
Description	Name of the channel
Field type	dimension
Data type	string.text.value

channel_url

Field label	Channel URL
Description	Url of a channel
Field type	dimension
Data type	string.text.url

channel_description

Field label	Channel description
Description	The channel's description
Field type	dimension
Data type	string.text.value

channel_custom_url

Field label	Channel custom URL
Description	The channel's custom URL
Field type	dimension
Data type	string.text.url

channel_published_at

Field label	Channel created date
Description	The date and time that the channel was created
Field type	dimension
Data type	string.time.date

channel_thumbnail_url

Field label	Channel thumbnail URL
Description	The URL of channel thumbnail
Field type	dimension
Data type	string.text.url

channel_thumbnail

Field label	Channel thumbnail
Description	The default thumbnail for a channel
Field type	dimension
Data type	string.text.url
Destinations	Google Sheets

channel_country

Field label	Channel country
Description	The country with which the channel is associated. Values are normalized
Field type	dimension
Data type	string.geo.country

channel_hidden_subscribers

Field label	Channel hidden subscribers
Description	Indicates whether the channel's subscriber count is publicly visible
Field type	dimension
Data type	bool

channel_views

Field label	Channel total page views
Description	All-time channel page views (lifetime snapshot); cannot be split by a date dimension. Do not add Date/Year/Month. For views over time, use Views instead
Field type	metric
Data type	int.number.value
Aggregation	Non-aggregatable metric

channel_subscribers

Field label	Channel total subscribers
Description	All-time subscriber count (lifetime snapshot); cannot be split by a date dimension. Do not add Date/Year/Month. For a subscriber trend, use Subscribers gained and Subscribers lost instead. This value is rounded down to three significant figures
Field type	metric
Data type	int.number.value
Aggregation	Non-aggregatable metric

channel_videos

Field label	Channel total video count
Description	All-time public video count (lifetime snapshot); cannot be split by a date dimension. Do not add Date/Year/Month
Field type	metric
Data type	int.number.value
Aggregation	Non-aggregatable metric

DATASOURCE

dataSourceName

Field label	Data source
Description	The name of the source for this data, as listed on supermetrics.com/docs
Field type	dimension
Data type	string.text.value
Destinations	API, Data warehouse

system_metadata.data_source_logins

Field label	Data source logins
Description	The data source login accounts that were used to authenticate against the data source
Field type	dimension
Data type	string.text.json

system_metadata.data_source_login_owners

Field label	Data source login owners
Description	The Supermetrics users that created the data source login connections
Field type	dimension
Data type	string.text.json

DEMOGRAPHIC

ageGroup

Field label	Age group
Description	This dimension identifies the age group of the logged-in users associated with the report data. Values are normalized
Field type	dimension
Data type	string.person.age

gender

Field label	Gender
Description	This dimension identifies the gender of the logged-in users associated with the report data. Values are normalized
Field type	dimension
Data type	string.person.gender

DEVICE/OS

deviceType

Field label	Device type
Description	This dimension identifies the physical form factor of the device on which the view occurred. Values are normalized
Field type	dimension
Data type	string.text.value

operatingSystem

Field label	Operating system
Description	This dimension identifies the software system of the device on which the view occurred
Field type	dimension
Data type	string.text.value

youtubeProduct

Field label	Youtube product
Description	This dimension identifies the YouTube service on which the user activity occurred
Field type	dimension
Data type	string.text.value

ENGAGEMENT

views

Field label	Video views
Description	The number of times that a video was viewed. For Shorts, this counts when the video starts to play or replay
Field type	metric
Data type	int.number.value

engaged_views

Field label	Engaged views
Description	The number of times that the video was viewed for at least 4 seconds. This uses the same counting method that Video views used to
Field type	metric
Data type	int.number.value

comments

Field label	Comments
Description	The number of times that users commented on a video
Field type	metric
Data type	int.number.value

likes

Field label	Likes
Description	The number of times that users indicated that they liked a video by giving it a positive rating
Field type	metric
Data type	int.number.value

dislikes

Field label	Dislikes
Description	The number of times that users indicated that they disliked a video by giving it a negative rating
Field type	metric
Data type	int.number.value

Field label	Shares
Description	The number of times that users shared a video through the Share button
Field type	metric
Data type	int.number.value

subscribersGained

Field label	Gained subscribers
Description	The number of times that users subscribed to a channel
Field type	metric
Data type	int.number.value

subscribersLost

Field label	Lost subscribers
Description	The number of times that users unsubscribed from a channel
Field type	metric
Data type	int.number.value

videosAddedToPlaylists

Field label	Videos added to playlist
Description	The number of times that videos were added to any YouTube playlists
Field type	metric
Data type	int.number.value

videosRemovedFromPlaylists

Field label	Videos removed from playlist
Description	The number of times that videos were removed from any YouTube playlists
Field type	metric
Data type	int.number.value

estimatedMinutesWatched

Field label	Estimated minutes watched
Description	The number of minutes that users watched videos for the specified channel, content owner or video
Field type	metric
Data type	int.number.value

averageViewDuration_seconds

Field label	Average view duration (sec)
Description	The average length, in seconds, of video playbacks
Field type	metric
Data type	int.number.value

avgTimeViewed_minutes

Field label	Average view duration (min)
Description	The average length, in minutes, of video playbacks
Field type	metric
Data type	float.number.value

avgTimeViewed_hms

Field label	Average view duration (h:m:s)
Description	The average length, in h:m:s format, of video playbacks
Field type	metric
Data type	string.time.hms

averageViewPercentage

Field label	Average view duration percentage
Description	The average percentage of a video watched during a video playback
Field type	metric
Data type	float.number.ratio

viewerPercentage

Field label	Viewer percentage
Description	The percentage of viewers who were logged in when watching the video
Field type	metric
Data type	float.number.percentage

GEOGRAPHIES

country

Field label	Country
Description	The country associated with the metrics in the report row. Values are normalized
Field type	dimension
Data type	string.geo.country

province

Field label	US State
Description	The U.S. state or territory associated with the metrics in the report row. Using this field will restrict country to US. Values are normalized
Field type	dimension
Data type	string.geo.region

MONETIZATION

adType

Field label	Ad type
Description	The dimension is used in ad performance reports and aggregates the requested metrics based on the types of ads that ran during video playbacks
Field type	dimension
Data type	string.text.value

redViews

Field label	YouTube Premium views
Description	The number of times that a video was viewed by YouTube Premium (previously known as YouTube Red) members
Field type	metric
Data type	int.number.value

estimatedRedMinutesWatched

Field label	Estimated YouTube Premium minutes watched
Description	The number of minutes that YouTube Premium (previously known as YouTube Red) members watched a video
Field type	metric
Data type	int.number.value

estimatedRevenue

Field label	Estimated revenue
Description	The total estimated net revenue from all Google-sold advertising sources as well as from non-advertising sources for the selected date range and region. Requires monetization be enabled for the channel
Field type	metric
Data type	float.number.value

monetizedPlaybacks

Field label	Monetized Playbacks
Description	The number of instances when a viewer played your video and was shown at least one ad impression. A monetized playback is counted if a viewer is shown a preroll ad but quits watching the ad before your video ever starts. The expected estimated error for this figure is ±2.0%. Requires monetization be enabled for the channel
Field type	metric
Data type	int.number.value

playbackBasedCpm

Field label	Playback Based CPM
Description	The estimated gross revenue per thousand playbacks. Requires monetization be enabled for the channel
Field type	metric
Data type	float.number.value

grossRevenue

Field label	Gross revenue (USD)
Description	The estimated gross revenue, in USD, from all Google-sold or DoubleClick-partner-sold advertising for the selected date range
Field type	metric
Data type	float.number.value

grossRevenue_gbp

Field label	Gross revenue (GBP)
Description	The estimated gross revenue, in GBP, from all Google-sold or DoubleClick-partner-sold advertising for the selected date range
Field type	metric
Data type	float.currency.value
Services	Currency conversion

grossRevenue_eur

Field label	Gross revenue (EUR)
Description	The estimated gross revenue, in EUR, from all Google-sold or DoubleClick-partner-sold advertising for the selected date range
Field type	metric
Data type	float.currency.value
Services	Currency conversion

adImpressions

Field label	Ad impressions
Description	The number of verified ad impressions served
Field type	metric
Data type	float.currency.value

cpm

Field label	CPM
Description	The estimated gross revenue per thousand ad impressions
Field type	metric
Data type	float.currency.value

QUERY

system_metadata.query_date_range_start

Field label	Start date
Description	The start date of the requested query
Field type	dimension
Data type	string.time.date

system_metadata.query_date_range_end

Field label	End date
Description	The end date of the requested query
Field type	dimension
Data type	string.time.date

system_metadata.query_timezone

Field label	Timezone
Description	The timezone that is supplied to the query
Field type	dimension
Data type	string.time.timezone

system_metadata.query_filters

Field label	Filters
Description	All filters used in the query
Field type	dimension
Data type	string.text.json

system_metadata.query_date_start

Field label	Start
Description	When the query was started
Field type	dimension
Data type	string.time.datetime

system_metadata.query_date_end

Field label	End
Description	When the query completed
Field type	dimension
Data type	string.time.datetime

system_metadata.query_duration

Field label	Duration
Description	The duration in seconds of the query
Field type	dimension
Data type	int.duration.seconds

system_metadata.query_accounts

Field label	Accounts
Description	A list of accounts of which the data was pulled from
Field type	dimension
Data type	string.text.json

system_metadata.query_excluded_accounts

Field label	Excluded invalid accounts
Description	A list of unavailable accounts excluded from the query due to the "Exclude invalid accounts" setting
Field type	dimension
Data type	string.text.json

TIME

today

Field label	Today
Description	Today's date, e.g. 2017-01-31
Field type	dimension
Data type	string.time.date
Destinations	API, Data warehouse

year

Field label	Year
Description	Year, e.g. 2017
Field type	dimension
Data type	string.time.year

yearOfWeek

Field label	Year of week (Sun-Sat)
Description	Year of week for US-style Sunday-Saturday weeks, e.g. 2017
Field type	dimension
Data type	string.time.year

yearOfWeekIso

Field label	Year of week (Mon-Sun)
Description	Year of week for ISO standard Monday-Sunday weeks, e.g. 2017
Field type	dimension
Data type	string.time.year

yearMonth

Field label	Year & month
Description	Year and month, e.g. 2017\|06
Field type	dimension
Data type	string.time.yearmonth

month

Field label	Month
Description	Month, e.g. 09
Field type	dimension
Data type	string.time.month

yearWeek

Field label	Year & week (Sun-Sat)
Description	Year and week for US-style Sunday-Saturday weeks, e.g. 2017\|08
Field type	dimension
Data type	string.time.yearweek

yearWeekIso

Field label	Year & week (Mon-Sun)
Description	Year and week for ISO standard Monday-Sunday weeks, e.g. 2017\|08
Field type	dimension
Data type	string.time.yearweekiso

week

Field label	Week (Sun-Sat)
Description	US week number, e.g. 51
Field type	dimension
Data type	string.time.week

weekIso

Field label	Week (Mon-Sun)
Description	ISO week number, e.g. 51
Field type	dimension
Data type	string.time.weekiso

dayOfMonth

Field label	Day of month
Description	Day of month, e.g. 2
Field type	dimension
Data type	string.time.dayofmonth

dayOfWeekName

Field label	Day of week (Sun-Sat)
Description	Day of week number & name for US-style Sunday-Saturday weeks, e.g. 0 Sunday
Field type	dimension
Data type	string.time.dayofweek

dayOfWeekNameIso

Field label	Day of week (Mon-Sun)
Description	Day of week number & name for ISO standard Monday to Sunday weeks, e.g. 1 Sunday
Field type	dimension
Data type	string.time.dayofweekiso

date

Field label	Date
Description	Date, e.g. 2017-01-31
Field type	dimension
Data type	string.time.date

query_date_range_start

Field label	Query date range start
Description	First date of the requested query date range
Field type	dimension
Data type	string.time.date
Destinations	API, Data warehouse

year_channel_totals

Field label	Year
Description	Year, e.g. 2017
Field type	dimension
Data type	string.time.year

yearOfWeek_channel_totals

Field label	Year of week (Sun-Sat)
Description	Year of week for US-style Sunday-Saturday weeks, e.g. 2017
Field type	dimension
Data type	string.time.year

yearOfWeekIso_channel_totals

Field label	Year of week (Mon-Sun)
Description	Year of week for ISO standard Monday-Sunday weeks, e.g. 2017
Field type	dimension
Data type	string.time.year

yearMonth_channel_totals

Field label	Year & month
Description	Year and month, e.g. 2017\|06
Field type	dimension
Data type	string.time.yearmonth

month_channel_totals

Field label	Month
Description	Month, e.g. 09
Field type	dimension
Data type	string.time.month

yearWeek_channel_totals

Field label	Year & week (Sun-Sat)
Description	Year and week for US-style Sunday-Saturday weeks, e.g. 2017\|08
Field type	dimension
Data type	string.time.yearweek

yearWeekIso_channel_totals

Field label	Year & week (Mon-Sun)
Description	Year and week for ISO standard Monday-Sunday weeks, e.g. 2017\|08
Field type	dimension
Data type	string.time.yearweekiso

week_channel_totals

Field label	Week (Sun-Sat)
Description	US week number, e.g. 51
Field type	dimension
Data type	string.time.week

weekIso_channel_totals

Field label	Week (Mon-Sun)
Description	ISO week number, e.g. 51
Field type	dimension
Data type	string.time.weekiso

TRAFFIC SOURCE

insightTrafficSourceType

Field label	Traffic source type
Description	This dimension describes the manner in which users reached the video
Field type	dimension
Data type	string.text.value

VIDEO

video

Field label	Video ID
Description	Id of a channel`s video
Field type	dimension
Data type	string.text.value

video_privacy_status

Field label	Video visibility status
Description	The video's visibility status. Values may be private, public, unlisted
Field type	dimension
Data type	string.text.value

video_title

Field label	Video title
Description	Title of the video
Field type	dimension
Data type	string.text.value

video_url

Field label	Video URL
Description	Url of a video
Field type	dimension
Data type	string.text.url

video_thumbnail_url

Field label	Video thumbnail URL
Description	Thumbnail of the video URL
Field type	dimension
Data type	string.text.url

video_thumbnail

Field label	Video thumbnail
Description	The thumbnail for a video
Field type	dimension
Data type	string.text.url
Destinations	Google Sheets

video_upload_status

Field label	Video upload status
Description	The status of the uploaded video. Values may be: deleted, failed, processed, rejected, uploaded
Field type	dimension
Data type	string.text.url

video_failure_reason

Field label	Video failure reason
Description	This value explains why a video failed to upload. This property is only present if the Video upload status property indicates that the upload failed
Field type	dimension
Data type	string.text.url

video_rejection_reason

Field label	Video rejection reason
Description	This value explains why YouTube rejected an uploaded video. This property is only present if the Video upload status property indicates that the upload was rejected
Field type	dimension
Data type	string.text.url

video_length

Field label	Video length
Description	The length of the video
Field type	dimension
Data type	string.time.hms

video_embeddable

Field label	Video embeddability
Description	This value indicates whether the video can be embedded on another website
Field type	dimension
Data type	bool

video_public_stats_viewable

Field label	Video public stats viewable
Description	This value indicates whether the extended video statistics on the video's watch page are publicly viewable
Field type	dimension
Data type	bool

video_made_for_kids

Field label	Video made for kids
Description	This value indicates whether the video is designated as child-directed, and it contains the current "made for kids" status of the video
Field type	dimension
Data type	bool

creatorContentType

Field label	Creator content type
Description	Identifies the type of YouTube content. Supported values are liveStream, shorts, story, and videoOnDemand
Field type	dimension
Data type	string.text.value

video_published_at

Field label	Published time
Description	The published date and time of the video that the search result identifies
Field type	dimension
Data type	string.time.datetime
Destinations

video_published_date

Field label	Published date
Description	The published date of the video that the search result identifies
Field type	dimension
Data type	string.time.date

video_description

Field label	Video description
Description	Description of a video
Field type	dimension
Data type	string.text.value

video_tags

Field label	Video tags
Description	A list of keyword tags associated with the video
Field type	dimension
Data type	string.text.value

liveBroadcastContent

Field label	Live broadcast content
Description	An indication of whether a video resource has live broadcast content. Valid property values are upcoming, live, and none
Field type	dimension
Data type	string.text.value

liveOrOnDemand

Field label	Live or on-demand
Description	Indicates whether the user activity metrics in the data row are associated with views of a live broadcast or was replayed on-demand. Possible values are LIVE and ON_DEMAND
Field type	dimension
Data type	string.text.value