此页面列出了频道所有者可以使用 YouTube Reporting API 检索的报告。每个报告的 id
(由 API 的 reportTypes.list
方法返回)都在报告说明中提供。
视频报告
视频报告可提供与频道中的视频相关的所有用户活动的统计信息。例如,这些报告包含视频的观看次数。
用户活动
此报告会提供与频道及其视频相关的用户活动统计信息。该报告的id
是channel_basic_a2
。
此版本的 id
为 channel_basic_a2
。它与 a1
版本具有以下差异:
- 添加 red_views 指标
- 添加 red_watch_time_minutes 指标
目录 | |
---|---|
尺寸: | date、channel_id、video_id、live_or_on_demand、subscribed_status、country_code |
指标: | 。 |
用户活动(按省份)
此报告提供美国各州和哥伦比亚特区的用户活动统计信息。该报告的id
是channel_province_a2
。
此版本的 id
为 channel_province_a2
。它与 a1
版本具有以下差异:
- 添加 red_views 指标
- 添加 red_watch_time_minutes 指标
目录 | |
---|---|
尺寸: | date、channel_id、video_id、live_or_on_demand、subscribed_status、country_code、resident_code |
指标: | 。 |
播放位置
此报告会提供与播放视频的类型或应用类型相关的统计信息。该报告的id
是channel_playback_location_a2
。
此版本的 id
为 channel_playback_location_a2
。它与 a1
版本具有以下差异:
- 添加 red_views 指标
- 添加 red_watch_time_minutes 指标
流量来源
此报告会根据观看者访问频道的视频内容的方式汇总观看统计数据。
例如,它标识了源自 Google 搜索或相关视频链接的观看次数。该报告的id
是channel_traffic_source_a2
。
此版本的 id
为 channel_traffic_source_a2
。它与 a1
版本具有以下差异:
- 添加 red_views 指标
- 添加 red_watch_time_minutes 指标
设备类型和操作系统
此报告会根据观看者的操作系统和设备类型汇总视频观看统计信息。例如,它可以确定在 Android 平板电脑或 Windows 桌面设备上的观看次数。该报告的id
是channel_device_os_a2
。
此版本的 id
为 channel_device_os_a2
。它与 a1
版本具有以下差异:
- 添加 red_views 指标
- 添加 red_watch_time_minutes 指标
观看者受众特征
此报告汇总了根据观看者的年龄段和性别统计的统计信息。
该报告的id
是channel_demographics_a1
。
目录 | |
---|---|
尺寸: | date、channel_id、video_id、live_or_on_demand、subscribed_status、country_code、age_group、gender |
指标: | views_percentage |
内容分享(按平台)
此报告提供的统计信息显示了该频道的视频在不同社交平台上的分享频率。
该报告的id
是channel_sharing_service_a1
。
目录 | |
---|---|
尺寸: | date、channel_id、video_id、live_or_on_demand、subscribed_status、country_code、sharing_service |
指标: | 分享次数 |
注释
此报告可提供有关频道视频期间显示的注释的统计信息。
报告数据可衡量每个视频各个注释的效果。相比之下,用户活动报告则会汇总视频所有注释的统计信息。
该报告的id
是channel_annotations_a1
。
卡片
该报告会提供在频道视频播放期间显示的卡片的展示次数和点击统计信息。
报告数据衡量具体卡片的效果。相比之下,用户活动报告汇总了与视频的所有卡片相关的统计信息。
该报告的id
是channel_cards_a1
。
片尾画面
此报告会针对在视频播放结束后显示的片尾画面提供展示和点击统计信息。
报告包含频道视频的统计信息。
该报告的id
是channel_end_screens_a1
。
字幕
此报告会提供字幕语言使用时间最长的统计数据。主要关闭字幕的视图会被排除。该报告的id
是channel_subtitles_a2
。
此版本的 id
为 channel_subtitles_a2
。它与 a1
版本具有以下差异:
- 添加 red_views 指标
- 添加 red_watch_time_minutes 指标
合并
此报告会合并播放位置报告、流量来源报告和设备/操作系统报告中使用的维度,从而提供精细的视频统计信息。该报告的id
是channel_combined_a2
。
此版本的 id
为 channel_combined_a2
。它与 a1
版本具有以下差异:
- 添加 red_views 指标
- 添加 red_watch_time_minutes 指标
播放列表报告
播放列表报告提供的统计信息与播放列表播放时的视频观看次数相关。
用户活动
此报告可提供有关用户与频道播放列表互动情况的统计信息。
该报告的id
是playlist_basic_a1
。
用户活动(按省份)
此报告提供与美国各州和哥伦比亚特区的频道播放列表互动情况相关的用户活动统计信息。
实际上,这意味着仅当 country_code 维度的值为 US
时,报告才会过滤数据。该报告的id
是playlist_province_a1
。
播放位置
此报告会提供与播放播放列表的网页类型或应用类型相关的统计信息。该报告的id
是playlist_playback_location_a1
。
流量来源
此报告汇总了观看者观看频道播放列表视频的方式所产生的观看统计信息。
例如,它标识了源自 Google 搜索或相关视频链接的观看次数。该报告的id
是playlist_traffic_source_a1
。
设备类型和操作系统
此报告会根据观看者的操作系统和设备类型汇总播放列表观看统计信息。例如,它可以确定在 Android 平板电脑或 Windows 桌面设备上的观看次数。该报告的id
是playlist_device_os_a1
。
合并
此报告合并了播放位置、流量来源和设备/操作系统报告中使用的维度,从而提供精细的播放列表统计信息。该报告的id
是playlist_combined_a1
。