Metrics

本文說明可使用 YouTube Analytics API 擷取的指標。這項 API 支援即時查詢，可產生 YouTube 數據分析自訂報表。

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

核心指標

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

以下列出 API 的核心指標。

如要瞭解詳情，請參閱適用於廢止政策的 YouTube API 清單。

查看指標

engagedViews (核心指標)
頻道影片開播幾秒後仍繼續觀看的次數。
觀看次數 (核心指標)
這項指標在不同類型的報表中代表不同數字。 This is a core metric and is subject to the Deprecation Policy.
playlistViews
這項指標的定義請參閱播放清單指標一節。
redViews
YouTube Premium (舊稱 YouTube Red) 會員觀看影片的次數。
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.
averageViewPercentage
影片播放期間的平均觀看長度百分比。自 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.
subscribersGained (核心指標)
使用者訂閱頻道的次數。This is a core metric and is subject to the Deprecation Policy.

頻道可以在多個地方獲得或失去訂閱者，包括影片觀看頁面、頻道頁面，以及 YouTube 首頁上顯示的導覽。 在頻道報表中，這項指標包含從上述任何位置獲得的訂閱者。不過，在使用 video 維度或 filter 參數將回應限制為只納入特定影片資料的報表中，subscribersGained 指標只會納入指定影片觀看頁面的統計資料。
subscribersLost (核心指標)
使用者取消訂閱頻道的次數。This is a core metric and is subject to the Deprecation Policy.

這項指標的資料回報方式與 subscribersGained 指標類似。 在頻道報表中，這項指標包含使用者透過任何機制取消訂閱頻道而流失的訂閱者。不過，如果報表使用 video 維度或 filter 參數，將回應限制為只包含特定影片的資料，這項指標就只會納入從指定影片觀看頁面取消訂閱的使用者。
videosAddedToPlaylists
影片新增至任何 YouTube 播放清單的次數。影片可能已新增至影片擁有者的播放清單，或新增至其他頻道的播放清單。

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

這項指標會傳回絕對數字，也就是說，如果使用者將影片新增至播放清單，然後移除，再重新新增，指標值會反映影片新增至播放清單兩次。系統無法提供 2014 年 10 月 1 日以前的這項指標資料。
videosRemovedFromPlaylists
影片從任何 YouTube 播放清單中移除的次數。影片可能已從影片擁有者的播放清單或其他頻道的播放清單中移除。

指標值包括影片從預設播放清單 (例如「稍後觀看」播放清單) 中移除的次數。

這項指標會傳回絕對值，也就是說，如果使用者將影片新增至播放清單、移除、再次新增，然後再次移除，指標值會反映影片從播放清單中移除兩次。系統無法提供 2014 年 10 月 1 日以前的這項指標資料。

播放清單的相關指標

播放清單報表包含兩種指標，可說明觀眾與播放清單中影片的互動情形：

  • 匯總影片指標提供使用者活動和曝光指標，這些指標會針對播放清單中所有影片匯總，且這些影片也屬於播放清單所屬的頻道。系統不會在匯總中計算其他頻道擁有的影片指標。因此，如果頻道建立的播放清單只包含其他頻道的影片，這些播放清單的報表就不會提供這些指標的值。

    如需支援的匯總影片指標定義，請參閱本文的「查看指標」和「觀看時間指標」部分。

  • 播放清單內指標會反映使用者在播放清單頁面中的活動和參與度。這些指標會納入播放清單中所有影片的觀看次數，不論影片屬於哪個頻道，但只會計算在播放清單中發生的觀看次數。

下列指標大多是播放清單指標；清單中的其餘指標 (例如 playlistSaves 指標) 則與使用者和播放清單本身的互動有關，而非與播放清單中的影片有關。因此，這些指標不會歸類為匯總影片指標或播放清單指標。

