Content Owner Reports

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

视频报告

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

用户活动

此报告会提供与内容所有者的频道及其频道中视频相关的用户活动统计信息。该报告当前版本的idcontent_owner_basic_a3

注意content_owner_basic_a1 报告已被完全弃用

用户活动(按省份)

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

播放位置

此报告会提供与播放视频的类型或应用类型相关的统计信息。该报告的idcontent_owner_playback_location_a2

版本 a2
状态:当前

此版本的 idcontent_owner_playback_location_a2。它与 a1 版本具有以下差异:

目录
尺寸: datechannel_idvideo_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeplayback_location_typeplayback_location9
指标: viewswatch_time_minutesaverage_view_duration_secondsaverage_view_duration_percentagered_viewsred_watch_time_minutes

流量来源

此报告会根据观看者到达内容所有者频道上的视频的方式汇总观看统计信息。 例如,它标识了源自 Google 搜索或相关视频链接的观看次数。该报告的idcontent_owner_traffic_source_a2

版本 a2
状态:当前

此版本的 idcontent_owner_traffic_source_a2。它与 a1 版本具有以下差异:

目录
尺寸: datechannel_idvideo_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codetraffic_source_typetraffic_source_detail_source_source_detail_source_detail
指标: viewswatch_time_minutesaverage_view_duration_secondsaverage_view_duration_percentagered_viewsred_watch_time_minutes

设备类型和操作系统

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

观看者受众特征

此报告汇总了根据观看者的年龄段和性别统计的统计信息。 该报告的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_9end_1}
指标: end_screen_element_clicksend_screen_element_impressionsend_screen_element_click_rate

字幕

此报告会提供字幕语言使用时间最长的统计数据。主要关闭字幕的视图会被排除。该报告的idcontent_owner_subtitles_a2

合并

此报告会合并播放位置报告、流量来源报告和设备/操作系统报告中使用的维度,从而提供精细的视频统计信息。该报告的idcontent_owner_combined_a2

播放列表报告

播放列表报告提供的统计信息与播放列表播放时的视频观看次数相关。

用户活动

此报告会提供用户与内容所有者频道上的播放列表进行互动的统计数据。 该报告的idcontent_owner_playlist_basic_a1

目录
尺寸: datechannel_idplaylist_idvideo_idlive_or_on_demandsubscribed_statuscountry_code
指标: viewswatch_time_minutesaverage_view_duration_secondsplaylist_startsplaylist_saves_ addedplaylist_saves_removed

用户活动(按省份)

此报告会针对美国各州和哥伦比亚特区的用户,提供用户与内容所有者频道上的播放列表的互动情况。 实际上,这意味着仅当 country_code 维度的值为 US 时,报告才会过滤数据。该报告的idcontent_owner_playlist_province_a1

目录
尺寸: datechannel_idplaylist_idvideo_idlive_or_on_demandsubscribed_statuscountry_coderesident_code
指标: viewswatch_time_minutesaverage_view_duration_secondsplaylist_startsplaylist_saves_ addedplaylist_saves_removed

播放位置

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

目录
尺寸: datechannel_idplaylist_idvideo_idlive_or_on_demandsubscribed_statuscountry_codeplayback_location_typeplayback_location_detail
指标: viewswatch_time_minutesaverage_view_duration_secondsplaylist_startsplaylist_saves_ addedplaylist_saves_removed

流量来源

此报告会根据观看者到达内容所有者频道上的播放列表视频的方式汇总观看统计信息。 例如,它标识了源自 Google 搜索或相关视频链接的观看次数。该报告的idcontent_owner_playlist_traffic_source_a1

目录
尺寸: datechannel_idplaylist_idvideo_idlive_or_on_demandsubscribed_statuscountry_codetraffic_source_typetraffic_source_detail
指标: viewswatch_time_minutesaverage_view_duration_secondsplaylist_startsplaylist_saves_ addedplaylist_saves_removed

设备类型和操作系统

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

目录
尺寸: datechannel_idplaylist_idvideo_idlive_or_on_demandsubscribed_statuscountry_codedevice_typeoperating_system
指标: viewswatch_time_minutesaverage_view_duration_secondsplaylist_startsplaylist_saves_ addedplaylist_saves_removed

合并

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

目录
尺寸: datechannel_idplaylist_idvideo_idlive_or_on_demandsubscribed_statuscountry_codeplayback_location_typetraffic_source_typedevice_type2}
指标: viewswatch_time_minutesaverage_view_duration_secondsplaylist_startsplaylist_saves_ addedplaylist_saves_removed

广告费率报告

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

该 API 支持下列广告费率报告,该报告可针对内容所有者的视频提供广告费率指标。该报告当前版本的idcontent_owner_ad_rates_a1

