本文定義 YouTube Reporting API 擷取的指標。這項 API 可擷取大量資料報表,內含頻道或內容擁有者的 YouTube 數據分析資料。
指標是使用者活動、廣告成效或預估收益的個別評估值。使用者活動指標包括影片觀看次數和評分 (喜歡和不喜歡)。
核心指標
雖然 YouTube Reporting API 須遵守《服務條款》中定義的廢止政策,但非核心指標 (和非核心維度) 不受該政策規範。在本頁的定義中,任何核心指標都會明確標示為核心指標。
以下列出 API 的核心指標。 YouTube Analytics API 也會使用這些指標,並將其視為核心指標。
annotation_click_through_rateannotation_close_rateaverage_view_duration_secondscommentsdislikesengaged_viewsestimated_partner_revenuelikessharessubscribers_gainedsubscribers_lostviews_percentageviewswatch_time_minutes
如要進一步瞭解適用於廢止政策的 YouTube API,請參閱相關清單。
查看指標
- engaged_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.
觸及率指標
- video_thumbnail_impressions
- 影片縮圖向觀眾顯示的次數。縮圖必須顯示超過 1 秒,且至少有一半的部分出現在畫面中,系統才會計入曝光次數。詳情請參閱 YouTube 說明中心。
- video_thumbnail_impressions_ctr
- 促成觀眾點擊觀看影片的曝光百分比。計算方式是將點擊次數除以曝光次數。
觀看時間指標
- 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.
- 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. - 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
- 資訊卡的點閱率,計算方式為資訊卡點擊次數與資訊卡曝光次數的比率。
- 資訊卡前導廣告的顯示次數。一次影片觀看次數可能會產生多次預告片曝光。
- 資訊卡前導廣告的點擊次數。資訊卡圖示點擊次數會歸因於向使用者顯示的最後一個前導廣告。
- 資訊卡前導廣告的點閱率,計算方式為資訊卡前導廣告的點擊次數除以資訊卡前導廣告的曝光總數。
片尾指標
片尾是影片最後 5 到 20 秒顯示的元素,可用來宣傳內容、頻道和網站。如需在影片中加入片尾和 YouTube 數據分析片尾報表的詳細操作說明,請前往 YouTube 說明中心。
- end_screen_element_impressions
- 片尾元素的顯示次數。每顯示一個片尾元素,就會記錄一次曝光。
- end_screen_element_clicks
- 片尾元素的點擊次數。
- end_screen_element_click_rate
- 片尾元素的點閱率,計算方式為片尾元素點擊次數除以片尾元素曝光次數。
會員取消指標
- membershipsCancellationSurveyResponses
- 在報表統計期內,取消指定頻道會員資格的 YouTube 使用者完成問卷調查的次數。
預估收益指標
注意:預估收益指標在月底可能會有所調整,而且不含合作夥伴銷售及放送的廣告。如需預估收益數據的其他資訊和注意事項,請參閱 YouTube 說明中心。
- 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
- 每千次播放的預估總收益。