Dimensions | YouTube Analytics and Reporting APIs

<!doctype html> <html lang="en" dir="ltr"> <head><script type="text/javascript" src="/_static/js/bundle-playback.js?v=HxkREWBo" charset="utf-8"></script> <script type="text/javascript" src="/_static/js/wombat.js?v=txqj7nKC" charset="utf-8"></script> <script>window.RufflePlayer=window.RufflePlayer||{};window.RufflePlayer.config={"autoplay":"on","unmuteOverlay":"hidden"};</script> <script type="text/javascript" src="/_static/js/ruffle/ruffle.js"></script> <script type="text/javascript"> __wm.init("https://web.archive.org/web"); __wm.wombat("https://developers.google.com/youtube/reporting/v1/reports/dimensions","20210615082306","https://web.archive.org/","web","/_static/", "1623745386"); </script> <link rel="stylesheet" type="text/css" href="/_static/css/banner-styles.css?v=S1zqJCYt" /> <link rel="stylesheet" type="text/css" href="/_static/css/iconochive.css?v=3PDvdIFv" />  <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 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="/web/20210615082306/https://developers.google.com/_pwa/developers/manifest.json" crossorigin="use-credentials"> <link rel="preconnect" href="//web.archive.org/web/20210615082306/https://www.gstatic.com/" crossorigin> <link rel="preconnect" href="//web.archive.org/web/20210615082306/https://fonts.gstatic.com/" crossorigin> <link rel="preconnect" href="//web.archive.org/web/20210615082306/https://fonts.googleapis.com/" crossorigin> <link rel="preconnect" href="//web.archive.org/web/20210615082306/https://apis.google.com/" crossorigin> <link rel="preconnect" href="//web.archive.org/web/20210615082306/https://www.google-analytics.com/" crossorigin><link rel="stylesheet" href="//web.archive.org/web/20210615082306cs_/https://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="//web.archive.org/web/20210615082306cs_/https://fonts.googleapis.com/css?family=Material+Icons&display=block"><link rel="stylesheet" href="https://web.archive.org/web/20210615082306cs_/https://www.gstatic.com/devrel-devsite/prod/vacc2a2a4a4394c7c42dc62dba69eb022d7680ce4a368d4b28c3e984cc9155a81/developers/css/app.css"><link rel="shortcut icon" href="https://web.archive.org/web/20210615082306im_/https://www.gstatic.com/devrel-devsite/prod/vacc2a2a4a4394c7c42dc62dba69eb022d7680ce4a368d4b28c3e984cc9155a81/developers/images/favicon.png"> <link rel="apple-touch-icon" href="https://web.archive.org/web/20210615082306im_/https://www.gstatic.com/devrel-devsite/prod/vacc2a2a4a4394c7c42dc62dba69eb022d7680ce4a368d4b28c3e984cc9155a81/developers/images/touchicon-180.png"><link rel="canonical" href="https://web.archive.org/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/dimensions"><link rel="search" type="application/opensearchdescription+xml" title="Google Developers" href="https://web.archive.org/web/20210615082306/https://developers.google.com/s/opensearch.xml"> <title>Dimensions  |  YouTube Analytics and Reporting APIs  |  Google Developers</title> <meta property="og:title" content="Dimensions | YouTube Analytics and Reporting APIs | Google Developers"><meta property="og:url" content="https://web.archive.org/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/dimensions"><meta property="og:image" content="https://web.archive.org/web/20210615082306im_/https://www.gstatic.com/devrel-devsite/prod/vacc2a2a4a4394c7c42dc62dba69eb022d7680ce4a368d4b28c3e984cc9155a81/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://web.archive.org/web/20210615082306/https://schema.org", "@type": "BreadcrumbList", "itemListElement": [{ "@type": "ListItem", "position": 1, "name": "YouTube", "item": "https://web.archive.org/web/20210615082306/https://developers.google.com/youtube" },{ "@type": "ListItem", "position": 2, "name": "Analytics and Reporting APIs", "item": "https://web.archive.org/web/20210615082306/https://developers.google.com/youtube/analytics" },{ "@type": "ListItem", "position": 3, "name": "Dimensions", "item": "https://web.archive.org/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/dimensions" }] } </script> </head> <body class="docs" template="page" theme="youtube-theme" type="reference" layout="docs" pending> <devsite-progress type="indeterminate" id="app-progress"></devsite-progress> <section class="devsite-wrapper"><devsite-header> <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://web.archive.org/web/20210615082306/https://developers.google.com/youtube"> <div class="devsite-product-logo-container" size="medium"> <img class="devsite-product-logo" alt="YouTube" src="https://web.archive.org/web/20210615082306im_/https://developers.google.com/site-assets/logo-youtube.svg" srcset="" sizes="64px" loading="lazy"> </div> </a> <span class="devsite-product-name"> <ul class="devsite-breadcrumb-list" aria-label="Product breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://web.archive.org/web/20210615082306/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://web.archive.org/web/20210615082306/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 aria-expanded="false" aria-haspopup="listbox" enable-signin enable-search enable-suggestions enable-query-completion project-name="YouTube Analytics and Reporting APIs" tenant-name="Google Developers" project-scope="/youtube/analytics" url-scoped="https://developers.google.com/s/results/youtube/analytics" role="combobox"> <form class="devsite-search-form" action="https://web.archive.org/web/20210615082306/https://developers.google.com/s/results" method="GET"> <div class="devsite-search-container"> <div class="devsite-searchbox"> <input aria-activedescendant="" aria-autocomplete="list" aria-label="Search" aria-haspopup="false" aria-multiline="false" aria-label="Search box" 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> <button type="button" search-open class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Open search"></button> </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> <devsite-select class="devsite-language-selector-menu"> <select aria-label="Select your language preference." class="devsite-language-selector-select" name="language" track-name="click" track-type="languageSelector"> <option>Language</option> <option value="en" lang="en" track-metadata-original-language="en" track-metadata-selected-language="en" track-name="changed" track-type="languageSelector"> English </option> <option value="id" lang="id" track-metadata-original-language="en" track-metadata-selected-language="id" track-name="changed" track-type="languageSelector"> Bahasa Indonesia </option> <option value="de" lang="de" track-metadata-original-language="en" track-metadata-selected-language="de" track-name="changed" track-type="languageSelector"> Deutsch </option> <option value="es" lang="es" track-metadata-original-language="en" track-metadata-selected-language="es" track-name="changed" track-type="languageSelector"> Español </option> <option value="fr" lang="fr" track-metadata-original-language="en" track-metadata-selected-language="fr" track-name="changed" track-type="languageSelector"> Français </option> <option value="pt_br" lang="pt_br" track-metadata-original-language="en" track-metadata-selected-language="pt_br" track-name="changed" track-type="languageSelector"> Português – Brasil </option> <option value="ru" lang="ru" track-metadata-original-language="en" track-metadata-selected-language="ru" track-name="changed" track-type="languageSelector"> Русский </option> <option value="zh_cn" lang="zh_cn" track-metadata-original-language="en" track-metadata-selected-language="zh_cn" track-name="changed" track-type="languageSelector"> 中文 – 简体 </option> <option value="ja" lang="ja" track-metadata-original-language="en" track-metadata-selected-language="ja" track-name="changed" track-type="languageSelector"> 日本語 </option> <option value="ko" lang="ko" track-metadata-original-language="en" track-metadata-selected-language="ko" track-name="changed" track-type="languageSelector"> 한국어 </option> </select> </devsite-select> </devsite-language-selector> <devsite-user enable-profiles fp-auth id="devsite-user"></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://web.archive.org/web/20210615082306/https://developers.google.com/youtube/analytics" class="gc-analytics-event " track-type="globalNav" track-metadata-position="nav" track-metadata-eventdetail="nav" track-name="home" data-category="Site-Wide Custom Events" data-label="Tab: Home"> Home </a> </tab> <tab> <a href="https://web.archive.org/web/20210615082306/https://developers.google.com/youtube/reporting" class="gc-analytics-event " track-type="globalNav" track-metadata-position="nav" track-metadata-eventdetail="nav" track-name="overview" data-category="Site-Wide Custom Events" data-label="Tab: Overview"> Overview </a> </tab> <tab> <a href="https://web.archive.org/web/20210615082306/https://developers.google.com/youtube/reporting/guides/authorization" class="gc-analytics-event " track-type="globalNav" track-metadata-position="nav" track-metadata-eventdetail="nav" track-name="authorization" data-category="Site-Wide Custom Events" data-label="Tab: Authorization"> Authorization </a> </tab> <tab active> <a href="https://web.archive.org/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports" class="gc-analytics-event " track-type="globalNav" track-metadata-position="nav" track-metadata-eventdetail="nav" track-name="bulkReports" aria-label="Bulk Reports, selected" data-category="Site-Wide Custom Events" data-label="Tab: Bulk Reports"> Bulk Reports </a> </tab> <tab> <a href="https://web.archive.org/web/20210615082306/https://developers.google.com/youtube/analytics/data_model" class="gc-analytics-event " track-type="globalNav" track-metadata-position="nav" track-metadata-eventdetail="nav" track-name="targetedQueries" data-category="Site-Wide Custom Events" data-label="Tab: Targeted Queries"> Targeted Queries </a> </tab> <tab> <a href="https://web.archive.org/web/20210615082306/https://developers.google.com/youtube/reporting/v1/code_samples" class="gc-analytics-event " track-type="globalNav" track-metadata-position="nav" track-metadata-eventdetail="nav" track-name="resources" data-category="Site-Wide Custom Events" data-label="Tab: Resources"> Resources </a> </tab> </nav> </devsite-tabs> </div> </div> </div> </div> </devsite-header> <devsite-book-nav scrollbars> <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://web.archive.org/web/20210615082306/https://developers.google.com/youtube"> <div class="devsite-product-logo-container" size="medium"> <img class="devsite-product-logo" alt="YouTube" src="https://web.archive.org/web/20210615082306im_/https://developers.google.com/site-assets/logo-youtube.svg" srcset="" sizes="64px" loading="lazy"> </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://web.archive.org/web/20210615082306/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://web.archive.org/web/20210615082306/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="/web/20210615082306/https://developers.google.com/youtube/analytics" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Home" track-type="navMenu" track-metadata-eventdetail="globalMenu" track-metadata-position="nav" track-name="home"> <span class="devsite-nav-text" tooltip> Home </span> </a> </li> <li class="devsite-nav-item"> <a href="/web/20210615082306/https://developers.google.com/youtube/reporting" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Overview" track-type="navMenu" track-metadata-eventdetail="globalMenu" track-metadata-position="nav" track-name="overview"> <span class="devsite-nav-text" tooltip> Overview </span> </a> </li> <li class="devsite-nav-item"> <a href="/web/20210615082306/https://developers.google.com/youtube/reporting/guides/authorization" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Authorization" track-type="navMenu" track-metadata-eventdetail="globalMenu" track-metadata-position="nav" track-name="authorization"> <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="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports" class="devsite-nav-title gc-analytics-event devsite-nav-has-children devsite-nav-active" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Bulk Reports" track-type="navMenu" track-metadata-eventdetail="globalMenu" track-metadata-position="nav" track-name="bulkReports"> <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="/web/20210615082306/https://developers.google.com/youtube/analytics/data_model" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Targeted Queries" track-type="navMenu" track-metadata-eventdetail="globalMenu" track-metadata-position="nav" track-name="targetedQueries"> <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="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/code_samples" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Resources" track-type="navMenu" track-metadata-eventdetail="globalMenu" track-metadata-position="nav" track-name="resources"> <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" role="navigation"> <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 Reporting 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>Bulk Data for YouTube Analytics</span></div></li> <li class="devsite-nav-item"><a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li> <li class="devsite-nav-item"><a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/dimensions" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Dimensions</span></a></li> <li class="devsite-nav-item"><a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/metrics" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Metrics</span></a></li> <li class="devsite-nav-item"><a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/channel_reports" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Channel Reports</span></a></li> <li class="devsite-nav-item"><a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/content_owner_reports" class="devsite-nav-title"><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>System-Managed Reports</span></div></li> <li class="devsite-nav-item"><a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/system_managed" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</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="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reference/rest" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>Jobs</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reference/rest/v1/jobs" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reference/rest/v1/jobs/create" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>create</span></a></li><li class="devsite-nav-item"><a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reference/rest/v1/jobs/delete" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>delete</span></a></li><li class="devsite-nav-item"><a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reference/rest/v1/jobs/get" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>get</span></a></li><li class="devsite-nav-item"><a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reference/rest/v1/jobs/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>Reports</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reference/rest/v1/jobs.reports" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reference/rest/v1/jobs.reports/get" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>get</span></a></li><li class="devsite-nav-item"><a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reference/rest/v1/jobs.reports/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <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>ReportTypes</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reference/rest/v1/reportTypes" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reference/rest/v1/reportTypes/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-break"></li> <li class="devsite-nav-item"><a href="/web/20210615082306/https://developers.google.com/youtube/reporting/revision_history" class="devsite-nav-title"><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 has-toc> <devsite-toc class="devsite-nav"></devsite-toc> <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://web.archive.org/web/20210615082306/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://web.archive.org/web/20210615082306/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://web.archive.org/web/20210615082306/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://web.archive.org/web/20210615082306/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://web.archive.org/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports" 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=""> Bulk Reports </a> </li> </ul> <devsite-thumb-rating position="header"> <template class="thumb-down-categories"> [{ "type": "thumb-down", "id": "missingTheInformationINeed", "label":"Missing the information I need" },{ "type": "thumb-down", "id": "tooComplicatedTooManySteps", "label":"Too complicated / too many steps" },{ "type": "thumb-down", "id": "outOfDate", "label":"Out of date" },{ "type": "thumb-down", "id": "samplesCodeIssue", "label":"Samples/Code issue" },{ "type": "thumb-down", "id": "otherDown", "label":"Other" }] </template> <template class="thumb-up-categories"> [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Easy to understand" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Solved my problem" },{ "type": "thumb-up", "id": "otherUp", "label":"Other" }] </template> </devsite-thumb-rating> </div> <h1 class="devsite-page-title">Dimensions<devsite-bookmark></devsite-bookmark></h1> <devsite-toc class="devsite-nav" 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 Reporting API</b> supports. This API retrieves bulk reports that contain YouTube Analytics data for a channel or content owner.</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 bulk report supports a predefined list of dimensions, and, in any report, each row of data has a unique combination of dimension values. As such, each row's combination of dimension values functions as the primary key for that row. You neither need to specify nor have the option of specifying which dimensions are included in the report.</p> <h2 id="Core_Dimensions" data-text="Core dimensions">Core dimensions</h2> <p>While the YouTube Reporting API is subject to the Deprecation Policy defined in the <a href="/web/20210615082306/https://developers.google.com/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. All of them are also core dimensions in the YouTube Analytics API. </p> <style> span.deprecated { color: #d50000; font-size: 14px; } </style> <ul> <li><code translate="no" dir="ltr"><a href="#age_group">age_group</a></code></li> <li><code translate="no" dir="ltr"><a href="#channel_id">channel_id</a></code></li> <li><code translate="no" dir="ltr"><a href="#country_code">country_code</a></code></li> <li><code translate="no" dir="ltr"><a href="#date">date</a></code></li> <li><code translate="no" dir="ltr"><a href="#gender">gender</a></code></li> <li><code translate="no" dir="ltr"><a href="#sharing_service">sharing_service</a></code></li> <li><code translate="no" dir="ltr"><a href="#uploader_type">uploader_type</a></code></li> <li><code translate="no" dir="ltr"><a href="#video_id">video_id</a></code></li> </ul> <p>See the list of <a href="/web/20210615082306/https://developers.google.com/youtube/youtube-api-list">YouTube APIs subject to the Deprecation Policy</a> for more information.</p> <h2 id="Dimensions" data-text="Dimensions">Dimensions</h2> <p>The following sections define the dimensions that are used in the YouTube Reporting API's bulk reports. Unless otherwise noted, these dimensions are used in both <a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/channel_reports">channel</a> and <a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/content_owner_reports">content owner</a> reports.</p> <h3 id="Resource_Dimensions" data-text="Resources">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_id">video_id</a></code></li> <li><code translate="no" dir="ltr"><a href="#playlist_id">playlist_id</a></code></li> <li><code translate="no" dir="ltr"><a href="#channel_id">channel_id</a></code></li> <li><code translate="no" dir="ltr"><a href="#asset_id">asset_id</a></code></li> </ul> <dl> <dt id="video_id" class="notranslate"><span itemprop="property">video_id</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="/web/20210615082306/https://developers.google.com/youtube/v3/docs/videos#id">id</a></code> property. <span class="notranslate">This is a core dimension and is subject to the <a href="/web/20210615082306/https://developers.google.com/youtube/youtube-api-list">Deprecation Policy</a>.</dd> <dt id="playlist_id" class="notranslate"><span itemprop="property">playlist_id</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="/web/20210615082306/https://developers.google.com/youtube/v3/docs/playlists#id">id</a></code> property.</dd> <dt id="channel_id" class="notranslate"><span itemprop="property">channel_id</span> <span style="color: #555">(core dimension)</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="/web/20210615082306/https://developers.google.com/youtube/v3/docs/channels#id">id</a></code> property. <span class="notranslate">This is a core dimension and is subject to the <a href="/web/20210615082306/https://developers.google.com/youtube/youtube-api-list">Deprecation Policy</a>.</span> </dd> <dt id="asset_id" class="notranslate"><span itemprop="property">asset_id</span> <span style="color: #555">(only used in content owner reports)</span></dt> <dd>The ID of an asset managed in YouTube's Content ID system. An asset is the representation of your intellectual property in that system. On the YouTube website, you can locate asset IDs in YouTube Content Manager. You can also retrieve them using the YouTube Content ID API.</dd> </dl> <h3 id="Geographic_Dimensions" data-text="Geographic areas">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_code" class="notranslate"><span itemprop="property">country_code</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="/web/20210615082306/https://developers.google.com/youtube/youtube-api-list">Deprecation Policy</a>.</span></dd> <dt id="province_code" class="notranslate"><span itemprop="property">province_code</span></dt> <dd>The U.S. state or territory associated with the metrics in the report row. The dimension values is an <a href="https://web.archive.org/web/20210615082306/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. <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> </dl> <h3 id="Temporal_Dimensions" data-text="Time periods">Time periods</h3> <dl> <dt id="date" class="notranslate"><span itemprop="property">date</span> <span style="color: #555">(core dimension)</span></dt> <dd>This dimension identifies the date associated with the metrics in each report row. In bulk reports, the date refers to the period beginning at 12:00 a.m. <b>Pacific time</b> and ending at 11:59 p.m. Pacific time on the specified day, month, and year. Depending on the time of year, Pacific time is either UTC-7 or UTC-8.<br><br> Note that while dates typically represent a 24-hour period, 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.</dd> <span class="notranslate">This is a core dimension and is subject to the <a href="/web/20210615082306/https://developers.google.com/youtube/youtube-api-list">Deprecation Policy</a>.</span></dd> </dl> <h3 id="Playback_Location_Dimensions" data-text="Playback locations">Playback locations</h3> <p>These dimensions provide insight about the page or application where user activity occurred.</p> <dl> <dt id="playback_location_type" class="notranslate"><span itemprop="property">playback_location_type</span></dt> <dd> This dimension identifies the type of page or application where user activity occurred. 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">0</code></td> <td>The data pertains to activity that occurred on the video's YouTube watch page or in an official YouTube application, such as the YouTube Android app.</td> </tr> <tr> <td><code translate="no" dir="ltr">1</code></td> <td>The data pertains to activity 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.</td> </tr> <tr> <td><code translate="no" dir="ltr">2</code></td> <td>The data pertains to activity that occurred on a YouTube channel page.</td> </tr> <tr> <td><code translate="no" dir="ltr">5</code></td> <td>The data pertains to metrics that cannot be classified into one of the other location types listed above.</td> </tr> <tr> <td><code translate="no" dir="ltr">7</code></td> <td>The data pertains to views that took place on the YouTube home page or home screen, in the user's subscription feed, or in another YouTube browsing feature.</td> <tr> <td><code translate="no" dir="ltr">8</code></td> <td>The data pertains to views that took place directly on the YouTube search results page.</td> </table> <dt id="playback_location_detail" class="notranslate"><span itemprop="property">playback_location_detail</span></dt> <dd>This dimension specifies the URL or application where the playback occurred. This dimension is only supported for views that occurred in embedded players, which means that the dimension value is only populated in rows where the dimension's value is <code translate="no" dir="ltr">1</code>. In other rows, this dimension's value is empty.</dd> </dl> <h3 id="Playback_Detail_Dimensions" data-text="Playback details">Playback details</h3> <dl> <dt id="live_or_on_demand" class="notranslate"><span itemprop="property">live_or_on_demand</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>onDemand</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="subscribed_status" class="notranslate"><span itemprop="property">subscribed_status</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">subscribed_status</code> value of <code translate="no" dir="ltr">subscribed</code>, and one view has a <code translate="no" dir="ltr">subscribed_status</code> value of <code translate="no" dir="ltr">unsubscribed</code>. </dd> </dl> <h3 id="Traffic_Source_Dimensions" data-text="Traffic sources">Traffic sources</h3> <dl> <dt id="traffic_source_type" class="notranslate"><span itemprop="property">traffic_source_type</span></dt> <dd>This dimension identifies the referrer type associated with the user activity metrics. The referrer type describes the manner in which users reached the video or channel associated with the row of data in the report. 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">0</code></td> <td><b>Direct or unknown</b><br>This value encompasses direct traffic to a page as well as pages for which the referrer is unknown. In query reports, this traffic source type is identified as <code translate="no" dir="ltr">NO_LINK_OTHER</code> or <code translate="no" dir="ltr">UNKNOWN_MOBILE_OR_DIRECT</code>.</td> </tr> <tr> <td><code translate="no" dir="ltr">1</code></td> <td><b>YouTube advertising</b><br>The viewer was referred to the video by an advertisement. In a traffic source report, if this dimension's value is <code translate="no" dir="ltr">1</code>, then the <a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/dimensions#traffic_source_detail">traffic_source_detail</a> dimension identifies the type of advertisement that was shown to the viewer. In query reports, this traffic source type is identified as <code translate="no" dir="ltr">ADVERTISING</code>. Possible values are: <table class="responsive"> <tr> <th colspan="2">Values</th> </tr> <tr> <td><code translate="no" dir="ltr"><strong>ctp_engagement_ad</strong></code></td> <td>Click-to-play engagement ad</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>engagement_ad</strong></code></td> <td>Engagement ad</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>googlemediaads</strong></code></td> <td>Google search ads</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>insearch_display</strong></code></td> <td>TrueView in-search and in-display</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>instream</strong></code></td> <td>TrueView in-stream</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>instream-select</strong></code></td> <td>Reserved skippable in-stream</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>unknown</strong></code></td> <td>Uncategorized YouTube advertising</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>video_wall</strong></code></td> <td>Video wall</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>yva</strong></code></td> <td>Homepage video ad</td> </tr> </table> </td> </tr> <tr> <td><code translate="no" dir="ltr">3</code></td> <td><b>Browse features</b><br>The viewer was referred from a YouTube page that leads to videos or channels. In a traffic source report, if this dimension's value is <code translate="no" dir="ltr">3</code>, then the <a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/dimensions#traffic_source_detail">traffic_source_detail</a> dimension identifies the feature that referred the traffic. In query reports, this traffic source type is identified as <code translate="no" dir="ltr">SUBSCRIBER</code>. Possible values are: <table class="responsive details"> <tr> <th colspan="2">Values</th> </tr> <tr> <td><code translate="no" dir="ltr"><strong>explore</strong></code></td> <td>Kids: explore</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>learning</strong></code></td> <td>Kids: learning</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>music</strong></code></td> <td>Music feed</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>my-history</strong></code></td> <td>Watch history</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>my-subscriptions</strong></code></td> <td>My subscriptions</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>my-uploads</strong></code></td> <td>My uploads</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>shows</strong></code></td> <td>Kids: shows</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>watch-later</strong></code></td> <td>Watch later</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>what-to-watch</strong></code></td> <td>What to watch</td> </tr> </table> </td> </tr> <tr> <td><code translate="no" dir="ltr">4</code></td> <td><b>YouTube channels</b><br>Viewers were referred from a YouTube channel page. In a traffic source report, if this dimension's value is <code translate="no" dir="ltr">4</code>, then the <a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/dimensions#traffic_source_detail">traffic_source_detail</a> dimension specifies the channel ID for that channel. In query reports, this traffic source type is identified as <code translate="no" dir="ltr">YT_CHANNEL</code>.</td> </tr> <tr> <td><code translate="no" dir="ltr">5</code></td> <td><b>YouTube search</b><br>Viewers were referred from YouTube search results. In a traffic source report, if this dimension's value is <code translate="no" dir="ltr">5</code>, then the <a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/dimensions#traffic_source_detail">traffic_source_detail</a> dimension specifies the associated search term. In query reports, this traffic source type is identified as <code translate="no" dir="ltr">YT_SEARCH</code>.</td> </tr> <tr> <td><code translate="no" dir="ltr">7</code></td> <td><b>Suggested videos</b><br>Viewers were referred from a related video listing on another video watch page. In a traffic source report, if this dimension's value is <code translate="no" dir="ltr">7</code>, then the <a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/dimensions#traffic_source_detail">traffic_source_detail</a> dimension identifies the video ID for that video. In query reports, this traffic source type is identified as <code translate="no" dir="ltr">RELATED_VIDEO</code> or <code translate="no" dir="ltr">YT_RELATED</code>.</td> </tr> <tr> <td><code translate="no" dir="ltr">8</code></td> <td><b>Other YouTube features</b><br>Viewers were referred from a YouTube page that does not fall into one of the other listed traffic source types. In a traffic source report, if this dimension's value is <code translate="no" dir="ltr">8</code>, then the <a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/dimensions#traffic_source_detail">traffic_source_detail</a> dimension identifies the page URL. In query reports, this traffic source type is identified as <code translate="no" dir="ltr">YT_OTHER_PAGE</code>. Possible values are: <table class="responsive details"> <tr> <th colspan="2">Values</th> </tr> <tr> <td><code translate="no" dir="ltr"><strong>g-crec</strong></code></td> <td>Recommended channels</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>offline</strong></code></td> <td>Offline</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>promotion</strong></code></td> <td>Partner promotion</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>unknown</strong></code></td> <td>Unknown</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>widget</strong></code></td> <td>Android homescreen widget</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>youtu.be</strong></code></td> <td>youtu.be</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>ytremote</strong></code></td> <td>YouTube Remote</td> </tr> </table> </td> </tr> <tr> <td><code translate="no" dir="ltr">9</code></td> <td><b>External</b><br>Viewers were referred from a link on another website. This traffic source includes referrals from Google search results. In a traffic source report, if this dimension's value is <code translate="no" dir="ltr">9</code>, then the <a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/dimensions#traffic_source_detail">traffic_source_detail</a> dimension identifies the external web page. In query reports, this traffic source type is identified as <code translate="no" dir="ltr">EXT_URL</code>.</td> </tr> <tr> <td><code translate="no" dir="ltr">11</code></td> <td><b>Video cards and annotations</b><br>Viewers were referred by clicking on an annotation or card in another video. In query reports, this traffic source type is identified as <code translate="no" dir="ltr">ANNOTATION</code>.</td> </tr> <tr> <td><code translate="no" dir="ltr">14</code></td> <td><b>Playlists</b><br>Views occurred while the video was being played as part of a playlist. In query reports, this traffic source type is identified as <code translate="no" dir="ltr">PLAYLIST</code>.<br><br>Note that this traffic source differs from source type <code translate="no" dir="ltr">18</code>, which indicates that the views originated from the page that <em>lists</em> all of the videos in the playlist.</td> </tr> <tr> <td><code translate="no" dir="ltr">17</code></td> <td><b>Notifications</b><br> Viewers were referred from an email or notification from YouTube. In query reports, this traffic source type is identified as <code translate="no" dir="ltr">NOTIFICATION</code>. Possible values are: <table class="responsive details"> <tr> <th colspan="2">Values</th> </tr> <tr> <td><code translate="no" dir="ltr"><strong>inbox</strong></code></td> <td></td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>push</strong></code></td> <td></td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>sdig</strong></code></td> <td>Views originated from notifications that were part of the subscriber digest</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>uploaded_other</strong></code></td> <td>Views originated from non-push notifications, such as email or Inbox notifications, sent to subscribers when a video was uploaded</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>uploaded_push</strong></code></td> <td>Views originated from push notifications sent to subscribers when a video was uploaded</td> </tr> </table> </td> </tr> <tr> <td><code translate="no" dir="ltr">18</code></td> <td><b>Playlist pages</b><br>Views originated from a page that lists all of the videos in a playlist. In query reports, this traffic source type is identified as <code translate="no" dir="ltr">YT_PLAYLIST_PAGE</code>.<br><br>Note that this traffic source differs from source type <code translate="no" dir="ltr">14</code>, which indicates that the views occurred while the video was being played as part of a playlist.</td> </tr> <tr> <td><code translate="no" dir="ltr">19</code></td> <td><b>Programming from claimed content</b><br>Views originated from claimed, user-uploaded videos that the content owner used to promote the viewed content. In query reports, this traffic source is identified as <code translate="no" dir="ltr">CAMPAIGN_CARD</code>. This traffic source is only supported for content owner reports.</td> </tr> <tr> <td><code translate="no" dir="ltr">20</code></td> <td><b>Interactive video endscreen</b><br>Views originated from the endscreen of another video. In query reports, this traffic source type is identified as <code translate="no" dir="ltr">END_SCREEN</code>.</td> </tr> <tr> <td><code translate="no" dir="ltr">23</code></td> <td><b>Stories</b><br>The viewer was referred by swiping vertically from the previous video in the Stories viewing experience.</td> </tr> <tr> <td><code translate="no" dir="ltr">24</code></td> <td><b>Shorts</b><br>The viewer was referred by swiping vertically from the previous video in the Shorts viewing experience.</td> </tr> <tr> <td><code translate="no" dir="ltr">25</code></td> <td><b>Product Pages</b><br>Videos on a product page brought viewers to another channel.</td> </tr> </table> </dd> <dt id="traffic_source_detail" class="notranslate"><span itemprop="property">traffic_source_detail</span></dt> <dd>This dimension provides additional detail about the traffic source that the row's <a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/dimensions#Traffic_Source_Dimensions">traffic_source_type</a> dimension value. This dimension value is populated for the following <a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/dimensions#Traffic_Source_Dimensions">traffic_source_type</a> dimension values: <ul> <li><code translate="no" dir="ltr"><strong>1</strong></code> – The dimension value identifies the type of advertisement that was shown to the viewer. See the <a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/dimensions#Traffic_Source_Dimensions">traffic_source_type</a> definition for a list of possible values.</li> <li><code translate="no" dir="ltr"><strong>3</strong></code> – The dimension value identifies the YouTube feature that led to the referred traffic. See the <a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/dimensions#Traffic_Source_Dimensions">traffic_source_type</a> definition for a list of possible values.</li> <li><code translate="no" dir="ltr"><strong>4</strong></code> – The dimension value specifies the channel ID from which the viewer was referred.</li> <li><code translate="no" dir="ltr"><strong>5</strong></code> – The dimension value specifies the search term that led to the referred traffic.</li> <li><code translate="no" dir="ltr"><strong>7</strong></code> – The dimension value identifies the video from which the viewer was referred.</li> <li><code translate="no" dir="ltr"><strong>8</strong></code> – The dimension value identifies the type of YouTube page that led to the referred traffic. See the <a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/dimensions#Traffic_Source_Dimensions">traffic_source_type</a> definition for a list of possible values.</li> <li><code translate="no" dir="ltr"><strong>9</strong></code> – The dimension value identifies the external page from which the traffic was referred.</li> <li><code translate="no" dir="ltr"><strong>17</strong></code> – The dimension value identifies the type of notification that led to the referred traffic. See the <a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/dimensions#Traffic_Source_Dimensions">traffic_source_type</a> definition for a list of possible values.</li> <li><code translate="no" dir="ltr"><strong>19</strong></code> – The dimension value identifies the video from which the viewer was referred.</li> <li><code translate="no" dir="ltr"><strong>20</strong></code> – The dimension value identifies the video from which the viewer was referred.</li> <li><code translate="no" dir="ltr"><strong>25</strong></code> – The dimension value identifies the product ID, which is a Google Knowledge Graph ID.</li> </ul> </dd> </dl> <h3 id="Device_Dimensions" data-text="Devices">Devices</h3> <dl> <dt id="device_type" class="notranslate"><span itemprop="property">device_type</span></dt> <dd>This dimension identifies the physical form factor of the device on which the view occurred. The following table lists valid dimension values:<br> <table class="responsive details"> <tr> <th colspan="2">Values</th> </tr> <tr> <td><code translate="no" dir="ltr">100</code></td> <td>Unknown</td> </tr> <tr> <td><code translate="no" dir="ltr">101</code></td> <td>Computer</td> </tr> <tr> <td><code translate="no" dir="ltr">102</code></td> <td>TV</td> </tr> <tr> <td><code translate="no" dir="ltr">103</code></td> <td>Game console</td> </tr> <tr> <td><code translate="no" dir="ltr">104</code></td> <td>Mobile phone</td> </tr> <tr> <td><code translate="no" dir="ltr">105</code></td> <td>Tablet</td> </tr> </table> </dd> <dt id="operating_system" class="notranslate"><span itemprop="property">operating_system</span></dt> <dd>This dimension identifies the software system of the device on which the view occurred. The following table lists valid dimension values:<br> <table class="responsive details"> <tr> <th colspan="2">Values</th> </tr> <tr> <td><code translate="no" dir="ltr">1</code></td> <td>Other</td> </tr> <tr> <td><code translate="no" dir="ltr">2</code></td> <td>Windows</td> </tr> <tr> <td><code translate="no" dir="ltr">3</code></td> <td>Windows Mobile</td> </tr> <tr> <td><code translate="no" dir="ltr">4</code></td> <td>Android</td> </tr> <tr> <td><code translate="no" dir="ltr">5</code></td> <td>iOS</td> </tr> <tr> <td><code translate="no" dir="ltr">6</code></td> <td>Symbian</td> </tr> <tr> <td><code translate="no" dir="ltr">7</code></td> <td>Blackberry</td> </tr> <tr> <td><code translate="no" dir="ltr">9</code></td> <td>Macintosh</td> </tr> <tr> <td><code translate="no" dir="ltr">10</code></td> <td>PlayStation</td> </tr> <tr> <td><code translate="no" dir="ltr">11</code></td> <td>Bada</td> </tr> <tr> <td><code translate="no" dir="ltr">12</code></td> <td>WebOS</td> </tr> <tr> <td><code translate="no" dir="ltr">13</code></td> <td>Linux</td> </tr> <tr> <td><code translate="no" dir="ltr">14</code></td> <td>Hiptop</td> </tr> <tr> <td><code translate="no" dir="ltr">15</code></td> <td>MeeGo</td> </tr> <tr> <td><code translate="no" dir="ltr">16</code></td> <td>Wii</td> </tr> <tr> <td><code translate="no" dir="ltr">17</code></td> <td>Xbox</td> </tr> <tr> <td><code translate="no" dir="ltr">18</code></td> <td>PlayStation Vita</td> </tr> <tr> <td><code translate="no" dir="ltr">19</code></td> <td>Smart TV</td> </tr> <tr> <td><code translate="no" dir="ltr">20</code></td> <td>Nintendo 3DS</td> </tr> <tr> <td><code translate="no" dir="ltr">21</code></td> <td>Chromecast</td> </tr> <tr> <td><code translate="no" dir="ltr">22</code></td> <td>Tizen</td> </tr> <tr> <td><code translate="no" dir="ltr">23</code></td> <td>Firefox</td> </tr> <tr> <td><code translate="no" dir="ltr">24</code></td> <td>RealMedia</td> </tr> <tr> <td><code translate="no" dir="ltr">25</code></td> <td>KaiOS</td> </tr> <tr> <td><code translate="no" dir="ltr">26</code></td> <td>Roku</td> </tr> <tr> <td><code translate="no" dir="ltr">27</code></td> <td>Nintendo Switch</td> </tr> <tr> <td><code translate="no" dir="ltr">28</code></td> <td>Apple tvOS</td> </tr> <tr> <td><code translate="no" dir="ltr">29</code></td> <td>Fire OS</td> </tr> <tr> <td><code translate="no" dir="ltr">31</code></td> <td>Vidaa</td> </tr> </table> </table> </dd> </dl> <h3 id="Demographic_Dimensions" data-text="Demographics">Demographics</h3> <p>Demographic dimensions help you to understand the age range and gender distribution of your audience. The <a href="https://web.archive.org/web/20210615082306/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="age_group" class="notranslate"><span itemprop="property">age_group</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><code class="notranslate" dir="ltr">AGE_13_17</code></li> <li><code class="notranslate" dir="ltr">AGE_18_24</code></li> <li><code class="notranslate" dir="ltr">AGE_25_34</code></li> <li><code class="notranslate" dir="ltr">AGE_35_44</code></li> <li><code class="notranslate" dir="ltr">AGE_45_54</code></li> <li><code class="notranslate" dir="ltr">AGE_55_64</code></li> <li><code class="notranslate" dir="ltr">AGE_65_</code></li> </ul> <span class="notranslate">This is a core dimension and is subject to the <a href="/web/20210615082306/https://developers.google.com/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">GENDER_OTHER</code>.<br><br>Note that the YouTube Analytics API currently only returns the values <code translate="no" dir="ltr">female</code> and <code translate="no" dir="ltr">male</code>. As such, you may see some discrepancy in the <a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/metrics#views_percentage">views_percentage</a> metric values that the two APIs return. (In the YouTube Analytics API, <a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/metrics#views_percentage">views_percentage</a> is called <code translate="no" dir="ltr">viewerPercentage</code>.)<br><br> <span class="notranslate">This is a core dimension and is subject to the <a href="/web/20210615082306/https://developers.google.com/youtube/youtube-api-list">Deprecation Policy</a>.</span></dd> </dl> <h3 id="Social_Dimensions" data-text="Engagement and content sharing">Engagement and content sharing</h3> <dl> <dt id="sharing_service" class="notranslate"><span itemprop="property">sharing_service</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="/web/20210615082306/https://developers.google.com/youtube/youtube-api-list">Deprecation Policy</a>.</span><br> <br>The following table lists valid dimension values:<br> <table class="responsive details"> <tr> <th colspan="2">Values</th> </tr> <tr> <td><code translate="no" dir="ltr"><strong>0</strong></code></td> <td>Unknown</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>1</strong></code></td> <td>Digg</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>4</strong></code></td> <td>reddit</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>5</strong></code></td> <td>StumbleUpon</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>6</strong></code></td> <td>mixi</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>7</strong></code></td> <td>Yahoo! Japan</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>8</strong></code></td> <td>goo</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>9</strong></code></td> <td>Ameba</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>10</strong></code></td> <td>Facebook</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>11</strong></code></td> <td>Myspace</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>12</strong></code></td> <td>NUjij</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>18</strong></code></td> <td>Tuenti</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>20</strong></code></td> <td>menéame</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>21</strong></code></td> <td>Wykop</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>22</strong></code></td> <td>Skyrock</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>25</strong></code></td> <td>Fotka</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>28</strong></code></td> <td>hi5</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>31</strong></code></td> <td>Twitter</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>32</strong></code></td> <td>Cyworld</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>34</strong></code></td> <td>Blogger</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>36</strong></code></td> <td>VKontakte (ВКонтакте)</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>37</strong></code></td> <td>Rakuten (楽天市場)</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>38</strong></code></td> <td>LiveJournal</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>39</strong></code></td> <td>Odnoklassniki (Одноклассники)</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>40</strong></code></td> <td>tumblr.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>42</strong></code></td> <td>Linkedin</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>43</strong></code></td> <td>Google+</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>44</strong></code></td> <td>Weibo</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>45</strong></code></td> <td>Pinterest</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>46</strong></code></td> <td>Email</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>47</strong></code></td> <td>Facebook Messenger</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>49</strong></code></td> <td>WhatsApp</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>50</strong></code></td> <td>Hangouts</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>51</strong></code></td> <td>Gmail</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>52</strong></code></td> <td>Kakao (Kakao Talk)</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>53</strong></code></td> <td>Other</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>55</strong></code></td> <td>Copy to Clipboard</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>59</strong></code></td> <td>Embed</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>60</strong></code></td> <td>Text message</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>61</strong></code></td> <td>Android messaging</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>62</strong></code></td> <td>Verizon messages</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>63</strong></code></td> <td>HTC text message</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>64</strong></code></td> <td>Sony Conversations</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>65</strong></code></td> <td>Go SMS</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>66</strong></code></td> <td>LGE Email</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>67</strong></code></td> <td>Line</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>68</strong></code></td> <td>Viber</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>69</strong></code></td> <td>Kik</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>70</strong></code></td> <td>Skype</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>71</strong></code></td> <td>Blackberry Messenger</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>72</strong></code></td> <td>WeChat</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>73</strong></code></td> <td>KAKAO Story</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>74</strong></code></td> <td>Dropbox</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>75</strong></code></td> <td>Telegram</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>76</strong></code></td> <td>Facebook Pages</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>77</strong></code></td> <td>GroupMe</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>78</strong></code></td> <td>Android Email</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>79</strong></code></td> <td>Motorola Messaging</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>80</strong></code></td> <td>Nearby Share</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>81</strong></code></td> <td>Naver</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>82</strong></code></td> <td>iOS System Activity Dialog</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>83</strong></code></td> <td>Google Inbox</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>84</strong></code></td> <td>Android Messenger</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>85</strong></code></td> <td>YouTube Music</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>86</strong></code></td> <td>YouTube Gaming</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>87</strong></code></td> <td>YouTube Kids</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>88</strong></code></td> <td>YouTube TV</td> </tr> </table> <br>See the <a href="https://web.archive.org/web/20210615082306/http://support.google.com/youtube/answer/57741">help docs</a> for more information. </dd> </dl> <h3 id="Annotation_Dimensions" data-text="Annotations">Annotations</h3> <dl> <dt id="annotation_type" class="notranslate"><span itemprop="property">annotation_type</span></dt> <dd>This dimension identifies the manner in which the annotation displays during the video. The following table lists possible dimension values:<br> <table class="responsive details"> <tr> <th colspan="2">Values</th> </tr> <tr> <td><code translate="no" dir="ltr"><strong>0</strong></code></td> <td>Unknown</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>1</strong></code></td> <td>Note</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>3</strong></code></td> <td>Spotlight</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>4</strong></code></td> <td>Title</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>8</strong></code></td> <td>Speech bubble</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>9</strong></code></td> <td>Label</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>10</strong></code></td> <td>Branding watermark</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>11</strong></code></td> <td>Featured video</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>12</strong></code></td> <td>Featured playlist</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>30</strong></code></td> <td>Call-to-Action</td> </tr> </table> The <a href="https://web.archive.org/web/20210615082306/https://support.google.com/youtube/answer/92710">YouTube Help Center</a> provides more detail about the different types of annotations as well as the process of adding annotations to your videos.</dd> <dt id="annotation_id" class="notranslate"><span itemprop="property">annotation_id</span></dt> <dd>The ID that YouTube uses to uniquely identify an annotation.</dd> </dl> <h3 id="Card_Dimensions" data-text="Cards">Cards</h3> <dl> <dt id="card_type" class="notranslate"><span itemprop="property">card_type</span></dt> <dd>This dimension identifies the type of card that was displayed to the user. The following table lists possible dimension values:<br> <table class="responsive details"> <tr> <th colspan="2">Values</th> </tr> <tr> <td><code translate="no" dir="ltr"><strong>0</strong></code></td> <td>Unknown</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>60</strong></code></td> <td>Link</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>61</strong></code></td> <td>Fundraising</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>62</strong></code></td> <td>Video</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>63</strong></code></td> <td>Playlist</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>65</strong></code></td> <td>Fan Funding</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>66</strong></code></td> <td>Merchandise</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>68</strong></code></td> <td>Associated website</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>69</strong></code></td> <td>Channel</td> </tr> </table> The <a href="https://web.archive.org/web/20210615082306/https://support.google.com/youtube/answer/6140491">YouTube Help Center</a> provides more detail about the different types of cards as well as the process of <a href="https://web.archive.org/web/20210615082306/https://support.google.com/youtube/answer/6140493">adding cards</a> to your videos.</dd> <dt id="card_id" class="notranslate"><span itemprop="property">card_id</span></dt> <dd>The ID that YouTube uses to uniquely identify a card.</dd> </dl> <h3 id="End_Screen_Dimensions" data-text="End screens">End screens</h3> <dl> <dt id="end_screen_element_type" class="notranslate"><span itemprop="property">end_screen_element_type</span></dt> <dd>This dimension identifies the type of end screen element that was displayed to the user. The following table lists the end screen element types and their values:<br> <table class="responsive details"> <tr> <th colspan="2">Values</th> </tr> <tr> <td><code translate="no" dir="ltr"><strong>501</strong></code></td> <td>Video - The element promotes another YouTube video.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>502</strong></code></td> <td>Playlist - The element promotes YouTube playlist.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>503</strong></code></td> <td>Website - The element links to your associated website.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>504</strong></code></td> <td>Channel - The element links to another channel.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>505</strong></code></td> <td>Subscribe - The element encourages subscriptions to your channel.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>506</strong></code></td> <td>Associated</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>507</strong></code></td> <td>Crowdfunding - The element links to an approved crowdfunding website.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>508</strong></code></td> <td>Merchandise - The element links to an approved merchandise website.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>509</strong></code></td> <td>Recent upload - The element links to your channel's most recently uploaded video.</td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>510</strong></code></td> <td>Best for viewer</td> </tr> </table></dd> <dt id="end_screen_element_id" class="notranslate"><span itemprop="property">end_screen_element_id</span></dt> <dd>The ID that YouTube uses to uniquely identify an end screen element.</dd> </dl> <h3 id="Subtitle_Dimensions" data-text="Subtitles">Subtitles</h3> <dl> <dt id="subtitle_language" class="notranslate"><span itemprop="property">subtitle_language</span></dt> <dd>This dimension identifies the closed caption language used for the longest time during the view. Views for which closed captions were mostly turned off are not counted. See the documentation for <a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/channel_reports#video-subtitles">channel reports</a> or <a href="/web/20210615082306/https://developers.google.com/youtube/reporting/v1/reports/content_owner_reports#video-subtitles">content owner reports</a> for more information about reports that contain this dimension.</dd> </dl> <h3 id="Ad_Performance" data-text="Ad performance">Ad performance</h3> <dl> <dt id="ad_type" class="notranslate" itemprop="property">ad_type</dt> <dd>The <code translate="no" dir="ltr">ad_type</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 table lists possible dimension values. See the <a href="https://web.archive.org/web/20210615082306/https://support.google.com/youtube/answer/2467968">YouTube Help Center</a> for more information about YouTube advertising formats.<br> <table class="details"> <tr> <th>Value</th> <th>Description</th> <th>Value in Query Reports</th> </tr> <tr> <td><code translate="no" dir="ltr"><strong>1</strong></code></td> <td>Skippable video ads (Auction)</td> <td><code translate="no" dir="ltr">auctionTrueviewInstream</code></td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>2</strong></code></td> <td>Display ads (Auction)</td> <td><code translate="no" dir="ltr">auctionDisplay</code></td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>3</strong></code></td> <td>Non-skippable video ads (Auction)</td> <td><code translate="no" dir="ltr">auctionInstream</code></td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>5</strong></code></td> <td>Display ads (Reserved)</td> <td><code translate="no" dir="ltr">reservedDisplay</code></td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>6</strong></code></td> <td>Non-skippable video ads (Reserved)</td> <td><code translate="no" dir="ltr">reservedInstream</code></td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>13</strong></code></td> <td>Unknown</td> <td><code translate="no" dir="ltr">unknown</code></td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>15</strong></code></td> <td>Skippable video ads (Reserved)</td> <td><code translate="no" dir="ltr">reservedInstreamSelect</code></td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>19</strong></code></td> <td>Bumper ads (auction)</td> <td><code translate="no" dir="ltr">auctionBumperInstream</code></td> </tr> <tr> <td><code translate="no" dir="ltr"><strong>20</strong></code></td> <td>Bumper ads (reserved)</td> <td><code translate="no" dir="ltr">reservedBumperInstream</code></td> </tr> </table> <p class="note"><b>Note:</b> Query reports might return for some additional ad types that were previously used on YouTube.</p> </dd> </dl> <h2 id="Content_Owner_Dimensions" data-text="Content owner dimensions">Content owner dimensions</h2> <p>The following dimensions are only used in content owner reports.</p> <dl> <dt id="claimed_status" class="notranslate" itemprop="property">claimed_status <span style="color: #555">(only used in content owner reports)</span></dt> <dd>This dimension indicate that a row of data only contains metrics for claimed content. The only valid value for this dimension is <code translate="no" dir="ltr">claimed</code>. The table in the definition of the <code translate="no" dir="ltr">uploader_type</code> dimension provides more detail about how to use this dimension.</dd> </dl> <dl> <dt id="uploader_type" class="notranslate" itemprop="property">uploader_type <span style="color: #555">(core dimension)</span> <span style="color: #555">(only used in content owner reports)</span></dt> <dd>This dimension indicates whether a row of data contains 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="/web/20210615082306/https://developers.google.com/youtube/youtube-api-list">Deprecation Policy</a>.<br/><br/>The table below shows the supported combinations for the <code translate="no" dir="ltr">claimed_status</code> and <code translate="no" dir="ltr">uploader_type</code> dimensions:<br/><br/> <table> <tr> <th><code class="notranslate" dir="ltr">claimed_status</code> value</th> <th><code class="notranslate" dir="ltr">uploader_type</code> value</th> <th>Description</th> </tr> <tr> <td>[Not set]</td> <td class="notranslate">self</td> <td> The row contains YouTube Analytics data for claimed and unclaimed content uploaded by the content owner. </td> </tr> <tr> <td class="notranslate">claimed</td> <td class="notranslate">self</td> <td> The row contains data for claimed content uploaded by the content owner. </td> </tr> <tr> <td class="notranslate">claimed</td> <td class="notranslate">thirdParty</td> <td> The row contains data for claimed content uploaded by a third party. </td> </tr> </table> </dd> </dl> </div> </div> <devsite-thumb-rating position="footer"> <template class="thumb-down-categories"> [{ "type": "thumb-down", "id": "missingTheInformationINeed", "label":"Missing the information I need" },{ "type": "thumb-down", "id": "tooComplicatedTooManySteps", "label":"Too complicated / too many steps" },{ "type": "thumb-down", "id": "outOfDate", "label":"Out of date" },{ "type": "thumb-down", "id": "samplesCodeIssue", "label":"Samples/Code issue" },{ "type": "thumb-down", "id": "otherDown", "label":"Other" }] </template> <template class="thumb-up-categories"> [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Easy to understand" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Solved my problem" },{ "type": "thumb-up", "id": "otherUp", "label":"Other" }] </template> </devsite-thumb-rating> </article> <devsite-content-footer class="nocontent"> <p>Except as otherwise noted, the content of this page is licensed under the <a href="https://web.archive.org/web/20210615082306/https://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 License</a>, and code samples are licensed under the <a href="https://web.archive.org/web/20210615082306/https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 License</a>. For details, see the <a href="https://web.archive.org/web/20210615082306/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 2021-06-10 UTC.</p> </devsite-content-footer> </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://web.archive.org/web/20210615082306/http://apiblog.youtube.com/" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 1)"> <img class="devsite-footer-promo-icon" src="https://web.archive.org/web/20210615082306im_/https://www.gstatic.com/images/icons/material/product/2x/blogger_64dp.png" loading="lazy" alt="Blog"> Blog </a> <div class="devsite-footer-promo-description">The latest news on the YouTube API blog</div> </li> <li class="devsite-footer-promo"> <a href="https://web.archive.org/web/20210615082306/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)"> <img class="devsite-footer-promo-icon" src="/web/20210615082306im_/https://developers.google.com/site-assets/logo-github.svg" loading="lazy" alt="GitHub"> GitHub </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://web.archive.org/web/20210615082306/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)"> <img class="devsite-footer-promo-icon" src="/web/20210615082306im_/https://developers.google.com/site-assets/developers_64dp.png" loading="lazy" alt="Issue Tracker"> Issue Tracker </a> <div class="devsite-footer-promo-description">Something wrong? Send us a bug report!</div> </li> <li class="devsite-footer-promo"> <a href="https://web.archive.org/web/20210615082306/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)"> <img class="devsite-footer-promo-icon" src="/web/20210615082306im_/https://developers.google.com/site-assets/logo-stack-overflow.svg" loading="lazy" alt="Stack Overflow"> Stack Overflow </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://web.archive.org/web/20210615082306/https://www.youtube.com/user/YouTubeDev" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 5)"> <img class="devsite-footer-promo-icon" src="/web/20210615082306im_/https://developers.google.com/site-assets/logo-youtube.svg" loading="lazy" alt="Videos"> Videos </a> <div class="devsite-footer-promo-description">Check out the YouTube Developer Relations team's YouTube channel</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://web.archive.org/web/20210615082306/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="/web/20210615082306/https://developers.google.com/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="/web/20210615082306/https://developers.google.com/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://web.archive.org/web/20210615082306/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://web.archive.org/web/20210615082306/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://web.archive.org/web/20210615082306/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="/web/20210615082306/https://developers.google.com/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="/web/20210615082306/https://developers.google.com/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="/web/20210615082306/https://developers.google.com/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="/web/20210615082306/https://developers.google.com/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://web.archive.org/web/20210615082306/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"> <img class="devsite-footer-sites-logo" src="https://web.archive.org/web/20210615082306im_/https://www.gstatic.com/devrel-devsite/prod/vacc2a2a4a4394c7c42dc62dba69eb022d7680ce4a368d4b28c3e984cc9155a81/developers/images/lockup-developers.svg" loading="lazy" alt="Google Developers"> </a> <ul class="devsite-footer-sites-list"> <li class="devsite-footer-sites-item"> <a href="//web.archive.org/web/20210615082306/https://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="//web.archive.org/web/20210615082306/https://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="//web.archive.org/web/20210615082306/https://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="//web.archive.org/web/20210615082306/https://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="/web/20210615082306/https://developers.google.com/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="/web/20210615082306/https://developers.google.com/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="//web.archive.org/web/20210615082306/https://policies.google.com/privacy" data-category="Site-Wide Custom Events" data-label="Footer Privacy link"> Privacy </a> </li> <li class="devsite-footer-utility-item devsite-footer-utility-button"> <span class="devsite-footer-utility-description">Sign up for the Google Developers newsletter</span> <a class="devsite-footer-utility-link gc-analytics-event" href="//web.archive.org/web/20210615082306/https://services.google.com/fb/forms/googledevelopersnewsletter/?utm_medium=referral&utm_source=google-products&utm_team=googledevs&utm_campaign=201611-newsletter-launch" data-category="Site-Wide Custom Events" data-label="Footer Subscribe link"> Subscribe </a> </li> </ul> <devsite-language-selector> <devsite-select class="devsite-language-selector-menu"> <select aria-label="Select your language preference." class="devsite-language-selector-select" name="language" track-name="click" track-type="languageSelector"> <option>Language</option> <option value="en" lang="en" track-metadata-original-language="en" track-metadata-selected-language="en" track-name="changed" track-type="languageSelector"> English </option> <option value="id" lang="id" track-metadata-original-language="en" track-metadata-selected-language="id" track-name="changed" track-type="languageSelector"> Bahasa Indonesia </option> <option value="de" lang="de" track-metadata-original-language="en" track-metadata-selected-language="de" track-name="changed" track-type="languageSelector"> Deutsch </option> <option value="es" lang="es" track-metadata-original-language="en" track-metadata-selected-language="es" track-name="changed" track-type="languageSelector"> Español </option> <option value="fr" lang="fr" track-metadata-original-language="en" track-metadata-selected-language="fr" track-name="changed" track-type="languageSelector"> Français </option> <option value="pt_br" lang="pt_br" track-metadata-original-language="en" track-metadata-selected-language="pt_br" track-name="changed" track-type="languageSelector"> Português – Brasil </option> <option value="ru" lang="ru" track-metadata-original-language="en" track-metadata-selected-language="ru" track-name="changed" track-type="languageSelector"> Русский </option> <option value="zh_cn" lang="zh_cn" track-metadata-original-language="en" track-metadata-selected-language="zh_cn" track-name="changed" track-type="languageSelector"> 中文 – 简体 </option> <option value="ja" lang="ja" track-metadata-original-language="en" track-metadata-selected-language="ja" track-name="changed" track-type="languageSelector"> 日本語 </option> <option value="ko" lang="ko" track-metadata-original-language="en" track-metadata-selected-language="ko" track-name="changed" track-type="languageSelector"> 한국어 </option> </select> </devsite-select> </devsite-language-selector> </nav> </div> </devsite-footer-utility> </section></section> <devsite-sitemask></devsite-sitemask> <devsite-snackbar></devsite-snackbar> <devsite-tooltip></devsite-tooltip> <devsite-heading-link></devsite-heading-link> <devsite-analytics enable-analytics-iframe> <script type="application/json" analytics>[{"gaid": "UA-24532603-1", "dimensions": {"dimension11": false, "dimension6": "en", "dimension3": false, "dimension4": "YouTube Analytics and Reporting APIs", "dimension1": "Signed out", "dimension5": "en"}, "metrics": {"ratings_value": "metric1", "ratings_count": "metric2"}}]</script> <script type="application/json" gtm>{"parameters": {"freeTrialEligibleUser": "False", "internalUser": "False", "language": {"machineTranslated": "False", "requested": "en", "served": "en"}, "pageType": "reference", "projectName": "YouTube Analytics and Reporting APIs", "scriptsafe": null, "signedIn": "False", "tenant": "developers", "recommendations": {"sourcePage": "", "sourceType": 0, "sourceRank": 0, "sourceIdenticalDescriptions": 0, "sourceTitleWords": 0, "sourceDescriptionWords": 0, "experiment": ""}}}</script> </devsite-analytics> <devsite-badger></devsite-badger> <script nonce="fb6P5NQxMpOxk/NoBmCbSw2GvcayjV"> (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://web.archive.org/web/20210615082306/https://www.gstatic.com/devrel-devsite/prod/vacc2a2a4a4394c7c42dc62dba69eb022d7680ce4a368d4b28c3e984cc9155a81/developers/js/app_loader.js', '[1,"en",null,"/js/devsite_app_module.js","https://web.archive.org/web/20210615082306/https://www.gstatic.com/devrel-devsite/prod/vacc2a2a4a4394c7c42dc62dba69eb022d7680ce4a368d4b28c3e984cc9155a81","https://web.archive.org/web/20210615082306/https://www.gstatic.com/devrel-devsite/prod/vacc2a2a4a4394c7c42dc62dba69eb022d7680ce4a368d4b28c3e984cc9155a81/developers","https://web.archive.org/web/20210615082306/https://developers-dot-devsite-v2-prod.appspot.com",null,null,["/_pwa/developers/manifest.json","https://web.archive.org/web/20210615082306/https://www.gstatic.com/devrel-devsite/prod/vacc2a2a4a4394c7c42dc62dba69eb022d7680ce4a368d4b28c3e984cc9155a81/images/video-placeholder.svg","https://web.archive.org/web/20210615082306/https://www.gstatic.com/devrel-devsite/prod/vacc2a2a4a4394c7c42dc62dba69eb022d7680ce4a368d4b28c3e984cc9155a81/developers/images/favicon.png","https://web.archive.org/web/20210615082306/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,40,50,63,70,75,76,80,87,88,91,92,93,97,98,100,101,102,103,104,105,107,111,112,113,115,116,117,118,120,122,123,124,125,127,129,130,131,132,133,134,135,136,138],"AIzaSyAP-jjEJBzmIyKR4F-3XITp8yM9T1gEEI8","AIzaSyB6xiKGDR5O3Ak2okS4rLkauxGUG7XP0hg"]') </script> <devsite-a11y-announce></devsite-a11y-announce> </body> </html>

CINXE.COM

Dimensions | YouTube Analytics and Reporting APIs | Google Developers