Metrics

本文档定义了 YouTube Reporting API 检索的指标。此 API 会检索包含面向频道或内容所有者的 YouTube 数据分析数据的批量数据报告。

指标是对用户活动、广告效果或估算收入的单独衡量。用户活动指标包括视频观看次数和评分（点赞和不喜欢）等。

核心指标

虽然 YouTube Reporting API 须遵守《服务条款》中定义的弃用政策，但非核心指标（和非核心维度）不受该政策的约束。在本页面的定义中，任何核心指标都会明确标识为核心指标。

以下列表列出了 API 的核心指标。如果这些指标也用于 YouTube Analytics API，则它们也是该 API 中的核心指标。

如需了解详情，请参阅须遵守弃用政策的 YouTube API 列表。

观看指标

engaged_views （核心指标）
频道的视频在开头前几秒之后被观看的次数。
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.

覆盖面指标

video_thumbnail_impressions
视频缩略图向观看者展示的次数。缩略图在屏幕上显示超过 1 秒，且至少有一半的部分显示出来，系统就会统计展示次数。如需了解详情，请访问YouTube 帮助中心。
video_thumbnail_impressions_ctr
带来观看点击的展示次数所占的百分比。计算方法是用点击次数除以展示次数。

观看时长指标

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.
shares （核心指标）
用户通过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
卡片的点击率，计算方法是用卡片点击次数除以卡片展示次数。
card_teaser_impressions
卡片宣传语的展示次数。观看者观看一次视频可能会产生多次宣传语展示。
card_teaser_clicks
卡片宣传语获得的点击次数。卡片图标获得的点击次数将归于向用户展示的上一条宣传语。
card_teaser_click_rate
卡片宣传语的点击率，计算方法是用卡片宣传语获得的点击次数除以卡片宣传语的总展示次数。

片尾画面指标

片尾画面是指在视频的最后 5 到 20 秒内显示的元素，用于宣传您的内容、频道和网站。如需详细了解如何向视频添加片尾画面以及YouTube 数据分析片尾画面报告，请访问 YouTube 帮助中心。

end_screen_element_impressions
片尾画面元素的展示次数。每显示一个片尾画面元素，系统就会记录一次展示。
end_screen_element_clicks
片尾画面元素被点击的次数。
end_screen_element_click_rate
片尾画面元素的点击率，计算方法是用片尾画面元素获得的点击次数除以片尾画面元素的展示次数。

会员取消指标

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
每千次播放的估算总收入。