На этой странице представлен список отчётов, которые владельцы контента могут получить с помощью API отчётов YouTube. id каждого отчёта, возвращаемый методом reportTypes.list API, указан в скобках рядом с названием отчёта.
Видеоотчеты
Видеоотчёты предоставляют статистику по всем действиям пользователей, связанным с видео на канале или с видео владельца контента. Например, эти отчёты содержат информацию о количестве просмотров ваших видео.
Активность пользователя
В этом отчете представлена статистика активности пользователей, связанная с каналами владельцев контента и видеороликами этих каналов.
id этого отчета — content_owner_basic_a4 .
Активность пользователей по провинциям
В этом отчете представлена статистика активности пользователей по штатам США и округу Колумбия.
id этого отчета — content_owner_province_a3 .
Места воспроизведения
В этом отчете представлена статистика, связанная с типом страницы или приложения, где происходило воспроизведение видео.
id этого отчета — content_owner_playback_location_a3 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , playback_location_type , playback_location_detail |
| Метрики: | engaged_views , views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes |
Источники трафика
Этот отчёт агрегирует статистику просмотров, основанную на способах, которыми зрители перешли на видео на каналах владельца контента. Например, он определяет количество просмотров, полученных через поиск Google или по ссылке на похожее видео.
id этого отчета — content_owner_traffic_source_a3 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , traffic_source_type , traffic_source_detail |
| Метрики: | engaged_views , views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes |
Тип устройства и операционная система
В этом отчёте собрана статистика просмотров видео по операционным системам и типам устройств зрителей. Например, он определяет количество просмотров на планшетах Android или настольных устройствах Windows.
id этого отчета — content_owner_device_os_a3 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , device_type , operating_system |
| Метрики: | engaged_views , views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes |
Демографические данные зрителей
В этом отчете собрана статистика просмотров в зависимости от возрастной группы и пола зрителей.
id этого отчета — content_owner_demographics_a1 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , age_group , gender |
| Метрики: | views_percentage |
Обмен контентом по платформам
В этом отчете представлена статистика, показывающая, как часто видеоролики на каналах владельцев контента публиковались на различных социальных платформах.
id этого отчета — content_owner_sharing_service_a1 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , sharing_service |
| Метрики: | shares |
Аннотации
В этом отчете представлена статистика по аннотациям, которые отображаются во время видео на каналах владельцев контента.
Данные отчёта измеряют эффективность отдельных аннотаций к каждому видео. Отчёт об активности пользователей , напротив, представляет собой агрегированную статистику по всем аннотациям к видео.
id этого отчета — content_owner_annotations_a1 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , annotation_type , annotation_id |
| Метрики: | annotation_click_through_rate , annotation_close_rate , annotation_impressions , annotation_clickable_impressions , annotation_closable_impressions , annotation_clicks , annotation_closes |
Карты
В этом отчете содержится статистика показов и переходов по карточкам , которые отображаются во время просмотра видео на каналах владельцев контента.
Данные отчёта измеряют эффективность отдельных карточек. Отчёт об активности пользователей , напротив, представляет собой агрегированную статистику по всем карточкам видео.
id этого отчета — content_owner_cards_a1 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , card_type , card_id |
| Метрики: | card_click_rate , card_teaser_click_rate , card_impressions , card_teaser_impressions , card_clicks , card_teaser_clicks |
Конечные экраны
В этом отчете содержится статистика показов и переходов по ссылкам для конечных заставок, которые отображаются после окончания воспроизведения видео.
Отчет содержит статистику по видеороликам на каналах владельцев контента.
id этого отчета — content_owner_end_screens_a1
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , end_screen_element_type , end_screen_element_id |
| Метрики: | end_screen_element_clicks , end_screen_element_impressions , end_screen_element_click_rate |
Субтитры
В этом отчёте представлена статистика по языку субтитров, который используется дольше всего при просмотре видео. Просмотры, в которых субтитры в основном отключены, исключены.
id этого отчета — content_owner_subtitles_a3 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , subtitle_language , subtitle_language_autotranslated |
| Метрики: | engaged_views , views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes |
Комбинированный
В этом отчете представлена подробная статистика видео путем объединения измерений, используемых в отчетах о месте воспроизведения , источнике трафика и устройстве/ОС .
id этого отчета — content_owner_combined_a3 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , playback_location_type , traffic_source_type , device_type , operating_system |
| Метрики: | engaged_views , views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes |
Отчеты о плейлистах
Отчеты по плейлистам содержат статистику, непосредственно связанную с просмотрами видео в контексте плейлиста.
Активность пользователя
В этом отчете представлена статистика, касающаяся взаимодействия пользователей с плейлистами на каналах владельцев контента.
id этого отчета — content_owner_playlist_basic_a2 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , playlist_id , video_id , live_or_on_demand , subscribed_status , country_code |
| Метрики: | engaged_views , views , watch_time_minutes , average_view_duration_seconds , playlist_starts , playlist_saves_added , playlist_saves_removed |
Активность пользователей по провинциям
В этом отчёте представлена статистика активности пользователей, связанная с их взаимодействием с плейлистами на каналах владельца контента для пользователей из штатов США и округа Колумбия. Отчёт фильтруется таким образом, чтобы включать данные только в том случае, если значение параметра country_code равно US .
id этого отчета — content_owner_playlist_province_a2 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , playlist_id , video_id , live_or_on_demand , subscribed_status , country_code , province_code |
| Метрики: | engaged_views , views , watch_time_minutes , average_view_duration_seconds , playlist_starts , playlist_saves_added , playlist_saves_removed |
Места воспроизведения
В этом отчете представлена статистика, связанная с типом страницы или приложения, где произошло воспроизведение плейлиста.
id этого отчета — content_owner_playlist_playback_location_a2 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , playlist_id , video_id , live_or_on_demand , subscribed_status , country_code , playback_location_type , playback_location_detail |
| Метрики: | engaged_views , views , watch_time_minutes , average_view_duration_seconds , playlist_starts , playlist_saves_added , playlist_saves_removed |
Источники трафика
В этом отчёте собрана статистика просмотров, основанная на способах, которыми зрители перешли к видео из плейлистов на каналах владельцев контента. Например, в отчёте указывается количество просмотров, полученных через поиск Google или по ссылке на похожее видео.
id этого отчета — content_owner_playlist_traffic_source_a2 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , playlist_id , video_id , live_or_on_demand , subscribed_status , country_code , traffic_source_type , traffic_source_detail |
| Метрики: | engaged_views , views , watch_time_minutes , average_view_duration_seconds , playlist_starts , playlist_saves_added , playlist_saves_removed |
Тип устройства и операционная система
В этом отчёте собрана статистика просмотров плейлистов в зависимости от операционных систем и типов устройств зрителей. Например, он определяет количество просмотров на планшетах Android или настольных компьютерах Windows.
id этого отчета — content_owner_playlist_device_os_a2 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , playlist_id , video_id , live_or_on_demand , subscribed_status , country_code , device_type , operating_system |
| Метрики: | engaged_views , views , watch_time_minutes , average_view_duration_seconds , playlist_starts , playlist_saves_added , playlist_saves_removed |
Комбинированный
В этом отчете представлена подробная статистика плейлиста, которая формируется путем объединения измерений, используемых в отчетах о месте воспроизведения , источнике трафика и устройстве/ОС .
id этого отчета — content_owner_playlist_combined_a2 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , playlist_id , video_id , live_or_on_demand , subscribed_status , country_code , playback_location_type , traffic_source_type , device_type , operating_system |
| Метрики: | engaged_views , views , watch_time_minutes , average_view_duration_seconds , playlist_starts , playlist_saves_added , playlist_saves_removed |
Отчеты об эффективности рекламы
Отчёты по эффективности рекламы предоставляют метрики, основанные на показах рекламы, показанной во время воспроизведения видео. Эти метрики учитывают каждый показ рекламы, а каждое воспроизведение видео может привести к нескольким показам.
API поддерживает следующий отчет по рейтингу рекламы, который предоставляет метрики рейтинга рекламы для видеороликов владельца контента.
id этого отчета — content_owner_ad_rates_a1 .
Идентификатор предыдущей версии этого отчета, которая теперь полностью устарела, был content_owner_ad_performance_a1 .
Единственное отличие от предыдущей версии заключается в том, что в этой версии название отчёта изменено на « rates вместо «performance» performance . В результате сам отчёт имеет тот же номер версии ( a1 ), что и предыдущая версия, но report ID другой.
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , claimed_status , uploader_type , country_code , ad_type |
| Метрики: | estimated_youtube_ad_revenue , ad_impressions , estimated_cpm |
Отчеты о предполагаемых доходах
Отчёты о предполагаемом доходе содержат общую предполагаемую выручку от видео, полученных из рекламных источников Google и не связанных с рекламой. Эти отчёты также содержат некоторые показатели эффективности рекламы. В них не учитывается доход от коротких видео .
Показатели доходов определяют конкретные источники доходов и сумму общего дохода, полученного через эти потоки доходов.
Предполагаемый доход от видео
В этом отчёте представлен общий доход от всех видео владельца контента, полученных как из рекламных источников Google, так и из нерекламных источников. Он также содержит некоторые показатели эффективности рекламы.
id этого отчета — content_owner_estimated_revenue_a1 .
Предполагаемый доход от активов
В этом отчёте представлен общий доход от всех ресурсов владельца контента, полученных как из рекламных источников, проданных через Google, так и из нерекламных источников. Он также содержит некоторые показатели эффективности рекламы. Обратите внимание, что параметр channel_id определяет канал, загрузивший видео с идентификатором video_id , для которого предоставляются метрики.
id этого отчета — content_owner_asset_estimated_revenue_a1 .
- Добавляет метрику estimate_partner_red_revenue
- Добавляет метрику estimate_partner_transaction_revenue
- Переименовывает метрику estimate_partner_ad_sense_revenue в estimate_partner_ad_auction_revenue
- Переименовывает метрику estimate_partner_double_click_revenue в estimate_partner_ad_reserved_revenue
- Обновляет название отчёта, используя слово «
revenueвместо словаearnings. В результате отчёт имеет тот же номер версии (a1), что и предыдущая версия, ноreport IDотличается.
Отчеты об активах
Отчёты об активах предоставляют метрики активности пользователей, связанные с видео, связанными с активами владельца контента. Видео включается в отчёт владельца контента, если владелец контента заявил, что оно соответствует одному из активов владельца контента. Видео могло быть загружено владельцем контента или другим пользователем YouTube.
В отчетах по активам параметр channel_id идентифицирует канал, загрузивший video_id , для которого предоставляются метрики.
Например, предположим, что в определённый день видео было просмотрено 10 раз, затем на него было заявлено право собственности, а затем оно было просмотрено ещё 10 раз. В отчёте по активам за этот день будет указано, что видео было просмотрено 20 раз, хотя только 10 из этих просмотров произошли после подачи заявления. Метрики за все последующие дни должны точно отражать активность пользователей, связанную с заявленным видео.
Активность пользователя
В этом отчете представлена статистика действий пользователей в отношении видеороликов, связанных с активами владельца контента.
id этой версии отчета — content_owner_asset_basic_a3 .
Активность пользователей по провинциям
Этот отчёт содержит статистику активности пользователей в штатах США и округе Колумбия. Фактически это означает, что отчёт фильтруется и включает только данные, если значение параметра country_code равно US . id этого отчёта — content_owner_asset_province_a3 .
id этой версии отчета — content_owner_asset_province_a3 .
Места воспроизведения видео
В этом отчете представлена статистика, связанная с типом страницы или приложения, где происходило воспроизведение видео.
id этой версии отчета — content_owner_asset_playback_location_a3 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , asset_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , playback_location_type , playback_location_detail |
| Метрики: | engaged_views , views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes |
Источники трафика
В этом отчёте собрана статистика просмотров, основанная на способах, которыми зрители перешли на видеоконтент, связанный с активами владельца контента. Например, он определяет количество просмотров, полученных через поиск Google или по ссылке на похожее видео.
id этой версии отчета — content_owner_asset_traffic_source_a3 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , asset_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , traffic_source_type , traffic_source_detail |
| Метрики: | engaged_views , views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes |
Тип устройства и операционная система
В этом отчёте собрана статистика просмотров видео по операционным системам и типам устройств зрителей. Например, он определяет количество просмотров на планшетах Android или настольных устройствах Windows.
id этой версии отчета — content_owner_asset_device_os_a3 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , asset_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , device_type , operating_system |
| Метрики: | engaged_views , views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes |
Демографические данные зрителей
Этот отчёт содержит статистику просмотров по возрасту и полу зрителей. id этого отчёта — content_owner_asset_demographics_a1 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , asset_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , age_group , gender |
| Метрики: | views_percentage |
Обмен контентом по платформам
Этот отчёт содержит статистику, показывающую частоту распространения видео, связанных с активами владельца контента, на различных социальных платформах. id этого отчёта: content_owner_asset_sharing_service_a1 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , asset_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , sharing_service |
| Метрики: | shares |
Аннотации
Этот отчёт содержит статистику по аннотациям, отображаемым в видео, связанных с активами владельца контента. Данные отчёта измеряют эффективность отдельных аннотаций. Отчёт об активности пользователей , напротив, объединяет статистику по всем аннотациям видео. id этого отчёта — content_owner_asset_annotations_a1 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , asset_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , annotation_type , annotation_title |
| Метрики: | annotation_click_through_rate , annotation_close_rate , annotation_impressions , annotation_clickable_impressions , annotation_closable_impressions , annotation_clicks , annotation_closes |
Карты
Этот отчёт содержит статистику показов и переходов по карточкам , отображаемым в видеороликах, связанных с активами владельца контента. Данные отчёта измеряют эффективность отдельных карточек. Отчёт об активности пользователей , напротив, агрегирует статистику по всем карточкам, отображаемым в каждом видеоролике, связанном с активом. id этого отчёта — content_owner_asset_cards_a1 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , asset_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , card_type , card_id |
| Метрики: | card_click_rate , card_teaser_click_rate , card_impressions , card_teaser_impressions , card_clicks , card_teaser_clicks |
Конечные экраны
Этот отчёт содержит статистику показов и переходов по конечным заставкам, которые отображаются после окончания воспроизведения видео. В отчёте содержится статистика по заявленным видео на каналах владельцев контента, а также указаны ресурсы, связанные с этими видео. id этого отчёта: content_owner_asset_end_screens_a1 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , asset_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , end_screen_element_type , end_screen_element_id |
| Метрики: | end_screen_element_clicks , end_screen_element_impressions , end_screen_element_click_rate |
Комбинированный
В этом отчете представлена подробная статистика видео путем объединения измерений, используемых в отчетах о месте воспроизведения , источнике трафика и устройстве/ОС .
id этого отчета — content_owner_asset_combined_a3 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , asset_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , playback_location_type , traffic_source_type , device_type , operating_system |
| Метрики: | engaged_views , views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes |