На этой странице перечислены отчеты, которые владельцы контента могут получить с помощью 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_reach_basic_a1 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id |
| Показатели: | video_thumbnail_impressions , video_thumbnail_impressions_ctr |
Общий охват
В этом отчете представлены статистические данные об охвате аудитории в сочетании с информацией об источниках трафика и типах устройств.
id этого отчета — content_owner_reach_combined_a1 .
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , traffic_source_type , traffic_source_detail , operating_system , device_type |
| Показатели: | video_thumbnail_impressions , video_thumbnail_impressions_ctr |
Отчеты по плейлистам
Отчеты по плейлистам содержат статистику, непосредственно связанную с просмотрами видео в контексте данного плейлиста.
Активность пользователей
В этом отчете представлены статистические данные о взаимодействии пользователей с плейлистами на каналах владельца контента.
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 .
Единственное отличие от предыдущей версии заключается в том, что в этой версии название отчета изменено с « performance » на « rates ». В результате сам отчет имеет тот же номер версии ( 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, и от источников, не связанных с рекламой. Эти отчеты также содержат некоторые показатели эффективности рекламы. В эти отчеты не включен доход, полученный от Shorts .
Показатели прибыли позволяют определить конкретные источники дохода и общий объем выручки, полученной за счет этих потоков.
Предполагаемый доход от видеоконтента
В этом отчете представлены общие доходы владельца контента от всех его видеороликов, полученных как от рекламных источников, продаваемых Google, так и от источников, не связанных с рекламой. Он также содержит некоторые показатели эффективности рекламы.
id этого отчета — content_owner_estimated_revenue_a1 .
Предполагаемая выручка от активов
В этом отчете представлены общие доходы владельца контента от рекламных источников, продаваемых Google, а также от источников, не связанных с рекламой. Он также содержит некоторые показатели эффективности рекламы. Обратите внимание, что параметр channel_id определяет канал, загрузивший видео с идентификатором video_id , для которого предоставляются показатели.
id этого отчета — content_owner_asset_estimated_revenue_a1 .
- Добавляет метрику estimated_partner_red_revenue.
- Добавляет метрику estimated_partner_transaction_revenue.
- Переименовывает метрику estimated_partner_ad_sense_revenue в estimated_partner_ad_auction_revenue
- Переименовывает метрику estimated_partner_double_click_revenue в estimated_partner_ad_reserved_revenue
- В результате в названии отчета вместо слова
revenue» используется слово «earnings. Номер версии самого отчета (a1) совпадает с предыдущей версией, ноreport IDотличается.
| Содержание | |
|---|---|
| Размеры: | date , channel_id , video_id , asset_id , claimed_status , uploader_type , country_code |
| Показатели: | estimated_partner_revenue , estimated_partner_ad_revenue , estimated_partner_ad_auction_revenue , estimated_partner_ad_reserved_revenue , estimated_partner_red_revenue , estimated_partner_transaction_revenue |
Отчеты по активам
Отчеты по контенту предоставляют метрики активности пользователей, связанные с видеороликами, которые привязаны к контенту владельца. Видео включается в отчет владельца контента, если владелец контента заявил, что это видео соответствует одному из его собственных ресурсов. Видео могло быть загружено владельцем контента или другим пользователем 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 |