本文定義了可透過 YouTube Analytics API 擷取的指標。這個 API 支援即時查詢,可產生 YouTube 數據分析自訂報表。
指標是使用者活動、廣告成效或預估收益的個別評估值。使用者活動指標包括影片觀看次數和評分 (喜歡和不喜歡)。
核心指標
雖然 YouTube Analytics API 須遵守《服務條款》中定義的廢止政策,但非核心指標 (和非核心維度) 不受該政策規範。在本頁的定義中,任何核心指標都會明確標示為核心指標。
以下列出 API 的核心指標。
annotationClickThroughRateannotationCloseRateaverageViewDurationcommentsdislikesengagedViewsestimatedMinutesWatchedestimatedRevenuelikessharessubscribersGainedsubscribersLostviewerPercentageviews
如要進一步瞭解適用於廢止政策的 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.
- dislikes (核心指標)
- 使用者給予影片負面評分來表示不喜歡的次數。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
- 每次播放清單開始播放後的平均影片觀看次數。請注意,這項指標只包含在網頁上發生的播放清單觀看次數。
註解指標
注意: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
- 資訊卡的點閱率,計算方式為資訊卡點擊次數與資訊卡曝光次數的比率。
- 資訊卡前導廣告的顯示次數。一次影片觀看次數可能會產生多次預告片曝光。
- 資訊卡前導廣告的點擊次數。資訊卡圖示點擊次數會歸因於向使用者顯示的最後一個前導廣告。
- 資訊卡前導廣告的點閱率,計算方式為資訊卡前導廣告的點擊次數除以資訊卡前導廣告的曝光總數。
直播指標 (同時觀看人數)
- averageConcurrentViewers
- 特定影片的平均同時觀看人數。如果有多位使用者一起透過電視螢幕觀看,這項指標會計入共視者。如果報表指定 livestreamPosition 維度,則
averageConcurrentViewers值會指定特定區隔的平均同時線上觀眾人數 - peakConcurrentViewers
- 特定影片的最高同時觀看人數。如果有多位使用者一起透過電視螢幕觀看,這項指標會計入共視者。如果報表指定 livestreamPosition 維度,則
peakConcurrentViewers值會指定影片特定片段的同時觀看人數高峰。
觀眾續看率指標
- audienceWatchRatio
- 觀眾在影片指定時間點觀看影片的絕對比率。計算方式是將影片某個片段的觀看次數,除以影片的總觀看次數。
elapsedVideoTimeRatio維度會指出指標對應的影片部分。
請注意,在單次影片觀看中,觀眾可能會多次觀看某個片段,也可能完全不看。舉例來說,如果使用者多次倒轉並觀看影片的同一部分,則該部分影片的絕對比率可能會大於1。
以下範例說明如何計算這個值:- 一部一分鐘的影片獲得 100 次觀看,一半的觀眾在 15 秒後停止觀看,其餘觀眾則看完。沒有任何觀眾重複觀看影片的任何部分。在這種情況下,影片前 25% 的時間區間內,這項指標的值為
1,影片其餘部分的值則為0.50。 - 一部一分鐘的影片獲得 100 次觀看,所有觀眾都看完整部影片,但其中 20 位觀眾看到 45 秒處時,跳回 30 秒處,然後看完剩餘的影片。在這種情況下,影片前半段或最後四分之一的時間區間,指標值會是
1。不過,影片第三季度的時間分段值會是1.2,因為 100% 的觀眾觀看了該片段,但其中 20% 的觀眾觀看了兩次。
- 一部一分鐘的影片獲得 100 次觀看,一半的觀眾在 15 秒後停止觀看,其餘觀眾則看完。沒有任何觀眾重複觀看影片的任何部分。在這種情況下,影片前 25% 的時間區間內,這項指標的值為
- relativeRetentionPerformance
- 這項指標會與所有長度相近的 YouTube 影片相比,顯示影片在播放期間留住觀眾的成效。這項指標的值介於
0和1之間,代表影片在特定時間點的相對續看率。影片中的時間點由elapsedVideoTimeRatio維度提供。
如果值為0,表示影片的觀眾續看率低於其他長度相近的影片;如果值為1,則表示影片的觀眾續看率高於其他長度相近的影片。中間值為0.5,表示長度相近的影片中,有一半的觀眾續看率較高,另一半則較低。
以下假設範例說明報表中可能顯示的值。平均而言,觀看 10 分鐘影片的觀眾中,有 90% 的人在 3 分鐘後仍繼續觀看,70% 的人在 8 分鐘後仍繼續觀看。不過,在某部 10 分鐘長的影片中,只有 80% 的觀眾在 3 分鐘後仍繼續觀看,但這些觀眾在 8 分鐘後仍繼續觀看。- 在影片播放 3 分鐘的時間點,
relativeRetentionPerformance指標的值會低於0.5,因為此時影片的成效低於平均值。elapsedVideoTimeRatio - 在
elapsedVideoTimeRatio影片播放到 8 分鐘時,relativeRetentionPerformance指標的值會高於0.5,因為此時影片的成效優於其他長度相近的影片。
- 在影片播放 3 分鐘的時間點,
- startedWatching
- 影片播放期間,特定影片片段做為第一個片段顯示的次數。
舉例來說,假設影片 X 長度為 5 分鐘。為製作這份報表,YouTube 會將影片分成 100 個 3 秒片段,並以 elapsedVideoTimeRatio 維度識別。觀眾造訪 YouTube 並觀看影片的前 1 分 10 秒,其中包含影片前 24 個片段的全部或部分內容。觀眾下次造訪 YouTube 時,會從第 24 個片段繼續播放,直到第 100 個片段播完為止。
這個範例會產生下列觀看指標值:startedWatching指標的值在區隔 1 和 24 中會是1,在所有其他區隔中則會是0。- 區隔 24 和 100 的
stoppedWatching指標值為1,所有其他區隔的指標值則為0。 totalSegmentImpressions指標的值在區隔 24 中會是2,在所有其他區隔中則會是1。
- stoppedWatching
- 在影片播放期間,影片特定片段是最後觀看片段的次數。如需這項指標值的計算範例,請參閱
startedWatching指標的定義。 - totalSegmentImpressions
- 影片特定片段的觀看次數。如需這項指標值的計算範例,請參閱
startedWatching指標的定義。請注意,觀眾可以在同一次播放中多次觀看影片的同一片段。
會員取消指標
- membershipsCancellationSurveyResponses
- 在報表統計期內,YouTube 使用者取消指定頻道會員資格後,完成問卷調查的次數。
預估收益指標
注意:預估收益指標在月底可能會有所調整,而且不含合作夥伴銷售及放送的廣告。如需預估收益數據的其他資訊和注意事項,請參閱 YouTube 說明中心。
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
- 每千次播放的預估總收益。