Metrics

本文件定義 YouTube Reporting API 擷取的指標。這個 API 會擷取大量資料報表,其中包含頻道或內容擁有者的 YouTube 數據分析資料。

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

核心指標

雖然 YouTube Reporting API 受到《服務條款》中載明的廢止政策的約束,但非核心指標 (以及非核心維度) 則不受此政策限制。本頁定義的指標是明確以核心指標為準的指標。

以下列出 API 的核心指標。 YouTube Analytics API 中所用的任何指標,也是該 API 的核心指標。

詳情請參閱廢止政策的 YouTube API 清單。

查看指標

觀看次數 (核心指標)
影片的觀看次數。在播放清單報表中,這項指標代表影片在播放清單中的觀看次數。請參閱 YouTube 說明中心,進一步瞭解系統如何回報觀看次數。This is a core metric and is subject to the Deprecation Policy.
紅色觀看次數
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.
紅手錶_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.
平均觀看時間百分比
影片播放期間的平均影片長度百分比。自 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 日前的資料。

播放清單的相關指標

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_前導廣告曝光率
資訊卡前導廣告顯示次數。影片觀看次數可能會產生多次前導廣告曝光。
card_前導廣告點擊次數
資訊卡前導廣告的點擊次數。資訊卡圖示的點擊次數會歸於最後向使用者顯示的前導廣告。
card_前導廣告點擊率
資訊卡前導廣告的點閱率,計算方式為資訊卡前導廣告與資訊卡前導廣告曝光總數的總和。

片尾指標

結束畫面是影片最後 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。不過,由於影片片段 100% 的觀眾觀看了該片段,而影片第三季的時間時間值是 1.2,但其中有 20% 的觀眾觀看了該片段兩次。

預估收益指標

注意:預估收益指標在月底時會有調整,不含合作夥伴銷售與合作夥伴放送的廣告。請前往 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_revenue(僅適用於 YouTube Reporting API)
所選日期範圍和區域內,透過競價售出的 AdSense 廣告帶來的預估總收益 (淨收益)。
estimated_partner_ad_reserved_revenue (僅適用於 YouTube Reporting API)
透過 DoubleClick (DCLK) 和其他 YouTube 銷售來源售出的預訂廣告的預估總收益 (淨收益)。這項指標先前命名為 estimated_partner_double_click_revenue
estimated_partner_double_click_revenue(僅適用於 YouTube Reporting API)
透過 DoubleClick (DCLK) 和其他 YouTube 銷售來源售出的已售出廣告的預估總收益 (淨收益)。
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_monetized_playback
觀眾播放影片,且至少有一次廣告曝光的次數。如果觀眾看到片頭廣告,但在影片播放前就停止觀看,就算是一次營利播放次數。此數字的預期估計誤差為 ±2.0%。
estimated_playback_Based_cpm
每千次播放的預估總收益。