YouTube Analytics API: Channel Reports

Trang này liệt kê những báo cáo mà chủ sở hữu kênh có thể truy xuất bằng API YouTube Analytics. Báo cáo kênh cung cấp chỉ số hoạt động của người dùng cho một kênh cụ thể và đo lường các chỉ số như lượt xem video, xếp hạng và số lượng đăng ký.

• Báo cáo video cung cấp số liệu thống kê cho tất cả hoạt động của người dùng liên quan đến video của một kênh.
• Báo cáo danh sách phát cung cấp số liệu thống kê có liên quan cụ thể đến lượt xem video xảy ra trong bối cảnh của một danh sách phát.

• Báo cáo hiệu suất quảng cáo chứa các chỉ số liên quan đến doanh thu và hiệu suất quảng cáo. Chúng sử dụng thứ nguyên adType để nhóm các chỉ số dựa trên loại quảng cáo chạy trong khi phát video. Phần báo cáo hiệu suất quảng cáo giải thích hai loại chỉ số hiệu suất quảng cáo mà API hỗ trợ.

Truy xuất báo cáo

Để truy xuất báo cáo kênh, bạn phải đặt giá trị tham số ids trong yêu cầu API thành một trong các giá trị sau:

• channel==MINE – API trả về dữ liệu cho kênh YouTube của người dùng đã xác thực.

