> ## Documentation Index
> Fetch the complete documentation index at: https://support.detrics.io/llms.txt
> Use this file to discover all available pages before exploring further.

# YouTube Analytics Metrics & Dimensions

> Complete reference for YouTube Analytics dimensions and metrics

<Info>
  **Last updated:** June 16, 2026
</Info>

<div style={{display: "flex", gap: "8px", marginBottom: "20px"}}>
  <div
    style={{
backgroundColor: "#f3f4f6",
color: "#374151",
padding: "4px 12px",
borderRadius: "16px",
fontSize: "14px",
fontWeight: "500"
}}
  >
    37 dimensions
  </div>

  <div
    style={{
backgroundColor: "#f3f4f6",
color: "#374151",
padding: "4px 12px",
borderRadius: "16px",
fontSize: "14px",
fontWeight: "500"
}}
  >
    41 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for YouTube Analytics data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div style={{display: "flex", gap: "8px", marginBottom: "20px", alignItems: "center"}}>
  <span style={{fontSize: "14px", fontWeight: "500", color: "#6B7280"}}>Supported destinations:</span>

  <div
    style={{
backgroundColor: "#f3f4f6",
color: "#374151",
padding: "4px 12px",
borderRadius: "16px",
fontSize: "14px",
fontWeight: "500"
}}
  >
    Google Sheets
  </div>

  <div
    style={{
backgroundColor: "#f3f4f6",
color: "#374151",
padding: "4px 12px",
borderRadius: "16px",
fontSize: "14px",
fontWeight: "500"
}}
  >
    Claude
  </div>

  <div
    style={{
backgroundColor: "#f3f4f6",
color: "#374151",
padding: "4px 12px",
borderRadius: "16px",
fontSize: "14px",
fontWeight: "500"
}}
  >
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your YouTube Analytics data.

### Channel

|                                                                                              |                                                                                                                                 |
| -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Channel ID</div>                 | The unique ID of the YouTube channel<br /><br />**Field Name:** `channelId`<br />**Type:** dimension                            |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Channel Name</div>               | The name of the YouTube channel<br /><br />**Field Name:** `channelTitle`<br />**Type:** dimension                              |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Channel URL</div>                | The URL of the YouTube channel<br /><br />**Field Name:** `channelUrl`<br />**Type:** dimension                                 |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Channel Description</div>        | The description of the YouTube channel<br /><br />**Field Name:** `channelDescription`<br />**Type:** dimension                 |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Channel Custom URL</div>         | The custom URL of the YouTube channel<br /><br />**Field Name:** `channelCustomUrl`<br />**Type:** dimension                    |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Channel Created Date</div>       | The date the channel was created<br /><br />**Field Name:** `channelPublishedAt`<br />**Type:** dimension                       |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Channel Thumbnail URL</div>      | The URL of the channel thumbnail<br /><br />**Field Name:** `channelThumbnailUrl`<br />**Type:** dimension                      |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Channel Country</div>            | The country associated with the channel<br /><br />**Field Name:** `channelCountry`<br />**Type:** dimension                    |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Channel Hidden Subscribers</div> | Whether the subscriber count is publicly visible<br /><br />**Field Name:** `channelHiddenSubscribers`<br />**Type:** dimension |

### Video

|                                                                                               |                                                                                                                                                |
| --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video ID</div>                    | The unique ID of the video<br /><br />**Field Name:** `videoId`<br />**Type:** dimension                                                       |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Title</div>                 | The title of the video<br /><br />**Field Name:** `videoTitle`<br />**Type:** dimension                                                        |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video URL</div>                   | The URL of the video<br /><br />**Field Name:** `videoUrl`<br />**Type:** dimension                                                            |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Thumbnail URL</div>         | The URL of the video thumbnail<br /><br />**Field Name:** `videoThumbnailUrl`<br />**Type:** dimension                                         |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Visibility Status</div>     | The visibility status of the video (public, private, unlisted)<br /><br />**Field Name:** `videoPrivacyStatus`<br />**Type:** dimension        |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Upload Status</div>         | The upload status of the video<br /><br />**Field Name:** `videoUploadStatus`<br />**Type:** dimension                                         |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Failure Reason</div>        | The reason a video failed to upload<br /><br />**Field Name:** `videoFailureReason`<br />**Type:** dimension                                   |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Rejection Reason</div>      | The reason a video was rejected<br /><br />**Field Name:** `videoRejectionReason`<br />**Type:** dimension                                     |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Length</div>                | The duration of the video<br /><br />**Field Name:** `videoLength`<br />**Type:** dimension                                                    |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Embeddability</div>         | Whether the video can be embedded on other sites<br /><br />**Field Name:** `videoEmbeddable`<br />**Type:** dimension                         |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Public Stats Viewable</div> | Whether extended video statistics are publicly viewable<br /><br />**Field Name:** `videoPublicStatsViewable`<br />**Type:** dimension         |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Made For Kids</div>         | Whether the video is designated as child-directed<br /><br />**Field Name:** `videoMadeForKids`<br />**Type:** dimension                       |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Published Date</div>              | The date the video was published<br /><br />**Field Name:** `videoPublishedDate`<br />**Type:** dimension                                      |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Description</div>           | The description of the video<br /><br />**Field Name:** `videoDescription`<br />**Type:** dimension                                            |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Tags</div>                  | Keyword tags associated with the video<br /><br />**Field Name:** `videoTags`<br />**Type:** dimension                                         |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Live Broadcast Content</div>      | Whether the video has live broadcast content (upcoming, live, none)<br /><br />**Field Name:** `liveBroadcastContent`<br />**Type:** dimension |

