Content Owner Reports

本页面列出了内容所有者可以使用 YouTube Reporting API 检索的报告。每个报告的 id(由 API 的 reportTypes.list 方法返回)都显示在报告名称旁边的括号中。

视频报告

视频报告提供与频道视频或内容所有者视频相关的所有用户活动统计信息。例如,这些报告包含视频的观看次数。

用户活动

此报告提供与内容所有者的频道以及这些频道的视频相关的用户活动统计信息。

相应报告的 idcontent_owner_basic_a4

目录
尺寸: datechannel_idvideo_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_code
指标: engaged_viewsviewscommentsshareswatch_time_minutesaverage_view_duration_secondsaverage_view_duration_percentageannotation_click_through_rateannotation_close_rateannotation_impressionsannotation_clickable_impressionsannotation_closable_impressionsannotation_clicksannotation_closescard_click_ratecard_teaser_click_ratecard_impressionscard_teaser_impressionscard_clickscard_teaser_clickssubscribers_gainedsubscribers_lostvideos_added_to_playlistsvideos_removed_from_playlistslikesdislikesred_views

用户活动(按省份)

此报告提供美国各州和哥伦比亚特区的用户活动统计信息。

此报告的 idcontent_owner_province_a3

目录
尺寸: datechannel_idvideo_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeprovince_code
指标: engaged_viewsviewswatch_time_minutesaverage_view_duration_secondsaverage_view_duration_percentageannotation_click_through_rateannotation_close_rateannotation_impressionsannotation_clickable_impressionsannotation_closable_impressionsannotation_clicksannotation_closescard_click_ratecard_teaser_click_ratecard_impressionscard_teaser_impressionscard_clickscard_teaser_clicksred_viewsred_watch_time_minutes

播放位置

此报告提供与发生视频播放的网页或应用类型相关的统计信息。

此报告的 idcontent_owner_playback_location_a3

流量来源

此报告会根据观看者在内容所有者的频道上观看视频的方式汇总观看统计信息。 例如,它可以确定来自 Google 搜索或相关视频链接的观看次数。

此报告的 idcontent_owner_traffic_source_a3

设备类型和操作系统

此报告会根据观看者的操作系统和设备类型汇总视频观看统计信息。例如,它可以识别在 Android 平板电脑或 Windows 桌面设备上发生的观看次数。

此报告的 idcontent_owner_device_os_a3

观看者受众特征

此报告会根据观看者的年龄段和性别汇总观看统计信息。

此报告的 idcontent_owner_demographics_a1

目录
尺寸: datechannel_idvideo_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeage_groupgender
指标: views_percentage

分享内容(按平台)

此报告提供的统计信息显示了内容所有者频道中的视频在不同社交平台上的分享频率。

此报告的 idcontent_owner_sharing_service_a1

目录
尺寸: datechannel_idvideo_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codesharing_service
指标: 分享

注释

此报告提供内容所有者频道中视频播放期间显示的注释的统计信息。

报告数据用于衡量每个视频中各个注释的效果。相比之下,用户活动报告会汇总视频所有注释的统计信息。

此报告的 idcontent_owner_annotations_a1

目录
尺寸: datechannel_idvideo_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeannotation_typeannotation_id
指标: annotation_click_through_rateannotation_close_rateannotation_impressionsannotation_clickable_impressionsannotation_closable_impressionsannotation_clicksannotation_closes

卡片

此报告提供内容所有者频道上视频播放期间显示的卡片的展示次数和点击率统计信息。

报告数据用于衡量各个卡片的表现。相比之下,用户活动报告会汇总视频所有卡片的统计信息。

此报告的 idcontent_owner_cards_a1

目录
尺寸: datechannel_idvideo_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codecard_typecard_id
指标: card_click_ratecard_teaser_click_ratecard_impressionscard_teaser_impressionscard_clickscard_teaser_clicks

片尾画面

此报告提供视频停止播放后显示的片尾画面的展示次数和点击率统计信息。

该报告包含内容所有者频道上视频的统计信息。

此报告的 idcontent_owner_end_screens_a1

目录
尺寸: datechannel_idvideo_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeend_screen_element_typeend_screen_element_id
指标: end_screen_element_clicksend_screen_element_impressionsend_screen_element_click_rate

字幕

此报告提供有关视频观看期间使用时间最长的隐式字幕语言的统计信息。系统会排除字幕大部分时间处于关闭状态的观看次数。

相应报告的 idcontent_owner_subtitles_a3

目录
尺寸: datechannel_idvideo_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codesubtitle_languagesubtitle_language_autotranslated
指标: engaged_viewsviewswatch_time_minutesaverage_view_duration_secondsaverage_view_duration_percentagered_viewsred_watch_time_minutes

