本頁面由 Cloud Translation API 翻譯而成。

YouTube Analytics API: Channel Reports

本頁面列出頻道擁有者可透過 YouTube Analytics API 擷取的報表。頻道報表可提供特定頻道的使用者活動指標，以及評估影片觀看次數、評分和訂閱人數等指標。

影片報表會針對頻道影片，提供所有使用者活動的統計資料。
「播放清單」報表會針對播放清單中發生的影片觀看次數，提供具體的統計資料。
廣告成效報表包含收益和廣告成效的相關指標，他們使用 adType 維度，根據影片播放期間放送的廣告類型將指標分組。「廣告成效報表」一節會說明 API 支援的兩種廣告成效指標類型。

擷取報表

如要擷取管道報表，您必須將 API 要求中的 ids 參數值設為下列其中一個值：

channel==MINE：API 會傳回已驗證使用者的 YouTube 頻道資料。
channel==CHANNEL_ID：將 CHANNEL_ID 設為您要擷取資料的管道專屬頻道 ID。授權要求的使用者必須是頻道擁有者。

頻道 ID 目前是以字母 UC 開頭的字串，但格式隨時可能變更。(如要查看頻道 ID，請前往 YouTube 頻道的進階帳戶設定頁面，或使用 YouTube Data API's channels.list 方法，透過程式輔助方式擷取頻道 ID)。

授權

所有 YouTube Analytics API 要求都必須獲得授權。授權指南說明如何使用 OAuth 2.0 通訊協定擷取授權權杖。

YouTube Analytics API 要求使用下列授權範圍：

範圍
https://www.googleapis.com/auth/yt-analytics.readonly	查看您 YouTube 內容的 YouTube 數據分析報表。這個範圍可讓您存取使用者活動指標，例如觀看次數和評分次數。
https://www.googleapis.com/auth/yt-analytics-monetary.readonly	查看你 YouTube 內容的 YouTube 數據分析收益報表。這個範圍可以存取使用者活動指標，以及預估收益和廣告成效指標。
https://www.googleapis.com/auth/youtube	管理您的 YouTube 帳戶。在 YouTube Analytics API 中，頻道擁有者會使用這個範圍來管理 YouTube 數據分析群組和群組項目。
https://www.googleapis.com/auth/youtubepartner	查看及管理 YouTube 上的資產和相關內容。在 YouTube Analytics API 中，內容擁有者會使用這個範圍來管理 YouTube 數據分析群組和群組項目。

注意：管道報表目前不支援預估收益和廣告成效指標。因此，https://www.googleapis.com/auth/yt-analytics-monetary.readonly 範圍目前不會授予這些報表中的金額資料存取權。

濾鏡

此表格說明受支援的報表，指出每份報表可用的篩選器。在表格中，以括號標示的篩選器為選用項目。舉例來說，對於篩選選項 video(,country)，您必須指定 video 篩選器，以及 country 篩選器。

這個 API 也可以為 video 和 playlist 篩選器指定多個值。如果要為其中一個篩選器指定多個值，也可以將該篩選器加入您為要求指定的維度清單。即使該篩選器未列為特定報表支援的維度也是如此。

如需如何依據特定值或一組值篩選 API 結果的完整說明，請參閱 filters 參數定義。

瞭解報表表格

本節將說明定義 API 所支援報表的表格格式和術語。下表列出播放詳細資料影片報表支援的維度、指標和篩選器。使用時間維度和 averageViewPercentage 指標。

維度：

使用 0 以上的數字	creatorContentType、subscribedStatus、youtubeProduct
請使用 0 或 1	day、month

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage

篩選器：

請使用 0 或 1	country、province、大陸、subContinent
請使用 0 或 1	video、group
使用 0 以上的數字	subscribedStatus、youtubeProduct

表格中會包含兩個維度列、一列指標資料，以及篩選器的三列。以維度和篩選器來說，只要組合符合表格中的使用規則，即可在 API 要求中合併每個資料列的值。因此，這份報表的有效 dimensions 參數值包括：

dimensions=day
dimensions=day,liveOrOnDemand
dimensions=month,subscribedStatus,youtubeProduct
dimensions=month,youtubeProduct

然而，參數值 day,month 無效，因為它使用兩個以時間為準的維度，但要求可使用 0 或 1。在此情況下，參數值 subscribedStatus,youtubeProduct 實際上確實會傳回報表，但不會依日期、週、月等項目匯總指標 (報表會單獨記錄在說明文件中)。

報表表格術語

表格使用下列術語，指明維度是必要或選用：

這些字詞代表必須提供值：
- 必要：必須包含值。
- 使用剛好 1：必須包含群組中的一個值。
- 使用 1 或多個：您可以加入群組中的任一或所有值，但必須加入至少一個值。
以下字詞代表值為選填：
- 選用：您可以選擇加入值。
- 使用 0 或 1：您可以選擇從群組中加入一個值。
- 使用 0 以上的值：您可以選擇加入群組中的任何值或所有值。

影片報表

基本統計資料

基本的使用者活動統計資料

這份報表提供與使用者在某個頻道動作相關的統計資料。你可以篩選報表，只傳回特定影片或國家/地區的資料。

維度：

[無]

指標：

使用 1 個以上

view1, redViews, 留言, 喜歡次數 65, <預估成效>1,560,60%, <預估成效>}{6,500,600,600,600,60 得{預估收益{統計}收益, {預估觀看次數{/211,600,600,600 次{/11,60}實際觀看次數{預估觀看次數 1,600,600,60 萬次,videosAddedToPlaylists estimatedMinutesWatched estimatedRedMinutesWatched averageViewDuration averageViewPercentage annotationClickThroughRate annotationCloseRate annotationImpressions annotationClickableImpressions annotationClosableImpressions annotationClicks annotationCloses cardClickRate cardTeaserClickRate cardImpressions cardTeaserImpressions cardClicks cardTeaserClicks subscribersGained subscribersLost estimatedRevenue estimatedAdRevenue grossRevenue estimatedRedPartnerRevenue monetizedPlaybacks playbackBasedCpm adImpressions

篩選器：

請使用 0 或 1	country、Europe、subContinent
請使用 0 或 1	video、group

美國各州的基本使用者活動統計資料

此報告提供美國各州或哥倫比亞特區的統計資料。請注意，這份報表僅支援上述國家/地區專屬報表中的部分指標。

維度：

[無]

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions annotationClosableImpressions annotationClicks annotationCloses cardClickRate cardTeaserClickRate cardImpressions cardTeaserImpressions cardClicks cardTeaserClicks

篩選器：

必要	province
請使用 0 或 1	video、group

根據時間

特定時間範圍內的使用者活動 (按國家/地區劃分)

這份報表提供特定時間間隔內，使用者在特定頻道上動作的相關統計資料。你可以篩選報表，只傳回特定影片或國家/地區的資料。

維度：

只使用 1 個	day、month
選用	creatorContentType

指標：

使用 1 個以上

views, redViews, 留言, 喜歡次數 65, <預估成效>1,560%, <預估成效>}{15,60%{<數字>平均觀看時間 6,51,600,600,600,000,610,600{/11,6 更千次平均觀看次數{/211,600,600 次上的觀看次數{/211,60}實際觀看次數{/161,601,60}實際觀看次數{/11 videosAddedToPlaylists estimatedMinutesWatched estimatedRedMinutesWatched averageViewDuration averageViewPercentage annotationClickThroughRate annotationCloseRate annotationImpressions annotationClickableImpressions annotationClosableImpressions annotationClicks annotationCloses cardClickRate cardTeaserClickRate cardImpressions cardTeaserImpressions cardClicks cardTeaserClicks subscribersGained subscribersLost estimatedRevenue estimatedAdRevenue grossRevenue estimatedRedPartnerRevenue monetizedPlaybacks playbackBasedCpm adImpressions

篩選器：

請使用 0 或 1	country、Europe、subContinent
請使用 0 或 1	video、group

特定時間範圍內，美國境內的使用者活動

此報表提供美國特定州別或哥倫比亞特區的使用者活動相關統計資料。請注意，這份報表僅支援上述國家/地區專屬報表中的部分指標。

維度：

只使用 1 個	day、month
選用	creatorContentType

指標：

使用 1 個以上

篩選器：

必要	province
請使用 0 或 1	video、group

使用者地理位置

使用者活動 (按國家/地區劃分)

這份報表針對各國家/地區的使用者活動提供了相關統計資料。你可以篩選報表，只傳回特定影片的資料。

維度：

必要	country
選用	creatorContentType

指標：

使用 1 個以上

篩選器：

請使用 0 或 1	land、subContinent
請使用 0 或 1	video、group

使用者活動 (依省分組)

這份報表提供美國各州和哥倫比亞特區的使用者活動統計資料。在這個報表中，您必須將 filters 參數值設為 country==US。

維度：

必要	province
選用	creatorContentType

指標：

使用 1 個以上

篩選器：

必要	country==美國
請使用 0 或 1	video、group

使用者活動 (按城市劃分) (<= 250 筆結果)

注意：這份報表需要您將 maxResults 參數設為 250 以下的整數值。與大多數其他報表不同，這份報表也會要求您指定 sort 請求參數值。

此報表按城市列出使用者活動統計資料。

維度：

必要	city
使用 0 以上的數字	creatorContentType、country、province、subscribedStatus 注意：如果加入「州/省」維度，也必須使用 `country==US` 篩選器。
請使用 0 或 1	day、month

指標：

使用 1 個以上

views、estimatedMinutesWatched、averageViewDuration、averageViewPercentage

篩選器：

請使用 0 或 1	country、province、大陸、subContinent
請使用 0 或 1	video、group

排序選項： -觀看次數
-estimatedMinutesWatched

播放詳細資料

播放詳細報表提供下列觀看屬性的相關統計資料：

觀看的是即時影像或隨選影片嗎？
觀眾是否已訂閱擁有影片的頻道？
這發生在哪項 YouTube 產品上？

注意：「liveOrOnDemand」liveOrOnDemand維度和篩選器無法與 averageViewPercentage 指標搭配使用。因此，以下每個子區段會列出兩份報表。一份報表支援 liveOrOnDemand 維度 (和篩選器)，另一份報表則支援 averageViewPercentage 指標。

使用者活動 (依訂閱狀態區分)

這份報表會針對已訂閱和未訂閱的觀眾提供使用者活動指標。統計資料可以按時間範圍 (日或月) 分類，而且也可以按國家/地區、洲或subContinent來篩選。

維度：

使用 0 以上的數字	creatorContentType、subscribedStatus
請使用 0 或 1	day、month

指標：

使用 1 個以上

views、redViews、按讚、不喜歡的次數、videosAddedToPlaylists、videosRemovedFromPlaylists、分享、estimatedMinutesWatched averageViewPercentage annotationCloseRate annotationImpressions annotationClickableImpressions annotationClosableImpressions annotationClicks annotationCloses cardClickRate cardTeaserClickRate cardImpressions cardTeaserImpressions cardClicks cardTeaserClicks

篩選器：

請使用 0 或 1	country、Europe、subContinent
請使用 0 或 1	video、group
選用	subscribedStatus

使用者活動 (依州/省的訂閱狀態劃分)

這份報表會針對美國各州或哥倫比亞特區，顯示訂閱/未訂閱觀眾的使用者活動指標。這份報表支援的指標少於先前的報表。

維度：

使用 0 以上的數字	creatorContentType、subscribedStatus
請使用 0 或 1	day、month

指標：

使用 1 個以上

篩選器：

請使用 0 或 1	video、group
使用 0 以上的數字	province、subscribedStatus

含有選用時間維度的播放詳細資料

這些報表不一定要使用時間維度 (「日」或「月」)，因為無論如何，您必須使用 startDate 和 endDate 請求參數來指定報表涵蓋的日期範圍。這個維度 (如果有的話) 表示您希望報表中的資料按日期、月份等方式匯總。

含有選用時間維度和 liveOrOnDemand 統計資料的播放詳細資料

這份報表提供特定時間間隔的播放詳情統計資料。支援 liveOrOnDemand 維度 (和篩選器)。

維度：

使用 0 以上的數字	creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct
請使用 0 或 1	day、month

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration

篩選器：

請使用 0 或 1	country、province、大陸、subContinent
請使用 0 或 1	video、group
使用 0 以上的數字	liveOrOnDemand、subscribedStatus、youtubeProduct

含有選用時間維度和 averageViewPercentage 指標的播放詳細資料

這份報表提供特定時間間隔的播放詳情統計資料。支援 averageViewPercentage 指標。

維度：

使用 0 以上的數字	creatorContentType、subscribedStatus、youtubeProduct
請使用 0 或 1	day、month

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage

篩選器：

請使用 0 或 1	country、province、大陸、subContinent
請使用 0 或 1	video、group
使用 0 以上的數字	subscribedStatus、youtubeProduct

各國家/地區的播放詳細資料

依國家/地區顯示 liveOrOnDemand 統計資料的播放詳細資料

這份報表提供各國家/地區的播放詳情。支援 liveOrOnDemand 維度 (和篩選器)。

維度：

必要	country
使用 0 以上的數字	creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration

篩選器：

請使用 0 或 1	land、subContinent
請使用 0 或 1	video、group
使用 0 以上的數字	liveOrOnDemand、subscribedStatus、youtubeProduct

依國家/地區顯示 averageViewPercentage 指標

以下報表與上一個報表類似。新增對 averageViewPercentage 指標的支援，但不支援 liveOrOnDemand 維度或篩選器。

維度：

必要	country
使用 0 以上的數字	creatorContentType、subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage

篩選器：

請使用 0 或 1	land、subContinent
請使用 0 或 1	video、group
使用 0 以上的數字	subscribedStatus、youtubeProduct

各州/省的播放詳細資料

使用 liveOrOnDemand 統計資料的各州/省播放詳細資料

這份報表提供美國各州和哥倫比亞特區的播放詳細資料。支援 liveOrOnDemand 維度 (和篩選器)。

維度：

必要	province
使用 0 以上的數字	creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration

篩選器：

必要	國家/地區`==US`
請使用 0 或 1	video、group
使用 0 以上的數字	liveOrOnDemand、subscribedStatus、youtubeProduct

使用 averageViewPercentage 指標各州的播放詳細資料

以下報表與上一個報表類似。新增對 averageViewPercentage 指標的支援，但不支援 liveOrOnDemand 維度或篩選器。

維度：

必要	province
使用 0 以上的數字	creatorContentType、subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage

篩選器：

必要	國家/地區`==US`
請使用 0 或 1	video、group
使用 0 以上的數字	subscribedStatus、youtubeProduct

播放位置

影片播放位置報表

這份報表會針對發生影片播放的頁面或應用程式類型，提供相關的統計資料。

維度：

必要	insightPlaybackLocationType
使用 0 以上的數字	creatorContentType、day、liveOrOnDemand、subscribedStatus

指標：

使用 1 個以上

views、estimatedMinutesWatched

篩選器：

請使用 0 或 1	country、province、大陸、subContinent
請使用 0 或 1	video、group
使用 0 以上的數字	liveOrOnDemand、subscribedStatus

播放位置詳細資料 (<= 25 筆結果)

注意：這份報表需要您將 maxResults 參數設為 25 以下的整數值。與大多數其他報表不同，這份報表也會要求您指定 sort 請求參數值。

這份報表會指出為頻道影片帶來最多觀看次數或觀看時間的內嵌影片播放器。

維度：

必要	insightPlaybackLocationDetail
選用	creatorContentType

指標：

使用 1 個以上

views、estimatedMinutesWatched

篩選器：

必要	insightPlaybackLocationType`==EMBEDDED`
請使用 0 或 1	country、province、大陸、subContinent
請使用 0 或 1	video、group
使用 0 以上的數字	liveOrOnDemand、subscribedStatus

排序選項： -觀看次數
-estimatedMinutesWatched

流量來源

此報告會依據觀眾找到您的影片內容的方式，彙整觀看統計資料。例如，此功能可識別出自 Google 搜尋結果或相關影片連結帶來的觀看次數。

維度：

必要	insightTrafficSourceType
使用 0 以上的數字	creatorContentType、day、liveOrOnDemand、subscribedStatus

指標：

使用 1 個以上

views、estimatedMinutesWatched

篩選器：

請使用 0 或 1	country、province、大陸、subContinent
請使用 0 或 1	video、group
使用 0 以上的數字	liveOrOnDemand、subscribedStatus

流量來源詳細資料 (<= 25 個結果)

注意：這份報表需要您將 maxResults 參數設為 25 以下的整數值。與大多數其他報表不同，這份報表也會要求您指定 sort 請求參數值。

本報告會根據為頻道內容產生最多觀看次數的推薦連結來源網址，來彙整檢視統計資料。「參照網址」是按流量來源類型分類，而 insightTrafficSourceDetail 維度的定義可以看出報表提供的流量來源。舉例來說，如果您將 insightTrafficSourceType 篩選器設為 ADVERTISING，報表會列出為頻道內容帶來最多觀看次數或觀看時間的廣告類型。

維度：

必要	insightTrafficSourceDetail
選用	creatorContentType

指標：

使用 1 個以上

views、estimatedMinutesWatched

篩選器：

必要	insightTrafficSourceType (請見下表的附註)
請使用 0 或 1	country、province、大陸、subContinent
請使用 0 或 1	video、group
使用 0 以上的數字	liveOrOnDemand、subscribedStatus

排序選項：

-觀看次數
-estimatedMinutesWatched

注意：這份報表僅適用於特定流量來源。舉例來說，NO_LINK_EMBEDDED 流量來源無法提供額外的詳細資料，因此不支援這份報表。如要進一步瞭解哪些流量來源支援這份報表，請參閱 insightTrafficSourceType 定義。

裝置類型和作業系統

裝置類型

此報告會依據觀眾找到您的影片內容的方式，彙整觀看統計資料。舉例來說，可用來找出行動裝置或遊戲主機上的觀看次數。

維度：

必要	deviceType
使用 0 以上的數字	creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、estimatedMinutesWatched

篩選器：

請使用 0 或 1	country、province、大陸、subContinent
請使用 0 或 1	video、group
使用 0 以上的數字	operatingSystem、liveOrOnDemand、subscribedStatus、youtubeProduct

作業系統

此報表根據觀眾的作業系統彙整檢視統計資料。例如，可識別 Android 裝置或 PlayStation 上產生的觀看次數。

維度：

必要	operatingSystem
使用 0 以上的數字	creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、estimatedMinutesWatched

篩選器：

請使用 0 或 1	country、province、大陸、subContinent
請使用 0 或 1	video、group
使用 0 以上的數字	deviceType、liveOrOnDemand、subscribedStatus、youtubeProduct

作業系統和裝置類型

這份報表會依據觀眾的作業系統和裝置類型，彙整查看統計資料。舉例來說，您可以識別 Android 平板電腦或 Windows 電腦裝置上的觀看次數。

維度：

必要	deviceType、operatingSystem
使用 0 以上的數字	creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、estimatedMinutesWatched

篩選器：

請使用 0 或 1	country、province、大陸、subContinent
請使用 0 或 1	video、group
使用 0 以上的數字	liveOrOnDemand、subscribedStatus、youtubeProduct

觀眾客層

此報告會根據觀眾的年齡層和性別，匯總檢視統計資料。

維度：

使用 1 個以上	ageGroup、gender
使用 0 以上的數字	creatorContentType、liveOrOnDemand、subscribedStatus

指標：

使用 1 個以上

viewerPercentage

篩選器：

請使用 0 或 1	country、province、大陸、subContinent
請使用 0 或 1	video、group
使用 0 以上的數字	liveOrOnDemand、subscribedStatus

注意：針對不同播放詳細資料維度 (subscribedStatus、liveOrOnDemand 或 youtubeProduct) 的 viewerPercentage 數據值，並未標準化。

舉例來說，如果報表採用 subscribedStatus 10% 的資料，並將 viewerPercentage 10} 的觀看次數。viewerPercentage(報表中所有 viewerPercentage 欄位的總值是 200%)。

您可以使用篩選器，確保報表只納入某個播放詳情維度的「viewerPercentage」viewerPercentage資料值 (或值組合)。

這份報表會提供統計資料，顯示頻道影片在不同社交平台分享的頻率。

維度：

必要	sharingService
使用 0 以上的數字	creatorContentType、subscribedStatus

指標：

使用 1 個以上

篩選器：

請使用 0 或 1	country、Europe、subContinent
請使用 0 或 1	video、group
選用	subscribedStatus

觀眾續看率

這份報表會評估影片留住觀眾的能力。「elapsedVideoTimeRatio」維度會測量對應指標值經過的影片量。audienceWatchRatio 和 relativeRetentionPerformance 指標提供兩項評估結果，說明影片留住觀眾的成效。第一個是絕對值，第二項代表影片與其他長度相近的 YouTube 影片相比，成效如何。

注意：觀眾續看率報表不支援為 video 篩選器指定逗號分隔值清單的功能，這個值必須指定單一影片 ID。

維度：

必要	elapsedVideoTimeRatio
選用	creatorContentType

指標：

使用 1 個以上

audienceWatchRatio、relativeRetentionPerformance

篩選器：

必要	影片
使用 0 以上的數字	audienceType、subscribedStatus、youtubeProduct

播放清單報表

播放清單報表包含與頻道擁有者播放清單中影片相關的使用者活動指標。有兩種報表版本可供使用，以下各節將針對各個版本提供說明：

各節的「建議做法」分頁會說明用來擷取對應報表的建議 API 要求格式。建議的報表支援一組更多指標，同時提供匯總影片指標和播放清單內指標。這個要求格式不使用 isCurated 維度。
各節的「使用 isCurated」分頁說明瞭需要 isCurated 維度的舊版 API 要求格式。這些報表僅支援播放清單內指標。請注意，所有報表的 isCurated 維度已淘汰。以下警告附註說明淘汰時間表。

以下警告附註會詳細說明兩個報表版本之間的差異。

重要事項：請在 2024 年 6 月 30 日前更新頻道的播放清單報表，並於 2024 年 12 月 31 日前更新內容擁有者的播放清單報表。請注意下列異動：

淘汰了 isCurated 維度。
- 如果是管道報表，自 2024 年 6 月 30 日起，系統將不再支援這項維度。
- 內容擁有者報表：2024 年 12 月 31 日當天或之後不再支援這項維度。
從擷取播放清單報表的要求中移除 isCurated 維度後，views 指標的行為就會改變：
- 如果要求包含 isCurated 維度，views 指標代表影片在播放清單中的觀看次數。
- 如果要求不包含 isCurated 維度，views 指標會指定影片的觀看總次數，playlistViews 指標則代表影片在播放清單中的觀看次數。

因此，為了在移除 isCurated 維度時保留回溯相容性，您必須一併更新程式碼以擷取 playlistViews 指標，而非僅適用於播放清單報表的 views 指標。由於播放清單報表仍支援 views 指標，儘管指標不同，但如果您未更新指標名稱，API 仍會傳回資料。當然，您可以修改應用程式，以擷取及顯示 views 和 playlistViews。

詳情請參閱修訂版本記錄。

匯總影片指標

這些指標提供使用者活動和曝光指標，而這些指標是匯總播放清單中所有影片 (屬於播放清單擁有者) 的影片。匯總結果不會計算其他頻道擁有的影片相關指標。所以如果頻道建立的播放清單只包含其他頻道擁有的影片，那麼這些播放清單的報表將不會顯示這些指標的值。

如需 YouTube 支援的匯總影片指標清單，請參閱支援的播放清單指標一節。

播放清單中的指標

這些指標反映了播放清單頁面中的使用者活動和參與度。無論影片擁有者屬於哪個頻道，這些指標都會計入播放清單中所有影片的觀看次數，但只會計入播放清單內容的觀看次數。

支援的播放清單指標

重要事項：如下表所示，views 指標會在每份播放清單報表的兩個可用版本中，提供不同類型的資料。

在建議報表格式中，views 是匯總影片指標。
在使用 isCurated 維度擷取的報表中，views 是播放清單中的指標。

建議

目錄
匯總影片指標	views、estimatedMinutesWatched、averageViewDuration
播放清單中的指標	playlistViews、playlistEstimatedMinutesWatched、playlistAverageViewDuration、playlistSaves、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

使用 isCurated

目錄
匯總影片指標	不支援
播放清單中的指標	views、estimatedMinutesWatched、averageViewDuration、averageViewPercentage、redViews、estimatedRedMinutesWatched

基本統計資料

這份報表針對使用者與頻道播放清單中影片的互動提供統計資料。你可以篩選報表，只傳回特定播放清單的資料。

建議

維度：

[無]

指標：

使用 1 個以上

views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart

篩選器：

只使用 1 個

playlist、group

使用 isCurated

isCurated 維度已淘汰，自 2024 年 6 月 30 日起，將不再支援管道報表。播放清單報表遷移指南針對此淘汰作業說明您可以或需要進行的其他變更。

維度：

[無]

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1
請使用 0 或 1	playlist、group
請使用 0 或 1	country、province、大陸、subContinent
使用 0 以上的數字	subscribedStatus、youtubeProduct

根據時間

這份報表針對使用者與頻道播放清單中影片的互動提供統計資料。你可以篩選報表，只傳回特定播放清單的資料。

建議

維度：

只使用 1 個

day、month

指標：

使用 1 個以上

篩選器：

只使用 1 個

playlist、group

使用 isCurated

維度：

只使用 1 個	day、month
使用 0 以上的數字	subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1
請使用 0 或 1	playlist、group
請使用 0 或 1	country、province、大陸、subContinent
使用 0 以上的數字	subscribedStatus、youtubeProduct

使用者地理位置

播放清單活動 (依國家/地區區分)

這份報表會針對特定國家/地區的使用者與頻道播放清單中的影片，提供相關的統計資料。

建議

維度：

必要

country

指標：

使用 1 個以上

views、estimatedMinutesWatched、averageViewDuration

篩選器：

只使用 1 個	playlist、group
請使用 0 或 1	land、subContinent

使用 isCurated

維度：

必要	country
使用 0 以上的數字	subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1
請使用 0 或 1	playlist、group
請使用 0 或 1	land、subContinent
使用 0 以上的數字	subscribedStatus、youtubeProduct

播放清單活動 (按州/省劃分)

這份報表提供美國各州和哥倫比亞特區的播放清單活動統計資料。在這個報表中，您必須篩選結果，讓系統僅傳回美國的資料。

建議

維度：

必要

province

指標：

使用 1 個以上

views、estimatedMinutesWatched、averageViewDuration

篩選器：

必要	國家/地區`==US`
只使用 1 個	playlist、group

使用 isCurated

維度：

必要

province

指標：

使用 1 個以上

views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1;國家/地區`==US`
請使用 0 或 1	playlist、group
使用 0 以上的數字	subscribedStatus、youtubeProduct

播放位置

這份報表會針對你的播放清單影片播放次數，提供相關網頁或應用程式類型的統計資料。

建議

維度：

必要	insightPlaybackLocationType

指標：

使用 1 個以上

views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart

篩選器：

只使用 1 個

playlist、group

使用 isCurated

維度：

必要	insightPlaybackLocationType
使用 0 以上的數字	day、subscribedStatus

指標：

使用 1 個以上

views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1
請使用 0 或 1	playlist、group
請使用 0 或 1	country、province、大陸、subContinent
選用	subscribedStatus

播放位置詳細資料 (<= 25 筆結果)

注意：這份報表需要您將 maxResults 參數設為 25 以下的整數值。與大多數其他報表不同，這份報表也會要求您指定 sort 請求參數值。

這份報表會指出為頻道播放清單中影片帶來最多觀看次數或觀看時間的嵌入式影片播放器。

建議

維度：

必要	insightPlaybackLocationDetail

指標：

使用 1 個以上

views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart

篩選器：

必要	insightPlaybackLocationType`==EMBEDDED`
只使用 1 個	playlist、group

排序選項： -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

使用 isCurated

維度：

必要	insightPlaybackLocationDetail

指標：

使用 1 個以上

views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1;insightPlaybackLocationType`==EMBEDDED`
請使用 0 或 1	playlist、group
請使用 0 或 1	country、province、大陸、subContinent
選用	subscribedStatus

排序選項： -views
-estimatedMinutesWatched
-playlistStarts

流量來源

這份報表會依據觀眾找到你播放清單內容的情形，匯總觀看統計資料。舉例來說，它可以識別來自 Google 搜尋的瀏覽次數。

建議

維度：

必要	insightTrafficSourceType

指標：

使用 1 個以上

篩選器：

只使用 1 個

playlist、group

使用 isCurated

維度：

必要	insightTrafficSourceType
使用 0 以上的數字	day、subscribedStatus

指標：

使用 1 個以上

views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1
請使用 0 或 1	playlist、group
請使用 0 或 1	country、province、大陸、subContinent
選用	subscribedStatus

流量來源詳細資料 (<= 25 個結果)

注意：這份報表需要您將 maxResults 參數設為 25 以下的整數值。與大多數其他報表不同，這份報表也會要求您指定 sort 要求參數值。

這份報表會依據為頻道播放清單中影片產生最多觀看次數的參照網址，匯總觀看統計資料。參照網址是按流量來源類型分類，而 insightTrafficSourceDetail 維度的定義可指出哪些流量來源可查看報表。

舉例來說，如果您將 insightTrafficSourceType 篩選器設為 ADVERTISING，報表就會列出為頻道播放清單產生最多觀看次數或觀看時間的廣告類型。

建議

維度：

必要	insightTrafficSourceDetail

指標：

使用 1 個以上

篩選器：

必要	insightTrafficSourceType`==ADVERTISING` (或其他支援的值)
只使用 1 個	playlist、group

排序選項： -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

使用 isCurated

維度：

必要	insightTrafficSourceDetail

指標：

使用 1 個以上

views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1;insightTrafficSourceType`==ADVERTISING` (或其他支援的值)
請使用 0 或 1	playlist、group
請使用 0 或 1	country、province、大陸、subContinent
選用	subscribedStatus

排序選項： -views
-estimatedMinutesWatched
-playlistStarts

裝置類型和作業系統

裝置類型

這份報表會依據觀眾觀看你播放清單影片的情形來匯總觀看統計資料。舉例來說，可用來識別行動裝置或遊戲主機上發生的瀏覽次數。

建議

維度：

必要	deviceType

指標：

使用 1 個以上

views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart

篩選器：

只使用 1 個

playlist、group

使用 isCurated

維度：

必要	deviceType
使用 0 以上的數字	day、subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1
請使用 0 或 1	playlist、group
請使用 0 或 1	country、province、大陸、subContinent
使用 0 以上的數字	operatingSystem、subscribedStatus、youtubeProduct

作業系統

此報表根據觀眾的作業系統彙整檢視統計資料。例如，可識別 Android 裝置或 PlayStation 上產生的觀看次數。

建議

維度：

必要	operatingSystem

指標：

使用 1 個以上

views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart

篩選器：

只使用 1 個

playlist、group

使用 isCurated

維度：

必要	operatingSystem
使用 0 以上的數字	day、subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1
請使用 0 或 1	playlist、group
請使用 0 或 1	country、province、大陸、subContinent
使用 0 以上的數字	deviceType、subscribedStatus、youtubeProduct

作業系統和裝置類型

這份報表會依據觀眾的作業系統和裝置類型匯總檢視統計資料。例如，可識別使用者在 Android 平板電腦或 Windows 電腦裝置上獲得多少觀看次數。

建議

維度：

必要	deviceType、operatingSystem

指標：

使用 1 個以上

views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart

篩選器：

只使用 1 個

playlist、group

使用 isCurated

維度：

必要	deviceType、operatingSystem
使用 0 以上的數字	day、subscribedStatus、youtubeProduct

指標：

使用 1 個以上

views、estimatedMinutesWatched、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

篩選器：

必要	isCurated==1
請使用 0 或 1	playlist、group
請使用 0 或 1	country、province、大陸、subContinent
使用 0 以上的數字	subscribedStatus、youtubeProduct

觀眾客層

建議

維度：

使用 1 個以上

ageGroup、gender

指標：

必要	viewerPercentage

篩選器：

只使用 1 個

playlist、group

使用 isCurated

維度：

使用 1 個以上	ageGroup、gender
使用 0 以上的數字	subscribedStatus

指標：

必要	viewerPercentage

篩選器：

必要	isCurated==1
請使用 0 或 1	playlist、group
請使用 0 或 1	country、province、大陸、subContinent
選用	subscribedStatus

注意：這份報表中的 viewerPercentage 值並未根據 subscribedStatus 播放詳細資料維度的不同值進行正規化。

舉例來說，使用 subscribedStatus 維度的報表會傳回 viewerPercentage 資料值 和 viewerPercentage的資料，總和為 100%。(報表中所有 viewerPercentage 欄位的總值是 200%)。

您可以使用篩選器，確保報表只納入「subscriptiondStatus」subscribedStatus維度中一個值的「viewerPercentage」viewerPercentage資料值。

廣告成效報表

注意：廣告成效報表需要授權權杖，才能授予 https://www.googleapis.com/auth/yt-analytics-monetary.readonly 範圍的存取權。

廣告成效報表會針對影片播放期間放送的廣告，提供曝光次數相關指標。這些指標會計入每次廣告曝光，而每次影片播放都可能會產生多次曝光。

以曝光為準的廣告成效指標如下：

此外，部分影片報表支援下列播放次數型廣告成效指標。但這些指標不會納入廣告成效報表中。

按廣告類型劃分的廣告成效

維度：

必要	adType
選用	天

指標：

使用 1 個以上

grossRevenue、adImpressions、cpm

篩選器：

請使用 0 或 1	video、group
請使用 0 或 1	country、Europe、subContinent

YouTube Analytics API: Channel Reports

擷取報表

授權

濾鏡

瞭解報表表格

報表表格術語

影片報表

基本統計資料

基本的使用者活動統計資料

美國各州的基本使用者活動統計資料

根據時間

特定時間範圍內的使用者活動 (按國家/地區劃分)

特定時間範圍內，美國境內的使用者活動

使用者地理位置

使用者活動 (按國家/地區劃分)

使用者活動 (依省分組)

使用者活動 (按城市劃分) (<= 250 筆結果)

播放詳細資料

使用者活動 (依訂閱狀態區分)

使用者活動 (依州/省的訂閱狀態劃分)

含有選用時間維度的播放詳細資料

含有選用時間維度和 liveOrOnDemand 統計資料的播放詳細資料

含有選用時間維度和 averageViewPercentage 指標的播放詳細資料

各國家/地區的播放詳細資料

依國家/地區顯示 liveOrOnDemand 統計資料的播放詳細資料

依國家/地區顯示 averageViewPercentage 指標

各州/省的播放詳細資料

使用 liveOrOnDemand 統計資料的各州/省播放詳細資料

使用 averageViewPercentage 指標各州的播放詳細資料

播放位置

影片播放位置報表

播放位置詳細資料 (<= 25 筆結果)

流量來源

流量來源

流量來源詳細資料 (<= 25 個結果)

裝置類型和作業系統

裝置類型

作業系統

作業系統和裝置類型

觀眾客層

參與度和內容分享

觀眾續看率

熱門影片

顯示區域性篩選條件的熱門影片 (<= 200 筆結果)

各州/省的熱門影片 (<= 200 筆結果)

訂閱頻道或未訂閱觀眾的熱門影片 (<= 200 筆結果)

YouTube 產品的熱門影片 (<= 200 筆結果)

顯示播放詳細資料篩選器的熱門影片 (<= 200 筆結果)

播放清單報表

匯總影片指標

播放清單中的指標

支援的播放清單指標

基本統計資料

根據時間

使用者地理位置

播放清單活動 (依國家/地區區分)

播放清單活動 (按州/省劃分)

播放位置

播放位置詳細資料 (<= 25 筆結果)

流量來源

流量來源詳細資料 (<= 25 個結果)

裝置類型和作業系統

裝置類型

作業系統

作業系統和裝置類型

觀眾客層

熱門播放清單

廣告成效報表

按廣告類型劃分的廣告成效