Примеры запросов API

На этой странице показаны примеры запросов API YouTube Analytics. В каждом примере кратко описывается извлекаемый отчет, а затем показаны соответствующие dimensions , metrics , filters и значения параметров sort . (Отчеты по каналам и отчеты владельцев контента определяют отчеты, которые поддерживает API.)

Каждый пример ссылается на Google API Explorer и заполняет его показанными значениями. В примерах также используются даты начала и окончания по умолчанию ( YYYY-MM-DD ) 2022-01-01 и 2022-06-30 .

После привязки к обозревателю API вы все равно должны указать владельца канала или контента, для которого вы получаете отчеты. Проводник API заполнит значение параметра ids либо channel==MINE , либо contentOwner==CONTENT_OWNER_ID , в зависимости от запроса, который вы щелкнули. Для отчетов по каналам вы можете изменить MINE на идентификатор канала аутентифицированного пользователя. В отчетах о владельце контента необходимо заменить CONTENT_OWNER_ID своим идентификатором владельца контента.

Вы также должны быть аутентифицированы как владелец указанного канала или контента, чтобы обозреватель API мог авторизовать ваши запросы API с помощью OAuth 2.0 .

  1. Сортировка запросов по нескольким параметрам/метрикам
  2. Отчеты канала
  3. Отчеты владельцев контента

Сортировка запросов по нескольким параметрам/метрикам

API поддерживает возможность сортировки данных ответов с использованием нескольких параметров или показателей. Например, приведенный ниже запрос извлекает данные об источнике ежедневного трафика для видео определенного канала. Каждая строка в результирующем наборе определяет количество просмотров и расчетное время просмотра из определенного типа источника трафика (например, EXT_URL ) в определенный день.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedWatchTime
sort=day,-views

В ответе результаты отсортированы в хронологическом порядке. В наборе результатов за каждый день результаты сортируются в порядке убывания количества просмотров. Итак, первая строка результирующего набора содержит данные для источника трафика, сгенерировавшего наибольшее количество просмотров в первый день запрошенного диапазона дат. Вторая строка содержит данные об источнике трафика, сгенерировавшем следующее наибольшее количество просмотров в первый день.

Отчеты канала

Основные характеристики

Видео отчеты

Общее количество просмотров, расчетное время просмотра и другие данные для канала.

Этот запрос извлекает агрегированные показатели для контента канала. Отчет возвращает одну строку данных, содержащую итоговые значения для каждой запрошенной метрики за указанный диапазон дат.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration

Количество просмотров (и многое другое) для канала в зависимости от страны

Этот запрос извлекает показатели для определенной страны для видео канала. Отчет возвращает одну строку данных, содержащую итоговые значения для каждой запрошенной метрики за указанный диапазон дат.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=country==US

Топ 10 — самые просматриваемые видео на канале

Этот запрос извлекает 10 наиболее просматриваемых видео канала, измеренных по расчетным минутам просмотра в указанном диапазоне дат. Результаты отсортированы по количеству минут просмотра в порядке убывания.

Примечание. В этом отчете необходимо указать значение параметра запроса sort и задать для параметра maxResults целочисленное значение 10 или меньше.

dimensions=video
metrics=estimatedMinutesWatched,views,likes,subscribersGained
maxResults=10
sort=-estimatedMinutesWatched

Топ-10 — CTR аннотаций для самых просматриваемых видео на канале.

Этот запрос извлекает количество просмотров, рейтинг кликов по аннотациям, коэффициент закрытия аннотаций и показы аннотаций для 10 наиболее просматриваемых видео на канале. Результаты сортируются по количеству просмотров в порядке убывания, что означает, что наиболее просматриваемое видео будет отображаться первым.

Примечание. В этом отчете необходимо указать значение параметра запроса sort и задать для параметра maxResults целочисленное значение 10 или меньше.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-views

Отчеты о плейлистах

Общее количество просмотров плейлиста для канала

Этот запрос извлекает общее количество запусков плейлиста, расчетное количество минут просмотра, количество просмотров и просмотров на запуск плейлиста для плейлистов на канале пользователя, прошедшего проверку подлинности. Метрика views учитывает только просмотры видео, произошедшие в контексте плейлиста.

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1

Статистика по конкретному плейлисту

Этот запрос извлекает общее количество запусков плейлиста, примерное время просмотра, просмотры и просмотры на запуск плейлиста для определенного плейлиста. Метрика views учитывает только просмотры видео, произошедшие в контексте плейлиста. Обратите внимание, что для выполнения этого запроса в обозревателе API необходимо заменить строку PLAYLIST_ID в значении параметра filters на идентификатор списка воспроизведения для списка воспроизведения в канале аутентифицированного пользователя.

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1;playlist==PLAYLIST_ID

Чтобы получить сводную статистику для нескольких списков воспроизведения, вы также можете заменить строку PLAYLIST_ID на список, разделенный запятыми, содержащий до 500 идентификаторов списков воспроизведения для списков воспроизведения на канале аутентифицированного пользователя.

Топ 10 — самые просматриваемые плейлисты для канала

