本页面列出了内容所有者可以使用 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 指标
流量来源
此报告会根据观看者观看内容所有者频道上视频的方式汇总观看统计信息。
例如,它可以识别是通过 Google 搜索还是通过指向相关视频的链接获得的观看次数。此报告的 id
为 content_owner_traffic_source_a2
。
此报告版本的 id
为 content_owner_traffic_source_a2
。它与版本 a1
有以下差异:
- 添加了 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 指标
观看者受众特征
此报告会根据观看者的年龄段和性别汇总观看统计信息。
此报告的 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 |
指标: | 分享 |
注释
此报告会提供内容所有者频道中视频播放期间显示的注释的统计信息。
报告数据用于衡量每个视频的各个注释的效果。与之相反,“用户活动”报告会汇总视频的所有注释的统计信息。
此报告的 id
为 content_owner_annotations_a1
。
卡片
此报告会提供内容所有者频道中视频播放期间展示的卡片的展示次数和点击率统计信息。
报告数据用于衡量各个卡片的效果。与之相反,“用户活动”报告会汇总视频的所有卡片的统计信息。
此报告的 id
为 content_owner_cards_a1
。
片尾画面
此报告会提供有关视频停止播放后显示的片尾画面的展示次数和点击次数统计信息。
该报告包含内容所有者频道中视频的统计信息。
此报告的 id
为 content_owner_end_screens_a1
。
字幕
此报告会提供有关视频观看期间使用时长最长的字幕语言的统计信息。系统会排除字幕处于关闭状态的观看次数。此报告的 id
为 content_owner_subtitles_a2
。
此报告版本的 id
为 content_owner_subtitles_a2
。它与版本 a1
有以下差异:
- 添加了 red_views 指标
- 添加了 red_watch_time_minutes 指标
合并
此报告通过组合播放位置、流量来源和设备/操作系统报告中使用的维度,提供精细的视频统计信息。此报告的 id
为 content_owner_combined_a2
。
此报告版本的 id
为 content_owner_combined_a2
。它与版本 a1
有以下差异:
- 添加了 red_views 指标
- 添加了 red_watch_time_minutes 指标
播放列表报告
“播放列表”报告提供与播放列表中发生的视频观看次数密切相关的统计信息。
用户活动
此报告提供与内容所有者频道上的播放列表相关的用户互动统计信息。
此报告的 id
为 content_owner_playlist_basic_a1
。
用户活动(按省份)
此报告针对美国各州和哥伦比亚特区的用户,提供与用户与内容所有者频道中播放列表的互动相关的用户活动统计信息。
这实际上意味着,系统会过滤报告,使其仅包含 country_code 维度的值为 US
的数据。此报告的 id
为 content_owner_playlist_province_a1
。
播放位置
此报告提供与播放列表播放发生的网页或应用类型相关的统计信息。此报告的 id
为 content_owner_playlist_playback_location_a1
。
流量来源
此报告会根据观看者访问内容所有者频道上的播放列表视频的方式汇总观看统计信息。
例如,它可以识别是通过 Google 搜索还是通过指向相关视频的链接获得的观看次数。此报告的 id
为 content_owner_playlist_traffic_source_a1
。
设备类型和操作系统
此报告会根据观看者的操作系统和设备类型汇总播放列表观看统计信息。例如,它可识别在 Android 平板电脑或 Windows 桌面设备上发生的观看次数。此报告的 id
为 content_owner_playlist_device_os_a1
。
合并
此报告通过组合播放位置、流量来源和设备/操作系统报告中使用的维度,提供精细的播放列表统计信息。此报告的 id
为 content_owner_playlist_combined_a1
。
广告费率报告
“广告展示次数/费用”报告会针对视频播放期间投放的广告提供基于展示次数的指标。这些指标会统计每次广告展示,而每次视频播放可能会产生多次展示。
该 API 支持以下广告费率报告,该报告会为内容所有者的视频提供广告费率指标。此报告当前版本的 id
为 content_owner_ad_rates_a1
。
此报告版本的 id
为 content_owner_ad_rates_a1
。此报告的旧版 ID(现已完全弃用)为 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
) 有以下差异:
- 添加了 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
不同。
估算的资产收入
此报告会提供内容所有者所有资产通过 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
) 有以下差异:
- 添加了 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
不同。
资产报告
资产报告提供与与内容所有者的资产相关联的视频的用户活动指标。如果内容所有者针对某个视频提出了版权主张,声称该视频与其某项资产相符,则该视频会显示在内容所有者的报告中。该视频可能是由内容所有者或其他 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 指标
流量来源
此报告会根据观看者与内容所有者资产关联的视频内容的观看方式汇总观看统计信息。例如,它可以识别是通过 Google 搜索还是通过指向相关视频的链接获得的观看次数。此报告的 id
为 content_owner_asset_traffic_source_a2
。
此报告版本的 id
为 content_owner_asset_traffic_source_a2
。它与版本 a1
有以下差异:
- 添加了 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 指标
观看者受众特征
此报告会根据观看者的年龄段和性别汇总观看统计信息。此报告的 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 |
指标: | 分享 |
注释
此报告提供与与内容所有者资产相关联的视频中显示的注释的统计信息。报告数据用于衡量各个注释的效果。与之相反,“用户活动”报告会汇总视频的所有注释的统计信息。此报告的 id
为 content_owner_asset_annotations_a1
。
卡片
此报告会针对与内容所有者的资产相关联的视频中显示的卡片提供展示次数和点击次数统计信息。报告数据用于衡量各个卡片的效果。与之相反,“用户活动”报告会汇总与资产关联的每个视频中显示的所有卡片的统计信息。此报告的 id
为 content_owner_asset_cards_a1
。
片尾画面
此报告会针对视频停止播放后显示的片尾画面提供展示次数和点击次数统计信息。该报告包含内容所有者频道上已收到版权主张的视频的统计信息,还会标识与这些视频相关联的资产。此报告的 id
为 content_owner_asset_end_screens_a1
。
合并
此报告通过组合播放位置、流量来源和设备/操作系统报告中使用的维度,提供精细的视频统计信息。此报告的 id
为 content_owner_asset_combined_a2
。
此报告版本的 id
为 content_owner_asset_combined_a2
。它与版本 a1
有以下差异:
- 添加了 red_views 指标
- 添加了 red_watch_time_minutes 指标