На этой странице показаны примеры запросов API YouTube Analytics. В каждом примере кратко описывается извлекаемый отчет, а затем показаны соответствующие dimensions , metrics , filters и значения параметров sort . (В документах отчетов о каналах и отчетах владельцев контента указаны отчеты, которые поддерживает API.)
Каждый пример ссылается на Google API Explorer и заполняет его показанными значениями. В примерах также используются даты начала и окончания по умолчанию ( YYYY-MM-DD ) 2023-09-01 и 2024-03-31
После подключения к API Explorer вам все равно необходимо указать владельца канала или контента, для которого вы получаете отчеты. Обозреватель API заполнит значение параметра ids либо channel==MINE , либо contentOwner==CONTENT_OWNER_ID в зависимости от запроса, который вы нажали. Для отчетов о каналах вы можете изменить MINE на идентификатор канала аутентифицированного пользователя. В отчетах о владельцах контента вам необходимо заменить CONTENT_OWNER_ID на свой идентификатор владельца контента.
Вам также необходимо пройти аутентификацию как указанный владелец канала или контента, чтобы API Explorer мог авторизовать ваши запросы 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 – рейтинг кликов по аннотациям для самых просматриваемых видео на канале.
Этот запрос позволяет получить количество просмотров, рейтинг кликов по аннотациям, коэффициент закрытия аннотаций и количество показов аннотаций для 10 самых просматриваемых видео на канале. Результаты сортируются по количеству просмотров в порядке убывания, что означает, что наиболее просматриваемое видео будет указано первым.
Примечание. В этом отчете необходимо указать значение параметра запроса sort и установить для параметра maxResults целое значение 10 или меньше.
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions maxResults=10 sort=-views
Отчеты о плейлистах
Общее количество просмотров плейлиста для канала
Этот запрос получает общее количество запусков плейлиста, примерное количество просмотренных минут, просмотры ( агрегированный показатель видео ), просмотры плейлиста (показатель в плейлисте ) и количество просмотров на начало плейлиста для плейлистов на канале проверенного пользователя.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
Статистика по конкретному плейлисту
Этот запрос получает общее количество запусков плейлиста, расчетное количество просмотренных минут, просмотры ( агрегированный показатель видео ), просмотры плейлиста (показатель в плейлисте ) и количество просмотров на начало плейлиста для определенного плейлиста. Обратите внимание, что для запуска этого запроса в API Explorer необходимо заменить строку PLAYLIST_ID в значении параметра filters на идентификатор списка воспроизведения для списка воспроизведения в канале аутентифицированного пользователя.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
Чтобы получить совокупную статистику для нескольких списков воспроизведения, вы также можете заменить строку PLAYLIST_ID списком, разделенным запятыми, содержащим до 500 идентификаторов списков воспроизведения для списков воспроизведения на канале аутентифицированного пользователя.
Топ-10 — самые просматриваемые плейлисты канала.
Этот запрос извлекает 10 наиболее просматриваемых плейлистов канала по количеству просмотров плейлистов в течение указанного диапазона дат. Он также получает несколько других показателей плейлиста, таких как количество раз, когда зрители инициировали воспроизведение каждого плейлиста, и среднее время, в течение которого зритель смотрел видео в плейлисте после его запуска. Результаты сортируются по просмотрам плейлистов в порядке убывания.
Примечание. Поскольку в этом отчете используется измерение playlist , необходимо указать значение параметра запроса sort , а также установить для параметра maxResults целое значение 10 или меньше.
dimensions=playlist metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves maxResults=10 sort=-playlistViews
Видеоотчеты
Ежедневные показатели времени просмотра видео канала
Этот запрос получает количество ежедневных просмотров, показатели времени просмотра и количество новых подписчиков видео канала. Отчет возвращает одну строку данных для каждого дня в запрошенном диапазоне дат. Строки сортируются в хронологическом порядке.
dimensions=day metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=day
Ежедневные показатели аннотаций для видео канала
Этот запрос получает количество ежедневных просмотров, рейтинг кликов по аннотациям, коэффициент закрытия аннотаций и количество показов аннотаций для контента канала. Результаты отсортированы в хронологическом порядке.
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=day
Отчеты о плейлистах
Ежедневные просмотры плейлиста для канала
Этот запрос получает количество просмотров за день ( агрегированный показатель видео ), просмотры плейлиста (показатель в плейлисте ), начало плейлиста, примерное количество просмотренных минут и количество просмотров на начало плейлиста для канала проверенного пользователя. Результаты отсортированы в хронологическом порядке.
dimensions=day metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart 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 городов США, на которые приходится наибольшее количество просмотров контента канала в течение указанного диапазона дат. Запрос можно изменить для запроса данных по другой стране , выбрав другое допустимое значение для этого фильтра. Аналогично, запрос можно изменить для получения данных по субконтиненту, например Западной Европе или Юго-Восточной Азии, с помощью фильтра «Субконтинент» и одного из его допустимых значений. Другие фильтры также поддерживаются. Результаты отсортированы по количеству просмотров в порядке убывания.
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 самых просматриваемых видео канала в Европе по количеству просмотров в течение указанного диапазона дат. Запрос можно изменить для запроса данных для другого континента , выбрав другое допустимое значение для этого фильтра. Аналогично, запрос можно изменить для получения данных по субконтиненту, например Западной Европе или Юго-Восточной Азии, с помощью фильтра «Субконтинент» и одного из его допустимых значений. Результаты отсортированы по количеству просмотров в порядке убывания.
Примечание. В этом отчете необходимо указать значение параметра запроса sort и установить для параметра maxResults целое значение 10 или меньше.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=continent==150 maxResults=10 sort=-views
Отчеты о плейлистах
Показатели времени просмотра плейлистов канала для конкретной страны
Этот запрос извлекает количество просмотров для конкретной страны ( агрегированный показатель видео ), просмотров плейлистов (показатель в плейлисте ) и показатели времени просмотра для плейлистов канала. Отчет возвращает одну строку данных для каждой страны, где просматривались плейлисты канала. Строки отсортированы по убыванию количества минут просмотра.
dimensions=country metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist 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 Explorer, необходимо заменить строку VIDEO_ID в значении параметра filters разделенным запятыми списком из одного или нескольких идентификаторов видео для загруженных вами видео.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Отчеты о плейлистах
Количество просмотров плейлиста и время просмотра из разных мест воспроизведения
Этот запрос получает количество просмотров ( агрегированный показатель видео ), просмотров плейлиста (показатель в плейлисте ), расчетное время просмотра и количество запусков плейлиста для плейлистов определенного канала. Результаты агрегируются в зависимости от типа страницы или приложения, где происходило воспроизведение видео, а результаты сортируются в порядке убывания по началам списка воспроизведения.
dimensions=insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=-playlistStarts
Количество просмотров плейлиста за день и время просмотра из разных мест воспроизведения
Этот запрос извлекает ежедневные запуски плейлиста, количество просмотров ( агрегированный показатель видео ), просмотры плейлиста (показатель в плейлисте ) и примерное время просмотра в США для плейлистов определенного канала. Результаты сгруппированы по дням для каждого типа страниц или приложений, где происходили просмотры плейлистов. Результаты отсортированы в хронологическом порядке.
dimensions=day,insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews filters=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,estimatedMinutesWatchedplaylistStarts,playlistViews filters=country==US
Количество просмотров плейлиста за день и время просмотра из разных источников трафика
Этот запрос получает данные о ежедневных просмотрах плейлиста на канале (показатель в плейлисте ), начале плейлиста и примерном времени просмотра. Он также получает общее количество просмотров ( агрегированный показатель видео ). Метрики агрегируются ежедневно по источникам трафика и сортируются в хронологическом порядке.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews 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,playlistViews filters=operatingSystem==ANDROID sort=day
Ежедневные показатели операционной системы для просмотров плейлистов на мобильных устройствах
Этот запрос извлекает ежедневные просмотры ( агрегированный показатель видео ), просмотры плейлистов (показатель в плейлисте ) и расчетное время просмотра на мобильных устройствах плейлистов определенного канала. Результаты сгруппированы по дням для каждой операционной системы, в которой происходили просмотры плейлистов. Результаты отсортированы в хронологическом порядке.
dimensions=day,operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE sort=day
Видеоотчеты
Демография зрителей в Калифорнии (возрастная группа и пол)
В этом отчете собраны статистические данные о возрастной группе и поле зрителей в Калифорнии, которые смотрели видео канала. Результаты сортируются по полу, а затем по возрастной группе. Этот запрос можно изменить для получения одной и той же статистики для всех зрителей по всему миру или для всех зрителей в стране, континенте, субконтиненте или другом штате США, изменив значение параметра filters .
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
Отчеты о плейлистах
Демографические данные о зрителях плейлистов в Калифорнии (возрастная группа и пол)
В этом отчете собраны статистические данные о возрастной группе и поле зрителей в Калифорнии, которые смотрели плейлисты канала. Результаты сортируются по полу, а затем по возрастной группе. Этот запрос можно изменить для получения одной и той же статистики для всех зрителей по всему миру или для всех зрителей в стране, континенте, субконтиненте или другом штате США, изменив значение параметра filters .
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
Показатели общего доступа, агрегированные по сервисам, где были опубликованы видео.
Этот запрос получает количество раз, когда пользователи использовали кнопку Share , чтобы поделиться видео канала. Результаты агрегируются по сервисам обмена (Google+, Twitter и т. д.) и сортируются по убыванию количества акций.
dimensions=sharingService metrics=shares sort=-shares
Показатели удержания аудитории для видео
В этом отчете измеряется способность видео удерживать аудиторию. Отчет можно получить только для одного видео одновременно. Обратите внимание: чтобы выполнить этот запрос в API Explorer, вам необходимо заменить строку 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 Explorer, необходимо заменить строку CHANNEL_ID в значении параметра filters разделенным запятыми списком, содержащим до 500 идентификаторов каналов для ваших каналов.
dimensions=video metrics=views filters=channel==CHANNEL_ID maxResults=10 sort=-views
Топ-10 – рейтинг кликов по аннотациям для самых просматриваемых видео на канале.
Этот запрос получает количество просмотров, рейтинг кликов по аннотациям, коэффициент закрытия аннотаций и показы аннотаций для 10 наиболее просматриваемых видео на указанном канале или группе каналов. Результаты сортируются по количеству просмотров в порядке убывания, что означает, что наиболее просматриваемое видео будет указано первым. Обратите внимание: чтобы выполнить этот запрос в API Explorer, необходимо заменить строку CHANNEL_ID в значении параметра filters разделенным запятыми списком, содержащим до 500 идентификаторов каналов для ваших каналов.
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=channel==CHANNEL_ID maxResults=10 sort=-views
Отчеты о плейлистах
Просмотры плейлистов для каналов владельца контента
Этот запрос получает общее количество запусков плейлиста, приблизительное количество просмотров плейлиста, количество просмотров плейлиста и количество просмотров на начало плейлиста для плейлистов на каналах владельца контента. Метрика playlistViews учитывает только просмотры видео, произошедшие в контексте плейлиста. Поскольку все запрошенные метрики являются метриками списка воспроизведения, в запрос также не требуется включать фильтр списка воспроизведения или групповой фильтр.
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
Статистика по конкретному плейлисту
Этот запрос получает общее количество запусков плейлиста, расчетное количество просмотренных минут, просмотры ( агрегированный показатель видео ), просмотры плейлиста (показатель в плейлисте ) и количество просмотров на начало плейлиста для определенного плейлиста. Обратите внимание: чтобы выполнить этот запрос в API Explorer, необходимо заменить строку PLAYLIST_ID в значении параметра filters на идентификатор плейлиста для плейлиста в одном из каналов владельца контента.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
Чтобы получить совокупную статистику для нескольких списков воспроизведения, вы также можете заменить строку PLAYLIST_ID списком, разделенным запятыми, содержащим до 500 идентификаторов списков воспроизведения для списков воспроизведения на каналах владельца контента.
Видеоотчеты
Ежедневные показатели времени просмотра самостоятельно загружаемого контента
Этот запрос извлекает ежедневные показатели времени просмотра, а также количество просмотров, количество монетизированных воспроизведений и количество показов видео, загруженных владельцем контента. Отчет возвращает одну строку данных для каждого дня в запрошенном диапазоне дат, строки сортируются в хронологическом порядке.
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
Отчеты о плейлистах
Ежедневные просмотры плейлистов для владельца контента
Этот запрос получает показатели ежедневного взаимодействия пользователей с видео в плейлистах владельца контента. Метрики, полученные в отчете, — это playlistViews , playlistStars , playlistEstimatedMinutesWatched иviewPerPlaylistStart . Все эти показатели являются показателями плейлиста . Поскольку все запрошенные метрики являются метриками списка воспроизведения, запрос не обязательно должен включать фильтр списка воспроизведения или групповой фильтр.
dimensions=day metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart 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 городов США, на которые приходится наибольшее количество просмотров видео, на которые заявлены права владельца контента, в течение указанного диапазона дат. Запрос можно изменить для запроса данных по другой стране , выбрав другое допустимое значение для этого фильтра. Аналогично, запрос можно изменить для получения данных по субконтиненту, например Западной Европе или Юго-Восточной Азии, с помощью фильтра «Субконтинент» и одного из его допустимых значений. Другие фильтры также поддерживаются. Результаты отсортированы по количеству просмотров в порядке убывания.
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 самых просматриваемых видео в Европе среди видео, на которые заявлен владелец контента, по количеству просмотров в течение указанного диапазона дат. Запрос можно изменить для запроса данных для другого континента , выбрав другое допустимое значение для этого фильтра. Аналогично, запрос можно изменить для получения данных по субконтиненту, например Западной Европе или Юго-Восточной Азии, с помощью фильтра «Субконтинент» и одного из его допустимых значений. Результаты отсортированы по количеству просмотров в порядке убывания.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=claimedStatus==claimed;filters=continent==150 maxResults=10 sort=-estimatedMinutesWatched
Отчеты о плейлистах
Показатели времени просмотра для плейлистов владельца контента для конкретной страны
Этот запрос извлекает количество просмотров плейлиста для конкретной страны и показатели времени просмотра плейлиста для всех плейлистов на каналах владельца контента. Отчет возвращает одну строку данных для каждой страны, в которой просматривались плейлисты. Строки отсортированы по убыванию количества минут просмотра.
dimensions=country metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-playlistEstimatedMinutesWatched
Топ-10 – Самые запускаемые плейлисты в США
Этот запрос извлекает 10 плейлистов из каналов владельца контента, которые зрители в США начали смотреть чаще всего в течение указанного диапазона дат. Результаты отсортированы по количеству запусков плейлиста в порядке убывания.
Примечание. Поскольку в этом отчете используется измерение playlist , необходимо указать значение параметра запроса sort , а также задать для параметра maxResults целое значение 10 или меньше.
dimensions=playlist metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration filters=country==US maxResults=10 sort=-playlistStarts
Видеоотчеты
Что нравится и что не нравится по типу контента
Этот запрос извлекает количество лайков и антипатий для каждого типа контента на определенном канале или группе каналов. Обратите внимание: чтобы выполнить этот запрос в API Explorer, необходимо заменить строку CHANNEL_ID в значении параметра filters разделенным запятыми списком, содержащим до 500 идентификаторов каналов для ваших каналов.
dimensions=creatorContentType metrics=likes,dislikes filters=channel==CHANNEL_ID
Видеоотчеты
Количество просмотров и время просмотра из разных мест воспроизведения
Этот запрос получает количество просмотров и примерное время просмотра видео, загруженных на определенный канал или группу каналов. Результаты агрегируются в зависимости от типа страницы или приложения, где происходило воспроизведение видео, и сортируются в порядке убывания количества просмотров. Обратите внимание: чтобы выполнить этот запрос в API Explorer, необходимо заменить строку CHANNEL_ID в значении параметра filters разделенным запятыми списком, содержащим до 500 идентификаторов каналов для ваших каналов.
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=channel==CHANNEL_ID sort=-views
Количество просмотров за день и время просмотра из разных мест воспроизведения
Этот запрос позволяет получить количество ежедневных просмотров и примерное время просмотра в США видео, загруженных на определенный канал или группу каналов. Результаты сгруппированы по дням для каждого типа страниц или приложений, где происходило воспроизведение видео. Результаты отсортированы в обратном хронологическом порядке. Обратите внимание: чтобы выполнить этот запрос в API Explorer, необходимо заменить строку CHANNEL_ID в значении параметра filters разделенным запятыми списком, содержащим до 500 идентификаторов каналов для ваших каналов.
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US;channel==CHANNEL_ID sort=-day
Топ-10 – сторонние сайты, которые генерируют наибольшее количество просмотров встроенного видео.
Этот запрос получает количество просмотров и примерное время просмотра определенного видео или группы видео. Результаты сгруппированы по стороннему сайту, на который было встроено видео. Результаты отсортированы в порядке убывания количества просмотров. Обратите внимание: чтобы выполнить этот запрос в проводнике API, необходимо заменить строку VIDEO_ID в значении параметра filters разделенным запятыми списком, содержащим до 500 идентификаторов видео для загруженных вами видео.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Отчеты о плейлистах
Количество просмотров плейлиста и время просмотра из разных мест воспроизведения
Этот запрос получает количество просмотров плейлиста, плейлиста оценил время наблюдения, и список воспроизведения начинается для всех плейлистов в каналах владельца контента. Результаты агрегируются на основе типа страницы или приложения, где произошли воспроизведения видео, а результаты отсортированы в порядке убывания по началам плейлиста.
dimensions=insightPlaybackLocationType metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts sort=-playlistStarts
Подсчет просмотра плейлиста и время наблюдения за разными местами воспроизведения
Этот запрос запускает Daily Playlist Spartslist, количество видов плейлиста, и плейлист оценил время наблюдения в Соединенных Штатах для всех плейлистов в каналах владельца контента. Результаты возвращаются для каждого типа страницы или приложения, где произошли представления плейлиста.
dimensions=day,insightPlaybackLocationType metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched filters=country==US
Видеоотчеты
ViewCounts и время наблюдения из разных источников трафика
Этот запрос получает количество просмотров и предполагаемое время наблюдения за видео владельца контента. Метрики агрегируются источником трафика, который описывает способ, с помощью которого пользователи достигли видео.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self
Daily View Counts и время наблюдения из разных источников трафика
Этот запрос получает ежедневное количество просмотров и ежедневное время для просмотра видео -видео. Метрики ежедневно агрегируются по источнику трафика и сортируются в обратном хронологическом порядке.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self sort=-day
ПРИМЕЧАНИЕ. Следующие два отчета примера поддерживаются только для конкретных источников трафика. Например, источник трафика NO_LINK_EMBEDDED не имеет дополнительной информации, и, следовательно, эти отчеты не доступны для этого источника. См. Определение insightTrafficSourceType для получения подробной информации об источниках трафика, для которых доступны эти типы отчета.
Топ -10 - термины поиска на YouTube, которые генерируют наибольшее трафик для видео
Этот запрос получает 10 поисковых терминов, которые сгенерировали наибольшее количество просмотров из результатов поиска YouTube для конкретного видео или группы видео. Результаты отсортируются по подсчету в порядке убывания. Обратите внимание, что для запуска этого запроса в APIS Explorer необходимо заменить строку VIDEO_ID в значении параметра filters со списком, разделенным за запятушкой, из 500 видео идентификаторов для загруженных видео.
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
Топ -10 - внешние веб -сайты, которые генерируют большинство трафика для видео
Этот запрос получает 10 внешних веб -сайтов, которые сгенерировали наибольшее количество просмотров из результатов поиска Google для конкретного видео или группы видео. Результаты отсортируются по расчетному времени наблюдения в порядке убывания. Обратите внимание, что для запуска этого запроса в APIS Explorer необходимо заменить строку VIDEO_ID в значении параметра filters со списком, разделенным за запятушкой, из 500 видео идентификаторов для загруженных видео.
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
Отчеты плейлиста
Подсчет просмотра плейлиста и время наблюдения из разных источников трафика в стране
Этот запрос получает количество просмотров плейлиста, запускается плейлист, и плейлист оценил время наблюдения за просмоткой плейлиста в указанной стране. Метрики агрегируются источником трафика, который описывает способ, которым пользователи достигли списка воспроизведения.
dimensions=insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=country==US
Подсчет просмотра плейлиста и время наблюдения из разных источников трафика
Этот запрос получает просмотры плейлиста, запускается плейлист, и плейлист оценил время наблюдения за плейлистами в одном или нескольких каналах владельца контента. Метрики агрегируются источником трафика. Обратите внимание, что чтобы запустить этот запрос в APIS Explorer, вы должны заменить строку CHANNEL_ID в значении параметра filters со списком, разделенным за запятушкой, из 500 идентификаторов канала для ваших каналов.
dimensions=day,insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID
Видеоотчеты
Ежедневные метрики типа устройства для заявленных видеороликов
Этот запрос получает ежедневное количество просмотра и предполагаемое время наблюдения по типу устройства для видео, заявленных конкретным владельцем контента. Результаты сгруппированы днем для каждого типа устройства, где произошли воспроизведения видео. Результаты отсортированы в хронологическом порядке.
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed sort=day
Ежедневные метрики операционной системы для заявленных видеороликов, просмотренных на мобильных устройствах
Этот запрос получает подсчет ежедневного просмотра и предполагаемое время наблюдения за операционной системой для просмотров видео, заявленных указанным владельцем контента, который имел место на мобильных устройствах. Результаты сгруппированы днем для каждой операционной системы, где произошли воспроизведения видео. Результаты отсортированы в хронологическом порядке.
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed;deviceType==MOBILE sort=day
Ежедневная операционная система и метрики типа устройства
Этот запрос извлекает подсчет ежедневного просмотра и предполагаемое время наблюдения для видео, заявленных конкретным владельцем контента. Статистика сгруппирована с помощью операционной системы и типа устройства. Результаты отсортированы в хронологическом порядке.
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
Отчеты плейлиста
Метрики типа устройства для просмотров плейлиста в операционной системе Android
Этот запрос извлекает подсчет плейлиста и плейлист оценил время наблюдения на устройствах Android для плейлистов в одном или нескольких каналах владельца контента. Результаты возвращаются для каждого типа устройства, где произошли представления плейлиста. Обратите внимание, что чтобы запустить этот запрос в APIS Explorer, вы должны заменить строку CHANNEL_ID в значении параметра filters со списком, разделенным за запятушкой, из 500 идентификаторов канала для ваших каналов.
dimensions=deviceType metrics=playlistViews,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID;operatingSystem==ANDROID
Метрики операционной системы для просмотров плейлиста на мобильных устройствах
Этот запрос получает количество плейлиста плейлиста и плейлист оценил время наблюдения на мобильных устройствах для плейлистов в любом из каналов владельца контента. Результаты возвращаются для каждой операционной системы, в которой произошли представления плейлиста.
dimensions=operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE
Видеоотчеты
Демография зрителя в Калифорнии (возрастная группа и пол)
Этот отчет дает статистику о возрастной группе и поле зрителей в Калифорнии, которые наблюдали за заявленным контентом владельца контента. Результаты сортируются по полу, а затем по возрастной группе. Этот запрос может быть изменен, чтобы получить одну и ту же статистику для всех зрителей по всему миру или всем зрителям в стране, континенте, субконтиненте или другое состояние США путем настройки значения параметра filters .
dimensions=ageGroup,gender metrics=viewerPercentage filters=claimedStatus==claimed;province==US-CA sort=gender,ageGroup
Обмен показателями, агрегированные по обслуживанию, где были переданы видео
Этот запрос получает количество раз, когда пользователи использовали кнопку Share , чтобы обмениваться видео, которые загрузил владелец контента. Результаты агрегируются путем обмена услугами (Google+, Twitter и т. Д.) И отсортируются в порядке убывания количества акций.
dimensions=sharingService metrics=shares filters=uploaderType==self sort=-shares
Метрики удержания аудитории для видео
Этот отчет измеряет способность видео сохранять свою аудиторию. Отчет может быть получен только для одного видео за раз. Обратите внимание, что для запуска этого запроса в APIS Explorer вы должны заменить строку VIDEO_ID в значении параметра filters на видео идентификатор для одного из ваших загруженных видео. Обратите внимание, что отчеты о хранении аудитории не поддерживают возможность указать несколько значений для video .
В этом примере в отчете используется фильтр audienceType для ограничения ответа, чтобы он содержит только данные для органических представлений, которые являются результатом прямого действия пользователя, таких как поиск видео или нажмите на предлагаемое видео. Таким образом, отчет не включает данные для представлений от TrueView In-Stream или TrueView в дисков. Вы можете удалить фильтр, чтобы получить данные о хранении аудитории видео от всех типов аудитории.
Обратите внимание, что данные для фильтра 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 filters=claimedStatus==claimed
Ежедневные доходы и показатели эффективности рекламы
Этот запрос получает ежедневные показатели доходов и производительности рекламы для заявленного контента владельца контента.
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed
Страновые доходы и показатели эффективности рекламы
Этот запрос получает показатели доходов и производительности рекламы для конкретного страны для заявленного контента владельца контента. Результаты сортируются в порядке убывания по сумме дохода, что означает, что первая перечисленная страна будет той, где партнер получил наибольший оценочный доход.
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed sort=-estimatedRevenue
Топ -10 - видео с самым высоким доходом
Этот запрос получает показатели доходов и производительности рекламы для 10 видеороликов, в которых утверждается владелец контента, и это имел самый высокий доход. Результаты сортируются в порядке убывания по сумме дохода, что означает, что первое видео будет тем, которое получит самый высокий оценочный доход.
dimensions=video metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed maxResults=10 sort=-estimatedRevenue
Метрики производительности рекламы для разных типов рекламы
Этот запрос получает показатели производительности рекламы для заявленного контента владельца контента. Результаты сгруппированы по типу AD, что позволяет сравнить доходы и значения CPM по разным типам AD.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType