На этой странице показаны примеры запросов 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 .
Сортировка запросов по нескольким параметрам/метрикам
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
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
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
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
Sharing metrics, aggregated by service where videos were shared
This request retrieves the number of times that users used the Share
button to share videos that the content owner uploaded. Results are aggregated by sharing service (Google+, Twitter, etc.) and sorted in descending order of number of shares.
dimensions=sharingService metrics=shares filters=uploaderType==self sort=-shares
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 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