Metrics

本文件定義了可透過 YouTube Analytics API 擷取的指標。這個 API 支援即時查詢,可產生自訂的 YouTube 數據分析報表。

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

核心指標

使用 YouTube Analytics API 時,您必須遵守《服務條款》中的廢止政策,但非核心指標 (以及非核心維度) 則不受這項政策的規範。本頁定義的指標是明確以核心指標為準的指標。

以下列出 API 的核心指標。

注意:下列核心指標已完全淘汰:
  • earnings 核心指標已於 2016 年 8 月 4 日淘汰,並重新命名為 estimatedRevenue。為遵守《服務條款》中的廢止政策,earningsestimatedRevenue 指標會同時支援,直到 2017 年 8 月 10 日為止。
  • favoritesAddedfavoritesRemoved 核心指標已於 2015 年 3 月 31 日淘汰。這些指標只能透過 YouTube Analytics API 擷取。

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

查看指標

觀看次數 (核心指標)
影片的觀看次數。在播放清單報表中,這項指標代表影片在播放清單中的觀看次數。請參閱 YouTube 說明中心,進一步瞭解系統如何回報觀看次數。This is a core metric and is subject to the Deprecation Policy.
RedView
YouTube Premium (舊稱 YouTube Red) 會員觀看的影片觀看次數。
不重複 (2016 年 9 月 27 日淘汰)
觀看影片的不重複觀眾人數。這項數據是根據不重複 Cookie 的數量所計算,因此會耗用多部裝置或瀏覽器的使用者。
uniques 指標已於 2016 年 9 月 27 日淘汰。核心指標並非核心指標,而是在 2016 年 10 月 31 日前提供支援。
viewerPercentage (核心指標)
觀看影片或播放清單時登入帳戶的觀眾百分比。This is a core metric and is subject to the Deprecation Policy.

觀看時間指標

estimatedMinutesWatched (核心指標)
使用者在指定頻道、內容擁有者、影片或播放清單中觀看影片的分鐘數。This is a core metric and is subject to the Deprecation Policy.
estimatedRedMinutesWatched
YouTube Premium (舊稱 YouTube Red) 會員觀看影片的總分鐘數。
averageViewDuration (核心指標)
影片播放的平均時間長度 (以秒為單位)。自 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.
subscribersGeted (核心指標)
使用者訂閱頻道的次數。This is a core metric and is subject to the Deprecation Policy.

頻道可以在多個地方吸引或流失訂閱者,包括影片觀賞頁面、頻道頁面,以及 YouTube 首頁顯示的指南。 在頻道報表中,這項指標包含從這些地點獲得的訂閱人數。不過,如果報表使用 video 維度或 filter 參數,將回應限制為僅包含特定影片的資料,subscribersGained 指標只會納入來自特定影片觀賞頁面的統計資料。
subscribers Loss (核心指標)
使用者取消訂閱頻道的次數。This is a core metric and is subject to the Deprecation Policy.

這項指標的資料與 subscribersGained 指標類似。在頻道報表中,這項指標會納入透過任何機制取消訂閱的訂閱人數。不過,如果報表使用 video 維度或 filter 參數,將回應限制為只包含特定影片的資料,則這項指標只會取消訂閱取消訂閱特定影片觀賞頁面的使用者。
videosAddedTo 播放清單
影片加入任何 YouTube 播放清單的次數。影片可能已加入影片擁有者的播放清單或其他頻道的播放清單中。

指標值包含影片加入預設播放清單 (例如「稍後觀看」播放清單) 的次數。但不會計算系統自動加入的影片播放清單,例如頻道的上傳播放清單或使用者的觀看記錄。

這項指標會傳回絕對數字,也就是使用者將影片加入播放清單後再次加入,這項指標的值就能反映影片加入播放清單兩次。無法提供 2014 年 10 月 1 日前的資料。
videosRemovedFrom 播放清單
影片從任何 YouTube 播放清單中移除的次數。影片可能已從影片擁有者的播放清單或其他頻道的播放清單中移除。