averageTimeInPlaylist
觀眾開始觀看播放清單後，觀看播放清單中影片的預估平均時間長度 (以分鐘為單位)。請注意，這項指標只會納入在網頁上發生的播放清單觀看次數。
playlistAverageViewDuration
觀眾每次觀看播放清單內容的預估平均時間長度 (以秒為單位)。請注意，這項指標代表播放清單中個別影片的平均觀看時間長度；相較之下，averageTimeInPlaylist 指標代表每位觀眾觀看整個播放清單的平均時間。這項指標會計入其他頻道擁有的播放清單影片資料。
playlistEstimatedMinutesWatched
使用者觀看播放清單內容的總分鐘數。其他情境的觀看時間 (例如觀眾在其他播放清單中觀看同一部影片時的觀看時間) 不會計入。這項指標包含其他頻道擁有的播放清單影片資料。
playlistSaves
使用者儲存播放清單的淨次數。如要進一步瞭解已儲存的播放清單，請參閱 YouTube 說明中心。這項指標會傳回淨變更數，也就是說，如果使用者儲存播放清單、從已儲存的播放清單清單中移除，然後再次儲存，指標值會反映新增一個播放清單儲存。
playlistStarts
觀眾開始播放播放清單的次數。請注意，這項指標只會納入在網頁上發生的播放清單觀看次數。
playlistViews
播放清單中影片的觀看次數。 這項指標會納入其他頻道擁有的播放清單影片資料。
viewsPerPlaylistStart
每次開始播放播放清單時，影片的平均觀看次數。請注意，這項指標只會納入在網頁上發生的播放清單觀看次數。

註解指標

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

annotationImpressions
註解曝光總數。
annotationClickableImpressions
顯示且可供點選的註解數量。
annotationClicks
註解的點擊次數。
annotationClickThroughRate (核心指標)
觀眾點擊註解的次數，在可點擊註解曝光次數中所佔的比例。This is a core metric and is subject to the Deprecation Policy. 如要進一步瞭解如何建立註解和使用連結註解，請前往 YouTube 說明中心。
annotationClosableImpressions
顯示且可關閉的註解數量。
annotationCloses
已關閉的註解數量。
annotationCloseRate (核心指標)
觀眾關閉的註解次數，在註解曝光總數中所佔的比例。This is a core metric and is subject to the Deprecation Policy.

資訊卡指標

如需更詳細的指示，請參閱 YouTube 說明中心的影片資訊卡新增說明和 YouTube 數據分析資訊卡報表。

cardImpressions
資訊卡的顯示次數。每當觀眾開啟資訊卡面板時，系統就會記錄各張資訊卡的曝光次數。
cardClicks
資訊卡的點擊次數。
cardClickRate
資訊卡的點閱率，計算方式為資訊卡點擊次數和資訊卡曝光次數間的比例。
cardTeaserImpressions
資訊卡前導廣告的顯示次數。觀眾每次觀看影片時，前導廣告可能會獲得多次曝光。
cardTeaserClicks
資訊卡前導廣告獲得的點擊次數。資訊卡圖示的點擊次數會歸入上一個顯示給使用者的前導廣告。
cardTeaserClickRate
資訊卡前導廣告的點閱率，計算方式為資訊卡前導廣告點擊次數與資訊卡前導廣告總曝光次數的比率。

直播指標 (同時觀看人數)

averageConcurrentViewers
特定影片的平均同時線上觀眾人數。如果報表指定了 livestreamPosition 維度，則 averageConcurrentViewers 值會指定特定區隔的平均線上觀眾人數
peakConcurrentViewers
特定影片的同時觀看人數最高峰。如果報表指定 livestreamPosition 維度，則 peakConcurrentViewers 值會指定影片特定片段的最高同時在線觀眾人數。

觀眾續看率指標

audienceWatchRatio
在影片的特定時間點，觀看影片的觀眾絕對比例。計算方式是比較影片某部分的觀看次數與影片總觀看次數。elapsedVideoTimeRatio 維度會指出指標對應的影片部分。

請注意，在一次觀看影片的過程中，觀眾可能會重複觀看某個部分，也可能完全略過。舉例來說，如果使用者多次倒轉並觀看影片的同一部分，該部分的絕對比率可能會大於 1。

以下範例說明值的計算方式：
  • 1 分鐘的影片觀看次數為 100 次。一半的觀眾在 15 秒後停止觀看，其餘觀眾則觀看完整部影片。沒有任何觀眾重複觀看影片片段。在這個例子中，影片前 25% 的時間區間，這個指標的值為 1，其餘時間則為 0.50。
  • 1 分鐘的影片觀看次數為 100 次。所有觀眾都觀看完整部影片，但有 20 位觀眾觀看到影片的 45 秒處時，跳回影片的 30 秒處，然後觀看影片的其餘部分。在本例中，影片前半段或最後四分之一的時間區間，指標值會是 1。不過，由於有 100% 的觀眾觀看影片的第三個四分之一，但其中 20% 的觀眾觀看該片段兩次，因此該時間區間的值為 1.2。
relativeRetentionPerformance
這項指標會比較影片與所有片長相近的 YouTube 影片，顯示影片在播放期間留住觀眾的能力。這項指標的值介於 0 和 1 之間，可識別影片在特定時間點的相對續看率。影片中的時間點由 elapsedVideoTimeRatio 維度提供。