Этот запрос извлекает 10 самых просматриваемых плейлистов на канале, измеренных по приблизительным минутам просмотра в указанном диапазоне дат. Он также извлекает несколько других показателей списка воспроизведения, таких как количество раз, когда зрители инициировали воспроизведение каждого списка воспроизведения, и среднее количество времени, в течение которого зритель просматривал видео в списке воспроизведения после его запуска. Результаты отсортированы по количеству минут просмотра в порядке убывания.

Примечание. Поскольку в этом отчете используется измерение playlist , необходимо указать значение для параметра запроса sort , а также задать для параметра maxResults целочисленное значение 10 или меньше.

dimensions=playlist
metrics=estimatedMinutesWatched,views,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
maxResults=10
sort=-estimatedMinutesWatched
по времени

Видео отчеты

Ежедневные показатели времени просмотра видео канала

Этот запрос извлекает количество просмотров за день, показатели времени просмотра и количество новых подписчиков для видео канала. Отчет возвращает одну строку данных для каждого дня в запрошенном диапазоне дат. Строки отсортированы в хронологическом порядке.

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

Ежедневные показатели аннотаций для видео канала

Этот запрос извлекает ежедневное количество просмотров, показатели кликабельности аннотаций, показатели закрытия аннотаций и показы аннотаций для контента канала. Результаты отсортированы в хронологическом порядке.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

Отчеты о плейлистах

Ежедневные просмотры плейлиста для канала

Этот запрос извлекает ежедневное количество просмотров, запуски плейлиста, предполагаемое время просмотра и количество просмотров на запуск плейлиста для канала аутентифицированного пользователя. Результаты отсортированы в хронологическом порядке.

dimensions=day
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1
sort=day
Географический

Видео отчеты

Показатели времени просмотра для видео на канале в зависимости от страны

Этот запрос извлекает количество просмотров для конкретной страны, показатели времени просмотра и данные о подписке для видео канала. Отчет возвращает одну строку данных для каждой страны, где просматривались видео канала. Строки отсортированы в порядке убывания количества минут просмотра.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

Показатели аннотаций для видео на канале в зависимости от страны

Этот запрос извлекает количество просмотров для конкретной страны, показатели кликабельности аннотаций, показатели закрытия аннотаций и показы аннотаций для видео канала. Результаты сортируются по рейтингу кликов аннотаций в порядке убывания, что означает, что страна с самым высоким рейтингом кликов аннотаций будет указана первой.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

Показатели по провинциям для штатов США и Вашингтона, округ Колумбия

Этот запрос получает разбивку количества просмотров по провинциям, примерное количество минут просмотра и среднюю продолжительность просмотра видео на канале. Данные охватывают штаты США и Вашингтон, округ Колумбия. Результаты отсортированы в алфавитном порядке по кодам провинций ISO 3166-2.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Топ-10 — самые просматриваемые видео в определенной стране

Этот запрос извлекает 10 самых просматриваемых видео канала по количеству просмотров за указанный диапазон дат в указанной стране. Результаты сортируются по количеству просмотров в порядке убывания.

Примечание. В этом отчете необходимо указать значение параметра запроса sort и задать для параметра maxResults целочисленное значение 10 или меньше.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views

Топ-10 городов США по общему количеству просмотров

Этот запрос извлекает список из 10 городов США, на которые приходится наибольшее количество просмотров контента канала в течение указанного диапазона дат. Запрос можно изменить, чтобы запросить данные для другой страны , выбрав другое допустимое значение для этого фильтра. Точно так же запрос можно изменить для получения данных для субконтинента, например Западной Европы или Юго-Восточной Азии, с помощью фильтра subContinent и одного из его допустимых значений. Поддерживаются и другие фильтры. Результаты сортируются по количеству просмотров в порядке убывания.

    dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views

Топ-10 городов США по общему количеству просмотров для каждого типа контента

Этот запрос извлекает список из 10 городов США, на которые приходится наибольшее количество просмотров контента канала в течение указанного диапазона дат для каждого поддерживаемого CreatorContentType . Результаты сортируются по количеству просмотров в порядке убывания.

    dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views

Топ-10 городов США по общему времени просмотра

Этот запрос извлекает список первых 10 дней в указанном диапазоне дат, когда на какой-либо город США приходилось наибольшее общее ежедневное время просмотра контента канала. Результаты запроса определяют общее время просмотра, дату, когда произошло время просмотра, и город, в котором, по оценкам, просматривался контент. Результаты сортируются в порядке убывания общего времени просмотра.

    dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime

Топ-10 — самые просматриваемые видео в Европе

Этот запрос извлекает 10 самых просматриваемых видео канала в Европе по количеству просмотров за указанный диапазон дат. Запрос можно изменить, чтобы запросить данные для другого континента , выбрав другое допустимое значение для этого фильтра. Точно так же запрос можно изменить для получения данных для субконтинента, например Западной Европы или Юго-Восточной Азии, с помощью фильтра subContinent и одного из его допустимых значений. Результаты сортируются по количеству просмотров в порядке убывания.

Примечание. В этом отчете необходимо указать значение параметра запроса sort и задать для параметра maxResults целочисленное значение 10 или меньше.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

Отчеты о плейлистах