這項指標值是指影片從「稍後觀看」播放清單等預設播放清單中移除的次數。

這項指標傳回的是絕對數字,也就是使用者將影片加入播放清單後再次遭到移除,代表影片從播放清單中移除兩次。無法提供 2014 年 10 月 1 日前的資料。

已淘汰的參與度指標

下列指標都是於 2015 年 3 月 31 日淘汰的核心指標

favoritesAdded (核心指標) (已於 2015 年 3 月 31 日淘汰)
使用者將影片標示為我的最愛的次數。詳情請參閱 YouTube 說明中心This is a core metric and is subject to the Deprecation Policy.
favoritesRemoved (核心指標) (已於 2015 年 3 月 31 日淘汰)
使用者從自己最愛的影片清單中移除影片的次數。詳情請參閱 YouTube 說明中心This is a core metric and is subject to the Deprecation Policy.

播放清單的相關指標

playlistStarts
觀眾開始播放播放清單的次數。請注意,這項指標僅含網路上的播放清單觀看次數。
viewsPerPlaylistStart
每次播放清單啟動時,影片觀看次數的平均次數。請注意,這項指標僅含網路上的播放清單觀看次數。
平均觀看時間內清單
觀眾開始播放播放清單後,觀眾觀看播放清單中影片的預估平均時間長度 (以分鐘為單位)。請注意,這項指標僅含網路上的播放清單觀看次數。

註解指標

注意:自 2012 年 6 月 10 日起,YouTube Analytics API 報表只會傳回 annotationClickThroughRateannotationCloseRate 指標的資料。此外,自 2013 年 7 月 16 日起,YouTube Analytics API 報表只會傳回其餘註解指標的資料。

annotationImpression
註解曝光總數。
annotationClickableImpression
顯示的可點擊註解數量。
annotationClicks
點擊註解的次數。
annotationClickThroughRate (核心指標)
觀眾點擊註解與可點擊註解曝光總數之間的比率。This is a core metric and is subject to the Deprecation Policy.YouTube 說明中心進一步瞭解如何建立註解使用連結註解
annotationClosableImpression
顯示且可關閉的註解數量。
annotationCloses
關閉註解的數量。
annotationCloseRate (核心指標)
觀眾關閉註解對註解曝光總數的比率。This is a core metric and is subject to the Deprecation Policy.

資訊卡指標

請參閱 YouTube 說明中心,進一步瞭解如何在影片中加入資訊卡YouTube 數據分析資訊卡報表

卡片曝光次數
資訊卡的顯示次數。開啟資訊卡面板後,系統會為每部影片的資訊卡記錄一次曝光次數。
資訊卡點擊次數
資訊卡獲得的點擊次數。
資訊卡點擊率
資訊卡的點閱率,計算方式為資訊卡點擊次數與資訊卡曝光次數的比率。
cardTeaserImpression
資訊卡前導廣告顯示次數。影片觀看次數可能會產生多次前導廣告曝光。
cardTeaserClicks
資訊卡前導廣告的點擊次數。資訊卡圖示的點擊次數會歸於最後向使用者顯示的前導廣告。
cardTeaserClickRate
資訊卡前導廣告的點閱率,計算方式為資訊卡前導廣告與資訊卡前導廣告曝光總數的總和。

觀眾續看率指標

audienceWatchRatio
在影片的特定時間點觀看影片的絕對比例。這項數據的計算方式是比較影片的一部分與影片的總觀看次數。elapsedVideoTimeRatio 維度可識別指標對應的影片部分。

請注意,有些人可以在相同的影片檢視畫面中,重複觀看某個片段 (甚至完全不看)。舉例來說,如果使用者倒轉影片並重複觀看相同的片段,則該片段的絕對長寬比可能會大於 1

