本文件定義了可使用 YouTube Analytics API 擷取的指標。這個 API 支援即時查詢,以產生自訂 YouTube 數據分析報表。
指標是指使用者活動、廣告成效或預估收益的個別評估。使用者活動指標包括影片觀看次數和評分 (喜歡和不喜歡的人數) 等。
核心指標
雖然 YouTube Analytics API 適用於《服務條款》中定義的「廢止政策」,但非核心指標 (和非核心維度) 則不受政策影響。本頁定義會明確識別任何屬於核心指標的指標。
以下清單列出該 API 的核心指標。
annotationClickThroughRate
annotationCloseRate
averageViewDuration
comments
dislikes
estimatedMinutesWatched
estimatedRevenue
likes
shares
subscribersGained
subscribersLost
viewerPercentage
views
earnings
核心指標已於 2016 年 8 月 4 日淘汰,並重新命名為estimatedRevenue
。根據《服務條款》中定義的「廢止政策」,在 2017 年 8 月 10 日前,系統持續支援earnings
和estimatedRevenue
指標。favoritesAdded
和favoritesRemoved
核心指標已於 2015 年 3 月 31 日淘汰。這些指標只能透過 YouTube Analytics API 擷取。
詳情請參閱受廢止政策適用的 YouTube API 清單。
查看指標
- 觀看次數 (核心指標)
- 這項指標代表不同類型報表中的數據:
- 在影片報表中,這項指標會指出影片的觀看次數。
- 在不使用
isCurated
維度的播放清單報表中,這項指標會指定播放清單中影片的總觀看次數,無論觀看次數是否出現在播放清單中。請注意,指標值只包含頻道擁有者影片的觀看次數。
在這類報表中,「playlistViews
」指標代表播放清單影片在特定播放清單內容中的觀看次數。 - 在採用
isCurated
維度的播放清單報表中,這項指標代表影片在特定播放清單情境中的觀看次數。請注意,這些報表不支援「playlistViews
」指標。
- playlistViews
- 您可以在「播放清單指標」專區中定義這項指標。
- redViews
- YouTube Premium (舊稱 YouTube Red) 會員觀看影片的次數。
- 不重複使用者 (已於 2016 年 9 月 27 日淘汰)
- 觀看影片的不重複觀眾人數。這個計算方法是根據不重複 Cookie 的數量計算,因此使用多種裝置或瀏覽器會導致超額計算。
「uniques
」指標已於 2016 年 9 月 27 日淘汰。2016 年 10 月 31 日之前,這項服務並非核心指標。 - 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.
- 不喜歡的人數 (核心指標)
- 使用者表示不喜歡影片 (給予負評) 的次數。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 日以前的資料。
已淘汰的參與度指標
下列指標皆為 2015 年 3 月 31 日淘汰的核心指標。
- favoritesAdded (核心指標) (2015 年 3 月 31 日淘汰)
- 使用者將影片加入最愛影片的次數。如需更多資訊,請造訪 YouTube 說明中心。This is a core metric and is subject to the Deprecation Policy.
- favoritesRemoved (核心指標) (2015 年 3 月 31 日淘汰)
- 使用者將影片從收藏影片清單中移除的次數。如需更多資訊,請造訪 YouTube 說明中心。This is a core metric and is subject to the Deprecation Policy.
播放清單的相關指標
播放清單報表包含兩種指標,可說明觀眾如何與播放清單中的影片互動:
-
「匯總影片指標」提供使用者活動和曝光指標,而這些指標是系統針對擁有播放清單所屬頻道的影片,匯總至播放清單中的所有影片。其他頻道擁有的影片不會計入匯總資料。因此,如果頻道建立的播放清單只包含其他頻道擁有的影片,這些播放清單的報表將不會顯示這些指標的值。
-
播放清單中的指標會反映使用者在播放清單頁面中的活動與參與度。這些指標會計入播放清單中所有影片的觀看次數 (無論影片所屬頻道為何),但只會計算播放清單內容的觀看次數。
下方列出的指標大多是在播放清單內的指標;清單中的其餘指標 (例如 playlistSaves
指標) 則是與播放清單本身的互動,而非播放清單中影片的相關數據。因此,這類指標不會分為匯總影片指標或播放清單內指標。
- averageTimeInPlaylist
- 播放清單開始播放後,觀眾觀看播放清單中影片的預估平均時間 (以分鐘為單位)。請注意,這項指標僅包含在網路上發生的播放清單觀看次數。
- playlistAverageViewDuration
- 每次播放清單觀看次數的預估平均長度 (以秒為單位)。請注意,這項指標代表播放清單中個別影片的平均觀看次數;相反地,
averageTimeInPlaylist
指標代表每位觀眾觀看整份播放清單的平均時間。這項指標會顯示其他頻道擁有的播放清單影片資料。 - playlistEstimatedMinutesWatched
- 使用者在播放清單中觀看播放清單內容的時間長度。至於其他情境中的觀看時間 (例如,觀眾收看同一部影片時,透過其他播放清單觀看內容所帶來的觀看時間) 不會列入計算。這項指標會顯示其他頻道擁有的播放清單影片資料。
- playlistSaves
- 使用者儲存播放清單的淨次數。如要進一步瞭解已儲存的播放清單,請參閱 YouTube 說明中心。這個指標會傳回淨變化數字,也就是說,如果使用者儲存播放清單、從儲存的播放清單中移除該播放清單,然後再次儲存,指標值代表新增的播放清單儲存次數。
- playlistStarts
- 觀眾啟動播放清單的次數。請注意,這項指標只包含在網路上發生的播放清單觀看次數。
- playlistViews
- 播放清單中的影片在播放清單內容中的觀看次數。這項指標包含其他頻道擁有的播放清單影片資料。
- viewsPerPlaylistStart
- 播放清單開始播放時的平均影片觀看次數。請注意,這項指標僅包含在網路上發生的播放清單觀看次數。
註解指標
注意:自 2012 年 6 月 10 日起,YouTube 數據分析 API 報表只會傳回 annotationClickThroughRate
和 annotationCloseRate
指標的資料。此外,YouTube 數據分析 API 報表只會傳回截至 2013 年 7 月 16 日為止其餘註解指標的資料。
- 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
- 資訊卡的點閱率,計算方式為資訊卡點擊次數與資訊卡曝光次數的比率。
- 資訊卡前導廣告的顯示次數。影片觀看次數可能會產生多次前導廣告曝光次數。
- 資訊卡前導廣告獲得的點擊次數。資訊卡圖示點擊次數會歸給使用者最後看到的前導廣告。
- 資訊卡前導廣告的點閱率,計算方式為資訊卡前導廣告獲得的點擊次數和資訊卡前導廣告曝光總數。
觀眾續看率指標
- audienceWatchRatio
- 在指定時間點觀看影片的觀眾絕對比例。這個比例的計算方式是比較影片中特定片段的觀看次數與影片的總觀看次數。
elapsedVideoTimeRatio
維度可識別與指標對應的影片片段。
請注意,如果影片中的片段在特定影片觀看次數中可能重複播放,或是完全無法播放,舉例來說,如果使用者倒轉和觀看某部影片的相同片段,該影片的絕對比例可能會大於1
。
以下示例說明這個值的計算方式:- 1 分鐘影片獲得 100 次觀看。半數觀眾在 15 秒後停止觀看,而其餘觀眾則看完整部影片。觀眾沒有重複觀看該片段。在這個情況下,對於影片上四分之一的時間區塊,這項指標的值會是
1
,而在影片剩餘部分的值則為0.50
。 - 1 分鐘影片獲得 100 次觀看。所有觀眾都看了整部影片,但其中有 20 名觀眾在看完 45 秒的影片後,先回到 30 秒的標記,然後再看完整部影片。在此情況下,對於影片前半段或後四季的時間區間,指標值會是
1
。不過,如果是影片第三季的時間區間,這個值會是1.2
,因為有 100% 的觀眾都看了這個片段,但有 20% 的觀眾會觀看這個片段兩次。
- 1 分鐘影片獲得 100 次觀看。半數觀眾在 15 秒後停止觀看,而其餘觀眾則看完整部影片。觀眾沒有重複觀看該片段。在這個情況下,對於影片上四分之一的時間區塊,這項指標的值會是
- relativeRetentionPerformance
- 這項評估資料與所有片長相近的 YouTube 影片相比,顯示影片在播放期間留住觀眾的程度。這項指標的值介於
0
和1
之間,代表影片在特定時間點的相對續看成效。影片中的點是由elapsedVideoTimeRatio
維度提供。
0
值表示影片留住觀眾的機率低於其他長度相近的影片,而1
值表示影片留住觀眾的成效高於任何其他長度相近的影片。中位數值0.5
代表長度相近的影片中,有半數的影片留住觀眾成效較佳,而留住觀眾比例的一半則降低。
以下假設範例說明這些值在報表中的可能呈現方式。平均來說,在 10 分鐘看影片的觀眾中,90% 的人在 3 分鐘之後仍在觀看,70% 的人在 8 分鐘後還會繼續觀看。不過,對於特定 10 分鐘長的影片,只有 80% 的觀眾在三分鐘後仍會繼續觀看,但這 8 分鐘過後,所有觀眾還是會繼續觀看。- 在與影片長度為三分鐘的時間點對應的
elapsedVideoTimeRatio
值中,relativeRetentionPerformance
指標的值會低於0.5
,因為當時影片的成效低於平均影片。 - 在
elapsedVideoTimeRatio
值對應到影片八分鐘的時間點時,relativeRetentionPerformance
指標的值就高於0.5
。也就是說,與此同時,影片的成效比其他長度相似的影片更好。
- 在與影片長度為三分鐘的時間點對應的
預估收益指標
注意:預估收益指標不會在月底進行調整,且不包含合作夥伴銷售和放送的廣告。請參閱 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
- 每千次播放次數的預估總收益。