Metrics

本文將說明 YouTube 報表 API 擷取的指標。這項 API 可擷取大量資料報表，內含頻道或內容擁有者的 YouTube 數據分析資料。

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

核心指標

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

以下清單列出 API 的核心指標。這些指標如果也用於 YouTube Analytics API，就會成為該 API 的核心指標。

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

查看指標

engaged_views(核心指標)
影片觀看次數 (觀看時間至少 4 秒)。
views(核心指標)
影片的觀看次數。在播放清單報表中，這項指標會顯示影片在播放清單中觀看次數。YouTube 說明中心提供有關觀看次數回報方式的其他資訊。This is a core metric and is subject to the Deprecation Policy.
red_views
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.
red_watch_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.
average_view_duration_percentage
影片播放期間，觀眾平均觀看的影片長度百分比。自 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.
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 日前的資料。

播放清單的相關指標

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

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

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

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

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

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_click_rate
資訊卡的點閱率，也就是資訊卡點擊次數和資訊卡曝光次數間的比例。
card_teaser_impressions
資訊卡前導廣告的顯示次數。觀眾每次觀看影片時，前導廣告可能會獲得多次曝光。
card_teaser_clicks
資訊卡前導廣告的點擊次數。資訊卡圖示的點擊次數會歸入上一個向使用者顯示的前導廣告。
card_teaser_click_rate
資訊卡前導廣告的點閱率，也就是資訊卡前導廣告點擊次數和資訊卡前導廣告曝光次數總數間的比例。

結束畫面指標

片尾是指在影片最後 5 到 20 秒顯示的元素，用於宣傳你的內容、頻道和網站。如要進一步瞭解如何在影片中加入片尾，以及如何使用 YouTube 數據分析片尾報表，請前往 YouTube 說明中心。

end_screen_element_impressions
顯示的片尾元素數量。每個顯示的片尾元素都會記錄一次曝光。
end_screen_element_clicks
片尾元素的點擊次數。
end_screen_element_click_rate
片尾元素的點擊率，計算方式為片尾元素點擊次數與片尾元素曝光次數的比率。

觀眾續看率指標

audience_retention_percentage
在影片的特定時間點，觀眾觀看影片的絕對比率。計算方式是將影片片段的觀看次數，與影片的總觀看次數進行比較。elapsed_video_time_percentage 維度會指出指標對應的影片部分。

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

以下範例說明如何計算這個值：
  • 1 分鐘的影片觀看次數為 100 次。半數的觀眾在 15 秒後停止觀看，其餘觀眾則會觀看整部影片。沒有觀眾重複觀看影片的任何片段。在這種情況下，這個指標的值會是影片前 25% 的時間區塊中的 1，而其值會是影片其餘部分的 0.50。
  • 1 分鐘的影片觀看次數為 100 次。所有觀眾都會觀看整部影片，但其中 20 位觀眾會先看完影片的 45 秒處，然後跳回影片的 30 秒處，再觀看影片的剩餘部分。在這種情況下，如果是影片前半或最後四分之一的時間區間，指標的值就會是 1。不過，由於 100% 的觀眾都觀看了影片的第 3 個時間區間，但其中有 20% 的觀眾觀看了該片段兩次，因此該時間區間的值為 1.2。

會員取消指標

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

預估收益指標

注意：預估收益指標會在月底調整，且不包含合作夥伴售出和放送的廣告。如要進一步瞭解預估收益金額，請參閱 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_reserved_revenue (僅支援 YouTube Reporting API)
透過 DoubleClick (DCLK) 和其他 YouTube 銷售來源預訂銷售的廣告，預估總收益 (淨收益)。這項指標先前稱為 estimated_partner_double_click_revenue。
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_cpm
每千次廣告曝光的預估總收益。
ad_impressions
已驗證的廣告曝光次數。
estimated_monetized_playbacks
觀眾播放影片時，影片至少有一次廣告曝光的次數。如果觀眾在片頭廣告播放期間停止觀看，系統就會計為營利播放。這個數據的預估誤差為 ±2.0%。
estimated_playback_based_cpm
每播放一千次的預估總收益。