Metrics

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

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

核心指標

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

以下清單列出 API 的核心指標。

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

查看指標

views(核心指標)
這項指標在不同類型的報表中代表不同的數字：
  • 在影片報表中，這個指標會指出影片的觀看次數。
  • 在未使用 isCurated 維度的播放清單報表中，這個指標會指定播放清單中影片的總觀看次數，無論這些觀看次數是否發生在播放清單的情況下。請注意，指標值只包含頻道擁有者影片的觀看次數。

    在這些報表中，playlistViews 指標代表在特定播放清單的情況下，觀眾觀看該播放清單影片的次數。
  • 在使用 isCurated 維度的播放清單報表中，這個指標會顯示影片在特定播放清單中觀看次數。請注意，這些報表不支援 playlistViews 指標。
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.
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.
shares(核心指標)
使用者透過 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
每次啟動播放清單時，觀眾平均觀看的影片次數。請注意，這項指標只包含在網站上發生的播放清單觀看次數。

註解指標

注意：YouTube Analytics API 報表只會傳回 2012 年 6 月 10 日後的 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/4 的時間區間，指標的值就會是 1。不過，由於 100% 的觀眾都觀看了影片的第 3 個時間區間，但其中有 20% 的觀眾觀看了該片段兩次，因此該片段的時間區間值為 1.2。
relativeRetentionPerformance
這項指標會將影片與所有片長相近的 YouTube 影片相互比較，顯示影片在播放期間留住觀眾的程度。這個指標的值介於 0 和 1 之間，可用來識別影片在特定時間點的相對留存成效。影片中的點是由 elapsedVideoTimeRatio 維度提供。

如果值為 0，表示這部影片的觀眾續留率低於其他片長相近的影片；如果值為 1，表示這部影片的觀眾續留率高於其他片長相近的影片。如果中間值為 0.5，表示一半的影片觀眾續看率較高，另一半則較低。

以下假設的範例說明值在報表中的顯示方式。平均而言，觀看 10 分鐘影片的觀眾有 90% 會在 3 分鐘後繼續觀看，70% 會在 8 分鐘後繼續觀看。不過，對於某部 10 分鐘的影片，只有 80% 的觀眾在 3 分鐘後仍在觀看，但所有觀眾在 8 分鐘後仍在觀看。
  • 在 elapsedVideoTimeRatio 值對應的影片播放時間為三分鐘時，relativeRetentionPerformance 指標的值會低於 0.5，因為在該時間點，該影片的成效低於平均影片。
  • 在 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。
  • 在區隔 24 中，totalSegmentImpressions 指標的值為 2，在所有其他區隔中，指標值則為 1。
stoppedWatching
影片播放期間，某個片段為最後片段的次數。如要瞭解這項指標值的計算方式，請參閱 startedWatching 指標的定義。
totalSegmentImpressions
影片特定片段的觀看次數。如要瞭解這項指標值的計算方式，請參閱 startedWatching 指標的定義。請注意，觀眾可以在同一次播放中重複觀看影片的同一片段。

會員取消指標

membershipsCancellationSurveyResponses
在報表期間，已取消指定頻道會籍的 YouTube 使用者填答問卷調查的次數。

預估收益指標

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

根據預設，所有預估收益數據都會以美元為單位。不過，YouTube 數據分析 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 合作夥伴售出的廣告產生的預估總收益 (以美元為單位)。總收益在月底可能會有所調整，而且不包含合作夥伴放送的廣告所產生的收益。總收益與預估收益或淨收益不同，後者會考量擁有權和收益分潤協議。
千次曝光出價(先前名稱為 impressionBasedCpm)
每千次廣告曝光的預估總收益。
adImpressions (舊稱 impressions)
已驗證的廣告曝光次數。
monetizedPlaybacks
觀眾播放影片時，影片至少有一次廣告曝光的次數。如果觀眾在片頭廣告播放期間停止觀看，系統就會計為營利播放。這個數據的預估誤差為 ±2.0%。
playbackBasedCpm
每千次播放的預估總收益。