合并

此报告结合了播放位置流量来源设备/操作系统报告中使用的维度,可提供精细的视频统计信息。

相应报告的 idcontent_owner_combined_a3

目录
尺寸: datechannel_idvideo_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeplayback_location_typetraffic_source_typedevice_typeoperating_system
指标: engaged_viewsviewswatch_time_minutesaverage_view_duration_secondsaverage_view_duration_percentagered_viewsred_watch_time_minutes

播放列表报告

播放列表报告提供的统计数据专门与在播放列表上下文中发生的视频观看相关。

用户活动

此报告提供与用户在内容所有者频道上与播放列表的互动相关的统计信息。

相应报告的 idcontent_owner_playlist_basic_a2

用户活动(按省份)

此报告提供与用户在内容所有者频道上与播放列表互动相关的用户活动统计信息,适用于美国各州和哥伦比亚特区的用户。报告经过过滤,仅包含 country_code 维度的值为 US 的数据。

相应报告的 idcontent_owner_playlist_province_a2

播放位置

此报告提供与播放列表播放发生的网页或应用类型相关的统计信息。

此报告的 idcontent_owner_playlist_playback_location_a2

流量来源

此报告会根据观看者在内容所有者的频道上观看播放列表视频的方式汇总观看统计信息。例如,此报告可确定来自 Google 搜索或相关视频链接的观看次数。

相应报告的 idcontent_owner_playlist_traffic_source_a2

设备类型和操作系统

此报告会根据观看者的操作系统和设备类型汇总播放列表观看统计信息。例如,它可以识别在 Android 平板电脑或 Windows 桌面设备上发生的观看次数。

此报告的 idcontent_owner_playlist_device_os_a2

合并

此报告结合了播放位置流量来源设备/操作系统报告中使用的维度,可提供精细的播放列表统计信息。

相应报告的 idcontent_owner_playlist_combined_a2

广告费率报告

广告费率报告提供在视频播放期间投放的广告的基于展示次数的指标。这些指标会统计每次广告展示,每次视频播放可能会产生多次展示。

该 API 支持以下广告费率报告,其中提供了内容所有者的视频的广告费率指标。

相应报告的 idcontent_owner_ad_rates_a1

相应报告的旧版本(现已完全弃用)的 ID 为 content_owner_ad_performance_a1

此版本与上一个版本的唯一区别在于,此版本将报告名称更新为使用 rates 一词,而不是 performance 一词。因此,报告本身的版本号 (a1) 与上一个版本相同,但 report ID 不同。

估算的收入报告

估算收入报告会提供视频从 Google 出售的广告来源和非广告来源获得的估算总收入。这些报告还包含一些广告效果指标。

收入指标用于标识特定收入来源以及通过这些收入来源获得的总收入金额。

估算的视频收入

此报告会显示内容所有者的所有视频通过 Google 销售的广告来源以及非广告来源获得的总收入。此外,还包含一些广告效果指标。

相应报告的 idcontent_owner_estimated_revenue_a2

估算的资产收入

此报告会显示内容所有者的所有媒体资源通过 Google 销售的广告来源以及非广告来源获得的总收入。此外,还包含一些广告效果指标。请注意,channel_id 维度用于标识上传了提供相应指标的 video_id 的频道。

相应报告的 idcontent_owner_asset_estimated_revenue_a2

资产报告

资产报告提供与内容所有者资产相关联的视频的用户活动指标。如果内容所有者已声明某视频与自己的某项资产相符,则该视频会纳入相应内容所有者的报告中。该视频可能是由内容所有者或其他 YouTube 用户上传的。

在资产报告中,channel_id 维度用于标识上传了 video_id(提供相应指标)的频道。

注意:在视频被提出版权主张的当天,资产报告中的用户活动指标可能不正确。之所以会出现这种差异,是因为报告中的指标反映的是当天的所有用户活动,而不仅仅是提出版权主张后的活动。

例如,假设某个视频在某一天被观看了 10 次,然后被声明版权,之后又被观看了 10 次。相应日期的资源报告会显示该视频被观看了 20 次,即使其中只有 10 次观看发生在版权主张提出之后。所有后续日期的指标都应准确反映与声明版权的视频相关的用户活动。

用户活动

此报告提供与用户对链接到内容所有者资产的视频执行的操作相关的统计信息。

此版本报告的 idcontent_owner_asset_basic_a3