### Breakdown

|                                                                                        |                                                                                                                                    |
| -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Creator Content Type</div> | The type of content: shorts, videoOnDemand, or liveStream<br /><br />**Field Name:** `creatorContentType`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Live Or On-Demand</div>    | Whether views are from live broadcast or on-demand playback<br /><br />**Field Name:** `liveOrOnDemand`<br />**Type:** dimension   |

### Demographics

|                                                                             |                                                                                                   |
| --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Age Group</div> | The age group of logged-in viewers<br /><br />**Field Name:** `ageGroup`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Gender</div>    | The gender of logged-in viewers<br /><br />**Field Name:** `gender`<br />**Type:** dimension      |

### Device

|                                                                                    |                                                                                                                                      |
| ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Device Type</div>      | The device type (mobile, desktop, tablet, TV)<br /><br />**Field Name:** `deviceType`<br />**Type:** dimension                       |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Operating System</div> | The operating system of the viewer device<br /><br />**Field Name:** `operatingSystem`<br />**Type:** dimension                      |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>YouTube Product</div>  | The YouTube service where activity occurred (Core, Music, etc.)<br /><br />**Field Name:** `youtubeProduct`<br />**Type:** dimension |

### Traffic

|                                                                                       |                                                                                                                                                  |
| ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Traffic Source Type</div> | How viewers reached the video (search, suggested, external, etc.)<br /><br />**Field Name:** `insightTrafficSourceType`<br />**Type:** dimension |

### Geography

|                                                                            |                                                                                                                   |
| -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Country</div>  | The country associated with the report metrics<br /><br />**Field Name:** `country`<br />**Type:** dimension      |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>US State</div> | The US state (only available when filtering by US)<br /><br />**Field Name:** `province`<br />**Type:** dimension |

### Monetization

|                                                                           |                                                                                                            |
| ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Type</div> | The type of ad that ran during video playback<br /><br />**Field Name:** `adType`<br />**Type:** dimension |

### Audience Retention

|                                                                                            |                                                                                                                                   |
| ------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Elapsed Video Time Ratio</div> | The ratio of elapsed video time to total video length<br /><br />**Field Name:** `elapsedVideoTimeRatio`<br />**Type:** dimension |

## Metrics

Metrics are the numerical values you can measure and analyze from your YouTube Analytics campaigns.

### Engagement

|                                                                                                    |                                                                                                                              |
| -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Views</div>                      | The number of times videos were viewed<br /><br />**Field Name:** `views`<br />**Type:** metric                              |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Engaged Views</div>                    | Views of at least 4 seconds<br /><br />**Field Name:** `engagedViews`<br />**Type:** metric                                  |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Estimated Minutes Watched</div>        | Total minutes users watched videos<br /><br />**Field Name:** `estimatedMinutesWatched`<br />**Type:** metric                |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Average View Duration (Sec)</div>      | Average video playback length in seconds<br /><br />**Field Name:** `averageViewDurationSeconds`<br />**Type:** metric       |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Average View Duration (Min)</div>      | Average video playback length in minutes<br /><br />**Field Name:** `averageViewDurationMinutes`<br />**Type:** metric       |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Average View Duration Percentage</div> | Average percentage of video watched<br /><br />**Field Name:** `averageViewPercentage`<br />**Type:** metric                 |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Likes</div>                            | Number of likes on videos<br /><br />**Field Name:** `likes`<br />**Type:** metric                                           |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Dislikes</div>                         | Number of dislikes on videos<br /><br />**Field Name:** `dislikes`<br />**Type:** metric                                     |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Comments</div>                         | Number of comments on videos<br /><br />**Field Name:** `comments`<br />**Type:** metric                                     |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Shares</div>                           | Number of times videos were shared<br /><br />**Field Name:** `shares`<br />**Type:** metric                                 |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Gained Subscribers</div>               | Number of new subscribers gained<br /><br />**Field Name:** `subscribersGained`<br />**Type:** metric                        |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Lost Subscribers</div>                 | Number of subscribers lost<br /><br />**Field Name:** `subscribersLost`<br />**Type:** metric                                |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Videos Added To Playlist</div>         | Times videos were added to playlists<br /><br />**Field Name:** `videosAddedToPlaylists`<br />**Type:** metric               |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Videos Removed From Playlist</div>     | Times videos were removed from playlists<br /><br />**Field Name:** `videosRemovedFromPlaylists`<br />**Type:** metric       |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Viewer Percentage</div>                | Percentage of logged-in viewers (only with demographics)<br /><br />**Field Name:** `viewerPercentage`<br />**Type:** metric |

