Metrics

本文件定義 YouTube Reporting API 擷取的指標。這個 API 可擷取大量資料報表，內含頻道或內容擁有者的 YouTube 數據分析資料。

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

核心指標

雖然 YouTube Reporting API 受到《服務條款》中定義的「廢止政策」規範，但非核心指標 (和非核心維度) 則不受政策影響。本頁定義會明確識別任何屬於核心指標的指標。

以下清單列出該 API 的核心指標。 這些指標也會用於 YouTube Analytics API 中，這也是該 API 的核心指標。

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

查看指標

觀看次數 (核心指標)
影片的觀看次數。在播放清單報表中，這項指標代表影片在播放清單中的觀看次數。如要進一步瞭解觀看次數報表記錄方式，請前往 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.
喜歡人數 (核心指標)
使用者給予影片正面評分而表示喜歡的次數。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.
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 說明中心。

注意：結束畫面指標資料自 2016 年 5 月 1 日起提供。

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

觀眾續看率指標

audience_retention_percentage
在指定時間點觀看影片的觀眾絕對比例。這個比例的計算方式是比較影片中特定片段的觀看次數與影片的總觀看次數。elapsed_video_time_percentage 維度可識別與指標對應的影片片段。

請注意，如果影片中的片段在特定影片觀看次數中可能重複播放，或是完全無法播放，舉例來說，如果使用者倒轉和觀看某部影片的相同片段，該影片的絕對比例可能會大於 1。

以下示例說明這個值的計算方式：
  • 1 分鐘影片獲得 100 次觀看。半數觀眾在 15 秒後停止觀看，而其餘觀眾則看完整部影片。觀眾沒有重複觀看該片段。在這個情況下，對於影片上四分之一的時間區塊，這項指標的值會是 1，而在影片剩餘部分的值則為 0.50。
  • 1 分鐘影片獲得 100 次觀看。所有觀眾都看了整部影片，但其中有 20 名觀眾在看完 45 秒的影片後，先回到 30 秒的標記，然後再看完整部影片。在此情況下，對於影片前半段或後四季的時間區間，指標值會是 1。不過，如果是影片第三季的時間區間，這個值會是 1.2，因為有 100% 的觀眾都看了這個片段，但有 20% 的觀眾會觀看這個片段兩次。

預估收益指標

注意：預估收益指標不會在月底進行調整，且不包含合作夥伴銷售和放送的廣告。請參閱 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_sense_revenue (僅適用於 YouTube Reporting API)
在所選日期範圍和區域內，由競價銷售的 AdSense 廣告帶來的預估總收益 (淨收益)。
estimated_partner_ad_reserved_revenue(僅在 YouTube Reporting API 支援)
透過 DoubleClick (DCLK) 和其他 YouTube 銷售來源供應的預留銷售廣告所賺取的預估總收益 (淨收益)。這項指標先前名為 estimated_partner_double_click_revenue。
estimated_partner_double_click_revenue(僅適用於 YouTube Reporting API)
透過 DoubleClick (DCLK) 和其他 YouTube 銷售來源放送的預訂廣告總收益 (淨收益)。
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
每千次播放次數的預估總收益。