本文档定义了 YouTube Reporting API 检索的指标。此 API 用于检索包含面向频道或内容所有者的 YouTube 数据分析数据的批量数据报告。
指标是指用户活动、广告效果或预估收入的各项衡量结果。用户活动指标包括视频观看次数和评分（赞和踩）等。
核心指标
虽然 YouTube Reporting API 受服务条款中定义的弃用政策约束，但非核心指标（和非核心维度）不受该政策约束。在本页中的定义中，任何核心指标都会明确标识为核心指标。
以下列表列出了该 API 的核心指标。 这些指标中的任何指标如果也用于 YouTube 数据分析 API，则也是该 API 中的核心指标。
annotation_click_through_rateannotation_close_rateaverage_view_duration_secondscommentsdislikesengaged_viewsestimated_partner_revenuelikessharessubscribers_gainedsubscribers_lostviews_percentageviewswatch_time_minutes
如需了解详情，请参阅符合弃用政策规定的 YouTube API 列表。
查看指标
- engaged_views（核心指标）
- 观看者看完频道视频开头前几秒后，继续观看视频的次数。
- 次观看 （核心指标）
- 视频的观看次数。在播放列表报告中，此指标表示视频在播放列表中的观看次数。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指标指定了值，但未为其他指标指定值。 - videos_added_to_playlists
- 视频被添加到任何 YouTube 播放列表的次数。这些视频可能已添加到视频所有者的播放列表或其他频道的播放列表中。
该指标值确实包含视频被添加到“稍后观看”等默认播放列表中的次数。不过，系统不会统计视频被自动添加到的播放列表，例如频道的“上传内容”播放列表或用户的观看记录。
此指标会返回一个绝对数值，这意味着，如果用户将视频添加到播放列表、将其移除，然后再次将其添加到播放列表，则该指标值会反映视频被添加到播放列表两次。我们不提供 2014 年 10 月 1 日之前的有关该指标的数据。 - videos_removed_from_playlists
- 视频从任何 YouTube 播放列表中移除的次数。视频可能已从视频所有者的播放列表或其他频道的播放列表中移除。
此指标值包括视频从“稍后观看”等默认播放列表中移除的次数。
此指标会返回一个绝对数值，这意味着，如果用户将视频添加到播放列表、将其移除、再次添加，然后再次将其移除，则该指标值会反映视频从播放列表中移除的次数。我们不提供 2014 年 10 月 1 日之前的有关该指标的数据。
播放列表指标
播放列表报告包含两种指标，用于说明观看者与播放列表中的视频互动的情况：
-
汇总视频指标会提供用户活动和展示次数指标，这些指标是针对播放列表中所有同时归播放列表所属频道所有的视频汇总得出的。在汇总时，系统不会计算其他频道所拥有的视频的指标。因此，如果某个频道创建的播放列表仅包含其他频道拥有的视频，则这些播放列表的报告不会提供这些指标的值。
-
播放列表内指标反映了播放列表页面中的用户活动和互动情况。这些指标包括播放列表中所有视频的观看次数，无论这些视频归哪个频道所有，但仅统计在播放列表上下文中发生的观看次数。
以下大多数指标都是播放列表内指标；列表中的其余指标（例如 playlistSaves 指标）与用户与播放列表本身的互动有关，而非与播放列表中的视频的互动。因此，这些指标不会被归类为汇总视频指标或播放列表内指标。
- playlist_starts
- 观看者发起播放播放列表的次数。请注意，此指标仅包含在网页上发生的播放列表观看次数。
- 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_closes
- 已关闭的注释数量。
- annotation_close_rate（核心指标）
- 观看者关闭的注释与注释总展示次数的比率。This is a core metric and is subject to the Deprecation Policy.
卡片指标
YouTube 帮助中心提供了有关向视频添加卡片和 YouTube 数据分析卡片报告的更详细说明。
- card_impressions
- 卡片的展示次数。打开卡片面板后，系统会将视频中每个卡片的展示次数记录下来。
- card_clicks
- 卡片的点击次数。
- card_click_rate
- 卡片的点击率，计算方法为卡片点击次数与展示次数之比。
- 卡片宣传语的展示次数。一次视频观看可产生多次宣传语展示。
- 卡片宣传语获得的点击次数。卡片图标获得的点击次数将归于向用户展示的上一条宣传语。
- 卡片宣传语的点击率，计算方法为卡片宣传语的点击次数与卡片宣传语的总展示次数之比。
片尾画面指标
片尾画面是指在视频的最后 5 到 20 秒内显示的元素，用于宣传您的内容、频道和网站。YouTube 帮助中心提供了有关向视频添加片尾画面和 YouTube 数据分析“片尾画面”报告的更详细说明。
- end_screen_element_impressions
- 显示的片尾画面元素的数量。系统会为每次显示的片尾画面元素记录一次展示。
- end_screen_element_clicks
- 片尾画面元素的点击次数。
- end_screen_element_click_rate
- 片尾画面元素的点击率，计算方法为片尾画面元素点击次数与片尾画面元素展示次数的比率。
观众黏度指标
- audience_retention_percentage
- 在视频的给定时间点观看视频的观看者的绝对比例。该比率的计算方法是将视频的某个部分的观看次数与视频的总观看次数进行比较。
elapsed_video_time_percentage维度用于标识指标对应的视频片段。
请注意，在一次视频观看中，视频的某个片段可能会被观看多次（或根本不被观看）。例如，如果用户反复快退并观看视频的同一部分，则该视频部分的绝对比率可能会大于1。
以下示例说明了如何计算此值：- 一个时长为 1 分钟的视频被观看 100 次。半数观看者会在 15 秒后停止观看，其余观看者会完整观看视频。没有任何观看者重复观看视频的任何部分。在这种情况下，对于视频前四分之一的时间分桶，此指标的值为
1，对于视频的其余部分，此指标的值为0.50。 - 一个时长为 1 分钟的视频被观看 100 次。所有观看者都会观看完整个视频，但其中 20 位观看者会观看到视频 45 秒处，然后跳回视频 30 秒处，再观看视频的其余部分。在这种情况下，如果时间分桶位于视频的前半部分或后四分之一，则该指标的值为
1。不过，对于视频的第三个季度的时间分桶，该值为1.2，因为 100% 的观看者都观看了该视频片段，但其中 20% 的观看者观看了该片段两次。
- 一个时长为 1 分钟的视频被观看 100 次。半数观看者会在 15 秒后停止观看，其余观看者会完整观看视频。没有任何观看者重复观看视频的任何部分。在这种情况下，对于视频前四分之一的时间分桶，此指标的值为
会员取消指标
- membershipsCancellationSurveyResponses
- 在报告期内取消了指定频道的频道会员资格的 YouTube 用户完成的调查问卷数量。
估算收入指标
注意：估算收入指标会受月末调整的影响，且不包括合作伙伴出售和投放的广告。如需详细了解估算收入数据，请访问 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_reserved_revenue（仅在 YouTube Reporting API 中受支持）
- 通过 DoubleClick (DCLK) 和其他 YouTube 出售的来源获得的预订型广告估算收入（净收入）总额。此指标以前称为
estimated_partner_double_click_revenue。 - estimated_partner_red_revenue（仅在 YouTube Reporting API 中受支持）
- 通过 YouTube Premium（以前称为“YouTube Red”）订阅获得的估算收入总额（净收入）。
- estimated_partner_transaction_revenue（仅在 YouTube Reporting API 中受支持）
- 扣除合作伙伴要求的所有退款后，付费内容和粉丝赞助等交易所产生的估算总收入。
广告效果指标
- estimated_youtube_ad_revenue
- 在所选日期范围和区域内，Google 出售或 DoubleClick 合作伙伴出售的所有广告带来的估算总收入（以美元为单位）。总收益以月末调整为准，且不涵盖合作伙伴投放的广告。请勿将总收入与估算收入或净收入混淆，后两者会考虑到您的所有权份额和收益分成协议。
- estimated_cpm
- 每千次广告展示的估算总收入。
- ad_impressions
- 投放的经过验证的广告展示次数。
- estimated_monetized_playbacks
- 观看者播放您的视频且至少有一次广告展示的情况数。如果观看者看到了前贴片广告，但在您的视频开始播放之前就退出了广告，系统也会将此计为一次创收的播放。此数据的预计估算误差为 ±2.0%。
- estimated_playback_based_cpm
- 每千次播放的估算总收入。