目录
尺寸: datechannel_idvideo_idasset_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_code
指标: engaged_viewsviewscommentslikesdislikesvideos_added_to_playlistsvideos_removed_from_playlistsshareswatch_time_minutesaverage_view_duration_secondsaverage_view_duration_percentageannotation_click_through_rateannotation_close_rateannotation_impressionsannotation_clickable_impressionsannotation_closable_impressionsannotation_clicksannotation_closescard_click_ratecard_teaser_click_ratecard_impressionscard_teaser_impressionscard_clickscard_teaser_clicksred_views

用户活动(按省份)

此报告提供美国各州和哥伦比亚特区的用户活动统计信息。这实际上意味着,只有当 country_code 维度的值为 US 时,报告才会包含相应数据。相应报告的 idcontent_owner_asset_province_a3

此版本报告的 idcontent_owner_asset_province_a3

目录
尺寸: datechannel_idvideo_idasset_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeprovince_code
指标: engaged_viewsviewswatch_time_minutesaverage_view_duration_secondsaverage_view_duration_percentageannotation_click_through_rateannotation_close_rateannotation_impressionsannotation_clickable_impressionsannotation_closable_impressionsannotation_clicksannotation_closescard_click_ratecard_teaser_click_ratecard_impressionscard_teaser_impressionscard_clickscard_teaser_clicksred_viewsred_watch_time_minutes

视频播放位置

此报告提供与发生视频播放的网页或应用类型相关的统计信息。

此版本报告的 idcontent_owner_asset_playback_location_a3

目录
尺寸: datechannel_idvideo_idasset_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeplayback_location_typeplayback_location_detail
指标: engaged_viewsviewswatch_time_minutesaverage_view_duration_secondsaverage_view_duration_percentagered_viewsred_watch_time_minutes

流量来源

此报告会根据观看者访问与内容所有者资产相关联的视频内容的方式,汇总观看统计信息。例如,它可以确定来自 Google 搜索或相关视频链接的观看次数。

此版本报告的 idcontent_owner_asset_traffic_source_a3

目录
尺寸: datechannel_idvideo_idasset_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codetraffic_source_typetraffic_source_detail
指标: engaged_viewsviewswatch_time_minutesaverage_view_duration_secondsaverage_view_duration_percentagered_viewsred_watch_time_minutes

设备类型和操作系统

此报告会根据观看者的操作系统和设备类型汇总视频观看统计信息。例如,它可以识别在 Android 平板电脑或 Windows 桌面设备上发生的观看次数。

观看者受众特征

此报告会根据观看者的年龄段和性别汇总观看统计信息。相应报告的 idcontent_owner_asset_demographics_a1

目录
尺寸: datechannel_idvideo_idasset_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeage_groupgender
指标: views_percentage

分享内容(按平台)

此报告提供的统计信息显示了与内容所有者的素材资源相关联的视频在不同社交平台上的分享频率。相应报告的 idcontent_owner_asset_sharing_service_a1

目录
尺寸: datechannel_idvideo_idasset_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codesharing_service
指标: 分享

注释

此报告提供与内容所有者资产相关联的视频中显示的注释的统计信息。报告数据用于衡量各个注释的效果。相比之下,用户活动报告会汇总视频所有注释的统计信息。相应报告的 idcontent_owner_asset_annotations_a1

目录
尺寸: datechannel_idvideo_idasset_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeannotation_typeannotation_title
指标: annotation_click_through_rateannotation_close_rateannotation_impressionsannotation_clickable_impressionsannotation_closable_impressionsannotation_clicksannotation_closes

卡片

此报告提供与内容所有者资产相关联的视频中显示的卡片的展示次数和点击率统计信息。报告数据用于衡量各个卡片的表现。相比之下,用户活动报告会汇总与资源相关联的每个视频中显示的所有卡片的统计信息。相应报告的 idcontent_owner_asset_cards_a1

目录
尺寸: datechannel_idvideo_idasset_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codecard_typecard_id
指标: card_click_ratecard_teaser_click_ratecard_impressionscard_teaser_impressionscard_clickscard_teaser_clicks

片尾画面

此报告提供视频停止播放后显示的片尾画面的展示次数和点击率统计信息。此报告包含内容所有者频道中已声明版权的视频的统计信息,还会指明与这些视频相关联的资产。相应报告的 idcontent_owner_asset_end_screens_a1

目录
尺寸: datechannel_idvideo_idasset_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeend_screen_element_typeend_screen_element_id
指标: end_screen_element_clicksend_screen_element_impressionsend_screen_element_click_rate

合并

此报告结合了播放位置流量来源设备/操作系统报告中使用的维度,可提供精细的视频统计信息。

相应报告的 idcontent_owner_asset_combined_a3