Показатели времени просмотра для плейлистов канала в зависимости от страны

Этот запрос извлекает количество просмотров и время просмотра для плейлистов канала по конкретной стране. Отчет возвращает одну строку данных для каждой страны, где просматривались плейлисты канала. Строки отсортированы в порядке убывания количества минут просмотра.

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
sort=-estimatedMinutesWatched

Топ-10 — самые популярные плейлисты в США

Этот запрос извлекает 10 плейлистов, которые зрители в США начали смотреть чаще всего в течение указанного диапазона дат. Результаты отсортированы по количеству запусков плейлиста в порядке убывания.

Примечание. Поскольку в этом отчете используется измерение playlist , необходимо указать значение для параметра запроса sort , а также задать для параметра maxResults целочисленное значение 10 или меньше.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts
Место воспроизведения

Видео отчеты

Количество просмотров и время просмотра из разных мест воспроизведения

Этот запрос извлекает количество просмотров и примерное время просмотра для видео определенного канала. Результаты агрегируются в зависимости от типа страницы или приложения, где произошло воспроизведение видео, и сортируются в порядке убывания количества просмотров.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-views

Ежедневный подсчет просмотров и время просмотра из разных мест воспроизведения

Этот запрос извлекает ежедневное количество просмотров и расчетное время просмотра в Соединенных Штатах для видео определенного канала. Результаты сгруппированы по дням для каждого типа страницы или приложения, где произошло воспроизведение видео. Результаты отсортированы в хронологическом порядке.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US
sort=day

Топ-10 — сторонние сайты, которые генерируют наибольшее количество просмотров встроенного видео.

Этот запрос извлекает количество просмотров и примерное время просмотра для определенного видео или группы видео. Результаты группируются по стороннему сайту, на который было встроено видео. Результаты сортируются в порядке убывания количества просмотров. Обратите внимание, что для выполнения этого запроса в обозревателе API необходимо заменить строку VIDEO_ID в значении параметра filters списком из одного или нескольких идентификаторов загруженных видео, разделенных запятыми.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Отчеты о плейлистах

Счетчик просмотров плейлиста и время просмотра из разных мест воспроизведения

Этот запрос извлекает количество просмотров, расчетное время просмотра и запуск плейлиста для плейлистов определенного канала. Результаты агрегируются на основе типа страницы или приложения, где произошло воспроизведение видео, а результаты сортируются в порядке убывания по количеству запусков плейлиста.

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts
filters=isCurated==1
sort=-playlistStarts

Ежедневный подсчет просмотров плейлиста и время просмотра из разных мест воспроизведения

Этот запрос извлекает ежедневные запуски плейлистов, количество просмотров и расчетное время просмотра в США для плейлистов определенного канала. Результаты сгруппированы по дням для каждого типа страницы или приложения, в которых были просмотрены плейлисты. Результаты отсортированы в хронологическом порядке.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,views,estimatedMinutesWatched
filters=isCurated==1;country==US
sort=day
Детали воспроизведения

Видео отчеты

Нравится и не нравится по типу контента

Этот запрос извлекает количество лайков и антипатий для каждого типа контента на канале.

dimensions=creatorContentType
metrics=likes,dislikes
Источник трафика

Видео отчеты

Количество просмотров и время просмотра из разных источников трафика в стране

Этот запрос возвращает количество просмотров и примерное время просмотра видео канала в указанной стране. Метрики агрегируются по источникам трафика, которые описывают способ, которым пользователи добрались до видео.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

Ежедневный подсчет просмотров и время просмотра из разных источников трафика

Этот запрос извлекает ежедневное количество просмотров и расчетное ежедневное время просмотра видео на канале. Показатели ежедневно агрегируются по источникам трафика и сортируются в хронологическом порядке.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

10 лучших поисковых запросов YouTube, которые генерируют наибольший трафик для видео.

Этот запрос извлекает 10 поисковых запросов, которые вызвали наибольшее количество просмотров из результатов поиска YouTube для одного или нескольких конкретных видео. Результаты сортируются по количеству просмотров в порядке убывания. Обратите внимание, что для выполнения этого запроса в обозревателе API необходимо заменить строку VIDEO_ID в значении параметра filters на список, разделенный запятыми, содержащий до 500 идентификаторов видео.

Например, вы можете запустить запрос для одного видео или заменить VIDEO_ID чтобы определить условия поиска, которые генерируют наибольший трафик для этого видео. Вы также можете перечислить все видео в определенном плейлисте, чтобы определить, какие поисковые запросы генерируют наибольший трафик для любого из видео в этом плейлисте.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Топ-10 — внешние веб-сайты, которые генерируют наибольший трафик для видео.

Этот запрос извлекает 10 внешних веб-сайтов, которые генерировали наибольшее количество просмотров определенного видео или группы видео. Результаты отсортированы по предполагаемому времени просмотра в порядке убывания. Обратите внимание, что для выполнения этого запроса в обозревателе API необходимо заменить строку VIDEO_ID в значении параметра filters на список, разделенный запятыми, содержащий до 500 идентификаторов видео для ваших загруженных видео.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Отчеты о плейлистах