值為 0 表示影片的觀眾續看率低於所有長度相近的影片，值為 1 則表示影片的觀眾續看率高於所有長度相近的影片。中間值為 0.5 表示，有一半的同類影片比你的影片更吸引觀眾，另一半則不如你的影片。

以下假設範例說明報表中的值可能顯示方式。平均來說，觀看 10 分鐘影片的觀眾中，有 90% 會觀看 3 分鐘，70% 會觀看 8 分鐘。不過，如果某部 10 分鐘的影片在 3 分鐘後只剩下 80% 的觀眾，但這些觀眾在 8 分鐘後仍持續觀看，
  • 在影片播放三分鐘時對應的 elapsedVideoTimeRatio 值，relativeRetentionPerformance 指標的值會低於 0.5，因為當時影片的成效低於平均值。
  • 在影片 8 分鐘處對應的 elapsedVideoTimeRatio 值，relativeRetentionPerformance 指標的值會高於 0.5，因為當時影片的成效優於其他長度相近的影片。
startedWatching
影片播放期間，特定片段成為觀眾觀看的第一個片段的次數。

舉例來說，假設影片 X 長度為 5 分鐘，為製作這份報表，YouTube 會將影片劃分為 100 個 3 秒片段，並以 elapsedVideoTimeRatio 維度識別這些片段。觀眾造訪 YouTube 並觀看影片的前 1 分 10 秒， 包括影片前 24 個片段的全部或部分內容。觀眾在後續的 YouTube 瀏覽期間觀看影片的其餘部分，從第 24 個片段繼續播放，直到第 100 個片段。

這個範例會產生下列觀看指標值：
  • 區隔 1 和 24 的 startedWatching 指標值為 1，其他區隔的指標值則為 0。
  • 區隔 24 和 100 的 stoppedWatching 指標值為 1，其他區隔的指標值則為 0。
  • totalSegmentImpressions 指標的值會是區隔 24 的 2，其他區隔的指標值則為 1。
stoppedWatching
影片播放期間，特定片段成為最後觀看片段的次數。如要查看這項指標值的計算範例，請參閱 startedWatching 指標的定義。
totalSegmentImpressions
影片特定片段的觀看次數。如要查看這項指標值的計算範例，請參閱 startedWatching 指標的定義。請注意，觀眾可能會在同一次播放期間重複觀看影片的同一片段。

會籍取消指標

membershipsCancellationSurveyResponses
在報表統計期內，取消指定頻道會員方案的 YouTube 使用者完成問卷調查的人數。

預估收益指標

注意：預估收益指標會在月底時調整，且不包含合作夥伴售出及放送的廣告。如要進一步瞭解預估收益數據和相關注意事項，請參閱 YouTube 說明中心。

根據預設，所有預估收益數字都會以美元顯示。不過，YouTube Analytics API 支援部分預估收益和廣告成效指標的 currency 參數，因此您可以擷取其他幣別的預估收益資料。
estimatedRevenue (核心指標) (先前稱為 earnings)
在所選日期範圍和區域內，所有 Google 售出的廣告來源以及非廣告來源的預估淨收益總額。 This is a core metric and is subject to the Deprecation Policy.

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

預估收益指標在月底可能會有所調整，而且不包含合作夥伴放送的廣告或售出的交易項目。
estimatedRedPartnerRevenue (舊稱 redPartnerRevenue)
在選取的報表維度中，透過 YouTube Premium (舊稱 YouTube Red) 訂閱賺取的預估總收益。這項指標的值反映音樂和非音樂內容的收益，並會於月底進行調整。

廣告成效指標

grossRevenue
在所選日期範圍和區域內，所有 Google 售出或 DoubleClick 合作夥伴售出的廣告所產生的預估總收益 (以美元計價)。總收益在月底可能會有所調整，而且不包含合作夥伴放送的廣告所產生的收益。總收益與預估收益或淨收益不同，後者會將擁有權比例和收益分潤協議納入考量。
cpm (先前稱為 impressionBasedCpm)
廣告每曝光一千次可帶來的預估總收益。
adImpressions (先前稱為 impressions)
放送的已驗證廣告曝光次數。
monetizedPlaybacks
觀眾播放影片時，影片至少有一次廣告曝光的次數。如果觀眾看到片頭廣告，但廣告播完前就停止觀看，且完全沒有觀看你的影片，系統仍會計為一次營利播放次數。這項數據的預估誤差為 ±2.0%。
playbackBasedCpm
每千次播放的預估總收益。