На этой странице перечислены отчеты, которые владельцы контента могут получить с помощью YouTube Reporting API. id каждого отчета, возвращаемый методом API reportTypes.list , отображается в скобках рядом с именем отчета.
Видео отчеты
Отчеты о видео предоставляют статистику по всем действиям пользователей, связанным с видео канала или видео владельца контента. Например, эти отчеты содержат количество просмотров ваших видео.
Активность пользователя
В этом отчете представлена статистика активности пользователей, связанная с каналами владельца контента и видео этих каналов. id текущей версии этого отчета — content_owner_basic_a3 .
id этой версии этого отчета — content_owner_basic_a3 . Имеет следующие отличия от версии a2 :
- Добавить показатель red_views
- Добавить показатель red_watch_time_minutes
Примечание. Отчет content_owner_basic_a1 полностью устарел .
Активность пользователей по провинциям
В этом отчете представлена статистика активности пользователей по штатам США и округу Колумбия. 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 :
- Добавляет метрику Assessment_partner_red_revenue
- Добавляет показатель предполагаемого_партнера_транзакции_дохода
- Переименовывает метрику Assessment_partner_ad_sense_revenue в Assessment_partner_ad_auction_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 :
- Добавляет метрику Assessment_partner_red_revenue
- Добавляет показатель предполагаемого_партнера_транзакции_дохода
- Переименовывает метрику Assessment_partner_ad_sense_revenue в Assessment_partner_ad_auction_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 |