Подсчет просмотров плейлиста и время просмотра из разных источников трафика в стране

Этот запрос извлекает количество просмотров плейлиста, запусков плейлиста и расчетное время просмотра для просмотров плейлиста в указанной стране. Метрики агрегируются по источникам трафика, которые описывают способ, которым пользователи достигли плейлиста.

dimensions=insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1;country==US

Ежедневный подсчет просмотров плейлиста и время просмотра из разных источников трафика

Этот запрос извлекает ежедневные просмотры плейлистов канала, запуски плейлистов и расчетное время просмотра для просмотров плейлистов. Показатели ежедневно агрегируются по источникам трафика и сортируются в хронологическом порядке.

dimensions=day,insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1
sort=day
Устройство/ОС

Видео отчеты

Ежедневные показатели типов устройств для операционной системы Android

Этот запрос извлекает ежедневное количество просмотров и расчетное время просмотра на устройствах Android для видео определенного канала. Результаты сгруппированы по дням для каждого типа устройств, на которых происходило воспроизведение видео. Результаты отсортированы в хронологическом порядке.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day

Ежедневные метрики операционной системы для мобильных устройств

Этот запрос извлекает ежедневное количество просмотров и расчетное время просмотра на мобильных устройствах для видео определенного канала. Результаты сгруппированы по дням для каждой операционной системы, в которой произошло воспроизведение видео. Результаты отсортированы в хронологическом порядке.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=day

Ежедневные показатели операционной системы и типа устройства

Этот запрос извлекает ежедневное количество просмотров и расчетное время просмотра для канала. Статистика сгруппирована по операционной системе и типу устройства. Результаты отсортированы в хронологическом порядке.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Отчеты о плейлистах

Ежедневные показатели типов устройств для просмотра плейлистов в операционной системе Android

Этот запрос извлекает ежедневное количество просмотров плейлистов и расчетное время просмотра на устройствах Android для плейлистов определенного канала. Результаты сгруппированы по дням для каждого типа устройств, на которых были просмотрены плейлисты. Результаты отсортированы в хронологическом порядке.

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched
filters=isCurated==1;operatingSystem==ANDROID
sort=day

Ежедневные показатели операционной системы для просмотров плейлистов на мобильных устройствах

Этот запрос извлекает ежедневное количество просмотров плейлистов и расчетное время просмотра на мобильных устройствах для плейлистов определенного канала. Результаты сгруппированы по дням для каждой операционной системы, в которой были просмотрены плейлисты. Результаты отсортированы в хронологическом порядке.

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=isCurated==1;deviceType==MOBILE
sort=day
Демографический

Видео отчеты

Демографические данные зрителей в Калифорнии (возрастная группа и пол)

Этот отчет содержит статистику о возрастной группе и поле зрителей в Калифорнии, которые смотрели видео канала. Результаты сортируются по полу, а затем по возрастной группе. Этот запрос можно изменить, чтобы получить одинаковую статистику для всех зрителей по всему миру или всех зрителей в стране, континенте, субконтиненте или другом штате США, изменив значение параметра filters .

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

Отчеты о плейлистах

Демографические данные зрителей плейлистов в Калифорнии (возрастная группа и пол)

Этот отчет содержит статистику о возрастной группе и поле зрителей в Калифорнии, которые смотрели плейлисты канала. Результаты сортируются по полу, а затем по возрастной группе. Этот запрос можно изменить, чтобы получить одинаковую статистику для всех зрителей по всему миру или всех зрителей в стране, континенте, субконтиненте или другом штате США, изменив значение параметра filters .

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=isCurated==1;province==US-CA
sort=gender,ageGroup
Социальное

Показатели обмена, агрегированные по службам, в которых были опубликованы видео

Этот запрос возвращает количество раз, когда пользователи использовали кнопку Share , чтобы поделиться видео канала. Результаты агрегируются по службам обмена (Google+, Twitter и т. д.) и сортируются в порядке убывания количества репостов.

dimensions=sharingService
metrics=shares
sort=-shares
Удержание аудитории

Показатели удержания аудитории для видео

Этот отчет измеряет способность видео удерживать свою аудиторию. Отчет можно получить только для одного видео за раз. Обратите внимание, что для выполнения этого запроса в обозревателе API необходимо заменить строку VIDEO_ID в значении параметра filters на идентификатор видео для одного из ваших загруженных видео. Обратите внимание, что отчеты об удержании аудитории не поддерживают возможность указания нескольких значений для video .

В этом примере в отчете используется фильтр audienceType , чтобы ограничить ответ, чтобы он содержал данные только для обычных просмотров, которые являются результатом прямого действия пользователя, такого как поиск видео или клик по предложенному видео. Таким образом, отчет не включает данные о просмотрах объявлений TrueView In-Stream или TrueView In-Display. Вы можете удалить фильтр, чтобы получить данные об удержании аудитории видео для всех типов аудитории.

Обратите внимание, что данные для фильтра audienceType доступны по состоянию на 25 сентября 2013 года. API не будет возвращать данные для запросов, использующих фильтр для получения данных за более ранние даты. Запросы, не использующие фильтр, работают для любой даты после 1 июля 2008 г.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC
Доход/объявления

