На этой странице перечислены отчеты, которые владельцы контента могут получить с помощью API отчетов YouTube. id
каждого отчета, возвращаемый методом API reportTypes.list
, отображается в скобках рядом с именем отчета.
Видео отчеты
Видеоотчеты предоставляют статистику по всем действиям пользователя, связанным с видео канала или видео владельца контента. Например, эти отчеты содержат количество просмотров ваших видео.
Активность пользователя
Этот отчет предоставляет статистику активности пользователей, связанную с каналами владельца контента и видео этих каналов. id
текущей версии этого отчета — content_owner_basic_a3
.
id
этой версии этого отчета — content_owner_basic_a3
. Он имеет следующие отличия от версии a2
:
- Добавить метрику red_views
- Добавить метрику red_watch_time_minutes
Активность пользователей по провинциям
Этот отчет содержит статистику активности пользователей для штатов США и округа Колумбия. id
этого отчета — content_owner_province_a2
.
id
этой версии этого отчета — content_owner_province_a2
. Он имеет следующие отличия от версии a1
:
- Добавить метрику red_views
- Добавить метрику red_watch_time_minutes
Места воспроизведения
Этот отчет предоставляет статистику, связанную с типом страницы или приложения, где произошло воспроизведение видео. id
этого отчета — content_owner_playback_location_a2
.
id
этой версии этого отчета — content_owner_playback_location_a2
. Он имеет следующие отличия от версии a1
:
- Добавить метрику red_views
- Добавить метрику red_watch_time_minutes
Содержание | |
---|---|
Размеры: | date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , playback_location_type , playback_location_detail |
Метрики: | views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes |
Источники трафика
Этот отчет объединяет статистику просмотров на основе способа, которым зрители добирались до видео на каналах владельца контента. Например, он определяет количество просмотров, полученных из поиска Google или по ссылке на связанное видео. id
этого отчета — content_owner_traffic_source_a2
.
id
этой версии этого отчета — content_owner_traffic_source_a2
. Он имеет следующие отличия от версии a1
:
- Добавить метрику red_views
- Добавить метрику red_watch_time_minutes
Содержание | |
---|---|
Размеры: | date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , traffic_source_type , traffic_source_detail |
Метрики: | 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_a2
.
id
этой версии этого отчета — content_owner_device_os_a2
. Он имеет следующие отличия от версии a1
:
- Добавить метрику red_views
- Добавить метрику red_watch_time_minutes
Содержание | |
---|---|
Размеры: | date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , device_type , operating_system |
Метрики: | 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_a2
.
id
этой версии этого отчета — content_owner_subtitles_a2
. Он имеет следующие отличия от версии a1
:
- Добавить метрику red_views
- Добавить метрику red_watch_time_minutes
Содержание | |
---|---|
Размеры: | date , channel_id , video_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , subtitle_language , subtitle_language_autotranslated |
Метрики: | views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes |
Комбинированный
Этот отчет предоставляет подробную статистику видео, объединяя измерения, используемые в отчетах о месте воспроизведения , источнике трафика и устройстве/ОС . id
этого отчета — content_owner_combined_a2
.
id
этой версии этого отчета — content_owner_combined_a2
. Он имеет следующие отличия от версии a1
:
- Добавить метрику red_views
- Добавить метрику red_watch_time_minutes
Содержание | |
---|---|
Размеры: | 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 |
Метрики: | views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes |
Отчеты о плейлистах
Отчеты по плейлистам содержат статистику, которая конкретно связана с просмотрами видео, происходящими в контексте плейлиста.
Активность пользователя
Этот отчет предоставляет статистику, связанную с взаимодействием пользователей с плейлистами на каналах владельца контента. id
этого отчета — content_owner_playlist_basic_a1
.
Содержание | |
---|---|
Размеры: | date , channel_id , playlist_id , video_id , live_or_on_demand , subscribed_status , country_code |
Метрики: | views , watch_time_minutes , average_view_duration_seconds , playlist_starts , playlist_saves_added , playlist_saves_removed |
Активность пользователей по провинциям
Этот отчет предоставляет статистику активности пользователей, связанную с взаимодействием пользователей с плейлистами на каналах владельца контента для пользователей в штатах США и округе Колумбия. Это фактически означает, что отчет фильтруется для включения данных только в том случае, если значение измерения country_code равно US
. id
этого отчета — content_owner_playlist_province_a1
.
Содержание | |
---|---|
Размеры: | date , channel_id , playlist_id , video_id , live_or_on_demand , subscribed_status , country_code , province_code |
Метрики: | views , watch_time_minutes , average_view_duration_seconds , playlist_starts , playlist_saves_added , playlist_saves_removed |
Места воспроизведения
Этот отчет предоставляет статистику, связанную с типом страницы или приложения, где произошли воспроизведения плейлистов. id
этого отчета — content_owner_playlist_playback_location_a1
.
Содержание | |
---|---|
Размеры: | date , channel_id , playlist_id , video_id , live_or_on_demand , subscribed_status , country_code , playback_location_type , playback_location_detail |
Метрики: | views , watch_time_minutes , average_view_duration_seconds , playlist_starts , playlist_saves_added , playlist_saves_removed |
Источники трафика
Этот отчет объединяет статистику просмотров на основе способа, которым зрители достигли видео плейлистов на каналах владельца контента. Например, он определяет количество просмотров, полученных из поиска Google или по ссылке на связанное видео. id
этого отчета — content_owner_playlist_traffic_source_a1
.
Содержание | |
---|---|
Размеры: | date , channel_id , playlist_id , video_id , live_or_on_demand , subscribed_status , country_code , traffic_source_type , traffic_source_detail |
Метрики: | views , watch_time_minutes , average_view_duration_seconds , playlist_starts , playlist_saves_added , playlist_saves_removed |
Тип устройства и операционная система
Этот отчет объединяет статистику просмотра плейлистов на основе операционных систем и типов устройств зрителей. Например, он определяет количество просмотров, которые произошли на планшетах Android или на настольных устройствах Windows. id
этого отчета — content_owner_playlist_device_os_a1
.
Содержание | |
---|---|
Размеры: | date , channel_id , playlist_id , video_id , live_or_on_demand , subscribed_status , country_code , device_type , operating_system |
Метрики: | views , watch_time_minutes , average_view_duration_seconds , playlist_starts , playlist_saves_added , playlist_saves_removed |
Комбинированный
Этот отчет предоставляет детальную статистику плейлиста, объединяя измерения, используемые в отчетах о месте воспроизведения , источнике трафика и устройстве/ОС . id
этого отчета — content_owner_playlist_combined_a1
.
Содержание | |
---|---|
Размеры: | 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 |
Метрики: | views , watch_time_minutes , average_view_duration_seconds , playlist_starts , playlist_saves_added , playlist_saves_removed |
Отчеты о рейтинге рекламы
Отчеты о ставках рекламы предоставляют метрики на основе показов для рекламы, которая воспроизводилась во время воспроизведения видео. Эти метрики учитывают каждый показ рекламы, и каждое воспроизведение видео может дать несколько показов.
API поддерживает следующий отчет о ставках рекламы, который предоставляет метрики ставок рекламы для видео владельца контента. id
текущей версии этого отчета — content_owner_ad_rates_a1
.
id
этой версии этого отчета — content_owner_ad_rates_a1
. Идентификатор предыдущей версии этого отчета, которая теперь полностью устарела, был content_owner_ad_performance_a1
.
Единственное отличие от предыдущей версии заключается в том, что эта версия обновляет название отчета, чтобы использовать слово rates
вместо слова 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
.
id
этой версии этого отчета — content_owner_estimated_revenue_a1
. Он имеет следующие отличия от предыдущей версии, которая была content_owner_estimated_earnings_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
отличается.
Предполагаемый доход от активов
В этом отчете представлены общие доходы от всех активов владельца контента из источников рекламы, проданных Google, а также из нерекламных источников. Он также содержит некоторые показатели эффективности рекламы. Обратите внимание, что измерение channel_id определяет канал, который загрузил video_id , для которого предоставляются показатели. id
для текущей версии этого отчета — content_owner_asset_estimated_revenue_a1
.
id
этой версии этого отчета — content_owner_asset_estimated_revenue_a1
. Он имеет следующие отличия от предыдущей версии, которая была content_owner_asset_estimated_earnings_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_a2
.
id
этой версии этого отчета — content_owner_asset_basic_a2
. Он имеет следующие отличия от версии a1
:
- Добавить метрику red_views
- Добавить метрику red_watch_time_minutes
Активность пользователей по провинциям
Этот отчет содержит статистику активности пользователей для штатов США и округа Колумбия. Это фактически означает, что отчет фильтруется для включения данных только в том случае, если значение измерения country_code равно US
. id
этого отчета — content_owner_asset_province_a2
.
id
этой версии этого отчета — content_owner_asset_province_a2
. Он имеет следующие отличия от версии a1
:
- Добавить метрику red_views
- Добавить метрику red_watch_time_minutes
Места воспроизведения видео
Этот отчет предоставляет статистику, связанную с типом страницы или приложения, где произошло воспроизведение видео. id
этого отчета — content_owner_asset_playback_location_a2
.
id
этой версии этого отчета — content_owner_asset_playback_location_a2
. Он имеет следующие отличия от версии a1
:
- Добавить метрику red_views
- Добавить метрику red_watch_time_minutes
Содержание | |
---|---|
Размеры: | 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 |
Метрики: | 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_a2
.
id
этой версии этого отчета — content_owner_asset_traffic_source_a2
. Он имеет следующие отличия от версии a1
:
- Добавить метрику red_views
- Добавить метрику red_watch_time_minutes
Содержание | |
---|---|
Размеры: | 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 |
Метрики: | 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_a2
.
id
этой версии этого отчета — content_owner_asset_device_os_a2
. Он имеет следующие отличия от версии a1
:
- Добавить метрику red_views
- Добавить метрику red_watch_time_minutes
Содержание | |
---|---|
Размеры: | date , channel_id , video_id , asset_id , claimed_status , uploader_type , live_or_on_demand , subscribed_status , country_code , device_type , operating_system |
Метрики: | 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_a2
.
id
этой версии этого отчета — content_owner_asset_combined_a2
. Он имеет следующие отличия от версии a1
:
- Добавить метрику red_views
- Добавить метрику red_watch_time_minutes
Содержание | |
---|---|
Размеры: | 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 |
Метрики: | views , watch_time_minutes , average_view_duration_seconds , average_view_duration_percentage , red_views , red_watch_time_minutes |