• channel==CHANNEL_ID – Đặt CHANNEL_ID thành mã nhận dạng kênh duy nhất của kênh mà bạn đang truy xuất dữ liệu. Người dùng uỷ quyền cho yêu cầu phải là chủ sở hữu kênh.

  Mã nhận dạng kênh hiện là một chuỗi bắt đầu bằng các chữ cái UC, mặc dù định dạng của mã này có thể thay đổi. (Bạn có thể tìm thấy mã nhận dạng kênh trên trang cài đặt tài khoản nâng cao cho kênh YouTube của mình, hoặc bạn có thể truy xuất mã nhận dạng kênh theo cách lập trình bằng phương thức YouTube Data API's channels.list.)

Ủy quyền

Tất cả yêu cầu API YouTube Analytics đều phải được cho phép. Hướng dẫn uỷ quyền giải thích cách sử dụng giao thức OAuth 2.0 để truy xuất mã uỷ quyền.

Yêu cầu API YouTube Analytics sử dụng các phạm vi uỷ quyền sau:

Phạm vi
https://www.googleapis.com/auth/yt-analytics.readonly	Xem báo cáo YouTube Analytics dành cho nội dung của bạn trên YouTube. Phạm vi này cung cấp quyền truy cập vào các chỉ số hoạt động của người dùng, chẳng hạn như số lượt xem và số lượt xếp hạng.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly	Xem báo cáo tiền trên YouTube Analytics cho nội dung trên YouTube của bạn. Phạm vi này cấp quyền truy cập vào các chỉ số về hoạt động của người dùng, cũng như các chỉ số về doanh thu và hiệu suất quảng cáo ước tính.
https://www.googleapis.com/auth/youtube	Quản lý tài khoản YouTube của bạn. Trong API YouTube Analytics, chủ sở hữu kênh sử dụng phạm vi này để quản lý các nhóm và mục trong nhóm trong YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner	Xem và quản lý tài sản và nội dung liên quan trên YouTube. Trong API YouTube Analytics, chủ sở hữu nội dung sử dụng phạm vi này để quản lý các nhóm và các mục trong nhóm trong YouTube Analytics.

Lưu ý: Các chỉ số về doanh thu và hiệu suất quảng cáo ước tính hiện chưa được hỗ trợ cho báo cáo kênh. Do đó, phạm vi https://www.googleapis.com/auth/yt-analytics-monetary.readonly hiện không cấp quyền truy cập vào dữ liệu tiền tệ trong các báo cáo đó.

Bộ lọc

Các bảng giải thích về các báo cáo được hỗ trợ sẽ xác định những bộ lọc có thể dùng cho mỗi báo cáo. Trong bảng, bạn không bắt buộc phải sử dụng các bộ lọc xuất hiện trong dấu ngoặc đơn. Ví dụ: Đối với lựa chọn lọc video(,country), bạn cần phải dùng bộ lọc video còn bộ lọc quốc gia là không bắt buộc.

API này cũng hỗ trợ khả năng chỉ định nhiều giá trị cho các bộ lọc video và playlist. Nếu chỉ định nhiều giá trị cho một trong các bộ lọc này, bạn cũng có thể thêm bộ lọc đó vào danh sách phương diện mà bạn chỉ định cho yêu cầu. Điều này đúng ngay cả khi bộ lọc không được liệt kê là phương diện được hỗ trợ cho một báo cáo cụ thể.

Hãy xem định nghĩa tham số filters để biết nội dung giải thích đầy đủ về cách lọc kết quả API theo một giá trị hoặc tập hợp giá trị cụ thể.

Tìm hiểu về bảng báo cáo

Phần này giải thích định dạng và thuật ngữ dùng trong các bảng xác định các báo cáo mà API hỗ trợ. Bảng dưới đây liệt kê các phương diện, chỉ số và bộ lọc được hỗ trợ cho báo cáo video có thông tin chi tiết về lượt phát bằng cách sử dụng phương diện thời gian và chỉ số averageViewPercentage.

Nội dung
Phương diện:	Sử dụng từ 0 trở lên creatorContentType, subscribedStatus, youtubeProduct Sử dụng 0 hoặc 1 ngày, tháng
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Bộ lọc:	Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Sử dụng 0 hoặc 1 video, nhóm Sử dụng từ 0 trở lên subscribedStatus, youtubeProduct

Bảng này có hai hàng cho phương diện, 1 hàng cho chỉ số và 3 hàng cho bộ lọc. Đối với các phương diện và bộ lọc, bạn có thể kết hợp các giá trị trong mỗi hàng trong một yêu cầu API, miễn là tổ hợp đó tuân thủ các quy tắc sử dụng trong bảng. Vì vậy, ví dụ: các giá trị thông số dimensions hợp lệ cho báo cáo này bao gồm:

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

Tuy nhiên, giá trị tham số day,month không hợp lệ vì sử dụng hai phương diện dựa trên thời gian, nhưng yêu cầu có thể dùng 0 hoặc 1. Trong trường hợp này, giá trị thông số subscribedStatus,youtubeProduct thực sự sẽ trả về báo cáo, nhưng các chỉ số không được tổng hợp theo ngày, tuần, tháng, v.v. (Báo cáo đó được nêu riêng trong tài liệu.)

Thuật ngữ trong bảng báo cáo

Các bảng sử dụng các thuật ngữ sau đây để cho biết phương diện là bắt buộc hay không bắt buộc:

• Những điều khoản này có nghĩa là một giá trị bắt buộc:
  • Bắt buộc: Bạn phải thêm giá trị.
  • Sử dụng chính xác 1: Bạn phải thêm một giá trị trong nhóm.
  • Sử dụng 1 hoặc nhiều giá trị: Bạn có thể bao gồm bất kỳ hoặc tất cả giá trị trong nhóm, nhưng bạn phải đưa vào ít nhất một giá trị.
• Những cụm từ này có nghĩa là bạn không bắt buộc phải cung cấp giá trị:
  • Không bắt buộc: Bạn có thể thêm giá trị.
  • Sử dụng 0 hoặc 1: Bạn có thể chọn một giá trị trong nhóm.
  • Sử dụng từ 0 trở lên: Bạn có thể chọn bao gồm bất kỳ hoặc tất cả giá trị trong nhóm.

Báo cáo video

Số liệu thống kê cơ bản

Số liệu thống kê cơ bản về hoạt động của người dùng

Báo cáo này cung cấp số liệu thống kê liên quan đến hành động của người dùng trên một kênh. Bạn có thể lọc báo cáo để chỉ trả về dữ liệu cho một video hoặc quốc gia cụ thể.

Nội dung
Phương diện:	[Không có]
Chỉ số:	Sử dụng từ 1 trở lên redViewsvideosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
Bộ lọc:	Sử dụng 0 hoặc 1 quốc gia, lục địa, subContinent Sử dụng 0 hoặc 1 video, nhóm

Số liệu thống kê cơ bản về hoạt động của người dùng ở các tiểu bang của Hoa Kỳ

Báo cáo này cung cấp số liệu thống kê cho một tiểu bang cụ thể của Hoa Kỳ hoặc Đặc khu Columbia. Xin lưu ý rằng báo cáo này chỉ hỗ trợ một số chỉ số có trong báo cáo theo quốc gia cụ thể được mô tả ở trên.

Nội dung
Phương diện:	[Không có]
Chỉ số:	Sử dụng từ 1 trở lên mỗi lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
Bộ lọc:	Bắt buộc province Sử dụng 0 hoặc 1 video, nhóm

Dựa trên thời gian

Hoạt động của người dùng theo quốc gia trong các khoảng thời gian cụ thể

Báo cáo này cung cấp số liệu thống kê liên quan đến hành động của người dùng trên một kênh theo các khoảng thời gian cụ thể. Bạn có thể lọc báo cáo để chỉ trả về dữ liệu cho một video hoặc quốc gia cụ thể.

Nội dung
Phương diện:	Sử dụng đúng 1 ngày, tháng Không bắt buộc creatorContentType
Chỉ số:	Sử dụng từ 1 trở lên redViewsvideosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
Bộ lọc:	Sử dụng 0 hoặc 1 quốc gia, lục địa, subContinent Sử dụng 0 hoặc 1 video, nhóm

Hoạt động của người dùng ở các tiểu bang của Hoa Kỳ trong các khoảng thời gian cụ thể

Báo cáo này cung cấp số liệu thống kê liên quan đến hoạt động của người dùng ở một tiểu bang cụ thể của Hoa Kỳ hoặc Đặc khu Columbia. Xin lưu ý rằng báo cáo này chỉ hỗ trợ một số chỉ số có trong báo cáo theo quốc gia cụ thể được mô tả ở trên.

Nội dung
Phương diện:	Sử dụng đúng 1 ngày, tháng Không bắt buộc creatorContentType
Chỉ số:	Sử dụng từ 1 trở lên mỗi lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
Bộ lọc:	Bắt buộc province Sử dụng 0 hoặc 1 video, nhóm

Khu vực địa lý của người dùng

Hoạt động của người dùng theo quốc gia

Báo cáo này cung cấp số liệu thống kê liên quan đến hoạt động của người dùng theo từng quốc gia đối với một kênh. Bạn có thể lọc báo cáo để chỉ trả về dữ liệu của một video cụ thể.

Nội dung
Phương diện:	Bắt buộc country Không bắt buộc creatorContentType
Chỉ số:	Sử dụng từ 1 trở lên redViewsvideosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
Bộ lọc:	Sử dụng 0 hoặc 1 lục địa, subContinent Sử dụng 0 hoặc 1 video, nhóm

Hoạt động của người dùng theo tỉnh

Báo cáo này cung cấp số liệu thống kê về hoạt động của người dùng ở các tiểu bang của Hoa Kỳ và Đặc khu Columbia. Đối với báo cáo này, bạn phải đặt giá trị thông số filters thành country==US.

Nội dung
Phương diện:	Bắt buộc province Không bắt buộc creatorContentType
Chỉ số:	Sử dụng từ 1 trở lên mỗi lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
Bộ lọc:	Bắt buộc country=Hoa Kỳ Sử dụng 0 hoặc 1 video, nhóm

Hoạt động của người dùng theo thành phố (<= 250 kết quả)

Lưu ý: Báo cáo này yêu cầu bạn đặt tham số maxResults thành một giá trị số nguyên từ 250 trở xuống. Không giống như hầu hết các báo cáo khác, báo cáo này cũng yêu cầu bạn chỉ định giá trị cho tham số yêu cầu sort.

Báo cáo này cung cấp số liệu thống kê về hoạt động của người dùng theo thành phố.

Nội dung
Phương diện:	Bắt buộc city Sử dụng từ 0 trở lên creatorContentType, country, tỉnh, subscribedStatus Lưu ý: Nếu thêm phương diện tỉnh thì bạn cũng phải sử dụng bộ lọc country==US. Sử dụng 0 hoặc 1 ngày, tháng
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched, averageViewDuration, averageViewPercentage
Bộ lọc:	Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Sử dụng 0 hoặc 1 video, nhóm
Tuỳ chọn sắp xếp:	-lượt xem -estimatedMinutesWatched

Thông tin chi tiết về quá trình phát

Báo cáo chi tiết về lượt phát cung cấp số liệu thống kê liên quan đến các thuộc tính xem sau:

• Quan điểm của video phát sóng trực tiếp hay video theo yêu cầu?
• Người xem có đăng ký kênh sở hữu video không?
• Lượt xem này xảy ra trên sản phẩm nào của YouTube?

Lưu ý: Bạn không thể dùng phương diện và bộ lọc liveOrOnDemand cùng với chỉ số averageViewPercentage. Do đó, mỗi tiểu mục sau đây liệt kê hai báo cáo. Một báo cáo hỗ trợ phương diện liveOrOnDemand (và bộ lọc), trong khi báo cáo còn lại hỗ trợ chỉ số averageViewPercentage.

Hoạt động của người dùng theo trạng thái đã đăng ký

Báo cáo này cung cấp chỉ số về hoạt động của người dùng đối với người xem đã đăng ký và chưa đăng ký. Bạn có thể nhóm số liệu thống kê theo khoảng thời gian (ngày hoặc tháng), và lọc báo cáo theo quốc gia, Châu lục hoặc subContinent.

Nội dung
Phương diện:	Sử dụng từ 0 trở lên creatorContentType, subscribedStatus Sử dụng 0 hoặc 1 ngày, tháng
Chỉ số:	Sử dụng từ 1 trở lên 37,redViewsvideosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
Bộ lọc:	Sử dụng 0 hoặc 1 quốc gia, lục địa, subContinent Sử dụng 0 hoặc 1 video, nhóm Không bắt buộc subscribedStatus

Hoạt động của người dùng theo trạng thái đã đăng ký ở các tỉnh

Báo cáo này cung cấp chỉ số về hoạt động của người dùng đối với người xem đã đăng ký và chưa đăng ký ở các tiểu bang của Hoa Kỳ hoặc Đặc khu Columbia. Báo cáo này hỗ trợ ít chỉ số hơn so với báo cáo trước đó.

Nội dung
Phương diện:	Sử dụng từ 0 trở lên creatorContentType, subscribedStatus Sử dụng 0 hoặc 1 ngày, tháng
Chỉ số:	Sử dụng từ 1 trở lên mỗi lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
Bộ lọc:	Sử dụng 0 hoặc 1 video, nhóm Sử dụng từ 0 trở lên tỉnh, subscribedStatus

Chi tiết lượt phát với phương diện thời gian không bắt buộc

Phương diện thời gian – ngày hoặc tháng – là không bắt buộc cho các báo cáo này bởi vì, dù vậy, bạn vẫn cần phải sử dụng thông số yêu cầu startDate và endDate để chỉ định phạm vi ngày mà báo cáo sẽ áp dụng. Phương diện (nếu có) cho biết rằng bạn muốn dữ liệu trong báo cáo được tổng hợp theo ngày, tháng, v.v.

Chi tiết về nội dung phát với tham số thời gian không bắt buộc và số liệu thống kê liveOrOnDemand

Báo cáo này cung cấp số liệu thống kê chi tiết về lượt phát trong các khoảng thời gian cụ thể. Bảng này hỗ trợ phương diện liveOrOnDemand (và bộ lọc).

Nội dung
Phương diện:	Sử dụng từ 0 trở lên creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct Sử dụng 0 hoặc 1 ngày, tháng
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Bộ lọc:	Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Sử dụng 0 hoặc 1 video, nhóm Sử dụng từ 0 trở lên liveOrOnDemand, subscribedStatus, youtubeProduct

Thông tin chi tiết về lượt phát lại với phương diện thời gian không bắt buộc và chỉ số averageViewPercentage

Báo cáo này cung cấp số liệu thống kê chi tiết về lượt phát trong các khoảng thời gian cụ thể. Công cụ này hỗ trợ chỉ số averageViewPercentage.

Nội dung
Phương diện:	Sử dụng từ 0 trở lên creatorContentType, subscribedStatus, youtubeProduct Sử dụng 0 hoặc 1 ngày, tháng
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Bộ lọc:	Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Sử dụng 0 hoặc 1 video, nhóm Sử dụng từ 0 trở lên subscribedStatus, youtubeProduct

Thông tin chi tiết về việc phát theo quốc gia

Thông tin chi tiết về lượt phát theo quốc gia qua số liệu thống kê liveOrOnDemand

Báo cáo này cung cấp số liệu thống kê chi tiết về lượt phát theo từng quốc gia. Bảng này hỗ trợ phương diện liveOrOnDemand (và bộ lọc).

Nội dung
Phương diện:	Bắt buộc country Sử dụng từ 0 trở lên creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Bộ lọc:	Sử dụng 0 hoặc 1 lục địa, subContinent Sử dụng 0 hoặc 1 video, nhóm Sử dụng từ 0 trở lên liveOrOnDemand, subscribedStatus, youtubeProduct

Thông tin chi tiết về lượt phát lại theo quốc gia với chỉ số averageViewPercentage

Báo cáo sau đây tương tự như báo cáo trước. Phần này hỗ trợ thêm cho chỉ số averageViewPercentage, nhưng không hỗ trợ liveOrOnDemand dưới dạng phương diện hoặc bộ lọc.

Nội dung
Phương diện:	Bắt buộc country Sử dụng từ 0 trở lên creatorContentType, subscribedStatus, youtubeProduct
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Bộ lọc:	Sử dụng 0 hoặc 1 lục địa, subContinent Sử dụng 0 hoặc 1 video, nhóm Sử dụng từ 0 trở lên subscribedStatus, youtubeProduct

Thông tin chi tiết về việc phát theo tỉnh

Thông tin chi tiết về nội dung phát theo tỉnh bằng số liệu thống kê liveOrOnDemand

Báo cáo này cung cấp số liệu thống kê chi tiết về việc phát video ở các tiểu bang tại Hoa Kỳ và Đặc khu Columbia. Bảng này hỗ trợ phương diện liveOrOnDemand (và bộ lọc).

Nội dung
Phương diện:	Bắt buộc province Sử dụng từ 0 trở lên creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Bộ lọc:	Bắt buộc quốc gia==US Sử dụng 0 hoặc 1 video, nhóm Sử dụng từ 0 trở lên liveOrOnDemand, subscribedStatus, youtubeProduct

Thông tin chi tiết về lượt phát lại theo tỉnh với chỉ số averageViewPercentage

Báo cáo sau đây tương tự như báo cáo trước. Phần này hỗ trợ thêm cho chỉ số averageViewPercentage, nhưng không hỗ trợ liveOrOnDemand dưới dạng phương diện hoặc bộ lọc.

Nội dung
Phương diện:	Bắt buộc province Sử dụng từ 0 trở lên creatorContentType, subscribedStatus, youtubeProduct
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Bộ lọc:	Bắt buộc quốc gia==US Sử dụng 0 hoặc 1 video, nhóm Sử dụng từ 0 trở lên subscribedStatus, youtubeProduct

Vị trí phát

Báo cáo vị trí phát video

Báo cáo này cung cấp số liệu thống kê liên quan đến loại trang hoặc ứng dụng nơi xảy ra lượt phát lại video.

Nội dung
Phương diện:	Bắt buộc insightPlaybackLocationType Sử dụng từ 0 trở lên creatorContentType, ngày, liveOrOnDemand, subscribedStatus
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched
Bộ lọc:	Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Sử dụng 0 hoặc 1 video, nhóm Sử dụng từ 0 trở lên liveOrOnDemand, subscribedStatus

Thông tin chi tiết về vị trí phát (<= 25 kết quả)

Lưu ý: Báo cáo này yêu cầu bạn đặt tham số maxResults thành một giá trị số nguyên từ 25 trở xuống. Không giống như hầu hết các báo cáo khác, báo cáo này cũng yêu cầu bạn chỉ định giá trị cho tham số yêu cầu sort.

Báo cáo này xác định các trình phát video được nhúng tạo ra nhiều lượt xem hoặc thời gian xem nhất cho video của một kênh.

Nội dung
Phương diện:	Bắt buộc insightPlaybackLocationDetail Không bắt buộc creatorContentType
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched
Bộ lọc:	Bắt buộc insightPlaybackLocationType==EMBEDDED Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Sử dụng 0 hoặc 1 video, nhóm Sử dụng từ 0 trở lên liveOrOnDemand, subscribedStatus
Tuỳ chọn sắp xếp:	-lượt xem -estimatedMinutesWatched

Nguồn lưu lượng truy cập

Nguồn lưu lượng truy cập

Báo cáo này tổng hợp số liệu thống kê về lượt xem dựa trên cách người xem tiếp cận nội dung video của bạn. Ví dụ: chỉ số này xác định số lượt xem bắt nguồn từ một lượt tìm kiếm trên Google hoặc từ một đường liên kết đến một video có liên quan.

Nội dung
Phương diện:	Bắt buộc insightTrafficSourceType Sử dụng từ 0 trở lên creatorContentType, ngày, liveOrOnDemand, subscribedStatus
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched
Bộ lọc:	Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Sử dụng 0 hoặc 1 video, nhóm Sử dụng từ 0 trở lên liveOrOnDemand, subscribedStatus

Chi tiết nguồn lưu lượng truy cập (<= 25 kết quả)

Lưu ý: Báo cáo này yêu cầu bạn đặt tham số maxResults thành một giá trị số nguyên từ 25 trở xuống. Không giống như hầu hết các báo cáo khác, báo cáo này cũng yêu cầu bạn chỉ định giá trị cho tham số yêu cầu sort.

Báo cáo này tổng hợp số liệu thống kê về lượt xem dựa trên các đường liên kết giới thiệu đã tạo ra nhiều lượt xem nhất cho nội dung của kênh. Đường liên kết giới thiệu được phân loại theo loại nguồn lưu lượng truy cập và định nghĩa của phương diện insightTrafficSourceDetail sẽ xác định các nguồn lưu lượng truy cập có sẵn trong báo cáo. Ví dụ: Nếu bạn đặt bộ lọc insightTrafficSourceType thành ADVERTISING, thì báo cáo sẽ liệt kê các loại quảng cáo mang lại nhiều lượt xem hoặc thời gian xem nhất cho nội dung của kênh.

Nội dung
Phương diện:	Bắt buộc insightTrafficSourceDetail Không bắt buộc creatorContentType
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched
Bộ lọc:	Bắt buộc insightTrafficSourceType (xem ghi chú bên dưới trong bảng) Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Sử dụng 0 hoặc 1 video, nhóm Sử dụng từ 0 trở lên liveOrOnDemand, subscribedStatus
Tuỳ chọn sắp xếp:	-lượt xem -estimatedMinutesWatched

Lưu ý: Báo cáo này chỉ được hỗ trợ cho các nguồn lưu lượng truy cập cụ thể. Ví dụ: nguồn lưu lượng truy cập NO_LINK_EMBEDDED không có thông tin chi tiết bổ sung và do đó, không hỗ trợ báo cáo này. Xem định nghĩa insightTrafficSourceType để biết thông tin chi tiết về những nguồn lưu lượng truy cập hỗ trợ báo cáo này.

Loại thiết bị và hệ điều hành

Loại thiết bị

Báo cáo này tổng hợp số liệu thống kê về lượt xem dựa trên cách người xem tiếp cận nội dung video của bạn. Ví dụ: chỉ số này xác định số lượt xem trên thiết bị di động hoặc máy chơi trò chơi.

Nội dung
Phương diện:	Bắt buộc deviceType Sử dụng từ 0 trở lên creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched
Bộ lọc:	Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Sử dụng 0 hoặc 1 video, nhóm Sử dụng từ 0 trở lên operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

Hệ điều hành

Báo cáo này tổng hợp số liệu thống kê về hoạt động xem dựa trên hệ điều hành của người xem. Ví dụ: chỉ số này xác định số lượt xem xảy ra trên thiết bị Android hoặc trên PlayStation.

Nội dung
Phương diện:	Bắt buộc operatingSystem Sử dụng từ 0 trở lên creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched
Bộ lọc:	Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Sử dụng 0 hoặc 1 video, nhóm Sử dụng từ 0 trở lên deviceType, liveOrOnDemand, subscribedStatus, youtubeProduct

Hệ điều hành và loại thiết bị

Báo cáo này tổng hợp số liệu thống kê về hoạt động xem dựa trên hệ điều hành và loại thiết bị của người xem. Ví dụ: chỉ số này xác định số lượt xem trên máy tính bảng Android hoặc trên thiết bị máy tính chạy Windows.

Nội dung
Phương diện:	Bắt buộc deviceType, operatingSystem Sử dụng từ 0 trở lên creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched
Bộ lọc:	Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Sử dụng 0 hoặc 1 video, nhóm Sử dụng từ 0 trở lên liveOrOnDemand, subscribedStatus, youtubeProduct

Thông tin nhân khẩu học của người xem

Báo cáo này tổng hợp số liệu thống kê về hoạt động xem dựa trên nhóm tuổi và giới tính của người xem.

Nội dung
Phương diện:	Sử dụng từ 1 trở lên ageGroup, gender Sử dụng từ 0 trở lên creatorContentType, liveOrOnDemand, subscribedStatus
Chỉ số:	Sử dụng từ 1 trở lên viewerPercentage
Bộ lọc:	Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Sử dụng 0 hoặc 1 video, nhóm Sử dụng từ 0 trở lên liveOrOnDemand, subscribedStatus

Hoạt động tương tác và chia sẻ nội dung

Báo cáo này cung cấp số liệu thống kê cho biết tần suất video của kênh đó được chia sẻ trên nhiều nền tảng mạng xã hội.

Nội dung
Phương diện:	Bắt buộc sharingService Sử dụng từ 0 trở lên creatorContentType, subscribedStatus
Chỉ số:	Sử dụng từ 1 trở lên lượt chia sẻ
Bộ lọc:	Sử dụng 0 hoặc 1 quốc gia, lục địa, subContinent Sử dụng 0 hoặc 1 video, nhóm Không bắt buộc subscribedStatus

Tỷ lệ giữ chân người xem

Báo cáo này đo lường khả năng giữ chân người xem của video. Phương diện elapsedVideoTimeRatio đo lường thời lượng video đã trôi qua cho các giá trị chỉ số tương ứng. Chỉ số audienceWatchRatio và relativeRetentionPerformance là hai chỉ số đo lường khả năng giữ chân người xem của video. Chỉ số đầu tiên là một giá trị tuyệt đối, còn chỉ số thứ hai cho biết hiệu suất của video đó so với các video khác trên YouTube có thời lượng tương tự.

Lưu ý: Báo cáo tỷ lệ giữ chân người xem không hỗ trợ tính năng chỉ định danh sách các giá trị được phân tách bằng dấu phẩy cho bộ lọc video; giá trị này phải chỉ định một mã video.

Nội dung
Phương diện:	Bắt buộc elapsedVideoTimeRatio Không bắt buộc creatorContentType
Chỉ số:	Sử dụng từ 1 trở lên audienceWatchRatio, relativeRetentionPerformance
Bộ lọc:	Bắt buộc video Sử dụng từ 0 trở lên audienceType, subscribedStatus, youtubeProduct

Video hàng đầu

Lưu ý: Những báo cáo này yêu cầu bạn phải đặt thông số maxResults thành một giá trị số nguyên từ 200 trở xuống. Trước ngày 1 tháng 1 năm 2013, chỉ có dữ liệu của 10 video hàng đầu. Không giống như hầu hết các báo cáo khác, các báo cáo này cũng yêu cầu bạn chỉ định giá trị cho tham số yêu cầu sort.

Các video hàng đầu có bộ lọc theo khu vực (không bắt buộc) (<= 200 kết quả)

Báo cáo này liệt kê những video hàng đầu của kênh. Bạn có thể lọc báo cáo này để liệt kê các video hàng đầu theo quốc gia, Châu lục hoặc subContinent.

Nội dung
Phương diện:	Bắt buộc video Không bắt buộc creatorContentType
Chỉ số:	Sử dụng từ 1 trở lên redViewsvideosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
Bộ lọc:	Sử dụng 0 hoặc 1 quốc gia, lục địa, subContinent
Tuỳ chọn sắp xếp:	-views -redViews -estimatedRevenue -estimatedRedPartnerRevenue -estimatedMinutesWatched -estimatedRedMinutesWatched -subscribersGained -subscribersLost

Các video hàng đầu theo tiểu bang (<= 200 kết quả)

Báo cáo này liệt kê những video hàng đầu của kênh ở một tiểu bang cụ thể tại Hoa Kỳ hoặc Đặc khu Columbia. Xin lưu ý rằng báo cáo này chỉ hỗ trợ một số chỉ số có trong báo cáo theo quốc gia cụ thể được mô tả ở trên.

Nội dung
Phương diện:	Bắt buộc video Không bắt buộc creatorContentType
Chỉ số:	Sử dụng từ 1 trở lên mỗi lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
Bộ lọc:	Bắt buộc province Không bắt buộc subscribedStatus
Tuỳ chọn sắp xếp:	-views -redViews -estimatedMinutesWatched -estimatedRedMinutesWatched

Các video hàng đầu cho người xem đã đăng ký hoặc không đăng ký (<= 200 kết quả)

Báo cáo này liệt kê những video hàng đầu của kênh theo số lượng người xem đã đăng ký hoặc không đăng ký. Bạn có thể lọc báo cáo này để liệt kê các video hàng đầu theo quốc gia, Châu lục hoặc subContinent. Báo cáo trước đây cho phép bạn truy xuất các video hàng đầu ở một tiểu bang cụ thể tại Hoa Kỳ cho người xem đã đăng ký hoặc chưa đăng ký. Tuy nhiên, báo cáo này hỗ trợ ít chỉ số hơn so với báo cáo này.

Nội dung
Phương diện:	Bắt buộc video Không bắt buộc creatorContentType
Chỉ số:	Sử dụng từ 1 trở lên 37,redViewsvideosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
Bộ lọc:	Không bắt buộc subscribedStatus Sử dụng 0 hoặc 1 quốc gia, lục địa, subContinent
Tuỳ chọn sắp xếp:	-views -redViews -estimatedMinutesWatched -estimatedRedMinutesWatched

Các video hàng đầu theo sản phẩm YouTube (<= 200 kết quả)

Báo cáo này liệt kê các video hàng đầu của kênh và hỗ trợ bộ lọc chi tiết về nội dung phát cũng như bộ lọc địa lý. Báo cáo này tương tự như báo cáo trước, nhưng hỗ trợ ít chỉ số hơn và hỗ trợ thêm cho bộ lọc youtubeProduct.

Nội dung
Phương diện:	Bắt buộc video Không bắt buộc creatorContentType
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Bộ lọc:	Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Sử dụng từ 0 trở lên subscribedStatus, youtubeProduct
Tuỳ chọn sắp xếp:	-views -redViews -estimatedMinutesWatched -estimatedRedMinutesWatched

Những video hàng đầu được lọc chi tiết về việc phát (<= 200 kết quả)

Báo cáo này liệt kê các video hàng đầu của kênh, lọc theo bất kỳ hoặc tất cả phương diện chi tiết về lượt phát: liveOrOnDemand, subscribedStatus và youtubeProduct. Không giống như báo cáo trước, báo cáo này hỗ trợ bộ lọc liveOrOnDemand và không hỗ trợ chỉ số averageViewPercentage.

Nội dung
Phương diện:	Bắt buộc video Không bắt buộc creatorContentType
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Bộ lọc:	Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Sử dụng từ 0 trở lên liveOrOnDemand, subscribedStatus, youtubeProduct
Tuỳ chọn sắp xếp:	-views -redViews -estimatedMinutesWatched -estimatedRedMinutesWatched

Báo cáo danh sách phát

Báo cáo danh sách phát chứa các chỉ số liên quan đến hoạt động của người dùng liên quan đến các video trong danh sách phát của chủ sở hữu kênh. Các báo cáo này có hai phiên bản và đối với mỗi báo cáo hiện có, các phần sau đây sẽ có nội dung mô tả về từng phiên bản:

• Thẻ Recommended (Đề xuất) trong mỗi phần mô tả định dạng yêu cầu API ưu tiên để truy xuất báo cáo tương ứng. Những báo cáo đề xuất hỗ trợ một bộ chỉ số mở rộng bao gồm cả chỉ số tổng hợp về video và chỉ số trong danh sách phát. Định dạng yêu cầu này không sử dụng phương diện isCurated.
• Thẻ Sử dụng isCurated trong mỗi phần mô tả một định dạng yêu cầu API cũ, trong đó bắt buộc phải có phương diện isCurated. Những báo cáo này chỉ hỗ trợ các chỉ số trong danh sách phát. Xin lưu ý rằng chúng tôi đã ngừng sử dụng phương diện isCurated trong tất cả các báo cáo. Ghi chú cảnh báo bên dưới giải thích về lịch trình ngừng sử dụng.

Lưu ý cảnh báo sau đây giải thích chi tiết hơn về những thay đổi giữa hai phiên bản báo cáo.

Chỉ số video tổng hợp

Các chỉ số này cho biết chỉ số về lượt hiển thị và hoạt động của người dùng được tổng hợp cho tất cả video trong danh sách phát mà kênh sở hữu danh sách phát đó sở hữu. Chỉ số của những video do các kênh khác sở hữu không được tính trong dữ liệu tổng hợp. Do đó, nếu một kênh tạo danh sách phát chỉ chứa video của các kênh khác, thì báo cáo về những danh sách phát đó sẽ không cung cấp giá trị cho những chỉ số này.

Xem phần các chỉ số được hỗ trợ cho danh sách phát để biết danh sách các chỉ số tổng hợp về video mà YouTube hỗ trợ.

Chỉ số trong danh sách phát

Các chỉ số này phản ánh hoạt động và mức độ tương tác của người dùng trong bối cảnh trang danh sách phát. Các chỉ số này bao gồm số lượt xem của tất cả video trong danh sách phát (bất kể kênh nào sở hữu video đó), nhưng chỉ tính số lượt xem xảy ra trong danh sách phát.

Các chỉ số được hỗ trợ của danh sách phát

Nên dùng

Nội dung
Chỉ số video tổng hợp	lượt xem, estimatedMinutesWatched, averageViewDuration
chỉ số trong danh sách phát	playlistViews, playlistEstimatedMinutesWatched, playlistAverageViewDuration, playlistSaves, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist

Sử dụng isCurated

Nội dung
Chỉ số video tổng hợp	Không được hỗ trợ
chỉ số trong danh sách phát	lượt xem, estimatedMinutesWatched, averageViewDuration, averageViewPercentage, redViews, estimatedRedMinutesWatched

Số liệu thống kê cơ bản

Báo cáo này cung cấp số liệu thống kê liên quan đến hoạt động tương tác của người dùng với các video trong danh sách phát của kênh. Bạn có thể lọc báo cáo để chỉ trả về dữ liệu của một danh sách phát cụ thể.

Được đề xuất

Nội dung
Phương diện:	[Không có]
Chỉ số:	Sử dụng từ 1 trở lên views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Bộ lọc:	Sử dụng đúng 1 danh sách phát, nhóm

Sử dụng isCurated

Nội dung
Phương diện:	[Không có]
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Bộ lọc:	Bắt buộc isCurated==1 (được lập trình) Sử dụng 0 hoặc 1 danh sách phát, nhóm Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Sử dụng từ 0 trở lên subscribedStatus, youtubeProduct

Dựa trên thời gian

Báo cáo này cung cấp số liệu thống kê liên quan đến hoạt động tương tác của người dùng với các video trong danh sách phát của kênh. Bạn có thể lọc báo cáo để chỉ trả về dữ liệu của một danh sách phát cụ thể.

Được đề xuất

Nội dung
Phương diện:	Sử dụng đúng 1 ngày, tháng
Chỉ số:	Sử dụng từ 1 trở lên views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Bộ lọc:	Sử dụng đúng 1 danh sách phát, nhóm

Sử dụng isCurated

Nội dung
Phương diện:	Sử dụng đúng 1 ngày, tháng Sử dụng từ 0 trở lên subscribedStatus, youtubeProduct
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Bộ lọc:	Bắt buộc isCurated==1 (được lập trình) Sử dụng 0 hoặc 1 danh sách phát, nhóm Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Sử dụng từ 0 trở lên subscribedStatus, youtubeProduct

Khu vực địa lý của người dùng

Hoạt động trong danh sách phát theo quốc gia

Báo cáo này cung cấp số liệu thống kê liên quan đến những lượt tương tác của người dùng ở một quốc gia cụ thể với các video trong danh sách phát của kênh.

Được đề xuất

Nội dung
Phương diện:	Bắt buộc country
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched, averageViewDuration
Bộ lọc:	Sử dụng đúng 1 danh sách phát, nhóm Sử dụng 0 hoặc 1 lục địa, subContinent

Sử dụng isCurated

Nội dung
Phương diện:	Bắt buộc country Sử dụng từ 0 trở lên subscribedStatus, youtubeProduct
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Bộ lọc:	Bắt buộc isCurated==1 (được lập trình) Sử dụng 0 hoặc 1 danh sách phát, nhóm Sử dụng 0 hoặc 1 lục địa, subContinent Sử dụng từ 0 trở lên subscribedStatus, youtubeProduct

Hoạt động danh sách phát theo tỉnh

Báo cáo này cung cấp số liệu thống kê về hoạt động của danh sách phát cho các tiểu bang tại Hoa Kỳ và Đặc khu Columbia. Đối với báo cáo này, bạn phải lọc kết quả để chỉ trả về dữ liệu của Hoa Kỳ.

Được đề xuất

Nội dung
Phương diện:	Bắt buộc province
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched, averageViewDuration
Bộ lọc:	Bắt buộc quốc gia==US Sử dụng đúng 1 danh sách phát, nhóm

Sử dụng isCurated

Nội dung
Phương diện:	Bắt buộc province
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Bộ lọc:	Bắt buộc isCurated==1;quốc gia==US Sử dụng 0 hoặc 1 danh sách phát, nhóm Sử dụng từ 0 trở lên subscribedStatus, youtubeProduct

Vị trí phát

Báo cáo này cung cấp số liệu thống kê liên quan đến loại trang hoặc ứng dụng sẽ phát video danh sách phát của bạn.

Được đề xuất

Nội dung
Phương diện:	Bắt buộc insightPlaybackLocationType
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Bộ lọc:	Sử dụng đúng 1 danh sách phát, nhóm

Sử dụng isCurated

Nội dung
Phương diện:	Bắt buộc insightPlaybackLocationType Sử dụng từ 0 trở lên ngày, subscribedStatus
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Bộ lọc:	Bắt buộc isCurated==1 (được lập trình) Sử dụng 0 hoặc 1 danh sách phát, nhóm Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Không bắt buộc subscribedStatus

Thông tin chi tiết về vị trí phát (<= 25 kết quả)

Lưu ý: Báo cáo này yêu cầu bạn đặt tham số maxResults thành một giá trị số nguyên từ 25 trở xuống. Không giống như hầu hết các báo cáo khác, báo cáo này cũng yêu cầu bạn chỉ định giá trị cho tham số yêu cầu sort.

Báo cáo này xác định những trình phát video được nhúng tạo ra nhiều lượt xem hoặc thời gian xem nhất cho các video trong danh sách phát của kênh.

Được đề xuất

Nội dung
Phương diện:	Bắt buộc insightPlaybackLocationDetail
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Bộ lọc:	Bắt buộc insightPlaybackLocationType==EMBEDDED Sử dụng đúng 1 danh sách phát, nhóm
Tuỳ chọn sắp xếp:	-playlistViews -playlistEstimatedMinutesWatched -playlistStarts

Sử dụng isCurated

Nội dung
Phương diện:	Bắt buộc insightPlaybackLocationDetail
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Bộ lọc:	Bắt buộc isCurated==1;insightPlaybackLocationType==EMBEDDED Sử dụng 0 hoặc 1 danh sách phát, nhóm Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Không bắt buộc subscribedStatus
Tuỳ chọn sắp xếp:	-views -estimatedMinutesWatched -playlistStarts

Nguồn lưu lượng truy cập

Báo cáo này tổng hợp số liệu thống kê về lượt xem dựa trên cách người xem tiếp cận nội dung danh sách phát của bạn. Ví dụ: chỉ số này xác định số lượt xem bắt nguồn từ một lượt tìm kiếm trên Google.

Được đề xuất

Nội dung
Phương diện:	Bắt buộc insightTrafficSourceType
Chỉ số:	Sử dụng từ 1 trở lên views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Bộ lọc:	Sử dụng đúng 1 danh sách phát, nhóm

Sử dụng isCurated

Nội dung
Phương diện:	Bắt buộc insightTrafficSourceType Sử dụng từ 0 trở lên ngày, subscribedStatus
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Bộ lọc:	Bắt buộc isCurated==1 (được lập trình) Sử dụng 0 hoặc 1 danh sách phát, nhóm Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Không bắt buộc subscribedStatus

Chi tiết nguồn lưu lượng truy cập (<= 25 kết quả)

Lưu ý: Báo cáo này yêu cầu bạn đặt tham số maxResults thành một giá trị số nguyên từ 25 trở xuống. Không giống như hầu hết các báo cáo khác, báo cáo này cũng yêu cầu bạn chỉ định một giá trị cho tham số yêu cầu sort.

Báo cáo này tổng hợp số liệu thống kê về lượt xem dựa trên các đường liên kết giới thiệu đã tạo ra nhiều lượt xem nhất cho các video trong danh sách phát của kênh. Đường liên kết giới thiệu được phân loại theo loại nguồn lưu lượng truy cập và định nghĩa của phương diện insightTrafficSourceDetail xác định các nguồn lưu lượng truy cập có sẵn cho báo cáo này.

Ví dụ: nếu bạn đặt bộ lọc insightTrafficSourceType thành ADVERTISING, thì báo cáo sẽ liệt kê các loại quảng cáo tạo ra lượt xem hoặc thời gian xem nhiều nhất cho danh sách phát của kênh.

Được đề xuất

Nội dung
Phương diện:	Bắt buộc insightTrafficSourceDetail
Chỉ số:	Sử dụng từ 1 trở lên views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Bộ lọc:	Bắt buộc insightTrafficSourceType==ADVERTISING (hoặc một giá trị khác được hỗ trợ) Sử dụng đúng 1 danh sách phát, nhóm
Tuỳ chọn sắp xếp:	-playlistViews -playlistEstimatedMinutesWatched -playlistStarts

Sử dụng isCurated

Nội dung
Phương diện:	Bắt buộc insightTrafficSourceDetail
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Bộ lọc:	Bắt buộc isCurated==1;insightTrafficSourceType==ADVERTISING (hoặc một giá trị khác được hỗ trợ) Sử dụng 0 hoặc 1 danh sách phát, nhóm Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Không bắt buộc subscribedStatus
Tuỳ chọn sắp xếp:	-views -estimatedMinutesWatched -playlistStarts

Lưu ý: Báo cáo này chỉ được hỗ trợ cho các nguồn lưu lượng truy cập cụ thể. Ví dụ: nguồn lưu lượng truy cập NO_LINK_EMBEDDED không có thông tin chi tiết bổ sung và do đó, không hỗ trợ báo cáo này. Xem định nghĩa insightTrafficSourceType để biết thông tin chi tiết về những nguồn lưu lượng truy cập hỗ trợ báo cáo này.

Loại thiết bị và hệ điều hành

Loại thiết bị

Báo cáo này tổng hợp số liệu thống kê về hoạt động xem dựa trên cách người xem tìm thấy những video trong danh sách phát của bạn. Ví dụ: chỉ số này xác định số lượt xem trên thiết bị di động hoặc máy chơi trò chơi.

Được đề xuất

Nội dung
Phương diện:	Bắt buộc deviceType
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Bộ lọc:	Sử dụng đúng 1 danh sách phát, nhóm

Sử dụng isCurated

Nội dung
Phương diện:	Bắt buộc deviceType Sử dụng từ 0 trở lên ngày, subscribedStatus, youtubeProduct
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Bộ lọc:	Bắt buộc isCurated==1 (được lập trình) Sử dụng 0 hoặc 1 danh sách phát, nhóm Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Sử dụng từ 0 trở lên operatingSystem, subscribedStatus, youtubeProduct

Hệ điều hành

Báo cáo này tổng hợp số liệu thống kê về hoạt động xem dựa trên hệ điều hành của người xem. Ví dụ: chỉ số này xác định số lượt xem xảy ra trên thiết bị Android hoặc trên PlayStation.

Được đề xuất

Nội dung
Phương diện:	Bắt buộc operatingSystem
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Bộ lọc:	Sử dụng đúng 1 danh sách phát, nhóm

Sử dụng isCurated

Nội dung
Phương diện:	Bắt buộc operatingSystem Sử dụng từ 0 trở lên ngày, subscribedStatus, youtubeProduct
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Bộ lọc:	Bắt buộc isCurated==1 (được lập trình) Sử dụng 0 hoặc 1 danh sách phát, nhóm Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Sử dụng từ 0 trở lên deviceType, subscribedStatus, youtubeProduct

Hệ điều hành và loại thiết bị

Báo cáo này tổng hợp số liệu thống kê về hoạt động xem dựa trên hệ điều hành và loại thiết bị của người xem. Ví dụ: công cụ này xác định số lượt xem trên máy tính bảng Android hoặc thiết bị máy tính chạy Windows.

Được đề xuất

Nội dung
Phương diện:	Bắt buộc deviceType, operatingSystem
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Bộ lọc:	Sử dụng đúng 1 danh sách phát, nhóm

Sử dụng isCurated

Nội dung
Phương diện:	Bắt buộc deviceType, operatingSystem Sử dụng từ 0 trở lên ngày, subscribedStatus, youtubeProduct
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Bộ lọc:	Bắt buộc isCurated==1 (được lập trình) Sử dụng 0 hoặc 1 danh sách phát, nhóm Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Sử dụng từ 0 trở lên subscribedStatus, youtubeProduct

Thông tin nhân khẩu học của người xem

Được đề xuất

Nội dung
Phương diện:	Sử dụng từ 1 trở lên ageGroup, gender
Chỉ số:	Bắt buộc viewerPercentage
Bộ lọc:	Sử dụng đúng 1 danh sách phát, nhóm

Sử dụng isCurated

Nội dung
Phương diện:	Sử dụng từ 1 trở lên ageGroup, gender Sử dụng từ 0 trở lên subscribedStatus
Chỉ số:	Bắt buộc viewerPercentage
Bộ lọc:	Bắt buộc isCurated==1 (được lập trình) Sử dụng 0 hoặc 1 danh sách phát, nhóm Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Không bắt buộc subscribedStatus

Lưu ý: Các giá trị viewerPercentage trong báo cáo này không được chuẩn hoá theo các giá trị khác nhau của phương diện chi tiết về lượt phát subscribedStatus.

Ví dụ: một báo cáo sử dụng phương diện subscribedStatus sẽ trả về tổng cộng 100% dữ liệu cho các lượt xem đã đăng ký và viewerPercentage cho đến 100% số lượt xem không đăng kýviewerPercentage (Tổng giá trị của tất cả các trường viewerPercentage trong báo cáo là 200%.)

Bạn có thể sử dụng bộ lọc để đảm bảo rằng báo cáo chỉ chứa dữ liệu viewerPercentage cho một giá trị của các phương diện subscribedStatus.

Danh sách phát hàng đầu

Lưu ý: Những báo cáo này yêu cầu bạn phải đặt thông số maxResults thành một giá trị số nguyên từ 200 trở xuống. Trước ngày 1 tháng 1 năm 2013, dữ liệu chỉ có sẵn đối với 10 danh sách phát hàng đầu. Không giống như hầu hết các báo cáo khác, các báo cáo này cũng yêu cầu bạn chỉ định giá trị cho tham số yêu cầu sort.

Báo cáo này liệt kê các danh sách phát hàng đầu của kênh dựa trên tiêu chí lọc và sắp xếp đã chỉ định.

Được đề xuất

Nội dung
Phương diện:	Bắt buộc danh sách phát
Chỉ số:	Sử dụng từ 1 trở lên averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Tuỳ chọn sắp xếp:	-playlistViews -playlistEstimatedMinutesWatched -playlistStarts

Sử dụng isCurated

Nội dung
Phương diện:	Bắt buộc danh sách phát
Chỉ số:	Sử dụng từ 1 trở lên lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Bộ lọc:	Bắt buộc isCurated==1 (được lập trình) Sử dụng 0 hoặc 1 quốc gia, tỉnh, lục địa, subContinent Sử dụng từ 0 trở lên danh sách phát, subscribedStatus, youtubeProduct
Tuỳ chọn sắp xếp:	-views -redViews -estimatedMinutesWatched -estimatedRedMinutesWatched -playlistStarts

Báo cáo hiệu quả hoạt động của quảng cáo

Lưu ý: Báo cáo hiệu suất quảng cáo yêu cầu mã thông báo uỷ quyền cấp quyền truy cập vào phạm vi https://www.googleapis.com/auth/yt-analytics-monetary.readonly.

Báo cáo hiệu suất quảng cáo cung cấp chỉ số dựa trên số lần hiển thị cho quảng cáo chạy trong quá trình phát lại video. Các chỉ số này tính đến từng lượt hiển thị quảng cáo và mỗi lượt phát video có thể mang lại nhiều lượt hiển thị.

Các chỉ số về hiệu suất của quảng cáo dựa trên số lượt hiển thị là:

• grossRevenue
• adImpressions
• cpm

Ngoài ra, một số báo cáo video hỗ trợ các chỉ số hiệu suất quảng cáo dựa trên lượt phát sau đây. Tuy nhiên, những chỉ số này không được đưa vào báo cáo hiệu suất quảng cáo.

• playbackBasedCpm
• monetizedPlaybacks

Hiệu suất quảng cáo theo loại quảng cáo

Nội dung
Phương diện:	Bắt buộc adType Không bắt buộc ngày
Chỉ số:	Sử dụng từ 1 trở lên grossRevenue, adImpressions, cpm
Bộ lọc:	Sử dụng 0 hoặc 1 video, nhóm Sử dụng 0 hoặc 1 quốc gia, lục địa, subContinent