### Channel Totals

|                                                                                             |                                                                                                                 |
| ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Channel Total Page Views</div>  | Total channel views (all time)<br /><br />**Field Name:** `channelTotalViews`<br />**Type:** metric             |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Channel Total Subscribers</div> | Total channel subscribers (all time)<br /><br />**Field Name:** `channelTotalSubscribers`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Channel Total Video Count</div> | Total public videos on the channel<br /><br />**Field Name:** `channelTotalVideos`<br />**Type:** metric        |

### Cards

|                                                                                           |                                                                                                                  |
| ----------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Card Impressions</div>        | Number of times cards were displayed<br /><br />**Field Name:** `cardImpressions`<br />**Type:** metric          |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Card Clicks</div>             | Number of times cards were clicked<br /><br />**Field Name:** `cardClicks`<br />**Type:** metric                 |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Card Click Rate</div>         | Click-through rate for cards<br /><br />**Field Name:** `cardClickRate`<br />**Type:** metric                    |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Card Teaser Impressions</div> | Number of times card teasers were shown<br /><br />**Field Name:** `cardTeaserImpressions`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Card Teaser Clicks</div>      | Number of clicks on card teasers<br /><br />**Field Name:** `cardTeaserClicks`<br />**Type:** metric             |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Card Teaser Click Rate</div>  | Click-through rate for card teasers<br /><br />**Field Name:** `cardTeaserClickRate`<br />**Type:** metric       |

### Annotations

|                                                                                                    |                                                                                                                    |
| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Annotation Impressions</div>           | Total annotation impressions<br /><br />**Field Name:** `annotationImpressions`<br />**Type:** metric              |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Annotation Clickable Impressions</div> | Clickable annotation impressions<br /><br />**Field Name:** `annotationClickableImpressions`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Annotation Closable Impressions</div>  | Closable annotation impressions<br /><br />**Field Name:** `annotationClosableImpressions`<br />**Type:** metric   |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Annotation Clicks</div>                | Number of annotation clicks<br /><br />**Field Name:** `annotationClicks`<br />**Type:** metric                    |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Annotation Closes</div>                | Number of annotation closes<br /><br />**Field Name:** `annotationCloses`<br />**Type:** metric                    |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Annotation Click Through Rate</div>    | Annotation click-through rate<br /><br />**Field Name:** `annotationClickThroughRate`<br />**Type:** metric        |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Annotation Close Rate</div>            | Annotation close rate<br /><br />**Field Name:** `annotationCloseRate`<br />**Type:** metric                       |

### Monetization

|                                                                                                             |                                                                                                                                        |
| ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Estimated Revenue</div>                         | Estimated net revenue from advertising and non-advertising sources<br /><br />**Field Name:** `estimatedRevenue`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Gross Revenue (USD)</div>                       | Estimated gross revenue from Google-sold advertising<br /><br />**Field Name:** `grossRevenue`<br />**Type:** metric                   |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Impressions</div>                            | Number of verified ad impressions served<br /><br />**Field Name:** `adImpressions`<br />**Type:** metric                              |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>CPM</div>                                       | Estimated gross revenue per thousand ad impressions<br /><br />**Field Name:** `cpm`<br />**Type:** metric                             |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Monetized Playbacks</div>                       | Playbacks where at least one ad impression was shown<br /><br />**Field Name:** `monetizedPlaybacks`<br />**Type:** metric             |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Playback Based CPM</div>                        | Estimated gross revenue per thousand playbacks<br /><br />**Field Name:** `playbackBasedCpm`<br />**Type:** metric                     |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Estimated YouTube Premium Minutes Watched</div> | Minutes watched by YouTube Premium members<br /><br />**Field Name:** `estimatedRedMinutesWatched`<br />**Type:** metric               |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>YouTube Premium Views</div>                     | Views by YouTube Premium members<br /><br />**Field Name:** `redViews`<br />**Type:** metric                                           |

### Audience Retention

|                                                                                                  |                                                                                                                             |
| ------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Audience Watch Ratio</div>           | Absolute ratio of viewers watching at given point<br /><br />**Field Name:** `audienceWatchRatio`<br />**Type:** metric     |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Relative Retention Performance</div> | Retention compared to similar length videos<br /><br />**Field Name:** `relativeRetentionPerformance`<br />**Type:** metric |

***

## Related

<CardGroup cols={2}>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog/index">
    Browse all platforms
  </Card>

  <Card title="Google Analytics 4 Fields" icon="chart-bar" href="/data-source/google-analytics-4/fields">
    Google Analytics 4 metrics & dimensions
  </Card>

  <Card title="Google Ads Fields" icon="chart-bar" href="/data-source/google-ads/fields">
    Google Ads metrics & dimensions
  </Card>

  <Card title="TikTok Organic Fields" icon="chart-bar" href="/data-source/tiktok-organic/fields">
    TikTok Organic metrics & dimensions
  </Card>
</CardGroup>