Показатели дохода канала и эффективности рекламы

Этот запрос извлекает показатели дохода канала и эффективности рекламы. Отчет возвращает одну строку данных, содержащую итоговые значения для каждой запрошенной метрики за указанный диапазон дат.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Ежедневный доход и показатели эффективности рекламы

Этот запрос извлекает ежедневный доход канала и показатели эффективности рекламы.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Показатели доходов и эффективности рекламы для конкретных стран

Этот запрос извлекает показатели доходов и эффективности рекламы канала для конкретной страны. Результаты сортируются в порядке убывания суммы дохода. Это означает, что первой в списке будет страна, в которой партнер получил наибольший чистый доход.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

Топ 10 — видео с самым высоким доходом

Этот запрос извлекает показатели дохода и эффективности рекламы для 10 видео канала с наибольшим доходом. Результаты сортируются в порядке убывания суммы дохода, что означает, что первое видео будет тем, у которого самый высокий расчетный доход.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue

Показатели эффективности рекламы для разных типов рекламы

Этот запрос извлекает показатели эффективности рекламы для контента, заявленного владельцем контента. Результаты сгруппированы по типам объявлений, что позволяет сравнивать доход и значения цены за тысячу показов для разных типов объявлений.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

Отчеты владельцев контента

Основные характеристики

Видео отчеты

Общее количество просмотров, расчетное время просмотра и другие данные для всего контента, на который заявлены права.

Этот запрос извлекает агрегированные показатели для контента, заявленного владельцем контента. Отчет возвращает одну строку данных, содержащую итоговые значения для каждой запрошенной метрики за указанный диапазон дат.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed

Количество просмотров (и многое другое) для всех самостоятельно загруженных видео в зависимости от страны.

Этот запрос извлекает показатели для определенной страны для видео, загруженных владельцем контента. Отчет возвращает одну строку данных, содержащую итоговые значения для каждой запрошенной метрики за указанный диапазон дат.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==self;country==FR

Общее количество просмотров (и больше) всего стороннего контента, на который заявлены права

Этот запрос извлекает сводные показатели для видео, на которые владелец контента заявил права, но не загрузил. Отчет возвращает одну строку данных, содержащую итоговые значения для каждой запрошенной метрики за указанный диапазон дат.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==thirdParty;claimedStatus==claimed

Общее количество просмотров (и многое другое) для всего самостоятельно загруженного контента

Этот запрос извлекает сводные показатели для видео, загруженных владельцем контента. Отчет возвращает одну строку данных, содержащую итоговые значения для каждой запрошенной метрики за указанный диапазон дат.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self

Общее количество просмотров (и многое другое) для всего заявленного контента, загруженного самостоятельно

Этот запрос извлекает сводные показатели для видео, которые владелец контента загрузил и на которые также заявил права. Отчет возвращает одну строку данных, содержащую итоговые значения для каждой запрошенной метрики за указанный диапазон дат.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self;claimedStatus==claimed

Топ-10 — самые просматриваемые видео для владельца контента

Этот запрос извлекает 10 наиболее просматриваемых видеороликов, измеренных по количеству просмотров за указанный диапазон дат, загруженных владельцем контента. Результаты сортируются по количеству просмотров в порядке убывания.

dimensions=video
metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions
filters=uploaderType==self
maxResults=10
sort=-views

Топ-10 — самые просматриваемые видео для владельца контента

Этот запрос извлекает 10 самых просматриваемых видеороликов, измеренных по приблизительному количеству минут просмотра в указанном диапазоне дат, загруженных владельцем контента. Результаты отсортированы по количеству минут просмотра в порядке убывания.

dimensions=video
metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained
filters=uploaderType==self
maxResults=10
sort=-estimatedMinutesWatched

Топ-10 — самые просматриваемые видео для канала владельца контента

Этот запрос извлекает 10 наиболее просматриваемых видео для определенного канала или группы каналов, которыми управляет владелец контента. Результаты сортируются по количеству просмотров в порядке убывания. Обратите внимание, что для выполнения этого запроса в обозревателе API необходимо заменить строку CHANNEL_ID в значении параметра filters списком, разделенным запятыми, который содержит до 500 идентификаторов каналов для ваших каналов.

dimensions=video
metrics=views
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

Топ-10 — CTR аннотаций для самых просматриваемых видео на канале.

Этот запрос извлекает количество просмотров, рейтинг кликов по аннотациям, коэффициент закрытия аннотаций и показы аннотаций для 10 наиболее просматриваемых видео на указанном канале или группе каналов. Результаты сортируются по количеству просмотров в порядке убывания, что означает, что наиболее просматриваемое видео будет отображаться первым. Обратите внимание, что для выполнения этого запроса в обозревателе API необходимо заменить строку CHANNEL_ID в значении параметра filters списком, разделенным запятыми, который содержит до 500 идентификаторов каналов для ваших каналов.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

Отчеты о плейлистах

Просмотры плейлистов для каналов владельца контента

Этот запрос извлекает общее количество запусков плейлиста, расчетное время просмотра, количество просмотров и количество просмотров на запуск плейлиста для плейлистов на каналах владельца контента. Метрика views учитывает только просмотры видео, произошедшие в контексте плейлиста.

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1

