HomeIntegrationsYouTube Analytics Reporting ToolYouTube Analytics Metrics and Dimensions

YouTube Analytics Metrics and Dimensions

Field group	Field	Type	Data type	Description
Channel statistics	Channel subscribers	METRIC	INTEGER	Subscribers count of the channel.
Channel statistics	Channel videos	METRIC	INTEGER	Video count of the channel.
Channel statistics	Channel views	METRIC	INTEGER	The number of times the channel has been viewed.
Audience retention insights	Audience watch rate	METRIC	RATIO	The absolute rate of viewers watching the video at the given point in the video.
Audience retention insights	Relative retention performance	METRIC	FLOAT	A measurement that shows how well a video retains viewers during playbacks in comparison to all YouTube videos of similar length.
Engagement	Comments	METRIC	INTEGER	The number of times that users commented on a video.
Engagement	Likes	METRIC	INTEGER	The number of times that users indicated that they liked a video by giving it a positive rating.
Engagement	Dislikes	METRIC	INTEGER	The number of times that users indicated that they disliked a video by giving it a negative rating.
Engagement	Shares	METRIC	INTEGER	The number of times that users shared a video through the Share button.
Engagement	Subscribers gained	METRIC	INTEGER	The number of times that users subscribed to a channel.
Engagement	Subscribers lost	METRIC	INTEGER	The number of times that users unsubscribed to a channel.
Annotations	Annotation impressions	METRIC	INTEGER	The total number of annotation impressions.
Annotations	Annotation clicks	METRIC	INTEGER	The number of clicked annotations.
Annotations	Annotation clickable impressions	METRIC	INTEGER	The number of annotations that appeared and could be clicked.
Annotations	Annotation closable impressions	METRIC	INTEGER	The number of annotations that appeared and could be closed.
Annotations	Annotation closes	METRIC	INTEGER	The number of closed annotations.
Annotations	Annotation close rate	METRIC	RATIO	The ratio of annotations that viewers closed to the total number of annotation impressions.
Views	Views	METRIC	INTEGER	The number of times that a video was viewed
Views	Estimated minutes watched	METRIC	MINUTES	The number of minutes that users watched videos for the specified channel, content owner, video, or playlist
Views	Average view rate	METRIC	RATIO	The average view rate of a video watched during a video playback
Views	Average view duration (seconds)	METRIC	SECONDS	The average length, in seconds, of video playbacks
Viewer Demographics Insights	Viewers rate (logged in)	METRIC	RATIO	The rate of viewers who were logged in when watching the video, by gender or age group
Time	Year	DIMENSION	YEAR	The four-digit year of the event e.g. 2020.
Time	Year month	DIMENSION	YEARMONTH	Year & month in the format 2023-Jan.
Time	Year month number	DIMENSION	YEAR_MONTH_NUMBER	Year & month in the format 2023-01.
Time	Month	DIMENSION	MONTHNAME	The month name of the event like January.
Time	Month number	DIMENSION	MONTH	The month of the event, a two digit integer from 01 to 12.
Time	Week number(sun-sat)	DIMENSION	WEEK_NUMBER	The week of the event, a two-digit number from 01 to 53. Each week starts on Sunday. January 1st is always in week 01. The first and last week of the year have fewer than 7 days in most years. Weeks other than the first and the last week of the year always have 7 days. For years where January 1st is a Sunday, the first week of that year and the last week of the prior year have 7 days.
Time	Week number(mon-sun)	DIMENSION	WEEK_ISO_NUMBER	The week of the event, a two-digit number from 01 to 53. Each week starts on Monday. January 1st is always in week 01. The first and last week of the year have fewer than 7 days in most years. Weeks other than the first and the last week of the year always have 7 days. For years where January 1st is a Sunday, the first week of that year and the last week of the prior year have 7 days.
Time	Week start date(sun - sat)	DIMENSION	WEEK_START_DATE	Start date of the week. Formatted as yyyy-MM-dd. Week starts on Sunday
Time	Week start date(mon - sun)	DIMENSION	WEEK_ISO_START_DATE	Start date of the ISO week. Formatted as yyyy-MM-dd. Week starts on Monday
Time	Date	DIMENSION	DATE	The date of the event, formatted as YYYYMMDD.
Channel	Channel title	DIMENSION	STRING	The name associated with the channel.
Channel	Channel ID	DIMENSION	STRING	The ID associated with a channel.
Channel	Channel description	DIMENSION	STRING	The channel's description.
Channel	Channel custom URL	DIMENSION	URL	The channel's custom URL.
Channel	Channel published date	DIMENSION	DATE	The date that the channel was created.
Channel	Channel published datetime	DIMENSION	DATETIME	The date and time that the channel was created.
Channel	Channel thumbnail URL	DIMENSION	IMAGE_URL	The default thumbnail image URL of the channel.
Channel	Channel country	DIMENSION	COUNTRY	The country with which the channel is associated.
Channel	Channel hidden subscribers	DIMENSION	BOOLEAN	Indicates whether the channel's subscriber count is publicly visible.
Video	Video title	DIMENSION	STRING	The name associated with the video.
Video	Video ID	DIMENSION	STRING	The ID associated with a video.
Video	Video published date	DIMENSION	DATE	The date that the video was published. Note that this time might be different than the time that the video was uploaded. For example, if a video is uploaded as a private video and then made public at a later time, this property will specify the time that the video was made public.
Video	Video published datetime	DIMENSION	DATETIME	The date and time that the video was published. Note that this time might be different than the time that the video was uploaded. For example, if a video is uploaded as a private video and then made public at a later time, this property will specify the time that the video was made public.
Video	Video description	DIMENSION	STRING	The video's description
Video	Video privacy status	DIMENSION	STRING	The video's privacy status (private, public, unlisted).
Video	Video thumbnail URL	DIMENSION	IMAGE_URL	The default thumbnail image URL of the video.
Video	Video upload status	DIMENSION	STRING	The status of the uploaded video
Video	Video failure reason	DIMENSION	STRING	This value explains why a video failed to upload. This property is only present if the uploadStatus property indicates that the upload failed.
Video	Video rejection reason	DIMENSION	STRING	This value explains why YouTube rejected an uploaded video. This property is only present if the uploadStatus property indicates that the upload was rejected.
Video	Video length	DIMENSION	DURATION	The length of the video. The property value is an ISO 8601 duration. For example, for a video that is at least one minute long and less than one hour long, the duration is in the format PT#M#S, in which the letters PT indicate that the value specifies a period of time, and the letters M and S refer to length in minutes and seconds, respectively. If the video is at least one hour long, the duration is in the format PT#H#M#S, in which the # preceding the letter H specifies the length of the video in hours and all of the other details are the same as described above. If the video is at least one day long, the letters P and T are separated, and the value's format is P#DT#H#M#S.
Video	Video embeddable	DIMENSION	BOOLEAN	This value indicates whether the video can be embedded on another website.
Video	Video public stats viewable	DIMENSION	BOOLEAN	This value indicates whether the extended video statistics on the video's watch page are publicly viewable. By default, those statistics are viewable, and statistics like a video's viewcount and ratings will still be publicly visible even if this property's value is set to false.
Video	Video made for kids	DIMENSION	BOOLEAN	This value indicates whether the video is designated as child-directed, and it contains the current 'made for kids' status of the video. For example, the status might be determined based on the value of the selfDeclaredMadeForKids property.
Video	Creator content type	DIMENSION	STRING	Identifies the type of YouTube content. Supported values are LIVE_STREAM, SHORTS, STORY, VIDEO_ON_DEMAND and UNSPECIFIED
Video	Live broadcast content	DIMENSION	STRING	Indicates if the video is an upcoming/active live broadcast. Or it's 'none' if the video is not an upcoming/active live broadcast.
Geographies	Country	DIMENSION	COUNTRY_CODE	The country associated with the metrics in the report row
Geographies	US province	DIMENSION	STRING	The U.S. state or territory associated with the metrics in the report row.
Device And Os	Device type	DIMENSION	STRING	This dimension identifies the physical form factor of the device on which the view occurred.
Device And Os	Operating system	DIMENSION	STRING	This dimension identifies the software system of the device on which the view occurred.
Demographics	Age group	DIMENSION	STRING	This dimension identifies the age group of the logged-in users associated with the report data
Demographics	Gender	DIMENSION	STRING	This dimension identifies the gender of the logged-in users associated with the report data
Audience retention	Elapsed video time rate	DIMENSION	RATIO	This dimension specifies the ratio of the elapsed portion of the video to the video's length.
Traffic source	Traffic source type	DIMENSION	STRING	This dimension describes the manner in which users reached the video.

Integrations

Category

YouTube Analytics Metrics and Dimensions