YouTube
Your channel's YouTube Analytics data: views, watch time, engagement, cards.
The YouTube connector brings into the sheet your channel's YouTube Analytics data: views, watch time, engagement, cards, end screens and more.
The metrics and dimensions exposed are a curated selection, not the entire YouTube Analytics catalog: revenue metrics are deliberately excluded (see Known limits), along with some dimensions that would require a mandatory filter the connector does not yet handle. Full official reference: metrics and dimensions.
Permessi richiesti
youtube.readonly: Needed to read channel information and resolve the video titles shown in reports.yt-analytics.readonly: Needed to read YouTube Analytics data (views, watch time, engagement, etc.). Does not include revenue metrics.
Metriche disponibili
| Metrica | Periodo | Aggregazione | Note |
|---|---|---|---|
| Views | |||
| Engaged Views | |||
| Watch Time (min) | |||
| Avg View Duration (sec) | Weighted average (not a direct sum of the row values). | ||
| Avg Percentage Viewed (%) | Weighted average (not a direct sum of the row values). | ||
| Premium Views | |||
| Premium Watch Time (min) | |||
| Likes | |||
| Dislikes | |||
| Comments | |||
| Shares | |||
| Subscribers Gained | |||
| Subscribers Lost | |||
| Videos Added to Playlists | |||
| Videos Removed from Playlists | |||
| Viewer Percentage (%) | Only available together with the Age Group or Gender dimension. | ||
| Playlist Starts | |||
| Views per Playlist Start | Weighted average (not a direct sum of the row values). | ||
| Avg Time in Playlist | Weighted average (not a direct sum of the row values). | ||
| Card Impressions | |||
| Card Clicks | |||
| Card Click Rate (%) | Weighted average (not a direct sum of the row values). | ||
| Card Teaser Impressions | |||
| Card Teaser Clicks | |||
| Card Teaser Click Rate (%) | Weighted average (not a direct sum of the row values). | ||
| End Screen Element Impressions | |||
| End Screen Element Clicks | |||
| End Screen Element Click Rate (%) | Weighted average (not a direct sum of the row values). | ||
| Avg Concurrent Viewers | |||
| Peak Concurrent Viewers |
Dimensioni disponibili
| Dimensione | Note |
|---|---|
| Day | |
| Month | |
| Country/Region | |
| Province/State (US) | |
| City | |
| Designated Market Area (US) | |
| Video ID | |
| Video Title | Not a native API dimension: the video ID is resolved into its title via an extra call to the YouTube Data API. If the video was deleted or is private, the ID is shown instead. For playlists, a resolved title is not yet available, only the ID. |
| Playlist ID | |
| Creator Content Type | |
| Live vs On-Demand | |
| YouTube Service | |
| Subscribed Status | |
| Traffic Source Type | |
| Playback Location Type | |
| Device Type | |
| Operating System | |
| Age Group | |
| Gender | |
| Sharing Service |
Limiti noti
- Revenue metrics are not availableThe connector does not request the yt-analytics-monetary.readonly scope, so metrics like estimated revenue, CPM or ad impressions are not included. Enabling them would require reconnecting every linked YouTube account and possibly a new Google app verification.
- Max 200 rows per reportThe YouTube Analytics API returns at most 200 rows per call. The connector downloads all of them and then applies offset/limit on our side: if the real results exceed 200 combinations, anything beyond that cap does not appear in the report.
- Time grouping only by Day or MonthUnlike other connectors, the API does not support native grouping by week, quarter or year: only Day and Month are valid time dimensions.