Просмотры плейлиста для определенного канала

Этот запрос извлекает общее количество запусков плейлиста, расчетное время просмотра, количество просмотров и количество просмотров на запуск плейлиста для плейлистов на каналах владельца контента. Метрика views учитывает только просмотры видео, произошедшие в контексте плейлиста. Обратите внимание, что для выполнения этого запроса в обозревателе API необходимо заменить строку CHANNEL_ID в значении параметра filters списком, разделенным запятыми, который содержит до 500 идентификаторов каналов для ваших каналов.

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1;channel==CHANNEL_ID

Статистика для плейлиста

Этот запрос извлекает общее количество запусков плейлиста, примерное время просмотра, просмотры и просмотры на запуск плейлиста для определенного плейлиста. Метрика views учитывает только просмотры видео, произошедшие в контексте плейлиста. Обратите внимание, что для запуска этого запроса в обозревателе API необходимо заменить строку PLAYLIST_ID в значении параметра filters на идентификатор списка воспроизведения для списка воспроизведения на одном из каналов владельца контента.

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1;playlist==PLAYLIST_ID

Чтобы получить сводную статистику для нескольких списков воспроизведения, вы также можете заменить строку PLAYLIST_ID списком с разделителями-запятыми, содержащим до 500 идентификаторов списков воспроизведения для списков воспроизведения на каналах владельца контента.

Топ-10 — самые просматриваемые плейлисты для владельца контента

Этот запрос извлекает 10 самых просматриваемых плейлистов владельца контента, измеренных по приблизительному количеству минут просмотра в указанном диапазоне дат. Он также извлекает несколько других показателей списка воспроизведения, таких как количество раз, когда зрители инициировали воспроизведение каждого списка воспроизведения, и среднее количество времени, в течение которого зритель просматривал видео в списке воспроизведения после его запуска. Результаты отсортированы по количеству минут просмотра в порядке убывания.

Примечание. Поскольку в этом отчете используется измерение playlist , необходимо указать значение для параметра запроса sort , а также задать для параметра maxResults целочисленное значение 10 или меньше.

dimensions=playlist
metrics=estimatedMinutesWatched,views,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
maxResults=10
sort=-estimatedMinutesWatched
по времени

Видео отчеты

Ежедневные показатели времени просмотра самостоятельно загруженного контента

Этот запрос извлекает ежедневные показатели времени просмотра, а также количество просмотров, количество монетизированных воспроизведений и количество показов для видео, загруженных владельцем контента. Отчет возвращает одну строку данных для каждого дня в запрошенном диапазоне дат, и строки сортируются в хронологическом порядке.

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

Метрики аннотаций для контента, на который заявлены права

Этот запрос извлекает ежедневное количество просмотров, показатели кликабельности аннотаций, показатели закрытия аннотаций и показы аннотаций для контента, заявленного владельцем контента. Результаты отсортированы в хронологическом порядке.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

Отчеты о плейлистах

Ежедневные просмотры плейлиста для владельца контента

Этот запрос извлекает ежедневное количество просмотров, запуски плейлиста, расчетное время просмотра и количество просмотров на запуск плейлиста для всех плейлистов на каналах владельца контента. Результаты отсортированы в хронологическом порядке.

dimensions=day
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1
sort=day
Географический

Видео отчеты

Показатели времени просмотра для самостоятельно загруженного контента в зависимости от страны

Этот запрос извлекает количество просмотров, показатели времени просмотра и предполагаемый доход от рекламы для каждой страны. Показатели относятся к видео, которые загрузил владелец контента. Отчет возвращает одну строку данных для каждой страны, в которой просматривалось видео, и строки сортируются в порядке убывания количества минут просмотра.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

Показатели аннотаций для самостоятельно загруженного контента для конкретных стран

Этот запрос извлекает количество просмотров для конкретной страны, показатели кликабельности аннотаций, показатели закрытия аннотаций и показы аннотаций для видео, загруженных владельцем контента. Результаты сортируются по рейтингу кликов аннотаций в порядке убывания, что означает, что страна с самым высоким рейтингом кликов аннотаций будет указана первой.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

Показатели по провинциям для штатов США и Вашингтона, округ Колумбия

Этот запрос извлекает данные о количестве просмотров, расчетном количестве минут просмотра и средней продолжительности просмотра видео, заявленных владельцем контента, по провинциям. Данные охватывают штаты США и Вашингтон, округ Колумбия. Результаты отсортированы в алфавитном порядке по кодам провинций ISO 3166-2.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Топ-10 городов США по общему количеству просмотров

Этот запрос извлекает список из 10 городов США, в которых за указанный диапазон дат было зафиксировано наибольшее количество просмотров видео, заявленных владельцем контента. Запрос можно изменить, чтобы запросить данные для другой страны , выбрав другое допустимое значение для этого фильтра. Точно так же запрос можно изменить для получения данных для субконтинента, например Западной Европы или Юго-Восточной Азии, с помощью фильтра subContinent и одного из его допустимых значений. Поддерживаются и другие фильтры. Результаты сортируются по количеству просмотров в порядке убывания.

    dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Топ-10 городов США по общему количеству просмотров для каждого типа контента

