Dimensions | YouTube Analytics and Reporting APIs

<!doctype html> <html lang="en" dir="ltr"> <head> <meta name="google-signin-client-id" content="721724668570-nbkv1cfusk7kk4eni4pjvepaus73b13t.apps.googleusercontent.com"> <meta name="google-signin-scope" content="profile email https://www.googleapis.com/auth/developerprofiles https://www.googleapis.com/auth/developerprofiles.award"> <meta property="og:site_name" content="Google for Developers"> <meta property="og:type" content="website"><meta name="theme-color" content="#ff0000"><meta charset="utf-8"> <meta content="IE=Edge" http-equiv="X-UA-Compatible"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="manifest" href="/_pwa/developers/manifest.json" crossorigin="use-credentials"> <link rel="preconnect" href="//www.gstatic.com" crossorigin> <link rel="preconnect" href="//fonts.gstatic.com" crossorigin> <link rel="preconnect" href="//fonts.googleapis.com" crossorigin> <link rel="preconnect" href="//apis.google.com" crossorigin> <link rel="preconnect" href="//www.google-analytics.com" crossorigin><link rel="stylesheet" href="//fonts.googleapis.com/css?family=Google+Sans:400,500|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700&display=swap"> <link rel="stylesheet" href="//fonts.googleapis.com/css2?family=Material+Icons&family=Material+Symbols+Outlined&display=block"><link rel="stylesheet" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/css/app.css"> <link rel="shortcut icon" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/favicon-new.png"> <link rel="apple-touch-icon" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/touchicon-180-new.png"><link rel="canonical" href="https://developers.google.com/youtube/analytics/dimensions"><link rel="search" type="application/opensearchdescription+xml" title="Google for Developers" href="https://developers.google.com/s/opensearch.xml"> <link rel="alternate" hreflang="en" href="https://developers.google.com/youtube/analytics/dimensions" /><link rel="alternate" hreflang="x-default" href="https://developers.google.com/youtube/analytics/dimensions" /><link rel="alternate" hreflang="ar" href="https://developers.google.com/youtube/analytics/dimensions?hl=ar" /><link rel="alternate" hreflang="bn" href="https://developers.google.com/youtube/analytics/dimensions?hl=bn" /><link rel="alternate" hreflang="zh-Hans" href="https://developers.google.com/youtube/analytics/dimensions?hl=zh-cn" /><link rel="alternate" hreflang="zh-Hant" href="https://developers.google.com/youtube/analytics/dimensions?hl=zh-tw" /><link rel="alternate" hreflang="fa" href="https://developers.google.com/youtube/analytics/dimensions?hl=fa" /><link rel="alternate" hreflang="fr" href="https://developers.google.com/youtube/analytics/dimensions?hl=fr" /><link rel="alternate" hreflang="de" href="https://developers.google.com/youtube/analytics/dimensions?hl=de" /><link rel="alternate" hreflang="he" href="https://developers.google.com/youtube/analytics/dimensions?hl=he" /><link rel="alternate" hreflang="hi" href="https://developers.google.com/youtube/analytics/dimensions?hl=hi" /><link rel="alternate" hreflang="id" href="https://developers.google.com/youtube/analytics/dimensions?hl=id" /><link rel="alternate" hreflang="it" href="https://developers.google.com/youtube/analytics/dimensions?hl=it" /><link rel="alternate" hreflang="ja" href="https://developers.google.com/youtube/analytics/dimensions?hl=ja" /><link rel="alternate" hreflang="ko" href="https://developers.google.com/youtube/analytics/dimensions?hl=ko" /><link rel="alternate" hreflang="pl" href="https://developers.google.com/youtube/analytics/dimensions?hl=pl" /><link rel="alternate" hreflang="pt-BR" href="https://developers.google.com/youtube/analytics/dimensions?hl=pt-br" /><link rel="alternate" hreflang="ru" href="https://developers.google.com/youtube/analytics/dimensions?hl=ru" /><link rel="alternate" hreflang="es-419" href="https://developers.google.com/youtube/analytics/dimensions?hl=es-419" /><link rel="alternate" hreflang="th" href="https://developers.google.com/youtube/analytics/dimensions?hl=th" /><link rel="alternate" hreflang="tr" href="https://developers.google.com/youtube/analytics/dimensions?hl=tr" /><link rel="alternate" hreflang="vi" href="https://developers.google.com/youtube/analytics/dimensions?hl=vi" /><title>Dimensions  |  YouTube Analytics and Reporting APIs  |  Google for Developers</title> <meta property="og:title" content="Dimensions  |  YouTube Analytics and Reporting APIs  |  Google for Developers"><meta name="description" content="Learn about the dimensions – common criteria used to aggregate data – used to calculate metric values in the reports."> <meta property="og:description" content="Learn about the dimensions – common criteria used to aggregate data – used to calculate metric values in the reports."><meta property="og:url" content="https://developers.google.com/youtube/analytics/dimensions"><meta property="og:image" content="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/opengraph/youtube-theme.png"> <meta property="og:image:width" content="1200"> <meta property="og:image:height" content="675"><meta property="og:locale" content="en"><meta name="twitter:card" content="summary_large_image"><script type="application/ld+json"> { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [{ "@type": "ListItem", "position": 1, "name": "YouTube", "item": "https://developers.google.com/youtube" },{ "@type": "ListItem", "position": 2, "name": "Analytics and Reporting APIs", "item": "https://developers.google.com/youtube/analytics" },{ "@type": "ListItem", "position": 3, "name": "Dimensions", "item": "https://developers.google.com/youtube/analytics/dimensions" }] } </script> <link rel="stylesheet" href="/extras.css"></head> <body class="docs" template="page" theme="youtube-theme" type="reference" layout="docs" concierge='closed' display-toc pending> <devsite-progress type="indeterminate" id="app-progress"></devsite-progress> <section class="devsite-wrapper"> <devsite-cookie-notification-bar></devsite-cookie-notification-bar><devsite-header role="banner"> <div class="devsite-header--inner nocontent"> <div class="devsite-top-logo-row-wrapper-wrapper"> <div class="devsite-top-logo-row-wrapper"> <div class="devsite-top-logo-row"> <button type="button" id="devsite-hamburger-menu" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Navigation menu button" visually-hidden aria-label="Open menu"> </button> <div class="devsite-product-name-wrapper"> <a href="https://developers.google.com/youtube"> <div class="devsite-product-logo-container" size="medium" > <picture> <img class="devsite-product-logo" alt="YouTube" src="https://developers.google.com/static/site-assets/logo-youtube.svg" srcset=" /static/site-assets/logo-youtube.svg" sizes="64px" loading="lazy" > </picture> </div> </a> <span class="devsite-product-name"> <ul class="devsite-breadcrumb-list" aria-label="Product breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://developers.google.com/youtube" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="YouTube" > YouTube </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/youtube/analytics" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail="YouTube Analytics and Reporting APIs" > Analytics and Reporting APIs </a> </li> </ul> </span> </div> <div class="devsite-top-logo-row-middle"> <div class="devsite-header-upper-tabs"> </div> <devsite-search enable-signin enable-search enable-suggestions enable-query-completion project-name="YouTube Analytics and Reporting APIs" tenant-name="Google for Developers" project-scope="/youtube/analytics" url-scoped="https://developers.google.com/s/results/youtube/analytics" > <form class="devsite-search-form" action="https://developers.google.com/s/results" method="GET"> <div class="devsite-search-container"> <button type="button" search-open class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Open search"></button> <div class="devsite-searchbox"> <input aria-activedescendant="" aria-autocomplete="list" aria-label="Search" aria-expanded="false" aria-haspopup="listbox" autocomplete="off" class="devsite-search-field devsite-search-query" name="q" placeholder="Search" role="combobox" type="text" value="" > <div class="devsite-search-image material-icons" aria-hidden="true"> </div> <div class="devsite-search-shortcut-icon-container" aria-hidden="true"> <kbd class="devsite-search-shortcut-icon">/</kbd> </div> </div> </div> </form> <button type="button" search-close class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Close search"></button> </devsite-search> </div> <devsite-language-selector> <ul role="presentation"> <li role="presentation"> <a role="menuitem" lang="en" >English</a> </li> <li role="presentation"> <a role="menuitem" lang="de" >Deutsch</a> </li> <li role="presentation"> <a role="menuitem" lang="es" >Español</a> </li> <li role="presentation"> <a role="menuitem" lang="es_419" >Español – América Latina</a> </li> <li role="presentation"> <a role="menuitem" lang="fr" >Français</a> </li> <li role="presentation"> <a role="menuitem" lang="id" >Indonesia</a> </li> <li role="presentation"> <a role="menuitem" lang="it" >Italiano</a> </li> <li role="presentation"> <a role="menuitem" lang="pl" >Polski</a> </li> <li role="presentation"> <a role="menuitem" lang="pt_br" >Português – Brasil</a> </li> <li role="presentation"> <a role="menuitem" lang="vi" >Tiếng Việt</a> </li> <li role="presentation"> <a role="menuitem" lang="tr" >Türkçe</a> </li> <li role="presentation"> <a role="menuitem" lang="ru" >Русский</a> </li> <li role="presentation"> <a role="menuitem" lang="he" >עברית</a> </li> <li role="presentation"> <a role="menuitem" lang="ar" >العربيّة</a> </li> <li role="presentation"> <a role="menuitem" lang="fa" >فارسی</a> </li> <li role="presentation"> <a role="menuitem" lang="hi" >हिंदी</a> </li> <li role="presentation"> <a role="menuitem" lang="bn" >বাংলা</a> </li> <li role="presentation"> <a role="menuitem" lang="th" >ภาษาไทย</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_cn" >中文 – 简体</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_tw" >中文 – 繁體</a> </li> <li role="presentation"> <a role="menuitem" lang="ja" >日本語</a> </li> <li role="presentation"> <a role="menuitem" lang="ko" >한국어</a> </li> </ul> </devsite-language-selector> <devsite-user enable-profiles fp-auth id="devsite-user"> <span class="button devsite-top-button" aria-hidden="true" visually-hidden>Sign in</span> </devsite-user> </div> </div> </div> <div class="devsite-collapsible-section "> <div class="devsite-header-background"> <div class="devsite-doc-set-nav-row"> <devsite-tabs class="lower-tabs"> <nav class="devsite-tabs-wrapper" aria-label="Lower tabs"> <tab > <a href="https://developers.google.com/youtube/analytics" track-metadata-eventdetail="https://developers.google.com/youtube/analytics" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - home" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Home" track-name="home" > Home </a> </tab> <tab > <a href="https://developers.google.com/youtube/reporting" track-metadata-eventdetail="https://developers.google.com/youtube/reporting" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - overview" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Overview" track-name="overview" > Overview </a> </tab> <tab > <a href="https://developers.google.com/youtube/reporting/guides/authorization" track-metadata-eventdetail="https://developers.google.com/youtube/reporting/guides/authorization" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - authorization" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Authorization" track-name="authorization" > Authorization </a> </tab> <tab > <a href="https://developers.google.com/youtube/reporting/v1/reports" track-metadata-eventdetail="https://developers.google.com/youtube/reporting/v1/reports" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - bulk reports" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Bulk Reports" track-name="bulk reports" > Bulk Reports </a> </tab> <tab class="devsite-active"> <a href="https://developers.google.com/youtube/analytics/data_model" track-metadata-eventdetail="https://developers.google.com/youtube/analytics/data_model" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - targeted queries" track-metadata-module="primary nav" aria-label="Targeted Queries, selected" data-category="Site-Wide Custom Events" data-label="Tab: Targeted Queries" track-name="targeted queries" > Targeted Queries </a> </tab> <tab > <a href="https://developers.google.com/youtube/reporting/v1/code_samples" track-metadata-eventdetail="https://developers.google.com/youtube/reporting/v1/code_samples" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - resources" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Resources" track-name="resources" > Resources </a> </tab> </nav> </devsite-tabs> </div> </div> </div> </div> </devsite-header> <devsite-book-nav scrollbars > <div class="devsite-book-nav-filter" > <span class="filter-list-icon material-icons" aria-hidden="true"></span> <input type="text" placeholder="Filter" aria-label="Type to filter" role="searchbox"> <span class="filter-clear-button hidden" data-title="Clear filter" aria-label="Clear filter" role="button" tabindex="0"></span> </div> <nav class="devsite-book-nav devsite-nav nocontent" aria-label="Side menu"> <div class="devsite-mobile-header"> <button type="button" id="devsite-close-nav" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Close navigation" aria-label="Close navigation"> </button> <div class="devsite-product-name-wrapper"> <a href="https://developers.google.com/youtube"> <div class="devsite-product-logo-container" size="medium" > <picture> <img class="devsite-product-logo" alt="YouTube" src="https://developers.google.com/static/site-assets/logo-youtube.svg" srcset=" /static/site-assets/logo-youtube.svg" sizes="64px" loading="lazy" > </picture> </div> </a> <span class="devsite-product-name"> <ul class="devsite-breadcrumb-list" aria-label="Upper header breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://developers.google.com/youtube" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="YouTube" > YouTube </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/youtube/analytics" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail="YouTube Analytics and Reporting APIs" > Analytics and Reporting APIs </a> </li> </ul> </span> </div> </div> <div class="devsite-book-nav-wrapper"> <div class="devsite-mobile-nav-top"> <ul class="devsite-nav-list"> <li class="devsite-nav-item"> <a href="/youtube/analytics" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Tab: Home" track-name="home" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Home" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Home </span> </a> </li> <li class="devsite-nav-item"> <a href="/youtube/reporting" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Tab: Overview" track-name="overview" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Overview" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Overview </span> </a> </li> <li class="devsite-nav-item"> <a href="/youtube/reporting/guides/authorization" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Authorization" track-name="authorization" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Authorization" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Authorization </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> <li class="devsite-nav-item"> <a href="/youtube/reporting/v1/reports" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Bulk Reports" track-name="bulk reports" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Bulk Reports" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Bulk Reports </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> <li class="devsite-nav-item"> <a href="/youtube/analytics/data_model" class="devsite-nav-title gc-analytics-event devsite-nav-has-children devsite-nav-active" data-category="Site-Wide Custom Events" data-label="Tab: Targeted Queries" track-name="targeted queries" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Targeted Queries" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Targeted Queries </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> <li class="devsite-nav-item"> <a href="/youtube/reporting/v1/code_samples" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Resources" track-name="resources" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Resources" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Resources </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> </ul> </div> <div class="devsite-mobile-nav-bottom"> <ul class="devsite-nav-list" menu="_book"> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>YouTube Analytics API</span> </div></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>Data Model</span> </div></li> <li class="devsite-nav-item"><a href="/youtube/analytics/data_model" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/data_model" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/data_model" ><span class="devsite-nav-text" tooltip>Overview</span></a></li> <li class="devsite-nav-item"><a href="/youtube/analytics/dimensions" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/dimensions" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/dimensions" ><span class="devsite-nav-text" tooltip>Dimensions</span></a></li> <li class="devsite-nav-item"><a href="/youtube/analytics/metrics" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/metrics" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/metrics" ><span class="devsite-nav-text" tooltip>Metrics</span></a></li> <li class="devsite-nav-item"><a href="/youtube/analytics/channel_reports" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/channel_reports" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/channel_reports" ><span class="devsite-nav-text" tooltip>Channel Reports</span></a></li> <li class="devsite-nav-item"><a href="/youtube/analytics/content_owner_reports" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/content_owner_reports" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/content_owner_reports" ><span class="devsite-nav-text" tooltip>Content Owner Reports</span></a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>Guides</span> </div></li> <li class="devsite-nav-item"><a href="/youtube/analytics/sample-requests" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/sample-requests" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/sample-requests" ><span class="devsite-nav-text" tooltip>Sample requests</span></a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>API Reference</span> </div></li> <li class="devsite-nav-item"><a href="/youtube/analytics/reference" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference" ><span class="devsite-nav-text" tooltip>Overview</span></a></li> <li class="devsite-nav-item"><a href="/youtube/analytics/reference/reports/query" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/reports/query" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/reports/query" ><span class="devsite-nav-text" tooltip>reports.query</span></a></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> <span class="devsite-nav-text" tooltip>Groups</span> </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groups" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groups" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groups" ><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groups/list" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groups/list" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groups/list" ><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groups/insert" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groups/insert" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groups/insert" ><span class="devsite-nav-text" tooltip>insert</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groups/update" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groups/update" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groups/update" ><span class="devsite-nav-text" tooltip>update</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groups/delete" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groups/delete" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groups/delete" ><span class="devsite-nav-text" tooltip>delete</span></a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> <span class="devsite-nav-text" tooltip>GroupItems</span> </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groupItems" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groupItems" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groupItems" ><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groupItems/list" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groupItems/list" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groupItems/list" ><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groupItems/insert" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groupItems/insert" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groupItems/insert" ><span class="devsite-nav-text" tooltip>insert</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groupItems/delete" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groupItems/delete" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groupItems/delete" ><span class="devsite-nav-text" tooltip>delete</span></a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-break"></li> <li class="devsite-nav-item"><a href="/youtube/analytics/revision_history" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/revision_history" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/revision_history" ><span class="devsite-nav-text" tooltip>Revision History</span></a></li> </ul> </div> </div> </nav> </devsite-book-nav> <section id="gc-wrapper"> <main role="main" class="devsite-main-content" has-book-nav > <devsite-content> <article class="devsite-article"> <div class="devsite-article-meta nocontent" role="navigation"> <ul class="devsite-breadcrumb-list" aria-label="Breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://developers.google.com/" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="" > Home </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/products" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail="" > Products </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/youtube" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="3" track-type="globalNav" track-name="breadcrumb" track-metadata-position="3" track-metadata-eventdetail="YouTube" > YouTube </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/youtube/analytics" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="4" track-type="globalNav" track-name="breadcrumb" track-metadata-position="4" track-metadata-eventdetail="YouTube Analytics and Reporting APIs" > Analytics and Reporting APIs </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/youtube/analytics/data_model" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="5" track-type="globalNav" track-name="breadcrumb" track-metadata-position="5" track-metadata-eventdetail="" > Targeted Queries </a> </li> </ul> <devsite-thumb-rating position="header"> </devsite-thumb-rating> </div> <h1 class="devsite-page-title" tabindex="-1"> Dimensions </h1> <devsite-feature-tooltip ack-key="AckCollectionsBookmarkTooltipDismiss" analytics-category="Site-Wide Custom Events" analytics-action-show="Callout Profile displayed" analytics-action-close="Callout Profile dismissed" analytics-label="Create Collection Callout" class="devsite-page-bookmark-tooltip nocontent" dismiss-button="true" id="devsite-collections-dropdown" dismiss-button-text="Dismiss" close-button-text="Got it"> <devsite-bookmark></devsite-bookmark> <span slot="popout-heading"> Stay organized with collections </span> <span slot="popout-contents"> Save and categorize content based on your preferences. </span> </devsite-feature-tooltip> <div class="devsite-page-title-meta"><devsite-view-release-notes></devsite-view-release-notes></div> <devsite-toc class="devsite-nav" depth="2" devsite-toc-embedded > </devsite-toc> <div class="devsite-article-body clearfix "> <div itemscope itemtype="http://developers.google.com/ReferenceObject"> <meta itemprop="name" content="Dimensions"/> <p>This document defines the dimensions that the <b>YouTube Analytics API</b> supports. This API supports real-time, targeted queries to generate custom YouTube Analytics reports.</p> <p>Dimensions are common criteria that are used to aggregate data, such as the date on which user activity occurred or the country where users were located.</p> <p>Each query report identifies the dimensions that it supports. For example, when retrieving user activity by time, you choose the time period for which data will be reported: <a href="/youtube/analytics/v1/dimsmets/dims#day">day</a> or <a href="/youtube/analytics/v1/dimsmets/dims#month">month</a>. In any report, each row of data has a unique combination of dimension values.</p> <p>To retrieve a query report, call the YouTube Analytics API's <code translate="no" dir="ltr">reports.query</code> method. In your request, use the <code translate="no" dir="ltr"><a href="/youtube/analytics/v1#dimensions">dimensions</a></code> parameter to specify the dimensions that YouTube will use to calculate metric values in the reports.</p> <h2 id="Core_Dimensions" data-text="Core dimensions" tabindex="-1">Core dimensions</h2> <p>While the YouTube Analytics API is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a> defined in the <a href="/youtube/terms">Terms of Service</a>, non-core dimensions (and non-core metrics) are not subject to the policy. In the definitions on this page, any dimension that is a core dimension is explicitly identified as such.</p> <p>The following list identifies the API's core dimensions. </p> <style> .deprecated { color: #d50000; font-size: 14px; } </style> <ul> <li><code translate="no" dir="ltr"><a href="#ageGroup">ageGroup</a></code></li> <li><code translate="no" dir="ltr"><a href="#channel">channel</a></code></li> <li><code translate="no" dir="ltr"><a href="#country">country</a></code></li> <li><code translate="no" dir="ltr"><a href="#day">day</a></code></li> <li><code translate="no" dir="ltr"><a href="#gender">gender</a></code></li> <li><code translate="no" dir="ltr"><a href="#month">month</a></code></li> <li><code translate="no" dir="ltr"><a href="#sharingService">sharingService</a></code></li> <li><code translate="no" dir="ltr"><a href="#uploaderType">uploaderType</a></code></li> <li><code translate="no" dir="ltr"><a href="#video">video</a></code></li> </ul> <p>For more information, see the list of the <a href="/youtube/youtube-api-list">YouTube APIs subject to the Deprecation Policy</a>.</p> <h2 id="filters" data-text="Filters" tabindex="-1">Filters</h2> <p>All query reports support filters. Filters identify dimension values that must be present in the retrieved dataset. As such, they limit an API response to only include data matching a particular value or set of values. For example, instead of retrieving user activity metrics for all countries, you could use a filter to only retrieve data for a particular country.</p> <p>In a request to retrieve a query report, the optional <code translate="no" dir="ltr"><a href="/youtube/analytics/v1#filters">filters</a></code> request parameter specifies the dimension values for which you want to filter data. For example, to retrieve user activity metrics for Europe, you would set the <code translate="no" dir="ltr"><a href="/youtube/analytics/v1#filters">filters</a></code> parameter value to <code translate="no" dir="ltr">continent==150</code>.</p> <p class="special"><strong>Important:</strong> API requests to retrieve content owner reports must filter data by either using one of the reporting entity dimensions or using a supported combination of the <code translate="no" dir="ltr"><a href="#claimedStatus">claimedStatus</a></code> and <code translate="no" dir="ltr"><a href="#uploaderType">uploaderType</a></code> dimensions.</p> <h2 id="Dimensions" data-text="Dimensions" tabindex="-1">Dimensions</h2> <p>The following sections define the dimensions that are used in the YouTube Analytics API's query reports. Unless otherwise noted, these dimensions are used in both <a href="/youtube/reporting/v1/reports/channel_reports">channel</a> and <a href="/youtube/reporting/v1/reports/content_owner_reports">content owner</a> reports. Dimensions that can only be used as filters are also identified.</p> <h3 id="Resource_Dimensions" data-text="Resources" tabindex="-1">Resources</h3> <p>These dimensions correspond to resources that channels and content owners manage on YouTube:</p> <ul style="list-style-type: none"> <li><code translate="no" dir="ltr"><a href="#video">video</a></code></li> <li><code translate="no" dir="ltr"><a href="#playlist">playlist</a></code></li> <li><code translate="no" dir="ltr"><a href="#channel">channel</a></code></li> <li><code translate="no" dir="ltr"><a href="#group">group</a></code></li> </ul> <p class="special"><strong>Note:</strong> The API lets you specify multiple values for the <code translate="no" dir="ltr">video</code>, <code translate="no" dir="ltr">playlist</code>, and <code translate="no" dir="ltr">channel</code> dimensions when they are used as filters. To do so, set the <code translate="no" dir="ltr"><a href="/youtube/analytics/v1#filters">filters</a></code> parameter value to a comma-separated list of the video, playlist, or channel IDs for which the API response should be filtered. The parameter value can specify up to 500 IDs.</p> <dl> <dt id="video" class="notranslate"><span itemprop="property">video</span> <span style="color: #555">(core dimension)</span></dt> <dd>The ID of a YouTube video. In the YouTube Data API, this is the value of a <code translate="no" dir="ltr">video</code> resource's <code translate="no" dir="ltr"><a href="/youtube/v3/docs/videos#id">id</a></code> property. <span class="notranslate">This is a core dimension and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span></dd> <dt id="playlist" class="notranslate"><span itemprop="property">playlist</span></dt> <dd>The ID of a YouTube playlist. In the YouTube Data API, this is the value of a <code translate="no" dir="ltr">playlist</code> resource's <code translate="no" dir="ltr"><a href="/youtube/v3/docs/playlists#id">id</a></code> property.</dd> <dt id="channel" class="notranslate"><span itemprop="property">channel</span> <span style="color: #555">(core dimension)</span> <span style="color: #555">(only used in content owner reports)</span></dt> <dd>The ID for a YouTube channel. In the YouTube Data API, this is the value of a <code translate="no" dir="ltr">channel</code> resource's <code translate="no" dir="ltr"><a href="/youtube/v3/docs/channels#id">id</a></code> property. <span class="notranslate">This is a core dimension and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span> <br><br>The <code translate="no" dir="ltr">channel</code> dimension is frequently used in content owner reports because those reports typically aggregate data for multiple channels. </dd> <dt id="group" class="notranslate"><span itemprop="property">group</span> <span style="color: #555">(filter only)</span></dt> <dd>The ID of a YouTube Analytics group. You can retrieve this value using the YouTube Analytics API's <code translate="no" dir="ltr"><a href="/youtube/analytics/v1/reference/groups/list">groups.list</a></code> method. When you use the <code translate="no" dir="ltr">group</code> filter, the API response contains data for all of the videos, playlists, or channels in that group.</dd> </dl> <h4 id="examples" data-text="Examples" tabindex="-1">Examples</h4> <p>The following sample requests use reporting entity dimensions or filters:</p> <ul> <li><p><strong>Channel examples</strong></p> <ul> <li> <a href="/youtube/analytics/sample-requests#channel-basic-stats-reports">Basic stats</a> <ul> <li>Top 10 – Most watched videos for a channel</li> <li>Top 10 – Annotation click-through rates for a channel's most viewed videos</li> <li>Statistics for a specific playlist</li> <li>Top 10 – Most watched playlists for a channel</li> </ul> </li> <li> <a href="/youtube/analytics/sample-requests#channel-geographic-reports">Geographic</a> <ul> <li>Top 10 – Most viewed videos in a specific country</li> <li>Top 10 – Most viewed videos in Europe</li> </ul> </li> </ul> </li> <li><p><strong>Content owner examples</strong></p> <ul> <li> <a href="/youtube/analytics/sample-requests#content-owner-basic-stats-reports">Basic stats</a> <ul> <li>Top 10 - Most viewed videos for a content owner</li> <li>Top 10 - Most watched videos for a content owner</li> <li>Top 10 - Most viewed videos for a content owner's channel</li> <li>Top 10 – Annotation click-through rates for a channel's most viewed videos</li> <li>Top 10 – Most watched playlists for a content owner</li> </ul> </li> <li> <a href="/youtube/analytics/sample-requests#content-owner-geographic-reports">Geographic</a> <ul> <li>Top 10 - Most watched videos in Europe for a content owner</li> <li>Top 10 – Most started playlists in the United States</li> </ul> </li> </ul> </li> </ul> <h3 id="Geographic_Dimensions" data-text="Geographic areas" tabindex="-1">Geographic areas</h3> <p>These dimensions identify a geographic region associated with user activity, ad performance, or estimated revenue metrics.</p> <dl> <dt id="country" class="notranslate"><span itemprop="property">country</span> <span style="color: #555">(core dimension)</span></dt> <dd>The country associated with the metrics in the report row. The dimension value is a two-letter ISO-3166-1 country code, such as <code translate="no" dir="ltr">US</code>, <code translate="no" dir="ltr">CN</code> (China), or <code translate="no" dir="ltr">FR</code> (France). The country code <code translate="no" dir="ltr">ZZ</code> is used to report metrics for which YouTube could not identify the associated country. <span class="notranslate">This is a core dimension and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span></dd> <dt id="province" class="notranslate"><span itemprop="property">province</span></dt> <dd>The U.S. state or territory associated with the metrics in the report row. The dimension value is an <a href="https://www.google.com/search?q=ISO+3166-2+US">ISO 3166-2 code</a> that identifies a U.S. state or the District of Columbia, such as <code translate="no" dir="ltr">US-MI</code> (Michigan) or <code translate="no" dir="ltr">US-TX</code> (Texas). The province code <code translate="no" dir="ltr">US-ZZ</code> is used to report metrics for which YouTube could not identify the associated U.S. state. When an API request includes <code translate="no" dir="ltr">province</code> in the <code translate="no" dir="ltr">dimensions</code> parameter value, the request must also restrict data to the United States by including <code translate="no" dir="ltr">country==US</code> in the <code translate="no" dir="ltr">filters</code> parameter value. <p class="note"><strong>Note:</strong> This dimension does not support ISO 3166-2 values that identify U.S. outlying areas since those territories also have their own ISO 3166-1 country codes. It also does not support subdivisions of countries other than the United States.</p> </dd> <dt id="dma" class="notranslate"><span itemprop="property">dma</span></dt> <dd>The 3-digit identifier that Nielsen uses to identify the Designated Market Area (DMA) associated with the viewing events described in the data row.</dd> <dt id="city" class="notranslate"><span itemprop="property">city</span></dt> <dd>The estimated city associated with the metrics in the report row. Data for this dimension is available for dates beginning January 1, 2022. </dd> <dt id="continent" class="notranslate"><span itemprop="property">continent</span> <span style="color: #555">(filter only)</span></dt> <dd> A United Nations (UN) statistical region code. The API supports the following values:<br> <table class="responsive details"> <tr> <th colspan="2">Values</th> </tr> <tr> <td><code translate="no" dir="ltr"><strong>002</strong></code></td> <td>Africa</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>019</strong></code></td> <td>Americas (Northern America, Latin America, South America, and the Caribbean)</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>142</strong></code></td> <td>Asia</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>150</strong></code></td> <td>Europe</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>009</strong></code></td> <td>Oceania</td> </tr> </table> This dimension can only be used to filter data. To use this dimension, set the value of the <code translate="no" dir="ltr"><a href="/youtube/analytics/v1#filters">filters</a></code> parameter to <code translate="no" dir="ltr">continent==REGION_CODE</code>, specifying a <code translate="no" dir="ltr">REGION_CODE</code> value from the table. </dd> <dt id="subContinent" class="notranslate"><span itemprop="property">subContinent</span> <span style="color: #555">(filter only)</span></dt> <dd> A UN statistical region code that identifies a geographical sub-region. The <a href="http://unstats.un.org/unsd/methods/m49/m49regin.htm">United Nations Statistics Division</a> lists sub-regions as well as the countries it associates with each region. <section class="expandable"> <p class="showalways">Display the list of supported sub-regions.</p> <table> <tr> <th>Value</th> <th>Region</th> <th>Sub-region</th> </tr> <tr> <td><code translate="no" dir="ltr"><strong>014</strong></code></td> <td>Africa</td> <td>Eastern Africa</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>017</strong></code></td> <td>Africa</td> <td>Middle Africa</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>015</strong></code></td> <td>Africa</td> <td>Northern Africa</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>018</strong></code></td> <td>Africa</td> <td>Southern Africa</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>011</strong></code></td> <td>Africa</td> <td>Western Africa</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>029</strong></code></td> <td>Americas</td> <td>Caribbean</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>013</strong></code></td> <td>Americas</td> <td>Central America</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>021</strong></code></td> <td>Americas</td> <td>Northern America</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>005</strong></code></td> <td>Americas</td> <td>South America</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>143</strong></code></td> <td>Asia</td> <td>Central Asia</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>030</strong></code></td> <td>Asia</td> <td>Eastern Asia</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>034</strong></code></td> <td>Asia</td> <td>Southern Asia</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>035</strong></code></td> <td>Asia</td> <td>Southeastern Asia</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>145</strong></code></td> <td>Asia</td> <td>Western Asia</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>151</strong></code></td> <td>Europe</td> <td>Eastern Europe</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>154</strong></code></td> <td>Europe</td> <td>Northern Europe</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>039</strong></code></td> <td>Europe</td> <td>Southern Europe</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>155</strong></code></td> <td>Europe</td> <td>Western Europe</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>053</strong></code></td> <td>Oceania</td> <td>Australia and New Zealand</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>054</strong></code></td> <td>Oceania</td> <td>Melanesia</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>057</strong></code></td> <td>Oceania</td> <td>Micronesia</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>061</strong></code></td> <td>Oceania</td> <td>Polynesia</td> </tr> </table> </section> <p>This dimension can only be used to filter data. To use this dimension, set the value of the <code translate="no" dir="ltr"><a href="/youtube/analytics/v1#filters">filters</a></code> parameter to <code translate="no" dir="ltr">subContinent==REGION_CODE</code>, specifying a <code translate="no" dir="ltr">REGION_CODE</code> value from the UN list.</p> </dd> </dl> <h4 id="examples_1" data-text="Examples" tabindex="-1">Examples</h4> <p>The following sample requests use geographic dimensions or filters:</p> <ul> <li><p><strong>Channel examples</strong></p> <ul> <li> <a href="/youtube/analytics/sample-requests#channel-basic-stats-reports">Basic stats</a>: Country-specific view counts (and more) for a channel </li> <li> <a href="/youtube/analytics/sample-requests#channel-geographic-reports">Geographic</a> <ul> <li>Country-specific watch time metrics for a channel's videos</li> <li>Country-specific annotation metrics for a channel's videos</li> <li>Province-specific metrics for U.S. states and Washington D.C.</li> <li>Country-specific watch time metrics for a channel's playlists</li> <li>Top 10 – Most started playlists in the United States</li> </ul> </li> <li> <a href="/youtube/analytics/sample-requests#channel-playback-location-reports">Playback location</a>: Daily view counts and watch time from different playback locations </li> <li> <a href="/youtube/analytics/sample-requests#channel-traffic-source-reports">Traffic source</a>: Viewcounts and watch time from different traffic sources in a country </li> <li> <a href="/youtube/analytics/sample-requests#channel-demographic-reports">Demographic</a>: Viewer demographics in California (age group and gender) </li> <li> <a href="/youtube/analytics/sample-requests#channel-top-videos-reports">Top videos</a> <ul> <li>Top 10 – Most viewed videos in a specific country</li> <li>Top 10 – Most viewed videos in Europe</li> </ul> </li> </ul> </li> <li><p><strong>Content owner examples</strong></p> <ul> <li> <a href="/youtube/analytics/sample-requests#content-owner-basic-stats-reports">Basic stats</a>: Country-specific view counts (and more) for all self-uploaded videos </li> <li> <a href="/youtube/analytics/sample-requests#content-owner-geographic-reports">Geographic</a> <ul> <li>Country-specific watch time metrics for self-uploaded content</li> <li>Country-specific annotation metrics for self-uploaded content</li> <li>Province-specific metrics for U.S. states and Washington D.C.</li> <li>Country-specific watch time metrics for a content owner's playlists</li> <li>Top 10 – Most started playlists in the United States</li> </ul> </li> <li> <a href="/youtube/analytics/sample-requests#content-owner-playback-location-reports">Playback location</a>: Daily view counts and watch time from different playback locations </li> <li> <a href="/youtube/analytics/sample-requests#content-owner-demographic-reports">Demographic</a>: Viewer demographics in California (age group and gender) </li> <li> <a href="/youtube/analytics/sample-requests#content-owner-top-videos-reports">Top videos</a>: Top 10 – Most watched videos in Europe for a content owner </li> <li> <a href="/youtube/analytics/sample-requests#content-owner-revenue-ads-reports">Revenue/Ad performance</a>: Country-specific revenue and ad performance metrics </li> </ul> </li> </ul> <h3 id="Temporal_Dimensions" data-text="Time periods" tabindex="-1">Time periods</h3> <p>These dimensions indicate that a report should aggregate data based on a time period, such as a day, a week, or a month. The <code translate="no" dir="ltr">startDate</code> and <code translate="no" dir="ltr">endDate</code> <a href="/youtube/analytics/v1#Parameters">request parameters</a> specify the time period for which the report includes data. Note that the report actually returns data up until the last day for which all metrics specified in the request are available at the time the query is made. In reports, dates are listed in <code translate="no" dir="ltr">YYYY-MM-DD</code> format.</p> <p class="special"><b>Important:</b> All dates refer to the time period beginning at 12:00AM Pacific time (UTC-7 or UTC-8) and ending at 11:59PM Pacific time on the specified day, month, and year. As a result, dates when clocks are adjusted forward for Daylight Savings Time represent a 23-hour period, and dates when clocks are adjusted backward represent a 25-hour period.<br><br>The <a href="/youtube/analytics/v1/dimsmets/dims#month">month</a> dimension refers to the time period beginning at 12:00AM Pacific time (UTC-7 or UTC-8) on the first day of the specified month and year.</p> <dl> <dt id="day" class="notranslate"><span itemprop="property">day</span> <span style="color: #555">(core dimension)</span></dt> <dd>When you use this dimension, data in the report is aggregated on a daily basis and each row contains data for one day. You can use other dimensions to break down the data even further. For example, a traffic source report can aggregate daily viewing statistics based on the manner in which users reach your videos. <span class="notranslate">This is a core dimension and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span></dd> <dt id="month" class="notranslate"><span itemprop="property">month</span> <span style="color: #555">(core dimension)</span></dt> <dd>Data in the report is aggregated by calendar month. As with daily reports, you can use other filters to segment the data even further. In the report, dates are listed in <code translate="no" dir="ltr">YYYY-MM</code> format.<br/><br/><strong>Note:</strong> If your API query uses the <code translate="no" dir="ltr">month</code> dimension, then the <code translate="no" dir="ltr"><a href="/youtube/analytics/v1#Parameters">start-date</a></code> and <code translate="no" dir="ltr"><a href="/youtube/analytics/v1#Parameters">end-date</a></code> parameters must both be set to the first day of the month. <span class="notranslate">This is a core dimension and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span></dd> </dl> <h4 id="examples_2" data-text="Examples" tabindex="-1">Examples</h4> <p>The following sample requests use temporal dimensions or filters:</p> <ul> <li><p><strong>Channel examples</strong></p> <ul> <li> <a href="/youtube/analytics/sample-requests#channel-time-based-reports">Time-based</a> <ul> <li>Daily watch time metrics for a channel's videos</li> <li>Daily annotation metrics for a channel's videos</li> <li>Daily playlist views for a channel</li> </ul> </li> <li> <a href="/youtube/analytics/sample-requests#channel-playback-location-reports">Playback location</a>: Daily view counts and watch time from different playback locations </li> <li> <a href="/youtube/analytics/sample-requests#channel-traffic-source-reports">Traffic source</a>: Daily view counts and watch time from different traffic sources </li> <li> <a href="/youtube/analytics/sample-requests#channel-device-os-reports">Device/OS</a> <ul> <li>Daily device type metrics for the Android operating system</li> <li>Daily operating system metrics for mobile devices</li> <li>Daily operating system and device type metrics</li> </ul> </li> </ul> </li> <li><p><strong>Content owner examples</strong></p> <ul> <li> <a href="/youtube/analytics/sample-requests#content-owner-time-based-reports">Time-based</a> <ul> <li>Daily watch time metrics for self-uploaded content</li> <li>Annotation metrics for claimed content</li> <li>Daily playlist views for a content owner</li> </ul> </li> <li> <a href="/youtube/analytics/sample-requests#content-owner-playback-location-reports">Playback location</a>: Daily view counts and watch time from different playback locations </li> <li> <a href="/youtube/analytics/sample-requests#content-owner-traffic-source-reports">Traffic source</a>: Daily view counts and watch time from different traffic sources </li> <li> <a href="/youtube/analytics/sample-requests#content-owner-device-os-reports">Device/OS</a> <ul> <li>Daily device type metrics for claimed videos</li> <li>Daily operating system metrics for claimed videos viewed on mobile devices</li> <li>Daily operating system and device type metrics</li> </ul> </li> <li> <a href="/youtube/analytics/sample-requests#content-owner-revenue-ads-reports">Revenue/Ad performance</a>: Daily revenue and ad performance metrics </li> </ul> </li> </ul> <h3 id="Playback_Location_Dimensions" data-text="Playback locations" tabindex="-1">Playback locations</h3> <p>These dimensions provide insight about the page or application where user activity occurred.</p> <dl> <dt id="insightPlaybackLocationType" class="notranslate"><span itemprop="property">insightPlaybackLocationType</span></dt> <dd> Data in the report is aggregated based on the type of page or application where video playbacks occurred. Possible values for this dimension are:<br/><br/> <ul> <li> <p><code translate="no" dir="ltr"><strong>BROWSE</strong></code> – The data describes views that took place on the YouTube home page or home screen, in the user's subscription feed, or in another YouTube browsing feature.</p> </li> <li> <p><code translate="no" dir="ltr"><strong>CHANNEL</strong></code> – The data describes views that occurred on a channel page.</p> </li> <li> <p><code translate="no" dir="ltr"><strong>EMBEDDED</strong></code> – The data describes views that occurred on another website or application where the video was embedded using an <code translate="no" dir="ltr"><iframe></code> or <code translate="no" dir="ltr"><object></code> embed.</p> </li> <li> <p><code translate="no" dir="ltr"><strong>EXTERNAL_APP</strong></code> – The data describes views that occurred in a third-party application where the video was played using a method other than an <code translate="no" dir="ltr"><iframe></code> or <code translate="no" dir="ltr"><object></code> embed. For example, playbacks in applications that use the YouTube Android Player API would be categorized using this value.</p> </li> <li> <p><code translate="no" dir="ltr"><strong>MOBILE</strong></code> – The data describes views that occurred on YouTube's mobile website or on approved YouTube API clients, including mobile devices.</p> <p>As of September 10, 2013, playbacks are no longer categorized as <code translate="no" dir="ltr">MOBILE</code> playbacks in YouTube Analytics reports. The value may remain in reports since legacy data still falls under that category. However, following that date, mobile playbacks are classified as either <code translate="no" dir="ltr">WATCH</code>, <code translate="no" dir="ltr">EMBEDDED</code>, or <code translate="no" dir="ltr">EXTERNAL_APP</code> playbacks, depending on the type of application where the playbacks occur.</p> </li> <li> <p><code translate="no" dir="ltr"><strong>SEARCH</strong></code> – The data describes views that took place directly on the YouTube search results page.</p> </li> <li> <p><code translate="no" dir="ltr"><strong>WATCH</strong></code> – The data describes views that occurred on the video's YouTube watch page or in an official YouTube application, such as the YouTube Android app.</p> </li> <li> <p><code translate="no" dir="ltr"><strong>YT_OTHER</strong></code> – The data describes views that are not otherwise classified.</p> </li> </ul> </dd> <dt id="insightPlaybackLocationDetail" class="notranslate"><span itemprop="property">insightPlaybackLocationDetail</span></dt> <dd>Data is aggregated based on the page where the player is located. Note that this report is only supported for views that occurred in embedded players, and it identifies the embedded players that generated the most views for a specified video. Thus, it provides a more fine-grained view than the playback location report by identifying the URLs or applications associated with the top embedded players.</dd> </dl> <h4 id="examples_3" data-text="Examples" tabindex="-1">Examples</h4> <p>The following sample requests use playback location dimensions:</p> <ul> <li><p><strong>Channel examples</strong></p> <ul> <li> <a href="/youtube/analytics/sample-requests#channel-playback-location-reports">Playback location</a> <ul> <li>Viewcounts and watch time from different playback locations</li> <li>Daily view counts and watch time from different playback locations</li> <li>Top 10 – Third-party sites that generate the most views for an embedded video</li> <li>Playlist view counts and watch time from different playback locations</li> <li>Daily playlist view counts and watch time from different playback locations</li> </ul> </li> </ul> </li> <li><p><strong>Content owner examples</strong></p> <ul> <li> <a href="/youtube/analytics/sample-requests#content-owner-playback-location-reports">Playback location</a> <ul> <li>Viewcounts and watch time from different playback locations</li> <li>Daily view counts and watch time from different playback locations</li> <li>Top 10 – Third-party sites that generate the most views for an embedded video</li> <li>Playlist view counts and watch time from different playback locations</li> <li>Daily playlist view counts and watch time from different playback locations</li> </ul> </li> </ul> </li> </ul> <h3 id="Playback_Detail_Dimensions" data-text="Playback details" tabindex="-1">Playback details</h3> <dl> <dt id="creatorContentType" class="notranslate"><span itemprop="property">creatorContentType</span></dt> <dd>This dimension identifies the type of content associated with the user activity metrics in the data row. Data for this dimension is available for dates beginning January 1, 2019.<br><br>The following table lists dimension values:<br> <table class="responsive details"> <tr> <th colspan="2">Values</th> </tr> <tr> <td><code translate="no" dir="ltr"><strong>LIVE_STREAM</strong></code></td> <td>The viewed content was a <a href="https://support.google.com/youtube/answer/2474026">YouTube livestream</a>.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>SHORTS</strong></code></td> <td>The viewed content was a <a href="https://www.youtube.com/creators/shorts/">YouTube Short</a>.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>STORY</strong></code></td> <td>The viewed content was a <a href="https://support.google.com/youtube/answer/7568166">YouTube Story</a>.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>VIDEO_ON_DEMAND</strong></code></td> <td>The viewed content was a YouTube video that does not fall under one of the other dimension values.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>UNSPECIFIED</strong></code></td> <td>The content type of the viewed content is unknown.</td> </tr> </table> </dd> <dt id="liveOrOnDemand" class="notranslate"><span itemprop="property">liveOrOnDemand</span></dt> <dd>This dimension indicates whether the user activity metrics in the data row are associated with views of a live broadcast. Data for this dimension is available for dates beginning April 1, 2014.<br><br>The following table lists dimension values:<br> <table class="responsive details"> <tr> <th colspan="2">Values</th> </tr> <tr> <td><code translate="no" dir="ltr"><strong>LIVE</strong></code></td> <td>The row's data describes user activity that occurred during a live broadcast.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>ON_DEMAND</strong></code></td> <td>The row's data describes user activity that did not occur during a live broadcast.</td> </tr> </table> </dd> <dt id="subscribedStatus" class="notranslate"><span itemprop="property">subscribedStatus</span></dt> <dd>This dimension indicates whether the user activity metrics in the data row are associated with viewers who were subscribed to the video's or playlist's channel. Possible values are <code translate="no" dir="ltr">SUBSCRIBED</code> and <code translate="no" dir="ltr">UNSUBSCRIBED</code>. <br><br>Note that the dimension value is accurate as of the time that the user activity occurs. For example, suppose a user has not subscribed to a channel and watches one of that channel's videos, then subscribes to the channel and watches another video, all on the same day. The channel's report indicates that one view has a <code translate="no" dir="ltr">subscribedStatus</code> value of <code translate="no" dir="ltr">SUBSCRIBED</code>, and one view has a <code translate="no" dir="ltr">subscribedStatus</code> value of <code translate="no" dir="ltr">UNSUBSCRIBED</code>. </dd> <dt id="youtubeProduct" class="notranslate"><span itemprop="property">youtubeProduct</span></dt> <dd>This dimension identifies the YouTube service on which the user activity occurred. Data for this dimension is available as of July 18, 2015.<br><br>The following table lists dimension values:<br> <table class="responsive details"> <tr> <th colspan="2">Values</th> </tr> <tr> <td><code translate="no" dir="ltr"><strong>CORE</strong></code></td> <td>The user activity that did not occur in one of the specialty YouTube applications (YouTube Gaming, YouTube Kids, or YouTube Music). Exception: User activity that occurred in YouTube Music before March 1, 2021, is included in <code translate="no" dir="ltr">CORE</code>.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>GAMING</strong></code></td> <td>The user activity occurred in YouTube Gaming.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>KIDS</strong></code></td> <td>The user activity occurred in YouTube Kids.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>MUSIC</strong></code></td> <td>The user activity occurred in YouTube Music on or after March 1, 2021. Data prior to March 1, 2021 is included in <code translate="no" dir="ltr">CORE</code>. Real-time data is not recorded.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>UNKNOWN</strong></code></td> <td>The user activity occurred prior to July 18, 2015.</td> </tr> </table> </dd> </dl> <h3 id="Traffic_Source_Dimensions" data-text="Traffic sources" tabindex="-1">Traffic sources</h3> <dl> <dt id="insightTrafficSourceType" class="notranslate"><span itemprop="property">insightTrafficSourceType</span></dt> <dd>Data in the report is aggregated based on the referrer type, which describes the manner in which users reached the video. Possible values for this dimension are: <ul> <li><code translate="no" dir="ltr"><strong>ADVERTISING</strong></code> – The viewer was referred to the video by an advertisement. If you filter based on this traffic source, the <code translate="no" dir="ltr">insightTrafficSourceDetail</code> field identifies the type of advertisement.</li> <li><code translate="no" dir="ltr"><strong>ANNOTATION</strong></code> – Viewers reached the video by clicking on an annotation in another video.</li> <li><code translate="no" dir="ltr"><strong>CAMPAIGN_CARD</strong></code> – Views originated from claimed, user-uploaded videos that the content owner used to promote the viewed content. This traffic source is only supported for content owner reports.</li> <li><code translate="no" dir="ltr"><strong>END_SCREEN</strong></code> – The views were referred from the end screen of another video.</li> <li><code translate="no" dir="ltr"><strong>EXT_URL</strong></code> – The video views were referred from a link on another website. If you filter based on this traffic source, the <code translate="no" dir="ltr">insightTrafficSourceDetail</code> field identifies the web page. This traffic source includes referrals from Google Search results.</li> <li><code translate="no" dir="ltr"><strong>HASHTAGS</strong></code> – Views originated from VOD hashtag pages or Shorts hashtag pivot pages.</li> <li><code translate="no" dir="ltr"><strong>LIVE_REDIRECT</strong></code> - The video views were referred from <a href="https://support.google.com/youtube/answer/10359590">Live Redirects</a>.</li> <li><code translate="no" dir="ltr"><strong>NO_LINK_EMBEDDED</strong></code> – The video was embedded on another website when it was viewed.</li> <li><code translate="no" dir="ltr"><strong>NO_LINK_OTHER</strong></code> – YouTube did not identify a referrer for the traffic. This category encompasses direct traffic to a video as well as traffic on mobile apps.</li> <li><code translate="no" dir="ltr"><strong>NOTIFICATION</strong></code> – The video views were referred from an email or notification from YouTube.</li> <li><code translate="no" dir="ltr"><strong>PLAYLIST</strong></code> – The video views occurred while the video was being played as part of a playlist. It includes traffic coming from the playlist page.</li> <li><code translate="no" dir="ltr"><strong>PRODUCT_PAGE</strong></code> - The video views were referred from a Product page.</li> <li><code translate="no" dir="ltr"><strong>PROMOTED</strong></code> – The video views were referred from an unpaid YouTube promotion, such as the YouTube "Spotlight Videos" page.</li> <li><code translate="no" dir="ltr"><strong>RELATED_VIDEO</strong></code> – The video views were referred from a related video listing on another video watch page. If you filter based on this traffic source, the <code translate="no" dir="ltr">insightTrafficSourceDetail</code> field specifies the video ID for that video.</li> <li><code translate="no" dir="ltr"><strong>SHORTS</strong></code> – The viewer was referred by swiping vertically from the previous video in the Shorts viewing experience.</li> <li><code translate="no" dir="ltr"><strong>SOUND_PAGE</strong></code> – Views originated from Shorts sound pivot pages.</li> <li><code translate="no" dir="ltr"><strong>SUBSCRIBER</strong></code> – The video views were referred from feeds on the YouTube homepage or from YouTube subscription features. If you filter based on this traffic source, the <code translate="no" dir="ltr">insightTrafficSourceDetail</code> field specifies the homepage feed items or other page from which views were referred.</li> <li><code translate="no" dir="ltr"><strong>YT_CHANNEL</strong></code> – The video views occurred on a channel page. If you filter based on this traffic source, the <code translate="no" dir="ltr">insightTrafficSourceDetail</code> field specifies the channel ID for that channel.</li> <li><code translate="no" dir="ltr"><strong>YT_OTHER_PAGE</strong></code> – The video views were referred from a link other than a search result or related video link that appeared on a YouTube page. If you filter based on this traffic source, the <code translate="no" dir="ltr">insightTrafficSourceDetail</code> field identifies the page.</li> <li><code translate="no" dir="ltr"><strong>YT_SEARCH</strong></code> – The video views were referred from YouTube search results. If you filter based on this traffic source, the <code translate="no" dir="ltr">insightTrafficSourceDetail</code> field specifies the search term.</li> <li><code translate="no" dir="ltr"><strong>VIDEO_REMIXES</strong></code> – The video views were referred from the remixed video link in the Shorts player. If you filter based on this traffic source, the <code translate="no" dir="ltr">insightTrafficSourceDetail</code> field specifies the video from which the viewer was referred.</li> </ul> </dd> <dt id="insightTrafficSourceDetail" class="notranslate"><span itemprop="property">insightTrafficSourceDetail</span></dt> <dd>Data in the report is aggregated based on the referrers that generated the most views for a specified video and a specified traffic source type. The following list identifies the <a href="#insightTrafficSourceType">traffic sources</a> for which this report is available. For each traffic source, the list identifies the information that the <code translate="no" dir="ltr">insightTrafficSourceDetail</code> dimension provides. <ul> <li><code translate="no" dir="ltr"><strong>ADVERTISING</strong></code> – The type of advertisement that led to the views. Possible values are: <ul> <li>Click-to-play engagement ad</li> <li>Engagement ad</li> <li>Google Search ads</li> <li>Homepage video ad</li> <li>Reserved skippable in-stream</li> <li>TrueView in-search and in-display</li> <li>TrueView in-stream</li> <li>Uncategorized YouTube advertising</li> <li>Video wall</li> </ul> </li> <li><code translate="no" dir="ltr"><strong>CAMPAIGN_CARD</strong></code> – The claimed video that led viewers to the video identified in the report.</li> <li><code translate="no" dir="ltr"><strong>END_SCREEN</strong></code> – The video that led viewers to the video identified in the report.</li> <li><code translate="no" dir="ltr"><strong>EXT_URL</strong></code> – The website that referred the viewers to the video.</li> <li><code translate="no" dir="ltr"><strong>HASHTAGS</strong></code> – The hashtag that led to the views.</li> <li><code translate="no" dir="ltr"><strong>NOTIFICATION</strong></code> – The email or notification that referred the traffic.</li> <li><code translate="no" dir="ltr"><strong>RELATED_VIDEO</strong></code> – The related video that led viewers to the video covered in the report.</li> <li><code translate="no" dir="ltr"><strong>SOUND_PAGE</strong></code> – The video that led to the views.</li> <li><code translate="no" dir="ltr"><strong>SUBSCRIBER</strong></code> – The homepage feed item or YouTube subscription feature that led viewers to the video covered in the report. Valid values are: <ul> <li><code translate="no" dir="ltr">activity</code> – Views from items in homepage subscription feeds that resulted from non-upload and non-social channel activity, including likes, favorites, bulletin posts, and playlist additions.</li> <li><code translate="no" dir="ltr">blogged</code> – Views from items in homepage subscription feeds that resulted from links from top blogs.</li> <li><code translate="no" dir="ltr">mychannel</code> – Views from items in other feeds listed on the homepage, such as "Likes," "Watch History," and "Watch Later."</li> <li><code translate="no" dir="ltr">podcasts</code> – Views originating from items in the Podcasts destination page.</li> <li><code translate="no" dir="ltr">sdig</code> – Views originating from subscription update emails.</li> <li><code translate="no" dir="ltr">uploaded</code> – Views from the <code translate="no" dir="ltr">uploaded</code> items in homepage subscription feeds.</li> <li><code translate="no" dir="ltr">/</code> – Other views originating from the YouTube homepage.</li> <li><code translate="no" dir="ltr">/my_subscriptions</code> – Views originating from users' <a href="https://www.youtube.com/my_subscriptions">My subscriptions</a> pages on YouTube.</li> </ul> </li> <li><code translate="no" dir="ltr"><strong>YT_CHANNEL</strong></code> – The channel page where viewers watched the video.</li> <li><code translate="no" dir="ltr"><strong>YT_OTHER_PAGE</strong></code> – The YouTube page from which viewers were referred to the video.</li> <li><code translate="no" dir="ltr"><strong>YT_SEARCH</strong></code> – The search term that led viewers to the video.</li> <li><code translate="no" dir="ltr"><strong>VIDEO_REMIXES</strong></code> – The video that led to the views.</li> </ul> </dd> </dl> <h4 id="examples_4" data-text="Examples" tabindex="-1">Examples</h4> <p>The following sample requests use traffic source dimensions:</p> <ul> <li><p><strong>Channel examples</strong></p> <ul> <li> <a href="/youtube/analytics/sample-requests#channel-traffic-source-reports">Traffic source</a> <ul> <li>Viewcounts and watch time from different traffic sources in a country</li> <li>Daily view counts and watch time from different traffic sources</li> <li>Top 10 – YouTube search terms that generate the most traffic for a video</li> <li>Top 10 – Google Search terms that generate the most traffic for a video</li> <li>Playlist view counts and watch time from different traffic sources in a country</li> <li>Daily playlist view counts and watch time from different traffic sources</li> </ul> </li> </ul> </li> <li><p><strong>Content owner examples</strong></p> <ul> <li> <a href="/youtube/analytics/sample-requests#content-owner-traffic-source-reports">Traffic source</a> <ul> <li>Viewcounts and watch time from different traffic sources</li> <li>Daily view counts and watch time from different traffic sources</li> <li>Top 10 – YouTube search terms that generate the most traffic for a video</li> <li>Top 10 – Google Search terms that generate the most traffic for a video</li> <li>Playlist view counts and watch time from different traffic sources in a country</li> <li>Daily playlist view counts and watch time from different traffic sources</li> </ul> </li> </ul> </li> </ul> <h3 id="Device_Dimensions" data-text="Devices" tabindex="-1">Devices</h3> <dl> <dt id="deviceType" class="notranslate"><span itemprop="property">deviceType</span></dt> <dd>This dimension identifies the physical form factor of the device on which the view occurred. The following list identifies the device types for which the API returns data. You can also use the <code translate="no" dir="ltr">deviceType</code> dimension as a filter to restrict an operating system report to only contain data for a specific type of device. <ul> <li><code translate="no" dir="ltr"><strong>DESKTOP</strong></code></li> <li><code translate="no" dir="ltr"><strong>GAME_CONSOLE</strong></code></li> <li><code translate="no" dir="ltr"><strong>MOBILE</strong></code></li> <li><code translate="no" dir="ltr"><strong>TABLET</strong></code></li> <li><code translate="no" dir="ltr"><strong>TV</strong></code></li> <li><code translate="no" dir="ltr"><strong>UNKNOWN_PLATFORM</strong></code></li> </ul> </dd> <dt id="operatingSystem" class="notranslate"><span itemprop="property">operatingSystem</span></dt> <dd>This dimension identifies the software system of the device on which the view occurred. The following list identifies the operating systems for which the API returns data. You can also use the <code translate="no" dir="ltr">operatingSystem</code> as a filter to restrict a device type report to only contain data for a specific operating system. <ul> <li><code translate="no" dir="ltr"><strong>ANDROID</strong></code></li> <li><code translate="no" dir="ltr"><strong>BADA</strong></code></li> <li><code translate="no" dir="ltr"><strong>BLACKBERRY</strong></code></li> <li><code translate="no" dir="ltr"><strong>CHROMECAST</strong></code></li> <li><code translate="no" dir="ltr"><strong>DOCOMO</strong></code></li> <li><code translate="no" dir="ltr"><strong>FIREFOX</strong></code></li> <li><code translate="no" dir="ltr"><strong>HIPTOP</strong></code></li> <li><code translate="no" dir="ltr"><strong>IOS</strong></code></li> <li><code translate="no" dir="ltr"><strong>KAIOS</strong></code></li> <li><code translate="no" dir="ltr"><strong>LINUX</strong></code></li> <li><code translate="no" dir="ltr"><strong>MACINTOSH</strong></code></li> <li><code translate="no" dir="ltr"><strong>MEEGO</strong></code></li> <li><code translate="no" dir="ltr"><strong>NINTENDO_3DS</strong></code></li> <li><code translate="no" dir="ltr"><strong>OTHER</strong></code></li> <li><code translate="no" dir="ltr"><strong>PLAYSTATION</strong></code></li> <li><code translate="no" dir="ltr"><strong>PLAYSTATION_VITA</strong></code></li> <li><code translate="no" dir="ltr"><strong>REALMEDIA</strong></code></li> <li><code translate="no" dir="ltr"><strong>SMART_TV</strong></code></li> <li><code translate="no" dir="ltr"><strong>SYMBIAN</strong></code></li> <li><code translate="no" dir="ltr"><strong>TIZEN</strong></code></li> <li><code translate="no" dir="ltr"><strong>VIDAA</strong></code></li> <li><code translate="no" dir="ltr"><strong>WEBOS</strong></code></li> <li><code translate="no" dir="ltr"><strong>WII</strong></code></li> <li><code translate="no" dir="ltr"><strong>WINDOWS</strong></code></li> <li><code translate="no" dir="ltr"><strong>WINDOWS_MOBILE</strong></code></li> <li><code translate="no" dir="ltr"><strong>XBOX</strong></code></li> </ul> </dd> </dl> <h4 id="examples_5" data-text="Examples" tabindex="-1">Examples</h4> <p>The following sample requests use device dimensions:</p> <ul> <li><p><strong>Channel examples</strong></p> <ul> <li> <a href="/youtube/analytics/sample-requests#channel-device-os-reports">Device/OS</a> <ul> <li>Daily device type metrics for the Android operating system</li> <li>Daily operating system metrics for mobile devices</li> <li>Daily operating system and device type metrics</li> <li>Daily device type metrics for playlist views on the Android operating system</li> <li>Daily operating system metrics for playlist views on mobile devices</li> </ul> </li> </ul> </li> <li><p><strong>Content owner examples</strong></p> <ul> <li> <a href="/youtube/analytics/sample-requests#content-owner-device-os-reports">Device/OS</a> <ul> <li>Daily device type metrics for claimed videos</li> <li>Daily operating system metrics for claimed videos viewed on mobile devices</li> <li>Daily operating system and device type metrics</li> <li>Daily device type metrics for playlist views on the Android operating system</li> <li>Daily operating system metrics for playlist views on mobile devices</li> </ul> </li> </ul> </li> </ul> <h3 id="Demographic_Dimensions" data-text="Demographics" tabindex="-1">Demographics</h3> <p>Demographic dimensions help you to understand the age range and gender distribution of your audience. The <a href="http://support.google.com/youtube/answer/1715072">YouTube Help Center</a> contains additional information about demographic data in <span class="notranslate">YouTube Analytics</span> reports.</p> <dl> <dt id="ageGroup" class="notranslate"><span itemprop="property">ageGroup</span> <span style="color: #555">(core dimension)</span></dt> <dd>This dimension identifies the age group of the logged-in users associated with the report data. The API uses the following age groups:<br/> <ul> <li><span class="notranslate">age13-17</span></li> <li><span class="notranslate">age18-24</span></li> <li><span class="notranslate">age25-34</span></li> <li><span class="notranslate">age35-44</span></li> <li><span class="notranslate">age45-54</span></li> <li><span class="notranslate">age55-64</span></li> <li><span class="notranslate">age65-</span></li> </ul> <span class="notranslate">This is a core dimension and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span> </dd> <dt id="gender" class="notranslate"><span itemprop="property">gender</span> <span style="color: #555">(core dimension)</span></dt> <dd>This dimension identifies the gender of the logged-in users associated with the report data. Valid values are <code translate="no" dir="ltr">female</code>, <code translate="no" dir="ltr">male</code> and <code translate="no" dir="ltr">user_specified</code>. <span class="notranslate">This is a core dimension and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span> </dd> </dl> <h4 id="examples_6" data-text="Examples" tabindex="-1">Examples</h4> <p>The following sample requests use demographic dimensions:</p> <ul> <li><p><strong>Channel examples</strong></p> <ul> <li> <a href="/youtube/analytics/sample-requests#channel-demographic-reports">Demographic</a> <ul> <li>Viewer demographics in California (age group and gender)</li> <li>Playlist viewer demographics in California (age group and gender)</li> </ul> </li> </ul> </li> <li><p><strong>Content owner examples</strong></p> <ul> <li> <a href="/youtube/analytics/sample-requests#content-owner-demographic-reports">Demographic</a> <ul> <li>Viewer demographics in California (age group and gender)</li> <li>Playlist viewer demographics in California (age group and gender)</li> </ul> </li> </ul> </li> </ul> <h3 id="Social_Dimensions" data-text="Engagement and content sharing" tabindex="-1">Engagement and content sharing</h3> <dl> <dt id="sharingService" class="notranslate"><span itemprop="property">sharingService</span> <span style="color: #555">(core dimension)</span></dt> <dd>This dimension identifies the service that was used to share videos. Videos can be shared on YouTube (or via the YouTube player) using the "Share" button. <span class="notranslate">This is a core dimension and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span><br> <br>The following table lists valid dimension values:<br> <table> <tr> <th>Sharing service</th> <th>API value</th> </tr> <tr> <td>Ameba</td> <td><code translate="no" dir="ltr"><strong>AMEBA</strong></code></td> </tr> <tr> <td>Android Email</td> <td><code translate="no" dir="ltr"><strong>ANDROID_EMAIL</strong></code></td> </tr> <tr> <td>Android Messenger</td> <td><code translate="no" dir="ltr"><strong>ANDROID_MESSENGER</strong></code></td> </tr> <tr> <td>Android messaging</td> <td><code translate="no" dir="ltr"><strong>ANDROID_MMS</strong></code></td> </tr> <tr> <td>Blackberry Messenger</td> <td><code translate="no" dir="ltr"><strong>BBM</strong></code></td> </tr> <tr> <td>Blogger</td> <td><code translate="no" dir="ltr"><strong>BLOGGER</strong></code></td> </tr> <tr> <td>Copy to Clipboard</td> <td><code translate="no" dir="ltr"><strong>COPY_PASTE</strong></code></td> </tr> <tr> <td>Cyworld</td> <td><code translate="no" dir="ltr"><strong>CYWORLD</strong></code></td> </tr> <tr> <td>Digg</td> <td><code translate="no" dir="ltr"><strong>DIGG</strong></code></td> </tr> <tr> <td>Dropbox</td> <td><code translate="no" dir="ltr"><strong>DROPBOX</strong></code></td> </tr> <tr> <td>Embed</td> <td><code translate="no" dir="ltr"><strong>EMBED</strong></code></td> </tr> <tr> <td>Email</td> <td><code translate="no" dir="ltr"><strong>MAIL</strong></code></td> </tr> <tr> <td>Facebook</td> <td><code translate="no" dir="ltr"><strong>FACEBOOK</strong></code></td> </tr> <tr> <td>Facebook Messenger</td> <td><code translate="no" dir="ltr"><strong>FACEBOOK_MESSENGER</strong></code></td> </tr> <tr> <td>Facebook Pages</td> <td><code translate="no" dir="ltr"><strong>FACEBOOK_PAGES</strong></code></td> </tr> <tr> <td>Fotka</td> <td><code translate="no" dir="ltr"><strong>FOTKA</strong></code></td> </tr> <tr> <td>Gmail</td> <td><code translate="no" dir="ltr"><strong>GMAIL</strong></code></td> </tr> <tr> <td>goo</td> <td><code translate="no" dir="ltr"><strong>GOO</strong></code></td> </tr> <tr> <td>Google+</td> <td><code translate="no" dir="ltr"><strong>GOOGLEPLUS</strong></code></td> </tr> <tr> <td>Go SMS</td> <td><code translate="no" dir="ltr"><strong>GO_SMS</strong></code></td> </tr> <tr> <td>GroupMe</td> <td><code translate="no" dir="ltr"><strong>GROUPME</strong></code></td> </tr> <tr> <td>Hangouts</td> <td><code translate="no" dir="ltr"><strong>HANGOUTS</strong></code></td> </tr> <tr> <td>hi5</td> <td><code translate="no" dir="ltr"><strong>HI5</strong></code></td> </tr> <tr> <td>HTC text message</td> <td><code translate="no" dir="ltr"><strong>HTC_MMS</strong></code></td> </tr> <tr> <td>Google Inbox</td> <td><code translate="no" dir="ltr"><strong>INBOX</strong></code></td> </tr> <tr> <td>iOS System Activity Dialog</td> <td><code translate="no" dir="ltr"><strong>IOS_SYSTEM_ACTIVITY_DIALOG</strong></code></td> </tr> <tr> <td>KAKAO Story</td> <td><code translate="no" dir="ltr"><strong>KAKAO_STORY</strong></code></td> </tr> <tr> <td>Kakao (Kakao Talk)</td> <td><code translate="no" dir="ltr"><strong>KAKAO</strong></code></td> </tr> <tr> <td>Kik</td> <td><code translate="no" dir="ltr"><strong>KIK</strong></code></td> </tr> <tr> <td>LGE Email</td> <td><code translate="no" dir="ltr"><strong>LGE_EMAIL</strong></code></td> </tr> <tr> <td>Line</td> <td><code translate="no" dir="ltr"><strong>LINE</strong></code></td> </tr> <tr> <td>Linkedin</td> <td><code translate="no" dir="ltr"><strong>LINKEDIN</strong></code></td> </tr> <tr> <td>LiveJournal</td> <td><code translate="no" dir="ltr"><strong>LIVEJOURNAL</strong></code></td> </tr> <tr> <td>menéame</td> <td><code translate="no" dir="ltr"><strong>MENEAME</strong></code></td> </tr> <tr> <td>mixi</td> <td><code translate="no" dir="ltr"><strong>MIXI</strong></code></td> </tr> <tr> <td>Motorola Messaging</td> <td><code translate="no" dir="ltr"><strong>MOTOROLA_MESSAGING</strong></code></td> </tr> <tr> <td>Myspace</td> <td><code translate="no" dir="ltr"><strong>MYSPACE</strong></code></td> </tr> <tr> <td>Naver</td> <td><code translate="no" dir="ltr"><strong>NAVER</strong></code></td> </tr> <tr> <td>Nearby Share</td> <td><code translate="no" dir="ltr"><strong>NEARBY_SHARE</strong></code></td> </tr> <tr> <td>NUjij</td> <td><code translate="no" dir="ltr"><strong>NUJIJ</strong></code></td> </tr> <tr> <td>Odnoklassniki (Одноклассники)</td> <td><code translate="no" dir="ltr"><strong>ODNOKLASSNIKI</strong></code></td> </tr> <tr> <td>Other</td> <td><code translate="no" dir="ltr"><strong>OTHER</strong></code></td> </tr> <tr> <td>Pinterest</td> <td><code translate="no" dir="ltr"><strong>PINTEREST</strong></code></td> </tr> <tr> <td>Rakuten (楽天市場)</td> <td><code translate="no" dir="ltr"><strong>RAKUTEN</strong></code></td> </tr> <tr> <td>reddit</td> <td><code translate="no" dir="ltr"><strong>REDDIT</strong></code></td> </tr> <tr> <td>Skype</td> <td><code translate="no" dir="ltr"><strong>SKYPE</strong></code></td> </tr> <tr> <td>Skyrock</td> <td><code translate="no" dir="ltr"><strong>SKYBLOG</strong></code></td> </tr> <tr> <td>Sony Conversations</td> <td><code translate="no" dir="ltr"><strong>SONY_CONVERSATIONS</strong></code></td> </tr> <tr> <td>StumbleUpon</td> <td><code translate="no" dir="ltr"><strong>STUMBLEUPON</strong></code></td> </tr> <tr> <td>Telegram</td> <td><code translate="no" dir="ltr"><strong>TELEGRAM</strong></code></td> </tr> <tr> <td>Text message</td> <td><code translate="no" dir="ltr"><strong>TEXT_MESSAGE</strong></code></td> </tr> <tr> <td>Tuenti</td> <td><code translate="no" dir="ltr"><strong>TUENTI</strong></code></td> </tr> <tr> <td>tumblr.</td> <td><code translate="no" dir="ltr"><strong>TUMBLR</strong></code></td> </tr> <tr> <td>Twitter</td> <td><code translate="no" dir="ltr"><strong>TWITTER</strong></code></td> </tr> <tr> <td>Unknown</td> <td><code translate="no" dir="ltr"><strong>UNKNOWN</strong></code></td> </tr> <tr> <td>Verizon messages</td> <td><code translate="no" dir="ltr"><strong>VERIZON_MMS</strong></code></td> </tr> <tr> <td>Viber</td> <td><code translate="no" dir="ltr"><strong>VIBER</strong></code></td> </tr> <tr> <td>VKontakte (ВКонтакте)</td> <td><code translate="no" dir="ltr"><strong>VKONTAKTE</strong></code></td> </tr> <tr> <td>WeChat</td> <td><code translate="no" dir="ltr"><strong>WECHAT</strong></code></td> </tr> <tr> <td>Weibo</td> <td><code translate="no" dir="ltr"><strong>WEIBO</strong></code></td> </tr> <tr> <td>WhatsApp</td> <td><code translate="no" dir="ltr"><strong>WHATS_APP</strong></code></td> </tr> <tr> <td>Wykop</td> <td><code translate="no" dir="ltr"><strong>WYKOP</strong></code></td> </tr> <tr> <td>Yahoo! Japan</td> <td><code translate="no" dir="ltr"><strong>YAHOO</strong></code></td> </tr> <tr> <td>YouTube Gaming</td> <td><code translate="no" dir="ltr"><strong>YOUTUBE_GAMING</strong></code></td> </tr> <tr> <td>YouTube Kids</td> <td><code translate="no" dir="ltr"><strong>YOUTUBE_KIDS</strong></code></td> </tr> <tr> <td>YouTube Music</td> <td><code translate="no" dir="ltr"><strong>YOUTUBE_MUSIC</strong></code></td> </tr> <tr> <td>YouTube TV</td> <td><code translate="no" dir="ltr"><strong>YOUTUBE_TV</strong></code></td> </tr> </table> <br>See the <a href="http://support.google.com/youtube/answer/57741">help docs</a> for more information. </dd> </dl> <h4 id="examples_7" data-text="Examples" tabindex="-1">Examples</h4> <p>The following sample requests use social dimensions:</p> <ul> <li><p><strong>Channel examples</strong></p> <ul> <li> <a href="/youtube/analytics/sample-requests#channel-social-reports">Social</a>: Sharing metrics, aggregated by service where videos were shared </li> </ul> </li> <li><p><strong>Content owner examples</strong></p> <ul> <li> <a href="/youtube/analytics/sample-requests#content-owner-social-reports">Social</a>: Sharing metrics, aggregated by service where videos were shared </li> </ul> </li> </ul> <h3 id="Retention_Dimensions" data-text="Audience retention" tabindex="-1">Audience retention</h3> <dl> <dt id="elapsedVideoTimeRatio" class="notranslate"><span itemprop="property">elapsedVideoTimeRatio</span></dt> <dd>This dimension specifies the ratio of the elapsed portion of the video to the video's length. Retention dimensions and metrics are used to measure audience retention over time, and the <code translate="no" dir="ltr">elapsedVideoTimeRatio</code> dimension is the time measurement. For example, a value of <code translate="no" dir="ltr">0.4</code> indicates that the corresponding report data shows retention data after 40 percent of the video has elapsed.<br/><br/> The API returns 100 data points for each video with ratio values ranging from <code translate="no" dir="ltr">0.01</code> to <code translate="no" dir="ltr">1.0</code>. The times at which data is measured during video playbacks are equally spaced for each video. This means that for a two-minute video, the interval between data points is 1.2 seconds. However, for a two-hour video, the interval between data points is 72 seconds. The dimension's value denotes the exclusive end of the interval.</dd> <dt id="audienceType" class="notranslate"><span itemprop="property">audienceType</span> <span style="color: #555">(filter only)</span> </dt> <dd>The dimension value identifies the type of traffic associated with the report data. Supported values are <code translate="no" dir="ltr">ORGANIC</code>, <code translate="no" dir="ltr">AD_INSTREAM</code>, and <code translate="no" dir="ltr">AD_INDISPLAY</code>. See the <a href="https://support.google.com/youtube/answer/1715160">YouTube Help Center</a> for explanations of these traffic source types. <br><br>Note that data for the <code translate="no" dir="ltr">audienceType</code> filter is available as of September 25, 2013. The API does not return data for queries that use the filter to try to retrieve data from earlier dates. Queries that do not use the filter work for any date after July 1, 2008. </dd> </dl> <h4 id="examples_8" data-text="Examples" tabindex="-1">Examples</h4> <p>The following sample requests use audience retention dimensions:</p> <ul> <li><p><strong>Channel examples</strong></p> <ul> <li> <a href="/youtube/analytics/sample-requests#channel-audience-retention-reports">Audience retention</a>: Audience retention metrics for a video </li> </ul> </li> <li><p><strong>Content owner examples</strong></p> <ul> <li> <a href="/youtube/analytics/sample-requests#content-owner-audience-retention-reports">Audience retention</a>: Audience retention metrics for a video </li> </ul> </li> </ul> <h3 id="Live_Streaming_Dimensions" data-text="Live streaming" tabindex="-1">Live streaming</h3> <dl> <dt id="livestreamPosition" class="notranslate"><span itemprop="property">livestreamPosition</span></dt> <dd>This dimension specifies a particular minute during a live video stream. The report metrics indicate how many users were watching the livestream at that time.</dd> </dl> <h3 id="Membership_Cancellation_Dimensions" data-text="Membership cancellations" tabindex="-1">Membership cancellations</h3> <dl> <dt id="membershipsCancellationSurveyReason" class="notranslate"><span itemprop="property">membershipsCancellationSurveyReason</span></dt> <dd>The number of surveys completed by YouTube users who canceled their channel membership for the specified channel during the reporting period. The following table lists valid dimension values:<br> <table> <tr> <th>API value</th> <th>Explanation</th> </tr> <tr> <td><code translate="no" dir="ltr"><strong>UNKNOWN</strong></code></td> <td>The user did not complete the survey.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>DISLIKE_PERKS</strong></code></td> <td>The user did not like the perks of the membership.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>PERKS_NOT_DELIVERED</strong></code></td> <td>The user said promised membership perks were not delivered.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>CANNOT_ACCESS_PERKS</strong></code></td> <td>The user was not able to access the perks.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>NO_LONGER_INTERESTED</strong></code></td> <td>The user is no longer interested in the channel membership.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>FEEL_UNAPPRECIATED</strong></code></td> <td>The user felt unappreciated as a channel member.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>FINANCIAL_REASONS</strong></code></td> <td>The user canceled for financial reasons.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>JOIN_LIMITED_TIME</strong></code></td> <td>The user only intended to join for a limited time.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>OTHER</strong></code></td> <td>The user had another reason for canceling.</td> </tr> </table> </dd> </dl> <h3 id="Ad_Performance" data-text="Ad performance" tabindex="-1">Ad performance</h3> <dl> <dt id="adType" class="notranslate" itemprop="property">adType</dt> <dd>The <code translate="no" dir="ltr">adType</code> dimension is used in ad performance reports and aggregates the requested metrics based on the types of ads that ran during video playbacks. The following list explains possible dimension values. See the <a href="https://support.google.com/youtube/answer/2467968">YouTube Help Center</a> for more information about YouTube advertising formats.<br> <ul> <li> <p><code itemprop="property" translate="no" dir="ltr"><strong>auctionBumperInstream</strong></code> – Non-skippable video ads, placed via auction, of up to 6 seconds that must be watched before a video can be viewed.</p> </li> <li> <p><code itemprop="property" translate="no" dir="ltr"><strong>auctionDisplay</strong></code> – A rich media or image ad that appears either as an overlay on the bottom of the video player, as a 300x250 ad unit on the video watch page, or as a combination of both. When the overlay runs, it automatically closes after displaying for a certain amount of time, and the user can close the overlay as well. If an overlay and a banner are shown together, each ad is counted as a separate impression.</p> </li> <li> <p><code itemprop="property" translate="no" dir="ltr"><strong>auctionInstream</strong></code> – Non-skippable video ads that run before, during, or after the main video.</p> </li> <li> <p><code itemprop="property" translate="no" dir="ltr"><strong>auctionTrueviewInslate</strong></code> – The viewer chooses one of several video ads from a selection of choices displayed before a video. <span class="notranslate">See the <a href="https://www.youtube.com/yt/advertise/trueview.html">TrueView</a> documentation for more information.</span></p> </li> <li> <p><code itemprop="property" translate="no" dir="ltr"><strong>auctionTrueviewInstream</strong></code> – Skippable video ads that run before or during the main video. See the <a href="https://www.youtube.com/yt/advertise/trueview.html">TrueView</a> documentation for more information.</p> </li> <li> <p><code itemprop="property" translate="no" dir="ltr"><strong>auctionUnknown</strong></code> – An ad that was purchased via the AdWords auction but that has not been classified into one of the other ad types.</p> </li> <li> <p><code itemprop="property" translate="no" dir="ltr"><strong>reservedBumperInstream</strong></code> – Non-skippable video ads, sold on a reserved basis, of up to 6 seconds that must be watched before a video can be viewed.</p> </li> <li> <p><code itemprop="property" translate="no" dir="ltr"><strong>reservedClickToPlay</strong></code> – A video ad that the user must click to initiate playback. An ad impression is recorded any time the click-to-play ad unit displays, regardless of whether the user initiates a playback. These are sold on a reserved basis.</p> </li> <li> <p><code itemprop="property" translate="no" dir="ltr"><strong>reservedDisplay</strong></code> – A rich media or image ad that appears either as an overlay on the bottom of the video player, as a 300x250 ad unit on the video watch page, or as a combination of both. When the overlay runs, it automatically closes after displaying for a certain amount of time, and the user can close the overlay as well. If an overlay and a banner are shown together, each ad is counted as a separate impression.</p> </li> <li> <p><code itemprop="property" translate="no" dir="ltr"><strong>reservedInstream</strong></code> – Non-skippable video ads that are inserted before, during, or after the main video.</p> </li> <li> <p><code itemprop="property" translate="no" dir="ltr"><strong>reservedInstreamSelect</strong></code></p> </li> <li> <p><code itemprop="property" translate="no" dir="ltr"><strong>reservedMasthead</strong></code> – A large ad, which can include video and graphic elements, that appears on the homepage.</p> </li> <li> <p><code itemprop="property" translate="no" dir="ltr"><strong>reservedUnknown</strong></code> – An ad that was sold on a reserved basis that could not be classified into one of the other ad types.</p> </li> <li> <p><code translate="no" dir="ltr"><strong>unknown</strong></code> – YouTube could not classify this ad type.</p> </li> </ul> </dd> </dl> <h4 id="examples_9" data-text="Examples" tabindex="-1">Examples</h4> <p>The following sample reports retrieve ad performance or revenue metrics:</p> <ul> <li><p><strong>Channel examples</strong></p> <ul> <li> <a href="/youtube/analytics/sample-requests#channel-revenue-ads-reports">Revenue/Ads</a> <ul> <li>Channel revenue and ad performance metrics</li> <li>Daily revenue and ad performance metrics</li> <li>Country-specific revenue and ad performance metrics</li> <li>Top 10 – Videos with the highest revenue</li> <li>Ad performance metrics for different ad types</li> </ul> </li> </ul> </li> <li><p><strong>Content owner examples</strong></p> <ul> <li> <a href="/youtube/analytics/sample-requests#content-owner-revenue-ads-reports">Revenue/Ads</a> <ul> <li>Revenue and ad performance metrics for claimed content</li> <li>Daily revenue and ad performance metrics</li> <li>Country-specific revenue and ad performance metrics</li> <li>Top 10 – Videos with the highest revenue</li> <li>Ad performance metrics for different ad types</li> </ul> </li> </ul> </li> </ul> <h3 id="Playlist_Dimensions" data-text="Playlists" tabindex="-1">Playlists</h3> <dl> <dt id="isCurated" class="notranslate"><span itemprop="property">isCurated</span> <span style="color: #555">(filter only)</span></dt> <dd><aside class="warning"> <b>Important:</b> Update playlist reports for channels before June 30, 2024, and update playlist reports for content owners by December 31, 2024. Please note the following changes: <ul> <li>The <code translate="no" dir="ltr"><a href="/youtube/analytics/dimensions#isCurated">isCurated</a></code> dimension has been deprecated. <ul> <li><b>For channel reports</b>, this dimension will no longer be supported on or after June 30, 2024.</li> <li><b>For content owner reports</b>, this dimension will no longer be supported on or after December 31, 2024.</li> </ul> </li> <li>The behavior of the <code translate="no" dir="ltr"><a href="/youtube/analytics/views#views">views</a></code> metric changes when you remove the <code translate="no" dir="ltr">isCurated</code> dimension from a request to retrieve a playlist report: <ul> <li>When a request includes the <code translate="no" dir="ltr">isCurated</code> dimension, the <code translate="no" dir="ltr"><a href="/youtube/analytics/views#views">views</a></code> metric indicates the number of times that the video was viewed in the context of the playlist.</li> <li>When a request does not include the <code translate="no" dir="ltr">isCurated</code> dimension, the <code translate="no" dir="ltr">views</code> metric specifies the total number of times that the video was viewed, while the <code translate="no" dir="ltr">playlistViews</code> metric indicates the number of times that the video was viewed in the context of the playlist.</li> </ul> </li> </ul> As a result, to preserve backward compatibility when you remove the <code translate="no" dir="ltr">isCurated</code> dimension, you must also update your code to retrieve the <code translate="no" dir="ltr">playlistViews</code> metric instead of the <code translate="no" dir="ltr">views</code> metric for playlist reports only. Since the <code translate="no" dir="ltr">views</code> metric is still supported for playlist reports, albeit with a different meaning, the API will still return data if you do not update the metric name. Of course, you can modify your application to retrieve and display both <code translate="no" dir="ltr">views</code> and <code translate="no" dir="ltr">playlistViews</code>.<br><br> See the <a href="/youtube/analytics/revision_history">revision history</a> for more details. </aside> This filter indicates that the request is retrieving data about video views that occurred in the context of a playlist.</dd> </dl> <h4 id="examples_10" data-text="Examples" tabindex="-1">Examples</h4> <p>All of the <a href="/youtube/analytics/sample-requests">sample requests</a> that retrieve playlist reports use the <code translate="no" dir="ltr">isCurated</code> filter.</p> <h2 id="Content_Owner_Dimensions" data-text="Content owner dimensions" tabindex="-1">Content owner dimensions</h2> <p>The following dimensions are only supported for content owner reports.</p> <div class="special" style="margin-bottom:12px"><strong>Important:</strong> API requests to retrieve content owner reports must filter data using one of the following dimensions: <ul style="margin-bottom: 0"> <li><code translate="no" dir="ltr"><a href="#Reporting_Entity_Dimensions">video</a></code></li> <li><code translate="no" dir="ltr"><a href="#Reporting_Entity_Dimensions">channel</a></code></li> <li>A supported combination of the <code translate="no" dir="ltr">claimedStatus</code> and <code translate="no" dir="ltr">uploaderType</code> dimensions as defined below.</li> </ul> </div> <dl> <dt id="claimedStatus" class="notranslate" itemprop="property">claimedStatus <span style="color: #555">(only used in content owner reports)</span></dt> <dd>This dimension lets you indicate that an API response should only contain metrics for claimed content. The only valid value for this dimension is <code translate="no" dir="ltr">claimed</code>. If the <code translate="no" dir="ltr">filters</code> parameter restricts the query to <code translate="no" dir="ltr">claimedStatus==claimed</code>, the API will only retrieve data for claimed content. The table in the definition of the <code translate="no" dir="ltr">uploaderType</code> dimension provides more detail about how to use this dimension.</dd> </dl> <dl> <dt id="uploaderType" class="notranslate" itemprop="property">uploaderType <span style="color: #555">(core dimension)</span> <span style="color: #555">(only used in content owner reports)</span></dt> <dd>This dimension lets you indicate whether an API response should contain metrics for content uploaded by the specified content owner and/or content uploaded by third parties, such as user-uploaded videos. Valid values are <code translate="no" dir="ltr">self</code> and <code translate="no" dir="ltr">thirdParty</code>. This is a core dimension and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.<br/><br/>The table below shows the supported combinations for the <code translate="no" dir="ltr">claimedStatus</code> and <code translate="no" dir="ltr">uploaderType</code> dimensions, which are both used in the <code translate="no" dir="ltr">filters</code> parameter:<br/><br/> <table> <tr> <th><code class="notranslate" dir="ltr">claimedStatus</code> value</th> <th><code class="notranslate" dir="ltr">uploaderType</code> value</th> <th>Description</th> </tr> <tr> <td>[Not set]</td> <td class="notranslate">self</td> <td> Retrieves YouTube Analytics data for claimed and unclaimed content uploaded by the content owner. </td> </tr> <tr> <td class="notranslate">claimed</td> <td>[Not set]</td> <td> Retrieves data for claimed content uploaded by the content owner or by a third party. </td> </tr> <tr> <td class="notranslate">claimed</td> <td class="notranslate">self</td> <td> Retrieves data for claimed content uploaded by the content owner. </td> </tr> <tr> <td class="notranslate">claimed</td> <td class="notranslate">thirdParty</td> <td> Retrieves data for claimed content uploaded by a third party. </td> </tr> </table> </dd> </dl> <h4 id="examples_11" data-text="Examples" tabindex="-1">Examples</h4> <p>Many of the sample API requests for content owner reports use a supported combination of the <code translate="no" dir="ltr">claimedStatus</code> and <code translate="no" dir="ltr">uploaderType</code> dimensions to filter data.</p> </div> </div> <devsite-recommendations display="in-page" hidden yield> </devsite-recommendations> <devsite-thumb-rating position="footer"> </devsite-thumb-rating> <devsite-recommendations id="recommendations-link" yield></devsite-recommendations> <div class="devsite-floating-action-buttons"> </div> </article> <devsite-content-footer class="nocontent"> <p>Except as otherwise noted, the content of this page is licensed under the <a href="https://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 License</a>, and code samples are licensed under the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 License</a>. For details, see the <a href="https://developers.google.com/site-policies">Google Developers Site Policies</a>. Java is a registered trademark of Oracle and/or its affiliates.</p> <p>Last updated 2024-10-30 UTC.</p> </devsite-content-footer> <devsite-notification > </devsite-notification> <div class="devsite-content-data"> <template class="devsite-content-data-template"> [[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-30 UTC."],[],[]] </template> </div> </devsite-content> </main> <devsite-footer-promos class="devsite-footer"> <nav class="devsite-footer-promos nocontent" aria-label="Promotions"> <ul class="devsite-footer-promos-list"> <li class="devsite-footer-promo"> <a href="https://blog.youtube" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 1)" > <picture> <img class="devsite-footer-promo-icon" src="/static/site-assets/logo-youtube.svg" loading="lazy" alt="Blog"> </picture> <span class="devsite-footer-promo-label"> Blog </span> </a> <div class="devsite-footer-promo-description">The latest news on the YouTube blog</div> </li> <li class="devsite-footer-promo"> <a href="https://github.com/youtube/api-samples" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 2)" > <picture> <img class="devsite-footer-promo-icon" src="/static/site-assets/logo-github.svg" loading="lazy" alt="GitHub"> </picture> <span class="devsite-footer-promo-label"> GitHub </span> </a> <div class="devsite-footer-promo-description">Find API code samples and other YouTube open-source projects.</div> </li> <li class="devsite-footer-promo"> <a href="https://issuetracker.google.com/issues/new?component=186600&template=874803" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 3)" > <picture> <img class="devsite-footer-promo-icon" src="/static/site-assets/developers_64dp.png" loading="lazy" alt="Issue Tracker"> </picture> <span class="devsite-footer-promo-label"> Issue Tracker </span> </a> <div class="devsite-footer-promo-description">Something wrong? Send us a bug report!</div> </li> <li class="devsite-footer-promo"> <a href="http://stackoverflow.com/questions/ask?tags=youtube-api" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 4)" > <picture> <img class="devsite-footer-promo-icon" src="/static/site-assets/logo-stack-overflow.svg" loading="lazy" alt="Stack Overflow"> </picture> <span class="devsite-footer-promo-label"> Stack Overflow </span> </a> <div class="devsite-footer-promo-description">Ask a question under the youtube-api tag</div> </li> <li class="devsite-footer-promo"> <a href="https://research.youtube/" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 5)" > <picture> <img class="devsite-footer-promo-icon" src="/static/site-assets/logo-youtube.svg" loading="lazy" alt="YouTube Researcher Program"> </picture> <span class="devsite-footer-promo-label"> YouTube Researcher Program </span> </a> <div class="devsite-footer-promo-description">For researchers interested in using data from YouTube’s global API</div> </li> </ul> </nav> </devsite-footer-promos> <devsite-footer-linkboxes class="devsite-footer"> <nav class="devsite-footer-linkboxes nocontent" aria-label="Footer links"> <ul class="devsite-footer-linkboxes-list"> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Tools</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="https://developers.google.com/apis-explorer/#p/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" > Google APIs Explorer </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/youtube/youtube_player_demo" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" > YouTube Player Demo </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/youtube/youtube_subscribe_button" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" > Configure a Subscribe Button </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Issue Tracker</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="https://issuetracker.google.com/issues/new?component=186600&template=874803" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" > File a bug </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://issuetracker.google.com/issues/new?component=186600&template=874803" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" > Request a feature </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://issuetracker.google.com/issues?q=componentid:186600" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" > See open issues </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Product Info</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="/youtube/terms/api-services-terms-of-service" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" > Terms of Service </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/youtube/terms/developer-policies" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" > Developer Policies </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/youtube/terms/required-minimum-functionality" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" > Required Minimum Functionality </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/youtube/terms/branding-guidelines" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 4)" > Branding Guidelines </a> </li> </ul> </li> </ul> </nav> </devsite-footer-linkboxes> <devsite-footer-utility class="devsite-footer"> <div class="devsite-footer-utility nocontent"> <nav class="devsite-footer-sites" aria-label="Other Google Developers websites"> <a href="https://developers.google.com/" class="devsite-footer-sites-logo-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google Developers Link"> <picture> <img class="devsite-footer-sites-logo" src="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/lockup-google-for-developers.svg" loading="lazy" alt="Google Developers"> </picture> </a> <ul class="devsite-footer-sites-list"> <li class="devsite-footer-sites-item"> <a href="//developer.android.com" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Android Link" > Android </a> </li> <li class="devsite-footer-sites-item"> <a href="//developer.chrome.com/home" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Chrome Link" > Chrome </a> </li> <li class="devsite-footer-sites-item"> <a href="//firebase.google.com" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Firebase Link" > Firebase </a> </li> <li class="devsite-footer-sites-item"> <a href="//cloud.google.com" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google Cloud Platform Link" > Google Cloud Platform </a> </li> <li class="devsite-footer-sites-item"> <a href="//ai.google.dev/" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google AI Link" > Google AI </a> </li> <li class="devsite-footer-sites-item"> <a href="/products" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer All products Link" > All products </a> </li> </ul> </nav> <nav class="devsite-footer-utility-links" aria-label="Utility links"> <ul class="devsite-footer-utility-list"> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="/terms/site-terms" data-category="Site-Wide Custom Events" data-label="Footer Terms link" > Terms </a> </li> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="//policies.google.com/privacy" data-category="Site-Wide Custom Events" data-label="Footer Privacy link" > Privacy </a> </li> <li class="devsite-footer-utility-item glue-cookie-notification-bar-control"> <a class="devsite-footer-utility-link gc-analytics-event" href="#" data-category="Site-Wide Custom Events" data-label="Footer Manage cookies link" aria-hidden="true" > Manage cookies </a> </li> <li class="devsite-footer-utility-item devsite-footer-utility-button"> <span class="devsite-footer-utility-description">Sign up for the Google for Developers newsletter</span> <a class="devsite-footer-utility-link gc-analytics-event" href="/newsletter/subscribe" data-category="Site-Wide Custom Events" data-label="Footer Subscribe link" > Subscribe </a> </li> </ul> <devsite-language-selector> <ul role="presentation"> <li role="presentation"> <a role="menuitem" lang="en" >English</a> </li> <li role="presentation"> <a role="menuitem" lang="de" >Deutsch</a> </li> <li role="presentation"> <a role="menuitem" lang="es" >Español</a> </li> <li role="presentation"> <a role="menuitem" lang="es_419" >Español – América Latina</a> </li> <li role="presentation"> <a role="menuitem" lang="fr" >Français</a> </li> <li role="presentation"> <a role="menuitem" lang="id" >Indonesia</a> </li> <li role="presentation"> <a role="menuitem" lang="it" >Italiano</a> </li> <li role="presentation"> <a role="menuitem" lang="pl" >Polski</a> </li> <li role="presentation"> <a role="menuitem" lang="pt_br" >Português – Brasil</a> </li> <li role="presentation"> <a role="menuitem" lang="vi" >Tiếng Việt</a> </li> <li role="presentation"> <a role="menuitem" lang="tr" >Türkçe</a> </li> <li role="presentation"> <a role="menuitem" lang="ru" >Русский</a> </li> <li role="presentation"> <a role="menuitem" lang="he" >עברית</a> </li> <li role="presentation"> <a role="menuitem" lang="ar" >العربيّة</a> </li> <li role="presentation"> <a role="menuitem" lang="fa" >فارسی</a> </li> <li role="presentation"> <a role="menuitem" lang="hi" >हिंदी</a> </li> <li role="presentation"> <a role="menuitem" lang="bn" >বাংলা</a> </li> <li role="presentation"> <a role="menuitem" lang="th" >ภาษาไทย</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_cn" >中文 – 简体</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_tw" >中文 – 繁體</a> </li> <li role="presentation"> <a role="menuitem" lang="ja" >日本語</a> </li> <li role="presentation"> <a role="menuitem" lang="ko" >한국어</a> </li> </ul> </devsite-language-selector> </nav> </div> </devsite-footer-utility> <devsite-panel></devsite-panel> <devsite-concierge data-info-panel data-ai-panel data-api-explorer-panel > </devsite-concierge> </section></section> <devsite-sitemask></devsite-sitemask> <devsite-snackbar></devsite-snackbar> <devsite-tooltip ></devsite-tooltip> <devsite-heading-link></devsite-heading-link> <devsite-analytics> <script type="application/json" analytics>[{"dimensions": {"dimension6": "en", "dimension5": "en", "dimension1": "Signed out", "dimension4": "YouTube Analytics and Reporting APIs", "dimension11": false, "dimension3": false}, "gaid": "UA-24532603-1", "metrics": {"ratings_count": "metric2", "ratings_value": "metric1"}, "purpose": 1}]</script> <script type="application/json" tag-management>{"at": "True", "ga4": [{"id": "G-272J68FCRF", "purpose": 1}], "ga4p": [{"id": "G-272J68FCRF", "purpose": 1}], "gtm": [], "parameters": {"internalUser": "False", "language": {"machineTranslated": "False", "requested": "en", "served": "en"}, "pageType": "reference", "projectName": "YouTube Analytics and Reporting APIs", "signedIn": "False", "tenant": "developers", "recommendations": {"sourcePage": "", "sourceType": 0, "sourceRank": 0, "sourceIdenticalDescriptions": 0, "sourceTitleWords": 0, "sourceDescriptionWords": 0, "experiment": ""}, "experiment": {"ids": ""}}}</script> </devsite-analytics> <devsite-badger></devsite-badger> <script nonce="h5f/JN8kXLx8AqzjVXK94QQKqo0GGx"> (function(d,e,v,s,i,t,E){d['GoogleDevelopersObject']=i; t=e.createElement(v);t.async=1;t.src=s;E=e.getElementsByTagName(v)[0]; E.parentNode.insertBefore(t,E);})(window, document, 'script', 'https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/js/app_loader.js', '[1,"en",null,"/js/devsite_app_module.js","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers","https://developers-dot-devsite-v2-prod.appspot.com",null,null,["/_pwa/developers/manifest.json","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/images/video-placeholder.svg","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/favicon-new.png","https://fonts.googleapis.com/css?family=Google+Sans:400,500|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700&display=swap"],1,null,[1,6,8,12,14,17,21,25,50,52,63,70,75,76,80,87,91,92,93,97,98,100,101,102,103,104,105,107,108,109,110,112,113,116,117,118,120,122,124,125,126,127,129,130,131,132,133,134,135,136,138,140,141,147,148,149,151,152,156,157,158,159,161,163,164,168,169,170,179,180,182,183,186,191,193,196],"AIzaSyAP-jjEJBzmIyKR4F-3XITp8yM9T1gEEI8","AIzaSyB6xiKGDR5O3Ak2okS4rLkauxGUG7XP0hg","developers.google.com","AIzaSyAQk0fBONSGUqCNznf6Krs82Ap1-NV6J4o","AIzaSyCCxcqdrZ_7QMeLCRY20bh_SXdAYqy70KY",null,null,null,["Profiles__enable_developer_profiles_callout","CloudShell__cloud_code_overflow_menu","MiscFeatureFlags__developers_footer_dark_image","MiscFeatureFlags__enable_firebase_utm","Cloud__enable_cloud_shell_fte_user_flow","BookNav__enable_tenant_cache_key","Search__enable_ai_search_summaries_restricted","Profiles__enable_public_developer_profiles","DevPro__enable_cloud_innovators_plus","Analytics__enable_clearcut_logging","Profiles__enable_profile_collections","CloudShell__cloud_shell_button","MiscFeatureFlags__enable_explain_this_code","Experiments__reqs_query_experiments","Search__enable_ai_eligibility_checks","Profiles__enable_recognition_badges","Concierge__enable_pushui","MiscFeatureFlags__developers_footer_image","Search__enable_ai_search_summaries","Cloud__enable_cloudx_ping","Significatio__enable_by_tenant","Search__enable_page_map","Profiles__enable_complete_playlist_endpoint","Cloud__enable_cloud_dlp_service","Profiles__enable_release_notes_notifications","Cloud__enable_cloud_facet_chat","Concierge__enable_concierge","Profiles__enable_awarding_url","Profiles__enable_completecodelab_endpoint","Cloud__enable_llm_concierge_chat","Profiles__enable_dashboard_curated_recommendations","Cloud__enable_cloudx_experiment_ids","EngEduTelemetry__enable_engedu_telemetry","MiscFeatureFlags__enable_project_variables","Cloud__enable_legacy_calculator_redirect","Cloud__enable_cloud_shell","Cloud__enable_free_trial_server_call","Search__enable_suggestions_from_borg","TpcFeatures__enable_mirror_tenant_redirects","Search__enable_dynamic_content_confidential_banner","Profiles__enable_page_saving","DevPro__enable_developer_subscriptions","MiscFeatureFlags__enable_view_transitions","TpcFeatures__enable_required_headers","Concierge__enable_concierge_restricted","Profiles__require_profile_eligibility_for_signin","MiscFeatureFlags__emergency_css","MiscFeatureFlags__enable_variable_operator"],null,null,"AIzaSyBLEMok-5suZ67qRPzx0qUtbnLmyT_kCVE","https://developerscontentserving-pa.clients6.google.com","AIzaSyCM4QpTRSqP5qI4Dvjt4OAScIN8sOUlO-k","https://developerscontentsearch-pa.clients6.google.com",1,4,null,"https://developerprofiles-pa.clients6.google.com",[1,"developers","Google for Developers","developers.google.com",null,"developers-dot-devsite-v2-prod.appspot.com",null,null,[1,1,[1],null,null,null,null,null,null,null,null,[1],null,null,null,null,null,null,[1],[1,null,null,[1,20],"/recommendations/information"],null,null,null,[1,1,1],[1,1,null,1,1]],null,[null,null,null,null,null,null,"/images/lockup-new.svg","/images/touchicon-180-new.png",null,null,null,null,1,null,null,null,null,null,null,null,null,1,null,null,null,"/images/lockup-dark-theme-new.svg",[]],[],null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,[6,1,14,15,20,22,23,29,32,36],null,[[null,null,null,[3,7,10,2,39,17,4,32,24,11,12,13,34,15,25],null,null,[1,[["docType","Choose a content type",[["Tutorial",null,null,null,null,null,null,null,null,"Tutorial"],["Guide",null,null,null,null,null,null,null,null,"Guide"],["Sample",null,null,null,null,null,null,null,null,"Sample"]]],["product","Choose a product",[["Android",null,null,null,null,null,null,null,null,"Android"],["ARCore",null,null,null,null,null,null,null,null,"ARCore"],["ChromeOS",null,null,null,null,null,null,null,null,"ChromeOS"],["Firebase",null,null,null,null,null,null,null,null,"Firebase"],["Flutter",null,null,null,null,null,null,null,null,"Flutter"],["Assistant",null,null,null,null,null,null,null,null,"Google Assistant"],["GoogleCloud",null,null,null,null,null,null,null,null,"Google Cloud"],["GoogleMapsPlatform",null,null,null,null,null,null,null,null,"Google Maps Platform"],["GooglePay",null,null,null,null,null,null,null,null,"Google Pay & Google Wallet"],["GooglePlay",null,null,null,null,null,null,null,null,"Google Play"],["Tensorflow",null,null,null,null,null,null,null,null,"TensorFlow"]]],["category","Choose a topic",[["AiAndMachineLearning",null,null,null,null,null,null,null,null,"AI and Machine Learning"],["Data",null,null,null,null,null,null,null,null,"Data"],["Enterprise",null,null,null,null,null,null,null,null,"Enterprise"],["Gaming",null,null,null,null,null,null,null,null,"Gaming"],["Mobile",null,null,null,null,null,null,null,null,"Mobile"],["Web",null,null,null,null,null,null,null,null,"Web"]]]]]],[1,1],null,1],[[["UA-24532603-1"],["UA-22084204-5"],null,null,["UA-24532603-5"],null,null,[["G-272J68FCRF"],null,null,[["G-272J68FCRF",2]]],[["UA-24532603-1",2]],null,[["UA-24532603-5",2]],null,1],[[14,11],[11,8],[12,9],[16,13],[6,5],[3,2],[13,10],[15,12],[5,4],[1,1],[4,3]],[[1,1],[2,2]]],null,4,null,null,null,null,null,null,null,null,null,null,null,null,null,"developers.devsite.google"],null,"pk_live_5170syrHvgGVmSx9sBrnWtA5luvk9BwnVcvIi7HizpwauFG96WedXsuXh790rtij9AmGllqPtMLfhe2RSwD6Pn38V00uBCydV4m"]') </script> <devsite-a11y-announce></devsite-a11y-announce> </body> </html>

CINXE.COM

Dimensions | YouTube Analytics and Reporting APIs | Google for Developers