Metrics | YouTube Analytics and Reporting APIs

<!doctype html> <html lang="en" dir="ltr"> <head> <meta name="google-signin-client-id" content="721724668570-nbkv1cfusk7kk4eni4pjvepaus73b13t.apps.googleusercontent.com"> <meta name="google-signin-scope" content="profile email https://www.googleapis.com/auth/developerprofiles https://www.googleapis.com/auth/developerprofiles.award"> <meta property="og:site_name" content="Google for Developers"> <meta property="og:type" content="website"><meta name="theme-color" content="#ff0000"><meta charset="utf-8"> <meta content="IE=Edge" http-equiv="X-UA-Compatible"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="manifest" href="/_pwa/developers/manifest.json" crossorigin="use-credentials"> <link rel="preconnect" href="//www.gstatic.com" crossorigin> <link rel="preconnect" href="//fonts.gstatic.com" crossorigin> <link rel="preconnect" href="//fonts.googleapis.com" crossorigin> <link rel="preconnect" href="//apis.google.com" crossorigin> <link rel="preconnect" href="//www.google-analytics.com" crossorigin><link rel="stylesheet" href="//fonts.googleapis.com/css?family=Google+Sans:400,500|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700&display=swap"> <link rel="stylesheet" href="//fonts.googleapis.com/css2?family=Material+Icons&family=Material+Symbols+Outlined&display=block"><link rel="stylesheet" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/css/app.css"> <link rel="shortcut icon" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/favicon-new.png"> <link rel="apple-touch-icon" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/touchicon-180-new.png"><link rel="canonical" href="https://developers.google.com/youtube/analytics/metrics"><link rel="search" type="application/opensearchdescription+xml" title="Google for Developers" href="https://developers.google.com/s/opensearch.xml"> <link rel="alternate" hreflang="en" href="https://developers.google.com/youtube/analytics/metrics" /><link rel="alternate" hreflang="x-default" href="https://developers.google.com/youtube/analytics/metrics" /><link rel="alternate" hreflang="ar" href="https://developers.google.com/youtube/analytics/metrics?hl=ar" /><link rel="alternate" hreflang="bn" href="https://developers.google.com/youtube/analytics/metrics?hl=bn" /><link rel="alternate" hreflang="zh-Hans" href="https://developers.google.com/youtube/analytics/metrics?hl=zh-cn" /><link rel="alternate" hreflang="zh-Hant" href="https://developers.google.com/youtube/analytics/metrics?hl=zh-tw" /><link rel="alternate" hreflang="fa" href="https://developers.google.com/youtube/analytics/metrics?hl=fa" /><link rel="alternate" hreflang="fr" href="https://developers.google.com/youtube/analytics/metrics?hl=fr" /><link rel="alternate" hreflang="de" href="https://developers.google.com/youtube/analytics/metrics?hl=de" /><link rel="alternate" hreflang="he" href="https://developers.google.com/youtube/analytics/metrics?hl=he" /><link rel="alternate" hreflang="hi" href="https://developers.google.com/youtube/analytics/metrics?hl=hi" /><link rel="alternate" hreflang="id" href="https://developers.google.com/youtube/analytics/metrics?hl=id" /><link rel="alternate" hreflang="it" href="https://developers.google.com/youtube/analytics/metrics?hl=it" /><link rel="alternate" hreflang="ja" href="https://developers.google.com/youtube/analytics/metrics?hl=ja" /><link rel="alternate" hreflang="ko" href="https://developers.google.com/youtube/analytics/metrics?hl=ko" /><link rel="alternate" hreflang="pl" href="https://developers.google.com/youtube/analytics/metrics?hl=pl" /><link rel="alternate" hreflang="pt-BR" href="https://developers.google.com/youtube/analytics/metrics?hl=pt-br" /><link rel="alternate" hreflang="ru" href="https://developers.google.com/youtube/analytics/metrics?hl=ru" /><link rel="alternate" hreflang="es-419" href="https://developers.google.com/youtube/analytics/metrics?hl=es-419" /><link rel="alternate" hreflang="th" href="https://developers.google.com/youtube/analytics/metrics?hl=th" /><link rel="alternate" hreflang="tr" href="https://developers.google.com/youtube/analytics/metrics?hl=tr" /><link rel="alternate" hreflang="vi" href="https://developers.google.com/youtube/analytics/metrics?hl=vi" /><title>Metrics  |  YouTube Analytics and Reporting APIs  |  Google for Developers</title> <meta property="og:title" content="Metrics  |  YouTube Analytics and Reporting APIs  |  Google for Developers"><meta name="description" content="Learn about the metrics – measurements of user activity, ad performance, or estimated revenue – that you can retrieve with the API."> <meta property="og:description" content="Learn about the metrics – measurements of user activity, ad performance, or estimated revenue – that you can retrieve with the API."><meta property="og:url" content="https://developers.google.com/youtube/analytics/metrics"><meta property="og:image" content="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/opengraph/youtube-theme.png"> <meta property="og:image:width" content="1200"> <meta property="og:image:height" content="675"><meta property="og:locale" content="en"><meta name="twitter:card" content="summary_large_image"><script type="application/ld+json"> { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [{ "@type": "ListItem", "position": 1, "name": "YouTube", "item": "https://developers.google.com/youtube" },{ "@type": "ListItem", "position": 2, "name": "Analytics and Reporting APIs", "item": "https://developers.google.com/youtube/analytics" },{ "@type": "ListItem", "position": 3, "name": "Metrics", "item": "https://developers.google.com/youtube/analytics/metrics" }] } </script> <link rel="stylesheet" href="/extras.css"></head> <body class="docs" template="page" theme="youtube-theme" type="reference" layout="docs" concierge='closed' display-toc pending> <devsite-progress type="indeterminate" id="app-progress"></devsite-progress> <section class="devsite-wrapper"> <devsite-cookie-notification-bar></devsite-cookie-notification-bar><devsite-header role="banner"> <div class="devsite-header--inner nocontent"> <div class="devsite-top-logo-row-wrapper-wrapper"> <div class="devsite-top-logo-row-wrapper"> <div class="devsite-top-logo-row"> <button type="button" id="devsite-hamburger-menu" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Navigation menu button" visually-hidden aria-label="Open menu"> </button> <div class="devsite-product-name-wrapper"> <a href="https://developers.google.com/youtube"> <div class="devsite-product-logo-container" size="medium" > <picture> <img class="devsite-product-logo" alt="YouTube" src="https://developers.google.com/static/site-assets/logo-youtube.svg" srcset=" /static/site-assets/logo-youtube.svg" sizes="64px" loading="lazy" > </picture> </div> </a> <span class="devsite-product-name"> <ul class="devsite-breadcrumb-list" aria-label="Product breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://developers.google.com/youtube" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="YouTube" > YouTube </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/youtube/analytics" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail="YouTube Analytics and Reporting APIs" > Analytics and Reporting APIs </a> </li> </ul> </span> </div> <div class="devsite-top-logo-row-middle"> <div class="devsite-header-upper-tabs"> </div> <devsite-search enable-signin enable-search enable-suggestions enable-query-completion project-name="YouTube Analytics and Reporting APIs" tenant-name="Google for Developers" project-scope="/youtube/analytics" url-scoped="https://developers.google.com/s/results/youtube/analytics" > <form class="devsite-search-form" action="https://developers.google.com/s/results" method="GET"> <div class="devsite-search-container"> <button type="button" search-open class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Open search"></button> <div class="devsite-searchbox"> <input aria-activedescendant="" aria-autocomplete="list" aria-label="Search" aria-expanded="false" aria-haspopup="listbox" autocomplete="off" class="devsite-search-field devsite-search-query" name="q" placeholder="Search" role="combobox" type="text" value="" > <div class="devsite-search-image material-icons" aria-hidden="true"> </div> <div class="devsite-search-shortcut-icon-container" aria-hidden="true"> <kbd class="devsite-search-shortcut-icon">/</kbd> </div> </div> </div> </form> <button type="button" search-close class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Close search"></button> </devsite-search> </div> <devsite-language-selector> <ul role="presentation"> <li role="presentation"> <a role="menuitem" lang="en" >English</a> </li> <li role="presentation"> <a role="menuitem" lang="de" >Deutsch</a> </li> <li role="presentation"> <a role="menuitem" lang="es" >Español</a> </li> <li role="presentation"> <a role="menuitem" lang="es_419" >Español – América Latina</a> </li> <li role="presentation"> <a role="menuitem" lang="fr" >Français</a> </li> <li role="presentation"> <a role="menuitem" lang="id" >Indonesia</a> </li> <li role="presentation"> <a role="menuitem" lang="it" >Italiano</a> </li> <li role="presentation"> <a role="menuitem" lang="pl" >Polski</a> </li> <li role="presentation"> <a role="menuitem" lang="pt_br" >Português – Brasil</a> </li> <li role="presentation"> <a role="menuitem" lang="vi" >Tiếng Việt</a> </li> <li role="presentation"> <a role="menuitem" lang="tr" >Türkçe</a> </li> <li role="presentation"> <a role="menuitem" lang="ru" >Русский</a> </li> <li role="presentation"> <a role="menuitem" lang="he" >עברית</a> </li> <li role="presentation"> <a role="menuitem" lang="ar" >العربيّة</a> </li> <li role="presentation"> <a role="menuitem" lang="fa" >فارسی</a> </li> <li role="presentation"> <a role="menuitem" lang="hi" >हिंदी</a> </li> <li role="presentation"> <a role="menuitem" lang="bn" >বাংলা</a> </li> <li role="presentation"> <a role="menuitem" lang="th" >ภาษาไทย</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_cn" >中文 – 简体</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_tw" >中文 – 繁體</a> </li> <li role="presentation"> <a role="menuitem" lang="ja" >日本語</a> </li> <li role="presentation"> <a role="menuitem" lang="ko" >한국어</a> </li> </ul> </devsite-language-selector> <devsite-user enable-profiles fp-auth id="devsite-user"> <span class="button devsite-top-button" aria-hidden="true" visually-hidden>Sign in</span> </devsite-user> </div> </div> </div> <div class="devsite-collapsible-section "> <div class="devsite-header-background"> <div class="devsite-doc-set-nav-row"> <devsite-tabs class="lower-tabs"> <nav class="devsite-tabs-wrapper" aria-label="Lower tabs"> <tab > <a href="https://developers.google.com/youtube/analytics" track-metadata-eventdetail="https://developers.google.com/youtube/analytics" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - home" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Home" track-name="home" > Home </a> </tab> <tab > <a href="https://developers.google.com/youtube/reporting" track-metadata-eventdetail="https://developers.google.com/youtube/reporting" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - overview" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Overview" track-name="overview" > Overview </a> </tab> <tab > <a href="https://developers.google.com/youtube/reporting/guides/authorization" track-metadata-eventdetail="https://developers.google.com/youtube/reporting/guides/authorization" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - authorization" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Authorization" track-name="authorization" > Authorization </a> </tab> <tab > <a href="https://developers.google.com/youtube/reporting/v1/reports" track-metadata-eventdetail="https://developers.google.com/youtube/reporting/v1/reports" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - bulk reports" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Bulk Reports" track-name="bulk reports" > Bulk Reports </a> </tab> <tab class="devsite-active"> <a href="https://developers.google.com/youtube/analytics/data_model" track-metadata-eventdetail="https://developers.google.com/youtube/analytics/data_model" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - targeted queries" track-metadata-module="primary nav" aria-label="Targeted Queries, selected" data-category="Site-Wide Custom Events" data-label="Tab: Targeted Queries" track-name="targeted queries" > Targeted Queries </a> </tab> <tab > <a href="https://developers.google.com/youtube/reporting/v1/code_samples" track-metadata-eventdetail="https://developers.google.com/youtube/reporting/v1/code_samples" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - resources" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Resources" track-name="resources" > Resources </a> </tab> </nav> </devsite-tabs> </div> </div> </div> </div> </devsite-header> <devsite-book-nav scrollbars > <div class="devsite-book-nav-filter" > <span class="filter-list-icon material-icons" aria-hidden="true"></span> <input type="text" placeholder="Filter" aria-label="Type to filter" role="searchbox"> <span class="filter-clear-button hidden" data-title="Clear filter" aria-label="Clear filter" role="button" tabindex="0"></span> </div> <nav class="devsite-book-nav devsite-nav nocontent" aria-label="Side menu"> <div class="devsite-mobile-header"> <button type="button" id="devsite-close-nav" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Close navigation" aria-label="Close navigation"> </button> <div class="devsite-product-name-wrapper"> <a href="https://developers.google.com/youtube"> <div class="devsite-product-logo-container" size="medium" > <picture> <img class="devsite-product-logo" alt="YouTube" src="https://developers.google.com/static/site-assets/logo-youtube.svg" srcset=" /static/site-assets/logo-youtube.svg" sizes="64px" loading="lazy" > </picture> </div> </a> <span class="devsite-product-name"> <ul class="devsite-breadcrumb-list" aria-label="Upper header breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://developers.google.com/youtube" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="YouTube" > YouTube </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/youtube/analytics" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail="YouTube Analytics and Reporting APIs" > Analytics and Reporting APIs </a> </li> </ul> </span> </div> </div> <div class="devsite-book-nav-wrapper"> <div class="devsite-mobile-nav-top"> <ul class="devsite-nav-list"> <li class="devsite-nav-item"> <a href="/youtube/analytics" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Tab: Home" track-name="home" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Home" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Home </span> </a> </li> <li class="devsite-nav-item"> <a href="/youtube/reporting" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Tab: Overview" track-name="overview" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Overview" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Overview </span> </a> </li> <li class="devsite-nav-item"> <a href="/youtube/reporting/guides/authorization" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Authorization" track-name="authorization" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Authorization" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Authorization </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> <li class="devsite-nav-item"> <a href="/youtube/reporting/v1/reports" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Bulk Reports" track-name="bulk reports" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Bulk Reports" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Bulk Reports </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> <li class="devsite-nav-item"> <a href="/youtube/analytics/data_model" class="devsite-nav-title gc-analytics-event devsite-nav-has-children devsite-nav-active" data-category="Site-Wide Custom Events" data-label="Tab: Targeted Queries" track-name="targeted queries" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Targeted Queries" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Targeted Queries </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> <li class="devsite-nav-item"> <a href="/youtube/reporting/v1/code_samples" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Resources" track-name="resources" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Resources" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Resources </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> </ul> </div> <div class="devsite-mobile-nav-bottom"> <ul class="devsite-nav-list" menu="_book"> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>YouTube Analytics API</span> </div></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>Data Model</span> </div></li> <li class="devsite-nav-item"><a href="/youtube/analytics/data_model" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/data_model" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/data_model" ><span class="devsite-nav-text" tooltip>Overview</span></a></li> <li class="devsite-nav-item"><a href="/youtube/analytics/dimensions" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/dimensions" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/dimensions" ><span class="devsite-nav-text" tooltip>Dimensions</span></a></li> <li class="devsite-nav-item"><a href="/youtube/analytics/metrics" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/metrics" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/metrics" ><span class="devsite-nav-text" tooltip>Metrics</span></a></li> <li class="devsite-nav-item"><a href="/youtube/analytics/channel_reports" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/channel_reports" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/channel_reports" ><span class="devsite-nav-text" tooltip>Channel Reports</span></a></li> <li class="devsite-nav-item"><a href="/youtube/analytics/content_owner_reports" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/content_owner_reports" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/content_owner_reports" ><span class="devsite-nav-text" tooltip>Content Owner Reports</span></a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>Guides</span> </div></li> <li class="devsite-nav-item"><a href="/youtube/analytics/sample-requests" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/sample-requests" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/sample-requests" ><span class="devsite-nav-text" tooltip>Sample requests</span></a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>API Reference</span> </div></li> <li class="devsite-nav-item"><a href="/youtube/analytics/reference" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference" ><span class="devsite-nav-text" tooltip>Overview</span></a></li> <li class="devsite-nav-item"><a href="/youtube/analytics/reference/reports/query" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/reports/query" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/reports/query" ><span class="devsite-nav-text" tooltip>reports.query</span></a></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> <span class="devsite-nav-text" tooltip>Groups</span> </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groups" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groups" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groups" ><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groups/list" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groups/list" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groups/list" ><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groups/insert" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groups/insert" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groups/insert" ><span class="devsite-nav-text" tooltip>insert</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groups/update" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groups/update" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groups/update" ><span class="devsite-nav-text" tooltip>update</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groups/delete" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groups/delete" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groups/delete" ><span class="devsite-nav-text" tooltip>delete</span></a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> <span class="devsite-nav-text" tooltip>GroupItems</span> </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groupItems" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groupItems" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groupItems" ><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groupItems/list" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groupItems/list" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groupItems/list" ><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groupItems/insert" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groupItems/insert" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groupItems/insert" ><span class="devsite-nav-text" tooltip>insert</span></a></li><li class="devsite-nav-item"><a href="/youtube/analytics/reference/groupItems/delete" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/reference/groupItems/delete" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/reference/groupItems/delete" ><span class="devsite-nav-text" tooltip>delete</span></a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-break"></li> <li class="devsite-nav-item"><a href="/youtube/analytics/revision_history" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /youtube/analytics/revision_history" track-type="bookNav" track-name="click" track-metadata-eventdetail="/youtube/analytics/revision_history" ><span class="devsite-nav-text" tooltip>Revision History</span></a></li> </ul> </div> </div> </nav> </devsite-book-nav> <section id="gc-wrapper"> <main role="main" class="devsite-main-content" has-book-nav > <devsite-content> <article class="devsite-article"> <div class="devsite-article-meta nocontent" role="navigation"> <ul class="devsite-breadcrumb-list" aria-label="Breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://developers.google.com/" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="" > Home </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/products" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail="" > Products </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/youtube" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="3" track-type="globalNav" track-name="breadcrumb" track-metadata-position="3" track-metadata-eventdetail="YouTube" > YouTube </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/youtube/analytics" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="4" track-type="globalNav" track-name="breadcrumb" track-metadata-position="4" track-metadata-eventdetail="YouTube Analytics and Reporting APIs" > Analytics and Reporting APIs </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/youtube/analytics/data_model" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="5" track-type="globalNav" track-name="breadcrumb" track-metadata-position="5" track-metadata-eventdetail="" > Targeted Queries </a> </li> </ul> <devsite-thumb-rating position="header"> </devsite-thumb-rating> </div> <h1 class="devsite-page-title" tabindex="-1"> Metrics </h1> <devsite-feature-tooltip ack-key="AckCollectionsBookmarkTooltipDismiss" analytics-category="Site-Wide Custom Events" analytics-action-show="Callout Profile displayed" analytics-action-close="Callout Profile dismissed" analytics-label="Create Collection Callout" class="devsite-page-bookmark-tooltip nocontent" dismiss-button="true" id="devsite-collections-dropdown" dismiss-button-text="Dismiss" close-button-text="Got it"> <devsite-bookmark></devsite-bookmark> <span slot="popout-heading"> Stay organized with collections </span> <span slot="popout-contents"> Save and categorize content based on your preferences. </span> </devsite-feature-tooltip> <div class="devsite-page-title-meta"><devsite-view-release-notes></devsite-view-release-notes></div> <devsite-toc class="devsite-nav" depth="2" devsite-toc-embedded > </devsite-toc> <div class="devsite-article-body clearfix "> <div itemscope itemtype="http://developers.google.com/ReferenceObject"> <meta itemprop="name" content="Metrics"/> <p>This document defines the metrics that you can retrieve using the YouTube Analytics API. This API supports real-time queries to generate custom YouTube Analytics reports.</p> <p>Metrics are individual measurements of user activity, ad performance, or estimated revenue. User activity metrics include things like video view counts and ratings (likes and dislikes).</p> <h2 id="Core_Metrics" data-text="Core metrics" tabindex="-1">Core metrics</h2> <p>While the YouTube Analytics API is subject to the Deprecation Policy defined in the <a href="/youtube/terms">Terms of Service</a>, non-core metrics (and non-core dimensions) are not subject to the policy. In the definitions on this page, any metric that is a core metric is explicitly identified as such.</p> <p>The list below identifies the API's core metrics. </p> <ul> <li><code translate="no" dir="ltr"><a href="#annotationClickThroughRate">annotationClickThroughRate</a></code></li> <li><code translate="no" dir="ltr"><a href="#annotationCloseRate">annotationCloseRate</a></code></li> <li><code translate="no" dir="ltr"><a href="#averageViewDuration">averageViewDuration</a></code></li> <li><code translate="no" dir="ltr"><a href="#comments">comments</a></code></li> <li><code translate="no" dir="ltr"><a href="#dislikes">dislikes</a></code></li> <li><code translate="no" dir="ltr"><a href="#estimatedMinutesWatched">estimatedMinutesWatched</a></code></li> <li><code translate="no" dir="ltr"><a href="#estimatedRevenue">estimatedRevenue</a></code></li> <li><code translate="no" dir="ltr"><a href="#likes">likes</a></code></li> <li><code translate="no" dir="ltr"><a href="#shares">shares</a></code></li> <li><code translate="no" dir="ltr"><a href="#subscribersGained">subscribersGained</a></code></li> <li><code translate="no" dir="ltr"><a href="#subscribersLost">subscribersLost</a></code></li> <li><code translate="no" dir="ltr"><a href="#viewerPercentage">viewerPercentage</a></code></li> <li><code translate="no" dir="ltr"><a href="#views">views</a></code></li> </ul> <div class="caution"><b>Note:</b> The following core metrics have been fully deprecated: <ul> <li>The <code translate="no" dir="ltr"><a href="#earnings">earnings</a></code> core metric was deprecated on August 4, 2016, and renamed <code translate="no" dir="ltr"><a href="#estimatedRevenue">estimatedRevenue</a></code>. In keeping with the Deprecation Policy defined in the <a href="/youtube/terms">Terms of Service</a>, the <code translate="no" dir="ltr">earnings</code> and <code translate="no" dir="ltr">estimatedRevenue</code> metrics were concurrently supported until August 10, 2017.</li> <li>The <code translate="no" dir="ltr"><a href="#favoritesAdded">favoritesAdded</a></code> and <code translate="no" dir="ltr"><a href="#favoritesRemoved">favoritesRemoved</a></code> core metrics were deprecated on March 31, 2015. These metrics could be retrieved only through the YouTube Analytics API.</li> </ul></div> <p>See the list of <a href="/youtube/youtube-api-list">YouTube APIs subject to the Deprecation Policy</a> for more information.</p> <h3 id="View_Metrics" data-text="View metrics" tabindex="-1">View metrics</h3> <div style="padding-left:25px"> <dl> <dt id="views" class="notranslate"><span itemprop="property">views</span> <span style="color: #555">(core metric)</span></dt> <dd>This metric represents different numbers in different types of reports: <ul> <li>In video reports, this metric specifies the number of times that a video was viewed.</li> <li>In playlist reports that do not use the <code translate="no" dir="ltr">isCurated</code> dimension, this metric specifies the total number of views for videos in the playlist, regardless of whether those views occurred in the context of the playlist. Note that the metric value includes only views of the channel owner's videos.<br><br>In these reports, the <code translate="no" dir="ltr">playlistViews</code> metric indicates the number of times that playlist videos were viewed in the context of a specific playlist.</li> <li>In playlist reports that use the <code translate="no" dir="ltr">isCurated</code> dimension, this metric indicates the number of times that videos were viewed in the context of a specific playlist. Note that the <code translate="no" dir="ltr">playlistViews</code> metric is not supported for these reports.</li> </ul> <span class="notranslate">This is a core metric and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span> <br/></dd> <dt id="playlistViews-placeholder" class="notranslate"><span itemprop="property">playlistViews</span></dt> <dd>This metric is defined in the <a href="#Playlist_Metrics">playlist metrics</a> section.<br/></dd> <dt id="redViews" class="notranslate"><span itemprop="property">redViews</span></dt> <dd>The number of times that a video was viewed by YouTube Premium (previously known as YouTube Red) members.<br/></dd> <dt id="uniques" class="notranslate"><span itemprop="property">uniques</span> (<span style="color:red">deprecated September 27, 2016)</dt> <dd>The number of unique viewers that watched a video. This calculation is based on the number of unique cookies and, therefore, will overcount users who are using multiple devices or browsers.<br><span class="special">The <code translate="no" dir="ltr"><a href="/youtube/analytics/v1/dimsmets/mets#uniques">uniques</a></code> metric was deprecated on September 27, 2016. It is not a core metric and will be supported until October 31, 2016.<br/></dd> <dt id="viewerPercentage" class="notranslate"><span itemprop="property">viewerPercentage</span> <span style="color: #555">(core metric)</span></dt> <dd>The percentage of viewers who were logged in when watching the video or playlist. <span class="notranslate">This is a core metric and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span></dd> </dl> </div> <h3 id="Watch_Time_Metrics" data-text="Watch time metrics" tabindex="-1">Watch time metrics</h3> <div style="padding-left:25px"> <dl> <dt id="estimatedMinutesWatched" class="notranslate"><span itemprop="property">estimatedMinutesWatched</span> <span style="color: #555">(core metric)</span></dt> <dd>The number of minutes that users watched videos for the specified channel, content owner, video, or playlist. <span class="notranslate">This is a core metric and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span><br/></dd> <dt id="estimatedRedMinutesWatched" class="notranslate"><span itemprop="property">estimatedRedMinutesWatched</span></dt> <dd>The number of minutes that YouTube Premium (previously known as YouTube Red) members watched a video.<br/></dd> <dt id="averageViewDuration" class="notranslate"><span itemprop="property">averageViewDuration</span> <span style="color: #555">(core metric)</span></dt> <dd>The average length, in seconds, of video playbacks. As of December 13, 2021, this metric excludes <a href="https://support.google.com/youtube/answer/10332730">looping clips</a> traffic. In a playlist report, the metric indicates the average length, in seconds, of video playbacks that occurred in the context of a playlist. <span class="notranslate">This is a core metric and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span><br/></dd> <dt id="averageViewPercentage" class="notranslate"><span itemprop="property">averageViewPercentage</span></dt> <dd>The average percentage of a video watched during a video playback. As of December 13, 2021, this metric excludes <a href="https://support.google.com/youtube/answer/10332730">looping clips</a> traffic.</dd> </dl> </div> <h3 id="Engagement_Metrics" data-text="Engagement metrics" tabindex="-1">Engagement metrics</h3> <div style="padding-left:25px"> <dl> <dt id="comments" class="notranslate"><span itemprop="property">comments</span> <span style="color: #555">(core metric)</span></dt> <dd>The number of times that users commented on a video. See the <a href="http://support.google.com/youtube/bin/static.py?topic=1715101&guide=1714169&page=guide.cs">YouTube Help Center</a> for more information. <span class="notranslate">This is a core metric and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span><br/></dd> <dt id="likes" class="notranslate"><span itemprop="property">likes</span> <span style="color: #555">(core metric)</span></dt> <dd>The number of times that users indicated that they liked a video by giving it a positive rating. <span class="notranslate">This is a core metric and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span><br/></dd> <dt id="dislikes" class="notranslate"><span itemprop="property">dislikes</span> <span style="color: #555">(core metric)</span></dt> <dd>The number of times that users indicated that they disliked a video by giving it a negative rating. <span class="notranslate">This is a core metric and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span><br/></dd> <dt id="shares" class="notranslate"><span itemprop="property">shares</span> <span style="color: #555">(core metric)</span></dt> <dd>The number of times that users shared a video through the <code translate="no" dir="ltr">Share</code> button. See the <a href="http://support.google.com/youtube/bin/static.py?topic=1733021&guide=1714169&page=guide.cs">YouTube Help Center</a> for more information. <span class="notranslate">This is a core metric and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span><br/></dd> <dt id="subscribersGained" class="notranslate"><span itemprop="property">subscribersGained</span> <span style="color: #555">(core metric)</span></dt> <dd>The number of times that users subscribed to a channel. <span class="notranslate">This is a core metric and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span><br/><br/>Channels can gain or lose subscribers in several places, including the video watch page, the channel page, and the guide that appears on the YouTube home page. In channel reports, this metric includes subscribers gained from any of these places. However, in reports that use either the <code translate="no" dir="ltr">video</code> dimension or the <code translate="no" dir="ltr">filter</code> parameter to restrict the response to only include data for a particular video, the <code translate="no" dir="ltr">subscribersGained</code> metric will only include statistics from the specified video's watch page. <br/></dd> <dt id="subscribersLost" class="notranslate"><span itemprop="property">subscribersLost</span> <span style="color: #555">(core metric)</span></dt> <dd>The number of times that users unsubscribed from a channel. <span class="notranslate">This is a core metric and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span><br/><br/>Data for this metric is reported similarly to the <code translate="no" dir="ltr">subscribersGained</code> metric. In channel reports, this metric includes subscribers lost through any mechanism through which users can unsubcribe from a channel. However, in reports that use either the <code translate="no" dir="ltr">video</code> dimension or the <code translate="no" dir="ltr">filter</code> parameter to restrict the response to only include data for a particular video, this metric only includes users who unsubscribed from the specified video's watch page. <br/></dd> <dt id="videosAddedToPlaylists" class="notranslate"><span itemprop="property">videosAddedToPlaylists</span></dt> <dd>The number of times that videos were added to any YouTube playlists. The videos could have been added to the video owner's playlist or to other channels' playlists.<br><br>The metric value does include the number of times that videos were added to default playlists like the "Watch Later" playlist. However, it does not count playlists that a video is automatically added to, such as a channel's uploads playlist or a user's watch history.<br><br>This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, and then adds it again, the metric value reflects the video being added to a playlist twice. Data for this metric is not available for dates before October 1, 2014.<br/></dd> <dt id="videosRemovedFromPlaylists" class="notranslate"><span itemprop="property">videosRemovedFromPlaylists</span></dt> <dd>The number of times that videos were removed from any YouTube playlists. The videos could have been removed from the video owner's playlist or from other channels' playlists.<br><br>The metric value includes the number of times that videos were removed from default playlists like the "Watch Later" playlist.<br><br>This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, adds it again, and then removes it again, the metric value reflects the video being removed from a playlist twice. Data for this metric is not available for dates before October 1, 2014.<br/></dd> </dl> <h4 id="Deprecated_Engagement_Metrics" data-text="Deprecated engagement metrics" tabindex="-1">Deprecated engagement metrics</h4> <p>The following metrics were both <a href="#Core_Metrics">core metrics</a> that were deprecated on March 31, 2015. </p> <dl> <dt id="favoritesAdded" class="notranslate"><span itemprop="property">favoritesAdded</span> <span style="color: #555">(core metric)</span> (<span style="color:red">deprecated March 31, 2015)</span></dt> <dd>The number of times that users marked a video as a favorite video. See the <a href="http://support.google.com/youtube/bin/static.py?topic=1715146&guide=1714169&page=guide.cs">YouTube Help Center</a> for more information. <span class="notranslate">This is a core metric and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span><br/></dd> <dt id="favoritesRemoved" class="notranslate"><span itemprop="property">favoritesRemoved</span> <span style="color: #555">(core metric)</span> (<span style="color:red">deprecated March 31, 2015)</span></dt> <dd>The number of times that users removed a video from their favorite video lists. See the <a href="http://support.google.com/youtube/bin/static.py?topic=1715146&guide=1714169&page=guide.cs">YouTube Help Center</a> for more information. <span class="notranslate">This is a core metric and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span><br/></dd> </dl> </div> <h3 id="Playlist_Metrics" data-text="Playlist metrics" tabindex="-1">Playlist metrics</h3> <p>Playlist reports contain two types of metrics that explain how viewers interact with the videos in a playlist:</p> <ul> <li> <p><b>Aggregated video metrics</b> provide user activity and impression metrics that are aggregated for all videos in the playlist that are also owned by the channel that owns the playlist. Metrics for videos owned by other channels are not computed in the aggregation. As a result, if a channel creates a playlist that contains only videos owned by other channels, reports for those playlists will not provide values for these metrics.</p> <p>Refer to the <a href="#View_Metrics">view metrics</a> and <a href="#Watch_Time_Metrics">watch time metrics</a> sections of this document for definitions of supported aggregated video metrics.</p> </li> <li> <p><b>In-playlist metrics</b> reflect user activity and engagement in the context of the playlist page. These metrics include views for all videos in the playlist, regardless of which channel owns them, but only counts views that occurred in the playlist context.</p> </li> </ul> <p>Most of the metrics listed below are in-playlist metrics; the remaining metrics in the list, such as the <code translate="no" dir="ltr">playlistSaves</code> metric, are about user interactions with the playlist itself and not with videos in the playlist. As such, those metrics would not be characterized as either aggregated video metrics or in-playlist metrics.</p> <div style="padding-left:25px"> <dl> <dt id="averageTimeInPlaylist" class="notranslate"><span itemprop="property">averageTimeInPlaylist</span></dt> <dd>The estimated average amount of time, in minutes, that a viewer viewed videos in a playlist after the playlist was initiated. Note that this metric includes only playlist views that occurred on the web.<br/></dd> <dt id="playlistAverageViewDuration" class="notranslate"><span itemprop="property">playlistAverageViewDuration</span></dt> <dd>The estimated average length, in seconds, watched per playlist view. Note that this metric represents the average length of views of individual videos within a playlist; the <code translate="no" dir="ltr">averageTimeInPlaylist</code> metric, by contrast, represents the average time each viewer spends watching the playlist as a whole. This metric includes data for playlist videos that are owned by other channels. <br/></dd> <dt id="playlistEstimatedMinutesWatched" class="notranslate"><span itemprop="property">playlistEstimatedMinutesWatched</span></dt> <dd>The number of minutes that users watched the playlist content as a part of the playlist. Watch time that occurred in other contexts—for example, watch time from views that occurred when viewers were watching the same video as part of other playlists—is not counted. This metric includes data for playlist videos that are owned by other channels. <br/></dd> <dt id="playlistSaves" class="notranslate"><span itemprop="property">playlistSaves</span></dt> <dd>The net number of times that users saved a playlist. See the <a href="https://support.google.com/youtube/answer/4541577">YouTube Help Center</a> for more information about saved playlists. This metric returns a net change number, meaning that if a user saves a playlist, removes it from the list of saved playlists, and saves it again, the metric value reflects one playlist save being added.<br/></dd> <dt id="playlistStarts" class="notranslate"><span itemprop="property">playlistStarts</span></dt> <dd>The number of times that viewers initiated playback of a playlist. Note that this metric includes only playlist views that occurred on the web.<br/></dd> <dt id="playlistViews" class="notranslate"><span itemprop="property">playlistViews</span></dt> <dd>The number of times that videos in the playlist were viewed in the context of that playlist. This metric includes data for playlist videos that are owned by other channels. <br/></dd> <dt id="viewsPerPlaylistStart" class="notranslate"><span itemprop="property">viewsPerPlaylistStart</span></dt> <dd>The average number of video views that occurred each time a playlist was initiated. Note that this metric includes only playlist views that occurred on the web.<br/></dd> </dl> </div> <h3 id="Annotations_Metrics" data-text="Annotations metrics" tabindex="-1">Annotations metrics</h3> <p class="special"><b>Note:</b> YouTube Analytics API reports only return data for the <code translate="no" dir="ltr"><a href="#annotationClickThroughRate">annotationClickThroughRate</a></code> and <code translate="no" dir="ltr"><a href="#annotationCloseRate">annotationCloseRate</a></code> metrics as of June 10, 2012. In addition, YouTube Analytics API reports only return data for the remaining annotation metrics as of July 16, 2013.</p> <div style="padding-left:25px"> <dl> <dt id="annotationImpressions" class="notranslate"><span itemprop="property">annotationImpressions</span></dt> <dd>The total number of annotation impressions.<br/></dd> <dt id="annotationClickableImpressions" class="notranslate"><span itemprop="property">annotationClickableImpressions</span></dt> <dd>The number of annotations that appeared and could be clicked.<br/></dd> <dt id="annotationClicks" class="notranslate"><span itemprop="property">annotationClicks</span></dt> <dd>The number of clicked annotations.<br/></dd> <dt id="annotationClickThroughRate" class="notranslate"><span itemprop="property">annotationClickThroughRate</span> <span style="color: #555">(core metric)</span></dt> <dd>The ratio of annotations that viewers clicked to the total number of clickable annotation impressions. <span class="notranslate">This is a core metric and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span> The YouTube Help Center has more information about <a href="http://support.google.com/youtube/bin/answer.py?answer=92710&topic=2802217&ctx=topic">creating annotations</a> and <a href="http://support.google.com/youtube/bin/answer.py?answer=1092582&topic=2802217&ctx=topic">using link annotations</a>.<br/></dd> <dt id="annotationClosableImpressions" class="notranslate"><span itemprop="property">annotationClosableImpressions</span></dt> <dd>The number of annotations that appeared and could be closed.<br/></dd> <dt id="annotationCloses" class="notranslate"><span itemprop="property">annotationCloses</span></dt> <dd>The number of closed annotations.<br/></dd> <dt id="annotationCloseRate" class="notranslate"><span itemprop="property">annotationCloseRate</span> <span style="color: #555">(core metric)</span></dt> <dd>The ratio of annotations that viewers closed to the total number of annotation impressions. <span class="notranslate">This is a core metric and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span></dd> </dl> </div> <h3 id="Card_Metrics" data-text="Card metrics" tabindex="-1">Card metrics</h3> <p>The YouTube Help Center contains more detailed instructions for <a href="https://support.google.com/youtube/answer/6140493?ref_topic=6140492">adding cards to your videos</a> and the <a href="https://support.google.com/youtube/answer/6165415">YouTube Analytics Cards Report</a>.</p> <div style="padding-left:25px"> <dl> <dt id="cardImpressions" class="notranslate"><span itemprop="property">cardImpressions</span></dt> <dd>The number of times cards were displayed. When the card panel is opened, a card impression is logged for each of the video's cards.<br/></dd> <dt id="cardClicks" class="notranslate"><span itemprop="property">cardClicks</span></dt> <dd>The number of times that cards were clicked.<br/></dd> <dt id="cardClickRate" class="notranslate"><span itemprop="property">cardClickRate</span></dt> <dd>The click-through-rate for cards, which is calculated as the ratio of card clicks to card impressions.<br/></dd> <dt id="cardTeaserImpressions" class="notranslate"><span itemprop="property">cardTeaserImpressions</span></dt> <dd>The number of times that card teasers were displayed. A video view can generate multiple teaser impressions.<br></dd> <dt id="cardTeaserClicks" class="notranslate"><span itemprop="property">cardTeaserClicks</span></dt> <dd>The number of clicks on card teasers. Card icon clicks are attributed to the last teaser displayed to the user.<br/></dd> <dt id="cardTeaserClickRate" class="notranslate"><span itemprop="property">cardTeaserClickRate</span></dt> <dd>The click-through-rate for card teasers, which is calculated as the ratio of clicks on card teasers to the total number of card teaser impressions.<br/></dd> </dl> </div> <h3 id="Concurrent_Viewers" data-text="Livestream metrics (concurrent viewers)" tabindex="-1">Livestream metrics (concurrent viewers)</h3> <div style="padding-left:25px"> <dl> <dt id="averageConcurrentViewers" class="notranslate"><span itemprop="property">averageConcurrentViewers</span></dt> <dd>The average number of concurrent viewers for a particular video. If the <a href="/youtube/analytics/v1/dimsmets/dims#livestreamPosition">livestreamPosition</a> dimension is specified for the report, then the <code translate="no" dir="ltr">averageConcurrentViewers</code> value specifies the average number of concurrent viewers during a particular segment</dd> <dt id="peakConcurrentViewers" class="notranslate"><span itemprop="property">peakConcurrentViewers</span></dt> <dd>The peak number of concurrent viewers for a particular video. If the <a href="/youtube/analytics/v1/dimsmets/dims#livestreamPosition">livestreamPosition</a> dimension is specified for the report, then the <code translate="no" dir="ltr">peakConcurrentViewers</code> value specifies the peak number of concurrent viewers during a particular segment of the video.</dd> </dl> </div> <h3 id="Audience_Retention_Metrics" data-text="Audience retention metrics" tabindex="-1">Audience retention metrics</h3> <div style="padding-left:25px"> <dl> <dt id="audienceWatchRatio" class="notranslate"><span itemprop="property">audienceWatchRatio</span></dt> <dd>The absolute ratio of viewers watching the video at the given point in the video. The ratio is calculated by comparing the number of times a portion of a video has been watched to the total number of views of the video. The <code translate="no" dir="ltr"><a href="/youtube/analytics/v1/dimsmets/dims#elapsedVideoTimeRatio">elapsedVideoTimeRatio</a></code> dimension identifies the portion of the video to which the metric corresponds.<br/><br/> Note that a portion of a video could be watched more than once (or not at all) in a given video view. For example, if users rewind and watch the same portion of a video multiple times, then the absolute ratio for that portion of the video the could be greater than <code translate="no" dir="ltr">1</code>.<br/><br/> The following examples illustrate how the value is calculated: <ul> <li>A one-minute video is watched 100 times. Half of the viewers stop watching after 15 seconds and the rest watch the entire video. None of the viewers watch any parts of the video more than once. In this case, this metric's value would be <code translate="no" dir="ltr">1</code> for time buckets in the first quarter of the video, and its value would be <code translate="no" dir="ltr">0.50</code> for the remainder of the video.</li> <li>A one-minute video is watched 100 times. All of the viewers watch the entire video, but 20 of the viewers watch until the video's 45-second mark, then skip back to the video's 30-second mark, and then watch the remainder of the video. In this case, the metric's value would be <code translate="no" dir="ltr">1</code> for time buckets in either the first half or the last quarter of the video. However, the value would be <code translate="no" dir="ltr">1.2</code> for time buckets in the third quarter of the video since 100 percent of the viewers watched that segment of the video but 20% of those viewers watched the segment twice.</li> </ul></dd> <dt id="relativeRetentionPerformance" class="notranslate"><span itemprop="property">relativeRetentionPerformance</span> </dt> <dd>A measurement that shows how well a video retains viewers during playbacks in comparison to all YouTube videos of similar length. The metric has a value between <code translate="no" dir="ltr">0</code> and <code translate="no" dir="ltr">1</code> that identifies the video's relative retention performance at a given point in the video. The point in the video is provided by the <code translate="no" dir="ltr"><a href="/youtube/analytics/v1/dimsmets/dims#elapsedVideoTimeRatio">elapsedVideoTimeRatio</a></code> dimension.<br><br> A value of <code translate="no" dir="ltr">0</code> indicates that the video retains viewers worse than any other video of similar length, while a value of <code translate="no" dir="ltr">1</code> indicates that the video retains viewers better than any other video of similar length. A median value of <code translate="no" dir="ltr">0.5</code> indicates that half of the videos of similar length retain viewers better while half retain viewers worse.<br><br> The following <em>hypothetical</em> example illustrates how the values might appear in a report. On average, 90 percent of viewers who watch videos that are 10 minutes long are still watching after three minutes and 70 percent are still watching after eight minutes. However, for a specific 10-minute-long video, only 80 percent of viewers are still watching after three minutes, but all of those viewers are still watching after eight minutes. <ul> <li>At the <code translate="no" dir="ltr"><a href="/youtube/analytics/v1/dimsmets/dims#elapsedVideoTimeRatio">elapsedVideoTimeRatio</a></code> value that corresponds to the point that is three minutes into the video, the <code translate="no" dir="ltr">relativeRetentionPerformance</code> metric would have a value below <code translate="no" dir="ltr">0.5</code> since, at that time, the video performs worse than the average video.</li> <li>At the <code translate="no" dir="ltr"><a href="/youtube/analytics/v1/dimsmets/dims#elapsedVideoTimeRatio">elapsedVideoTimeRatio</a></code> value corresponding to the point that is eight minutes into the video, the <code translate="no" dir="ltr">relativeRetentionPerformance</code> metric would have a value higher than <code translate="no" dir="ltr">0.5</code> since, at that time, the video is performing better than other videos of similar length.</li> </ul></dd> <dt id="startedWatching" class="notranslate"><span itemprop="property">startedWatching</span></dt> <dd>The number of times a particular segment of the video was the first segment seen during a video playback.<br><br> For example, suppose Video X is 5 minutes long. For the purposes of this report, YouTube divides the video into 100 3-second segments, which are identified with the <a href="/youtube/analytics/v1/dimsmets/dims#elapsedVideoTimeRatio">elapsedVideoTimeRatio</a> dimension. A viewer visits YouTube and watches the first minute and ten seconds of the video, which includes all or part of the first 24 segments of the video. On a subsequent YouTube visit, the viewer watches the rest of the video, resuming playback in segment 24 and continuing through segment 100.<br><br> This example would produce these watch metric values: <ul> <li>The value of the <code translate="no" dir="ltr">startedWatching</code> metric would be <code translate="no" dir="ltr">1</code> for segments 1 and 24, and the metric value would be <code translate="no" dir="ltr">0</code> for all other segments.</li> <li>The value of the <code translate="no" dir="ltr">stoppedWatching</code> metric would be <code translate="no" dir="ltr">1</code> for segments 24 and 100, and the metric value would be <code translate="no" dir="ltr">0</code> for all other segments.</li> <li>The value of the <code translate="no" dir="ltr">totalSegmentImpressions</code> metric would be <code translate="no" dir="ltr">2</code> for segment 24, and the metric value would be <code translate="no" dir="ltr">1</code> for all other segments.</li> </ul> </dd> <dt id="stoppedWatching" class="notranslate"><span itemprop="property">stoppedWatching</span></dt> <dd>The number of times a particular segment of the video was the last segment seen during a video playback. Refer to the definition of the <code translate="no" dir="ltr">startedWatching</code> metric for an example of how this metric value is calculated.</dd> <dt id="totalSegmentImpressions" class="notranslate"><span itemprop="property">totalSegmentImpressions</span></dt> <dd>The number of times a particular segment of a video was viewed. Refer to the definition of the <code translate="no" dir="ltr">startedWatching</code> metric for an example of how this metric value is calculated. Note that a viewer can watch the same segment of a video multiple times in the same playback.</dd> </dl> </div> <h3 id="Membership_Cancellation_Metrics" data-text="Membership cancellation metrics" tabindex="-1">Membership cancellation metrics</h3> <div style="padding-left:25px"> <dl> <dt id="membershipsCancellationSurveyResponses" class="notranslate"><span itemprop="property">membershipsCancellationSurveyResponses</span></dt> <dd>The number of surveys completed by YouTube users who canceled their channel membership for the specified channel during the reporting period.</dd> </dl> </div> <h3 id="Estimated_Revenue_Metrics" data-text="Estimated revenue metrics" tabindex="-1">Estimated revenue metrics</h3> <p class="note"><b>Note:</b> Estimated revenue metrics are subject to month-end adjustments and do not include partner-sold and partner-served advertising. Please see the <a href="https://support.google.com/youtube/answer/1714384">YouTube Help Center</a> for additional information and notes about estimated revenue figures.</p> <div class="note">By default, all estimated revenue figures are reported in USD. However, the YouTube Analytics API supports the <code translate="no" dir="ltr"><a href="/youtube/analytics/v1#currency">currency</a></code> parameter for some estimated revenue and ad performance metrics, allowing you to retrieve estimated revenue data in other currencies.</div> <div style="padding-left:25px"> <dl> <span id="estimatedRevenue"></span> <dt id="estimatedRevenue" class="notranslate"><span itemprop="property">estimatedRevenue</span> <span style="color: #555">(core metric)</span> <span style="color: #555;">(previously named <code translate="no" dir="ltr">earnings</code>)</span></dt> <dd>The total estimated net revenue from all Google-sold advertising sources as well as from non-advertising sources for the selected date range and region. <span class="notranslate">This is a core metric and is subject to the <a href="/youtube/youtube-api-list">Deprecation Policy</a>.</span><br/><br/>Estimated revenue metrics are subject to month-end adjustment and do not include partner-sold and partner-served advertising.<br/> </dd> <span id="estimatedAdRevenue"></span> <dt id="estimatedAdRevenue" class="notranslate"><span itemprop="property">estimatedAdRevenue</span> <span style="color: #555;">(previously named <code translate="no" dir="ltr">adEarnings</code>)</span></dt> <dd>The total estimated net revenue from all Google-sold advertising sources for the selected date range and region.<br/><br/>Estimated revenue metrics are subject to month-end adjustment and do not include partner-sold and partner-served advertising.<br/></dd> <span id="estimatedRedPartnerRevenue"></span> <dt id="estimatedRedPartnerRevenue" class="notranslate"><span itemprop="property">estimatedRedPartnerRevenue</span> <span style="color: #555;">(previously named <code translate="no" dir="ltr">redPartnerRevenue</code>)</span></dt> <dd>The total estimated revenue earned from YouTube Premium (previously known as YouTube Red) subscriptions for the selected report dimensions. The metric's value reflects revenue from both music and non-music content and is subject to month-end adjustment.<br/></dd> </dl> </div> <h3 id="Ad_Performance_Metrics" data-text="Ad performance metrics" tabindex="-1">Ad performance metrics</h3> <div style="padding-left:25px"> <dl> <dt id="grossRevenue" class="notranslate"><span itemprop="property">grossRevenue</span></dt> <dd>The estimated gross revenue, in USD, from all Google-sold or DoubleClick-partner-sold advertising for the selected date range and region. Gross revenue is subject to month-end adjustment and does not include partner-served advertising. Gross revenue should not be confused with estimated revenue, or net revenue, which factors in your share of ownership and revenue-sharing agreements.<br/></dd> <span id="cpm"></span> <dt id="cpm" class="notranslate"><span itemprop="property">cpm</span> <span style="color: #555;">(previously named <code translate="no" dir="ltr">impressionBasedCpm</code>)</span></dt> <dd>The estimated gross revenue per thousand ad impressions.<br/></dd> <span id="adImpressions"></span> <dt id="adImpressions" class="notranslate"><span itemprop="property">adImpressions</span> <span style="color: #555;">(previously named <code translate="no" dir="ltr">impressions</code>)</span></dt> <dd>The number of verified ad impressions served.<br/></dd> <dt id="monetizedPlaybacks" class="notranslate"><span itemprop="property">monetizedPlaybacks</span></dt> <dd>The number of instances when a viewer played your video and was shown at least one ad impression. A monetized playback is counted if a viewer is shown a preroll ad but quits watching the ad before your video ever starts. The expected estimated error for this figure is ±2.0%.<br/></dd> <dt id="playbackBasedCpm" class="notranslate"><span itemprop="property">playbackBasedCpm</span></dt> <dd>The estimated gross revenue per thousand playbacks.<br/></dd> </dl> </div> </div> </div> <devsite-recommendations display="in-page" hidden yield> </devsite-recommendations> <devsite-thumb-rating position="footer"> </devsite-thumb-rating> <devsite-recommendations id="recommendations-link" yield></devsite-recommendations> <div class="devsite-floating-action-buttons"> </div> </article> <devsite-content-footer class="nocontent"> <p>Except as otherwise noted, the content of this page is licensed under the <a href="https://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 License</a>, and code samples are licensed under the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 License</a>. For details, see the <a href="https://developers.google.com/site-policies">Google Developers Site Policies</a>. Java is a registered trademark of Oracle and/or its affiliates.</p> <p>Last updated 2024-08-14 UTC.</p> </devsite-content-footer> <devsite-notification > </devsite-notification> <div class="devsite-content-data"> <template class="devsite-content-data-template"> [[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-08-14 UTC."],[],[]] </template> </div> </devsite-content> </main> <devsite-footer-promos class="devsite-footer"> <nav class="devsite-footer-promos nocontent" aria-label="Promotions"> <ul class="devsite-footer-promos-list"> <li class="devsite-footer-promo"> <a href="https://blog.youtube" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 1)" > <picture> <img class="devsite-footer-promo-icon" src="/static/site-assets/logo-youtube.svg" loading="lazy" alt="Blog"> </picture> <span class="devsite-footer-promo-label"> Blog </span> </a> <div class="devsite-footer-promo-description">The latest news on the YouTube blog</div> </li> <li class="devsite-footer-promo"> <a href="https://github.com/youtube/api-samples" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 2)" > <picture> <img class="devsite-footer-promo-icon" src="/static/site-assets/logo-github.svg" loading="lazy" alt="GitHub"> </picture> <span class="devsite-footer-promo-label"> GitHub </span> </a> <div class="devsite-footer-promo-description">Find API code samples and other YouTube open-source projects.</div> </li> <li class="devsite-footer-promo"> <a href="https://issuetracker.google.com/issues/new?component=186600&template=874803" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 3)" > <picture> <img class="devsite-footer-promo-icon" src="/static/site-assets/developers_64dp.png" loading="lazy" alt="Issue Tracker"> </picture> <span class="devsite-footer-promo-label"> Issue Tracker </span> </a> <div class="devsite-footer-promo-description">Something wrong? Send us a bug report!</div> </li> <li class="devsite-footer-promo"> <a href="http://stackoverflow.com/questions/ask?tags=youtube-api" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 4)" > <picture> <img class="devsite-footer-promo-icon" src="/static/site-assets/logo-stack-overflow.svg" loading="lazy" alt="Stack Overflow"> </picture> <span class="devsite-footer-promo-label"> Stack Overflow </span> </a> <div class="devsite-footer-promo-description">Ask a question under the youtube-api tag</div> </li> <li class="devsite-footer-promo"> <a href="https://research.youtube/" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 5)" > <picture> <img class="devsite-footer-promo-icon" src="/static/site-assets/logo-youtube.svg" loading="lazy" alt="YouTube Researcher Program"> </picture> <span class="devsite-footer-promo-label"> YouTube Researcher Program </span> </a> <div class="devsite-footer-promo-description">For researchers interested in using data from YouTube’s global API</div> </li> </ul> </nav> </devsite-footer-promos> <devsite-footer-linkboxes class="devsite-footer"> <nav class="devsite-footer-linkboxes nocontent" aria-label="Footer links"> <ul class="devsite-footer-linkboxes-list"> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Tools</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="https://developers.google.com/apis-explorer/#p/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" > Google APIs Explorer </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/youtube/youtube_player_demo" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" > YouTube Player Demo </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/youtube/youtube_subscribe_button" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" > Configure a Subscribe Button </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Issue Tracker</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="https://issuetracker.google.com/issues/new?component=186600&template=874803" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" > File a bug </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://issuetracker.google.com/issues/new?component=186600&template=874803" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" > Request a feature </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://issuetracker.google.com/issues?q=componentid:186600" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" > See open issues </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Product Info</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="/youtube/terms/api-services-terms-of-service" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" > Terms of Service </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/youtube/terms/developer-policies" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" > Developer Policies </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/youtube/terms/required-minimum-functionality" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" > Required Minimum Functionality </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/youtube/terms/branding-guidelines" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 4)" > Branding Guidelines </a> </li> </ul> </li> </ul> </nav> </devsite-footer-linkboxes> <devsite-footer-utility class="devsite-footer"> <div class="devsite-footer-utility nocontent"> <nav class="devsite-footer-sites" aria-label="Other Google Developers websites"> <a href="https://developers.google.com/" class="devsite-footer-sites-logo-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google Developers Link"> <picture> <img class="devsite-footer-sites-logo" src="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/lockup-google-for-developers.svg" loading="lazy" alt="Google Developers"> </picture> </a> <ul class="devsite-footer-sites-list"> <li class="devsite-footer-sites-item"> <a href="//developer.android.com" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Android Link" > Android </a> </li> <li class="devsite-footer-sites-item"> <a href="//developer.chrome.com/home" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Chrome Link" > Chrome </a> </li> <li class="devsite-footer-sites-item"> <a href="//firebase.google.com" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Firebase Link" > Firebase </a> </li> <li class="devsite-footer-sites-item"> <a href="//cloud.google.com" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google Cloud Platform Link" > Google Cloud Platform </a> </li> <li class="devsite-footer-sites-item"> <a href="//ai.google.dev/" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google AI Link" > Google AI </a> </li> <li class="devsite-footer-sites-item"> <a href="/products" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer All products Link" > All products </a> </li> </ul> </nav> <nav class="devsite-footer-utility-links" aria-label="Utility links"> <ul class="devsite-footer-utility-list"> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="/terms/site-terms" data-category="Site-Wide Custom Events" data-label="Footer Terms link" > Terms </a> </li> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="//policies.google.com/privacy" data-category="Site-Wide Custom Events" data-label="Footer Privacy link" > Privacy </a> </li> <li class="devsite-footer-utility-item glue-cookie-notification-bar-control"> <a class="devsite-footer-utility-link gc-analytics-event" href="#" data-category="Site-Wide Custom Events" data-label="Footer Manage cookies link" aria-hidden="true" > Manage cookies </a> </li> <li class="devsite-footer-utility-item devsite-footer-utility-button"> <span class="devsite-footer-utility-description">Sign up for the Google for Developers newsletter</span> <a class="devsite-footer-utility-link gc-analytics-event" href="/newsletter/subscribe" data-category="Site-Wide Custom Events" data-label="Footer Subscribe link" > Subscribe </a> </li> </ul> <devsite-language-selector> <ul role="presentation"> <li role="presentation"> <a role="menuitem" lang="en" >English</a> </li> <li role="presentation"> <a role="menuitem" lang="de" >Deutsch</a> </li> <li role="presentation"> <a role="menuitem" lang="es" >Español</a> </li> <li role="presentation"> <a role="menuitem" lang="es_419" >Español – América Latina</a> </li> <li role="presentation"> <a role="menuitem" lang="fr" >Français</a> </li> <li role="presentation"> <a role="menuitem" lang="id" >Indonesia</a> </li> <li role="presentation"> <a role="menuitem" lang="it" >Italiano</a> </li> <li role="presentation"> <a role="menuitem" lang="pl" >Polski</a> </li> <li role="presentation"> <a role="menuitem" lang="pt_br" >Português – Brasil</a> </li> <li role="presentation"> <a role="menuitem" lang="vi" >Tiếng Việt</a> </li> <li role="presentation"> <a role="menuitem" lang="tr" >Türkçe</a> </li> <li role="presentation"> <a role="menuitem" lang="ru" >Русский</a> </li> <li role="presentation"> <a role="menuitem" lang="he" >עברית</a> </li> <li role="presentation"> <a role="menuitem" lang="ar" >العربيّة</a> </li> <li role="presentation"> <a role="menuitem" lang="fa" >فارسی</a> </li> <li role="presentation"> <a role="menuitem" lang="hi" >हिंदी</a> </li> <li role="presentation"> <a role="menuitem" lang="bn" >বাংলা</a> </li> <li role="presentation"> <a role="menuitem" lang="th" >ภาษาไทย</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_cn" >中文 – 简体</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_tw" >中文 – 繁體</a> </li> <li role="presentation"> <a role="menuitem" lang="ja" >日本語</a> </li> <li role="presentation"> <a role="menuitem" lang="ko" >한국어</a> </li> </ul> </devsite-language-selector> </nav> </div> </devsite-footer-utility> <devsite-panel></devsite-panel> <devsite-concierge data-info-panel data-ai-panel data-api-explorer-panel > </devsite-concierge> </section></section> <devsite-sitemask></devsite-sitemask> <devsite-snackbar></devsite-snackbar> <devsite-tooltip ></devsite-tooltip> <devsite-heading-link></devsite-heading-link> <devsite-analytics> <script type="application/json" analytics>[{"dimensions": {"dimension5": "en", "dimension4": "YouTube Analytics and Reporting APIs", "dimension11": false, "dimension3": false, "dimension6": "en", "dimension1": "Signed out"}, "gaid": "UA-24532603-1", "metrics": {"ratings_count": "metric2", "ratings_value": "metric1"}, "purpose": 1}]</script> <script type="application/json" tag-management>{"at": "True", "ga4": [{"id": "G-272J68FCRF", "purpose": 1}], "ga4p": [{"id": "G-272J68FCRF", "purpose": 1}], "gtm": [], "parameters": {"internalUser": "False", "language": {"machineTranslated": "False", "requested": "en", "served": "en"}, "pageType": "reference", "projectName": "YouTube Analytics and Reporting APIs", "signedIn": "False", "tenant": "developers", "recommendations": {"sourcePage": "", "sourceType": 0, "sourceRank": 0, "sourceIdenticalDescriptions": 0, "sourceTitleWords": 0, "sourceDescriptionWords": 0, "experiment": ""}, "experiment": {"ids": ""}}}</script> </devsite-analytics> <devsite-badger></devsite-badger> <script nonce="AJFPtQ+AV+/POUmWoeelLHgO87TLIX"> (function(d,e,v,s,i,t,E){d['GoogleDevelopersObject']=i; t=e.createElement(v);t.async=1;t.src=s;E=e.getElementsByTagName(v)[0]; E.parentNode.insertBefore(t,E);})(window, document, 'script', 'https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/js/app_loader.js', '[1,"en",null,"/js/devsite_app_module.js","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers","https://developers-dot-devsite-v2-prod.appspot.com",null,null,["/_pwa/developers/manifest.json","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/images/video-placeholder.svg","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/favicon-new.png","https://fonts.googleapis.com/css?family=Google+Sans:400,500|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700&display=swap"],1,null,[1,6,8,12,14,17,21,25,50,52,63,70,75,76,80,87,91,92,93,97,98,100,101,102,103,104,105,107,108,109,110,112,113,117,118,120,122,124,125,126,127,129,130,131,132,133,134,135,136,138,140,141,147,148,149,151,152,156,157,158,159,161,163,164,168,169,170,179,180,182,183,186,191,193,196],"AIzaSyAP-jjEJBzmIyKR4F-3XITp8yM9T1gEEI8","AIzaSyB6xiKGDR5O3Ak2okS4rLkauxGUG7XP0hg","developers.google.com","AIzaSyAQk0fBONSGUqCNznf6Krs82Ap1-NV6J4o","AIzaSyCCxcqdrZ_7QMeLCRY20bh_SXdAYqy70KY",null,null,null,["Analytics__enable_clearcut_logging","Search__enable_ai_search_summaries_restricted","MiscFeatureFlags__enable_firebase_utm","Profiles__enable_dashboard_curated_recommendations","Profiles__enable_recognition_badges","Experiments__reqs_query_experiments","Profiles__enable_profile_collections","Significatio__enable_by_tenant","Profiles__enable_awarding_url","Cloud__enable_cloud_facet_chat","CloudShell__cloud_code_overflow_menu","Profiles__enable_developer_profiles_callout","MiscFeatureFlags__emergency_css","TpcFeatures__enable_required_headers","Cloud__enable_legacy_calculator_redirect","MiscFeatureFlags__enable_variable_operator","CloudShell__cloud_shell_button","MiscFeatureFlags__developers_footer_dark_image","Search__enable_ai_search_summaries","Cloud__enable_cloud_shell","Cloud__enable_cloud_dlp_service","Profiles__enable_complete_playlist_endpoint","Concierge__enable_concierge","Search__enable_page_map","MiscFeatureFlags__enable_view_transitions","BookNav__enable_tenant_cache_key","Concierge__enable_concierge_restricted","TpcFeatures__enable_mirror_tenant_redirects","Profiles__enable_completecodelab_endpoint","Profiles__require_profile_eligibility_for_signin","Search__enable_suggestions_from_borg","Search__enable_dynamic_content_confidential_banner","DevPro__enable_cloud_innovators_plus","Cloud__enable_cloud_shell_fte_user_flow","Cloud__enable_llm_concierge_chat","Profiles__enable_release_notes_notifications","Profiles__enable_page_saving","Search__enable_ai_eligibility_checks","Concierge__enable_pushui","MiscFeatureFlags__enable_explain_this_code","DevPro__enable_developer_subscriptions","Cloud__enable_cloudx_ping","Profiles__enable_public_developer_profiles","Cloud__enable_free_trial_server_call","Cloud__enable_cloudx_experiment_ids","MiscFeatureFlags__developers_footer_image","MiscFeatureFlags__enable_project_variables","EngEduTelemetry__enable_engedu_telemetry"],null,null,"AIzaSyBLEMok-5suZ67qRPzx0qUtbnLmyT_kCVE","https://developerscontentserving-pa.clients6.google.com","AIzaSyCM4QpTRSqP5qI4Dvjt4OAScIN8sOUlO-k","https://developerscontentsearch-pa.clients6.google.com",1,4,null,"https://developerprofiles-pa.clients6.google.com",[1,"developers","Google for Developers","developers.google.com",null,"developers-dot-devsite-v2-prod.appspot.com",null,null,[1,1,[1],null,null,null,null,null,null,null,null,[1],null,null,null,null,null,null,[1],[1,null,null,[1,20],"/recommendations/information"],null,null,null,[1,1,1],[1,1,null,1,1]],null,[null,null,null,null,null,null,"/images/lockup-new.svg","/images/touchicon-180-new.png",null,null,null,null,1,null,null,null,null,null,null,null,null,1,null,null,null,"/images/lockup-dark-theme-new.svg",[]],[],null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,[6,1,14,15,20,22,23,29,32,36],null,[[null,null,null,[3,7,10,2,39,17,4,32,24,11,12,13,34,15,25],null,null,[1,[["docType","Choose a content type",[["Tutorial",null,null,null,null,null,null,null,null,"Tutorial"],["Guide",null,null,null,null,null,null,null,null,"Guide"],["Sample",null,null,null,null,null,null,null,null,"Sample"]]],["product","Choose a product",[["Android",null,null,null,null,null,null,null,null,"Android"],["ARCore",null,null,null,null,null,null,null,null,"ARCore"],["ChromeOS",null,null,null,null,null,null,null,null,"ChromeOS"],["Firebase",null,null,null,null,null,null,null,null,"Firebase"],["Flutter",null,null,null,null,null,null,null,null,"Flutter"],["Assistant",null,null,null,null,null,null,null,null,"Google Assistant"],["GoogleCloud",null,null,null,null,null,null,null,null,"Google Cloud"],["GoogleMapsPlatform",null,null,null,null,null,null,null,null,"Google Maps Platform"],["GooglePay",null,null,null,null,null,null,null,null,"Google Pay & Google Wallet"],["GooglePlay",null,null,null,null,null,null,null,null,"Google Play"],["Tensorflow",null,null,null,null,null,null,null,null,"TensorFlow"]]],["category","Choose a topic",[["AiAndMachineLearning",null,null,null,null,null,null,null,null,"AI and Machine Learning"],["Data",null,null,null,null,null,null,null,null,"Data"],["Enterprise",null,null,null,null,null,null,null,null,"Enterprise"],["Gaming",null,null,null,null,null,null,null,null,"Gaming"],["Mobile",null,null,null,null,null,null,null,null,"Mobile"],["Web",null,null,null,null,null,null,null,null,"Web"]]]]]],[1,1],null,1],[[["UA-24532603-1"],["UA-22084204-5"],null,null,["UA-24532603-5"],null,null,[["G-272J68FCRF"],null,null,[["G-272J68FCRF",2]]],[["UA-24532603-1",2]],null,[["UA-24532603-5",2]],null,1],[[13,10],[11,8],[12,9],[5,4],[3,2],[4,3],[15,12],[14,11],[1,1],[6,5],[16,13]],[[2,2],[1,1]]],null,4,null,null,null,null,null,null,null,null,null,null,null,null,null,"developers.devsite.google"],null,"pk_live_5170syrHvgGVmSx9sBrnWtA5luvk9BwnVcvIi7HizpwauFG96WedXsuXh790rtij9AmGllqPtMLfhe2RSwD6Pn38V00uBCydV4m"]') </script> <devsite-a11y-announce></devsite-a11y-announce> </body> </html>

CINXE.COM

Metrics | YouTube Analytics and Reporting APIs | Google for Developers