Этот запрос извлекает список из 10 городов США, на долю которых приходится наибольшее количество просмотров контента, заявленного владельцем контента, в течение указанного диапазона дат для каждого поддерживаемого CreatorContentType . Результаты сортируются по количеству просмотров в порядке убывания.

    dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Топ-10 городов США по общему времени просмотра

Этот запрос извлекает список первых 10 дней в указанном диапазоне дат, когда на какой-либо город США приходилось наибольшее общее ежедневное время просмотра контента, заявленного владельцем контента. Результаты запроса определяют общее время просмотра, дату, когда произошло время просмотра, и город, в котором, по оценкам, просматривался контент. Результаты сортируются в порядке убывания общего времени просмотра.

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

Топ-10 — самые просматриваемые видео в Европе

Этот запрос извлекает 10 самых просматриваемых видео в Европе среди видео, на которые претендует владелец контента, согласно количеству просмотров за указанный диапазон дат. Запрос можно изменить, чтобы запросить данные для другого континента , выбрав другое допустимое значение для этого фильтра. Точно так же запрос можно изменить для получения данных для субконтинента, например Западной Европы или Юго-Восточной Азии, с помощью фильтра subContinent и одного из его допустимых значений. Результаты сортируются по количеству просмотров в порядке убывания.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

Отчеты о плейлистах

Показатели времени просмотра для плейлистов владельца контента в зависимости от страны

Этот запрос извлекает данные о количестве просмотров и времени просмотра для всех плейлистов на каналах владельца контента в зависимости от страны. Отчет возвращает одну строку данных для каждой страны, в которой плейлисты просматривались. Строки отсортированы в порядке убывания количества минут просмотра.

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
sort=-estimatedMinutesWatched

Топ-10 — самые популярные плейлисты в США

Этот запрос извлекает 10 плейлистов с каналов владельца контента, которые зрители в США начали смотреть чаще всего в течение указанного диапазона дат. Результаты отсортированы по количеству запусков плейлиста в порядке убывания.

Примечание. Поскольку в этом отчете используется измерение playlist , необходимо указать значение для параметра запроса sort , а также задать для параметра maxResults целочисленное значение 10 или меньше.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts
Детали воспроизведения

Видео отчеты

Нравится и не нравится по типу контента

Этот запрос извлекает количество лайков и антипатий для каждого типа контента на конкретном канале или группе каналов. Обратите внимание, что для выполнения этого запроса в обозревателе API необходимо заменить строку CHANNEL_ID в значении параметра filters списком, разделенным запятыми, который содержит до 500 идентификаторов каналов для ваших каналов.

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID
Место воспроизведения

Видео отчеты

Количество просмотров и время просмотра из разных мест воспроизведения

Этот запрос извлекает количество просмотров и примерное время просмотра видео, загруженных на определенный канал или группу каналов. Результаты агрегируются в зависимости от типа страницы или приложения, где произошло воспроизведение видео, и сортируются в порядке убывания количества просмотров. Обратите внимание, что для выполнения этого запроса в обозревателе API необходимо заменить строку CHANNEL_ID в значении параметра filters списком, разделенным запятыми, который содержит до 500 идентификаторов каналов для ваших каналов.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

Ежедневный подсчет просмотров и время просмотра из разных мест воспроизведения

Этот запрос извлекает ежедневное количество просмотров и расчетное время просмотра в США для видео, загруженных на определенный канал или группу каналов. Результаты сгруппированы по дням для каждого типа страницы или приложения, где произошло воспроизведение видео. Результаты отсортированы в обратном хронологическом порядке. Обратите внимание, что для выполнения этого запроса в обозревателе API необходимо заменить строку CHANNEL_ID в значении параметра filters списком, разделенным запятыми, который содержит до 500 идентификаторов каналов для ваших каналов.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day

Top 10 – Third-party sites that generate the most views for an embedded video

This query retrieves view counts and estimated watch time for a particular video or group of videos. Results are grouped by the third-party site where the video was embedded. Results are sorted in descending order by view count. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Playlist reports

Playlist view counts and watch time from different playback locations

This query retrieves the number of views, estimated watch time, and playlist starts for all playlists in a content owner's channels. Results are aggregated based on the type of page or application where video playbacks occurred, and results are sorted in descending order by playlist starts.

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts
filters=isCurated==1
sort=-playlistStarts

Daily playlist view counts and watch time from different playback locations

This query retrieves daily playlist starts, view counts, and estimated watch time in the United States for all playlists in a content owner's channels. Results are grouped by day for each type of page or application where playlist views occurred. Results are sorted in chronological order.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,views,estimatedMinutesWatched
filters=isCurated==1;country==US
sort=day
Traffic source

Video reports

Viewcounts and watch time from different traffic sources

This request retrieves the number of views and estimated watch time for the content owner's videos. The metrics are aggregated by traffic source, which describes the manner in which users reached the video.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

Daily view counts and watch time from different traffic sources

This request retrieves daily view counts and daily estimated watch time for the content owner's videos. The metrics are aggregated on a daily basis by traffic source and sorted in reverse chronological order.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