content_owner_ad_rates_a1
状态:当前

此版本的 idcontent_owner_ad_rates_a1。此报告之前版本的 ID(现已完全弃用)为 content_owner_ad_performance_a1

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

目录
尺寸: datechannel_idvideo_idclaimed_statusuploader_typecountry_codead_type
指标: estimated_youtube_ad_ revenuead_impressionsestimated_cpm

估算的收入报告

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

收入指标可指明具体收入来源以及通过这些收入来源产生的总收入。

估算的视频收入

此报告会提供内容所有者所有来自 Google 出售的广告来源或非广告来源的视频的总收入。它还包含一些广告效果指标。该报告当前版本的idcontent_owner_estimated_revenue_a1

content_owner_estimated_Revenue_a1
状态:当前

此版本的 idcontent_owner_estimated_revenue_a1。与上一个版本 content_owner_estimated_earnings_a1 相比存在以下差异:

目录
尺寸: datechannel_idvideo_idclaimed_statusuploader_typecountry_code
指标: estimated_partner_Revenueestimated_partner_ad_ revenueestimated_partner_ad_auction_ revenueestimated_partner_ad_reserved_ revenueestimated_youtube_ad_ revenueestimated_monetized_mobackizedestimated_playback_1}$}估算的 }每千次展示费用 }

估算的资产收入

此报告会提供由内容所有者销售的所有内容来源的总收入(由 Google 出售的广告来源或非广告来源)。它还包含一些广告效果指标。请注意,channel_id 维度用于标识上传了要提供指标的 video_id 的频道。该报告当前版本的idcontent_owner_asset_estimated_revenue_a1

content_owner_asset_estimated_Revenue_a1
状态:当前

此版本的 idcontent_owner_asset_estimated_revenue_a1。与上一个版本 content_owner_asset_estimated_earnings_a1 相比存在以下差异:

目录
尺寸: datechannel_idvideo_idasset_idclaimed_statusuploader_typecountry_code
指标: estimated_partner_ revenueestimated_partner_ad_Revenueestimated_partner_ad_auction_ revenueestimated_partner_ad_reserved_ revenueestimated_partner_red_ revenueestimated_partner_transaction_Revenue

资产报告

资产报告提供与关联到内容所有者资产的视频相关的用户活动指标。如果内容所有者已声明该视频与某项内容所有者的内容相匹配,那么该视频就会显示在内容所有者的报告中。该视频可能是由内容所有者或其他 YouTube 用户上传的。

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

注意:对于收到版权主张的视频,资产报告中的用户活动指标可能有误。出现差异的原因是,报告中的指标反映的是当天的所有用户活动,而不只是提出版权主张之后发生的活动。

例如,假设在某个特定日期,某个视频被观看了 10 次,接着被声明了版权,最后又被观看了 10 次。当天的资产报告会显示该视频获得了 20 次观看,即使其中 10 次是在声明后才出现的。连续几天的指标应准确反映与已声明版权的视频相关的用户活动。

用户活动

此报告会提供与内容所有者的资产相关的视频操作相关的统计信息。该报告的idcontent_owner_asset_basic_a2

用户活动(按省份)

此报告提供美国各州和哥伦比亚特区的用户活动统计信息。实际上,这意味着仅当 country_code 维度的值为 US 时,报告才会过滤数据。该报告的idcontent_owner_asset_province_a2

视频播放位置

此报告会提供与播放视频的类型或应用类型相关的统计信息。该报告的idcontent_owner_asset_playback_location_a2

流量来源

此报告会根据观看者到达与内容所有者资产相关联的视频内容的方式汇总观看统计信息。例如,它标识了源自 Google 搜索或相关视频链接的观看次数。该报告的idcontent_owner_asset_traffic_source_a2

版本 a2
状态:当前

此版本的 idcontent_owner_asset_traffic_source_a2。它与 a1 版本具有以下差异:

目录
尺寸: datechannel_idvideo_idasset_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codetraffic_source_type0_2}traffic_source_type
指标: viewswatch_time_minutesaverage_view_duration_secondsaverage_view_duration_percentagered_viewsred_watch_time_minutes

设备类型和操作系统

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

观看者受众特征

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

目录
尺寸: datechannel_idvideo_idasset_idclaimed_statusuploader_typelive_or_on_demandsubscribed_statuscountry_codeage_groupage2
指标: 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_type
指标: 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_type
指标: 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_codeend1_screen_element_element2_end_element_element_element2
指标: end_screen_element_clicksend_screen_element_impressionsend_screen_element_click_rate

合并

此报告会合并播放位置报告、流量来源报告和设备/操作系统报告中使用的维度,从而提供精细的视频统计信息。该报告的idcontent_owner_asset_combined_a2