Metrics

本文說明 YouTube Reporting API 擷取的指標。這項 API 可擷取大量資料報表，內含頻道或內容擁有者的 YouTube 數據分析資料。

指標是使用者活動、廣告成效或預估收益的個別測量結果。使用者活動指標包括影片觀看次數和評分 (喜歡和不喜歡)。

核心指標

YouTube Reporting API 適用於《服務條款》中定義的淘汰政策，但非核心指標 (和非核心維度) 不適用於這項政策。在本頁的定義中，任何核心指標都會明確標示。

以下列出 API 的核心指標。 YouTube 數據分析 API 中使用的任何指標，也都是該 API 的核心指標。

如要瞭解詳情，請參閱適用於廢止政策的 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
資訊卡的點閱率，計算方式為資訊卡點擊次數和資訊卡曝光次數間的比例。
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
每千次播放的預估總收益。