Note: The next two sample reports are only supported for specific traffic sources. For example, the NO_LINK_EMBEDDED traffic source does not have additional details and, therefore, these reports are not available for that source. See the insightTrafficSourceType definition for details about the traffic sources for which these types of report are available.

Top 10 – YouTube search terms that generate the most traffic for a video

This query retrieves the 10 search terms that generated the most views from YouTube search results for a specific video or group of videos. Results are sorted by view count in descending order. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Top 10 – External websites that generate the most traffic for a video

This query retrieves the 10 external websites that generated the most views from Google search results for a specific video or group of videos. Results are sorted by estimated watch time in descending order. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Playlist reports

Playlist view counts and watch time from different traffic sources in a country

This request retrieves the number of playlist views, playlist starts, and estimated watch time for playlist views in a specified country. The metrics are aggregated by traffic source, which describes the manner in which users reached the playlist.

dimensions=insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1;country==US

Daily playlist view counts and watch time from different traffic sources

This request retrieves daily playlist views, playlist starts, and estimated watch time for playlists in one or more of a content owner's channels. The metrics are aggregated on a daily basis by traffic source and sorted in chronological order. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=day,insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1;channel==CHANNEL_ID
sort=day
Device/OS

Video reports

Daily device type metrics for claimed videos

This query retrieves daily view counts and estimated watch time by device type for videos claimed by a particular content owner. Results are grouped by day for each type of device where video playbacks occurred. Results are sorted in chronological order.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

Daily operating system metrics for claimed videos viewed on mobile devices

This query retrieves daily view counts and estimated watch time by operating system for views of videos claimed by a specified content owner that took place on mobile devices. Results are grouped by day for each operating system where video playbacks occurred. Results are sorted in chronological order.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

Daily operating system and device type metrics

This query retrieves daily view counts and estimated watch time for videos claimed by a particular content owner. Statistics are grouped by operating system and device type. Results are sorted in chronological order.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Playlist reports

Daily device type metrics for playlist views on the Android operating system

This query retrieves daily playlist view counts and estimated watch time on Android devices for playlists in one or more of a content owner's channels. Results are grouped by day for each type of device where playlist views occurred. Results are sorted in chronological order. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched
filters=isCurated==1;channel==CHANNEL_ID;operatingSystem==ANDROID
sort=day

Daily operating system metrics for playlist views on mobile devices

This query retrieves daily playlist view counts and estimated watch time on mobile devices for playlists in any of a content owner's channels. Results are grouped by day for each operating system on which playlist views occurred. Results are sorted in chronological order.

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=isCurated==1;deviceType==MOBILE
sort=day
Demographic

Video reports

Viewer demographics in California (age group and gender)

This report retrieves statistics about the age group and gender of viewers in California who watched the content owner's claimed content. Results are sorted by gender and then by age group. This query could be modified to retrieve the same statistics for all viewers worldwide or all viewers in a country, continent, subcontinent, or another US state by adjusting the filters parameter value.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

Playlist reports

Playlist viewer demographics in California (age group and gender)

This report retrieves statistics about the age group and gender of viewers in California who watched the playlists in any of the content owner's channels. Results are sorted by gender and then by age group. This query could be modified to retrieve the same statistics for all viewers worldwide or all viewers in a country, continent, subcontinent, or another US state by adjusting the filters parameter value.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=isCurated==1;province==US-CA
sort=gender,ageGroup
Audience retention

Audience retention metrics for a video

This report measures a video's ability to retain its audience. The report can only be retrieved for a single video at a time. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with the video ID for one of your uploaded videos. Note that audience retention reports do not support the ability to specify multiple values for the video filter.

In this example, the report uses the audienceType filter to restrict the response so that it only contains data for organic views, which are the result of a direct user action, such as a search for a video or a click on a suggested video. As such, the report does not include data for views from TrueView in-stream or TrueView in-display ads. You can remove the filter to retrieve the video's audience retention data from all audience types.

Note that data for the audienceType filter is available as of September 25, 2013. The API will not return data for queries that use the filter to try to retrieve data from earlier dates. Queries that do not use the filter work for any date after July 1, 2008.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC
Revenue/Ads

Revenue and ad performance metrics for claimed content

This request retrieves revenue and ad performance metrics for the content owner's claimed content. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Daily revenue and ad performance metrics

This request retrieves daily revenue and ad performance metrics for the content owner's claimed content.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Country-specific revenue and ad performance metrics

This request retrieves country-specific revenue and ad performance metrics for the content owner's claimed content. Results are sorted in descending order by revenue amount, which means that the first country listed will be the one where the partner had the greatest estimated revenue.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

Top 10 – Videos with the highest revenue

This request retrieves revenue and ad performance metrics for the 10 videos that where claimed by the content owner claimed and that had the highest revenue. Results are sorted in descending order by revenue amount, which means that the first video will be the one that had the highest estimated revenue.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue

Ad performance metrics for different ad types

This request retrieves ad performance metrics for the content owner's claimed content. Results are grouped by ad type, which enables you to compare revenue and CPM values across different ad types.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType