本文档定义了 YouTube Reporting API 检索的指标。此 API 用于检索包含面向频道或内容所有者的 YouTube 数据分析数据的批量数据报告。
指标是对用户活动、广告效果或估算收入的单独衡量。用户活动指标包括视频观看次数和评分(顶和踩)等。
核心指标
虽然 YouTube Reporting API 受服务条款中定义的弃用政策约束,但非核心指标(和非核心维度)不受该政策约束。在本页面的定义中,任何属于核心指标的指标都会明确标识为核心指标。
下表列出了该 API 的核心指标。 YouTube Analytics 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.
覆盖面指标
- 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.
- likes(核心指标)
- 用户通过给出好评表示喜欢某个视频的次数。This is a core metric and is subject to the Deprecation Policy.
- dislikes(核心指标)
- 用户通过给出差评表示不喜欢某个视频的次数。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
- 片尾画面元素的点击率,计算方法为片尾画面元素点击次数与片尾画面元素展示次数的比率。
会员取消指标
- membershipsCancellationSurveyResponses
- 在报告期内,取消了指定频道会员资格的 YouTube 用户完成的调查问卷数量。
估算收入指标
注意:估算收入指标在月末可能会有所调整,而且不包含合作伙伴出售或投放的广告所产生的收入。如需了解有关估算收入数据的更多信息和注意事项,请参阅 YouTube 帮助中心。
- 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
- 每千次播放的估算总收入。