本文档定义了 YouTube 报告 API 检索的指标。此 API 可检索包含频道或内容所有者的 YouTube 数据分析数据的批量数据报告。
指标是指对用户活动、广告效果或估算收入的各项衡量指标。用户活动指标包括视频观看次数和评分(顶和踩等)等。
核心指标
虽然 YouTube Reporting API 受服务条款中规定的弃用政策约束,但非核心指标(和非核心维度)不受该政策影响。在本页面的定义中,任何明确显示为核心指标的指标都是这样。
下表列出了 API 的核心指标。 这些同样在 YouTube Analytics API 中使用的指标也是该 API 中的核心指标。
annotation_click_through_rate
annotation_close_rate
average_view_duration_seconds
comments
dislikes
estimated_partner_revenue
likes
shares
subscribers_gained
subscribers_lost
views_percentage
views
watch_time_minutes
如需了解详情,请参阅需遵循弃用政策的 YouTube API 列表。
查看指标
- 观看次数(核心指标)
- 视频的观看次数。在播放列表报告中,该指标可指示视频在播放列表环境中的观看次数。YouTube 帮助中心提供了有关如何报告观看次数的更多信息。This is a core metric and is subject to the Deprecation Policy.
- red_views
- YouTube Premium(以前称为 YouTube Red)会员观看视频的次数。
- views_percentage(核心指标)
- 观看视频或播放列表时登录的观看者所占的百分比。This is a core metric and is subject to the Deprecation Policy.
观看时长指标
- watch_time_minutes(核心指标)
- 用户观看指定频道、内容所有者、视频或播放列表的视频的分钟数。This is a core metric and is subject to the Deprecation Policy.
- red_watch_time_minutes(红时表时长)
- YouTube Premium(以前称为 YouTube Red)会员观看某个视频的分钟数。
- average_view_duration_seconds(核心指标)
- 视频的平均播放时长(以秒为单位)。自 2021 年 12 月 13 日起,此指标不包括循环播放的剪辑流量。在播放列表报告中,该指标表示在播放列表环境中所播放的视频的平均时长(以秒为单位)。This is a core metric and is subject to the Deprecation Policy.
- average_view_duration_percentage
- 视频播放期间观看视频的平均百分比。自 2021 年 12 月 13 日起,此指标不包括循环播放的剪辑流量。
互动指标
- 评论(核心指标)
- 用户评论视频的次数。如需了解详情,请参阅 YouTube 帮助中心。This is a core metric and is subject to the Deprecation Policy.
- 顶的次数(核心指标)
- 用户对视频给予好评的次数,表示他们喜欢相应视频的次数。This is a core metric and is subject to the Deprecation Policy.
- 踩(核心指标)
- 用户对视频给予差评,表示他们踩了视频的次数。This is a core metric and is subject to the Deprecation Policy.
- 用户通过
Share
按钮分享视频的次数。如需了解详情,请参阅 YouTube 帮助中心。This is a core metric and is subject to the Deprecation Policy. - subscribers_gained(核心指标)
- 用户订阅频道的次数。This is a core metric and is subject to the Deprecation Policy.
频道可以在多个位置获得或失去订阅者,包括视频观看页面、频道页和 YouTube 首页上显示的指南。 为了确定没有通过视频观看页面订阅的新频道的订阅者人数,基本的“用户活动”报告中会包含一个未指定 video_id 维度值的行。该行也为subscribersLost
指标指定了值,但没有为其他指标指定值。 - subscribers_lost(核心指标)
- 用户退订频道的次数。This is a core metric and is subject to the Deprecation Policy.
此指标的数据报告与subscribers_gained
指标类似。 为了找出在视频观看页面上退订但没有退订的用户数量,基本的用户活动报告中会包含一个未指定 video_id 维度值的行。该行也为subscribers_gained
指标指定了值,但没有为其他指标指定值。 - 视频添加到播放列表
- 视频添加到任意 YouTube 播放列表的次数。这些视频可能已添加到视频所有者的播放列表或其他频道的播放列表中。
该指标值确实包括视频被添加到默认播放列表(如“稍后观看”播放列表)的次数。但是,系统不会统计自动添加到视频的播放列表,例如频道的上传内容播放列表或用户的观看记录。
该指标会返回一个绝对数字,也就是说,如果用户在将视频添加到播放列表后将其移除,然后重新添加,则此指标值反映的是该视频被添加到播放列表中两次。系统无法提供 2014 年 10 月 1 日之前的该指标数据。 - videos_removed_from_playlists
- 视频从所有 YouTube 播放列表中移除的次数。这些视频可能已被从视频所有者的播放列表或其他频道的播放列表中移除。
该指标值包括从默认播放列表(如“稍后观看”播放列表)中移除视频的次数。
该指标会返回一个绝对数字,也就是说,如果用户向播放列表中添加了视频,然后将其移除,并再次将其移除,则该指标值反映的是系统从播放列表中移除两次。系统无法提供 2014 年 10 月 1 日之前的该指标数据。
播放列表指标
- 播放列表开始位置
- 观看者发起播放列表播放的次数。请注意,此指标仅包含网络上发生的播放列表观看次数。
- playlist_saves_Added(仅 YouTube Reporting API 支持)
- 用户保存播放列表的次数。如需详细了解已保存的播放列表,请参阅 YouTube 帮助中心。该指标会返回一个绝对数字,也就是说,如果用户保存了某个播放列表,将其从已保存的播放列表列表中移除并再次保存,则该指标值反映了系统添加的两次播放列表保存操作。
- playlist_saves_removed(仅适用于 YouTube Reporting API)
- 用户从保存的播放列表中移除播放列表的次数。此指标会返回一个绝对数字,也就是说,如果用户保存了某个播放列表,将其从已保存的播放列表列表中移除,再次保存并再次将其移除,则该指标值反映的是两次保存保存播放列表的情况。
注解指标
- annotation_impressions
- 注释总展示次数。
- annotation_clickable_impressions
- 显示且可以点击的注释的数量。
- annotation_clicks
- 获得点击的注释的数量。
- annotation_click_through_rate(核心指标)
- 观看者点击了注释的次数与可点击注释总展示次数的比率。This is a core metric and is subject to the Deprecation Policy.在 YouTube 帮助中心中,您可以详细了解如何创建注释和使用链接注释。
- annotation_closable_impressions
- 出现和可以关闭的注释的数量。
- 注解
- 已关闭注释的数量。
- annotation_close_rate(核心指标)
- 观看者关闭的注解与注解总展示次数的比率。This is a core metric and is subject to the Deprecation Policy.
卡片指标
YouTube 帮助中心包含有关向视频添加卡片和 YouTube 数据分析卡报告的更详细的说明。
- card_impressions
- 卡片的展示次数。打开卡片面板后,系统会为视频的每个卡片记录一次卡片展示。
- 卡片点击次数
- 卡片获得的点击次数。
- click_rate
- 卡片点击率,计算方法为卡片点击次数与卡片展示次数的比率。
- 卡片宣传语的展示次数。一次视频观看可产生多次宣传片展示。
- 卡片宣传语获得的点击次数。卡片图标获得的点击次数将归功于用户最后一次展示的宣传语。
- 卡片宣传语的点击率,计算方式为:卡片宣传语的点击次数与卡片宣传语总展示次数。
片尾画面指标
片尾画面是在视频的最后 5 到 20 秒展示以宣传您的内容、频道和网站的元素。YouTube 帮助中心针对为视频添加片尾画面和 YouTube 数据分析的片尾画面报告提供了更详细的说明。
注意:系统自 2016 年 5 月 1 日起提供片尾画面指标数据。
- end_screen_element_impressions
- 显示的片尾画面元素数量。系统会针对显示的每个片尾画面元素记录一次展示。
- end_screen_element_clicks
- 片尾画面元素被点击的次数。
- end_screen_element_click_rate
- 片尾画面元素的点击率,计算方式为:片尾画面元素点击次数与片尾画面元素展示次数的比率。
观众黏度指标
- audience_retention_percentage
- 在视频的指定时间点观看视频的绝对观看者人数。该比率的计算方法是:将一部分视频的观看次数与视频的总观看次数进行比较。
elapsed_video_time_percentage
维度用于标识视频中与指标对应的部分。
请注意,在某一视频观看过程中,视频的一部分可能会被观看多次(或者根本无法观看)。例如,如果用户快退并多次观看视频的同一部分,则视频的该部分的绝对比率可能大于1
。
以下示例说明了如何计算值:- 一分钟的视频获得了 100 次观看。一半的观看者在 15 秒后停止观看,其余观看者观看视频。没有任何观看者多次观看视频的任何部分。在本例中,对于视频第一季度中的时间段,该指标的值将为
1
,而对于视频的其余部分,该指标的值将为0.50
。 - 一分钟的视频获得了 100 次观看。所有观看者都看完了整个视频,但 20 名观看者会观看视频的 45 秒标记,然后跳回视频的 30 秒标记,然后观看视频的其余部分。在这种情况下,指标在视频前半部分或下四分之一处的时间段值为
1
。然而,在视频第三四分之一的时间段内,该值为1.2
,因为 100% 的观看者观看了该片段,但 20% 的观看者观看了该片段两次。
- 一分钟的视频获得了 100 次观看。一半的观看者在 15 秒后停止观看,其余观看者观看视频。没有任何观看者多次观看视频的任何部分。在本例中,对于视频第一季度中的时间段,该指标的值将为
估算收入指标
注意:估算收入指标在月底可能会有所调整,而且不包含合作伙伴出售的广告和合作伙伴投放的广告。请访问 YouTube 帮助中心,了解有关估算收入数据的更多信息和说明。
YouTube Reporting API 会以美元为单位报告所有估算收入和收入数据。
- estimated_partner_ revenue(核心指标)
- 在选定日期范围和区域内,Google 出售的所有来源以及非广告来源带来的总净收入估算值。
- estimated_partner_ad_Revenue
- Google 出售的所有广告资源在选定日期范围和区域内产生的估算总净收入。
估算收入指标在月底可能会有所调整,而且不包含合作伙伴出售和投放的广告。 - estimated_partner_ad_auction_ revenue (仅 YouTube Reporting API 支持)
- 在选定日期范围和区域内,通过 AdSense 竞价出售的广告的估算收入总额(净收入)。此指标之前名为
estimated_partner_ad_sense_revenue
。 - estimated_partner_ad_sense_ income (仅适用于 YouTube Reporting API)
- 在选定日期范围和区域内,竞价出售的 AdSense 广告所带来的总估算收入(净收入)。
- estimated_partner_ad_reserved_ income (仅适用于 YouTube Reporting API)
- 通过 DoubleClick (DCLK) 预订出售的广告和其他 YouTube 出售的来源所带来的总估算收入(净收入)。此指标之前名为
estimated_partner_double_click_revenue
。 - estimated_partner_double_click_ income (仅适用于 YouTube Reporting API)
- 通过 DoubleClick (DCLK) 预订出售的广告和其他 YouTube 出售来源所带来的总估算收入(净收入)
- estimated_partner_red_ income(仅在 YouTube Reporting API 中受支持)
- YouTube Premium(以前称为 YouTube Red)订阅带来的总估算收入(净收入)。
- estimated_partner_transaction_ income (仅适用于 YouTube Reporting API)
- 付费内容和粉丝资助等交易的总估算收入减去合作伙伴收取的所有退款。
广告效果指标
- estimated_youtube_ad_Revenue
- 在所选日期范围和区域内,Google 出售或 DoubleClick 合作伙伴出售的所有广告所带来的估算总收入(美元)。总收益以月末调整为准,且不涵盖合作伙伴投放的广告。总收入与估算收入(又称净收入)有所不同,后者会将您的所有权份额和收益分成协议的分成列入计算,请勿将二者混淆。
- estimated_cpm
- 每千次广告展示的估算总收入。
- 广告展示次数
- 投放的已验证广告展示次数。
- estimated_monetized_playbacks
- 观看者播放视频并至少看到一次广告展示的情况数量。如果向观看者播放了前贴片广告,但您的视频还没开始观看就停止了观看,则计为一次创收播放。此数字的预计误差为 ±2.0%。
- estimated_playback_based_cpm
- 每千次播放的估算总收入。