下列範例說明這個值的計算方式:
  • 一分鐘的影片觀看了 100 次。半數的觀眾在觀看 15 秒後停止觀看,其餘觀眾則看完整部影片。所有觀眾都一再觀看影片的任何部分。在此情況下,這項指標在影片播放第一季的時間值區為 1,影片剩餘期間的值則為 0.50
  • 一分鐘的影片觀看了 100 次。所有觀眾都看完整部影片,但有 20 名觀眾收看了 45 秒之前的片段,然後回到影片的 30 秒標記中,接著就看完了剩下的部分。在這種情況下,指標值的值會是影片上半部或上一季的時間點值區,值為 1。不過,由於影片片段 100% 的觀眾觀看了該片段,而影片第三季的時間時間值是 1.2,但其中有 20% 的觀眾觀看了該片段兩次。
相對留存率
這項數據顯示影片在播放期間,與長度相近的所有 YouTube 影片相比,能有效吸引觀眾的注意力。這項指標的值介於 01 之間,可識別影片在特定時間點的相對留存成效。影片的點是由 elapsedVideoTimeRatio 維度提供。

0 值表示影片留住觀眾的成效比其他長度相近的影片還差,而 1 值表示影片留住觀眾的成效優於其他長度相近的影片。0.5 的中位數值表示,長度相近的影片中,有半數將留住觀眾,而一半則留住觀眾。

以下假設範例說明值在報表中的可能值。平均而言,90% 的觀看時間 10 分鐘的觀眾在 3 分鐘之後仍然仍在觀看,70% 的人在 8 分鐘之後仍在觀看。不過,就某部 10 分鐘影片而言,只有 80% 的觀眾在 3 分鐘後仍持續觀看,而全部的觀眾在 8 分鐘後仍會收看影片。
  • elapsedVideoTimeRatio 值對應到影片三分鐘的時間點上,relativeRetentionPerformance 指標的值會低於 0.5,這是因為影片在該時間點的表現低於平均影片。
  • 在對應於影片八分鐘的時間點的 elapsedVideoTimeRatio 值中,relativeRetentionPerformance 指標的值會高於 0.5,因為在該時間點,影片的成效優於其他長度相近的其他影片。

預估收益指標

注意:預估收益指標在月底時會有調整,不含合作夥伴銷售與合作夥伴放送的廣告。請前往 YouTube 說明中心查看有關預估收益數據的額外資訊與注意事項。

根據預設,所有預估收益數字都會以美元回報。不過,YouTube Analytics API 支援某些預估收益和廣告成效指標的 currency 參數,方便您使用其他貨幣擷取預估收益資料。
estimatedRevenue (核心指標) (先前稱為 earnings)
在所選日期範圍和區域內,所有 Google 售出的廣告來源,以及來自非廣告來源的預估淨收益。 This is a core metric and is subject to the Deprecation Policy.

預估收益指標會在月底調整,且不含合作夥伴銷售與合作夥伴放送的廣告。
estimatedAdRevenue (先前稱為 adEarnings)
在所選日期範圍和區域內,所有 Google 售出的廣告來源預估淨收益。

預估收益指標會在月底調整,且不含合作夥伴銷售與合作夥伴放送的廣告。
estimatedRedPartner Revenue (原稱為 redPartnerRevenue)
針對所選報表維度,透過 YouTube Premium (先前稱為 YouTube Red) 訂閱帶來的預估收益總額。這項指標的值反映的是音樂和非音樂內容收益,而且可能會經過月底調整。

廣告成效指標

總收益
在所選日期範圍和區域內,所有 Google 銷售或 DoubleClick 合作夥伴銷售的廣告預估總收益,以美元為單位。總收益在月底可能會有所調整,而且不包含合作夥伴放送的廣告所產生的收益。總收益不應與預估收益或淨收益一併混淆,後者是依擁有權分潤和收益分享協議而定。
千次曝光出價 (原稱 impressionBasedCpm)
每千次廣告曝光的預估總收益。
adImpression (原稱為 impressions)
通過驗證的廣告曝光次數。
營利播放
觀眾播放影片,且至少有一次廣告曝光的次數。如果觀眾看到片頭廣告,但在影片播放前就停止觀看,就算是一次營利播放次數。此數字的預期估計誤差為 ±2.0%。
PlaybackBasedCpm
每千次播放的預估總收益。