На этой странице перечислены отчеты, которые владельцы контента могут получить с помощью API отчетов YouTube. id каждого отчета, возвращаемый методом API reportTypes.list , отображается в скобках рядом с именем отчета.
Видео отчеты
Видеоотчеты предоставляют статистику по всем действиям пользователя, связанным с видео канала или видео владельца контента. Например, эти отчеты содержат количество просмотров ваших видео.
Активность пользователя
В этом отчете представлена статистика активности пользователей, связанная с каналами владельца контента и видео этих каналов.
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 . В результате сам отчет имеет тот же номер версии ( 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_a2 .
Предполагаемый доход от активов
Этот отчет содержит общий доход для всех активов владельца контента из источников рекламы, проданных Google, а также из нерекламных источников. Он также содержит некоторые показатели эффективности рекламы. Обратите внимание, что измерение channel_id определяет канал, который загрузил video_id , для которого предоставляются показатели.
id этого отчета — content_owner_asset_estimated_revenue_a2 .
- Добавляет метрику 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 |