YouTube Analytics API: Channel Reports

Trang này liệt kê các 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 các chỉ số về hoạt động của người dùng đối với một kênh cụ thể, đồng thời đo lường những chỉ số như số lượt xem video, điểm xếp hạng và số người đăng ký.

  • Báo cáo về video cung cấp số liệu thống kê về 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ê liên quan cụ thể đến số 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. Các chỉ số này sử dụng phương diệ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 về 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 này 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 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 của kênh trên trang cài đặt nâng cao của tài khoản cho kênh YouTube của mình hoặc bạn có thể truy xuất mã nhận dạng của kênh theo phương thức lập trình bằng phương thức YouTube Data API's channels.list.)

Ủy quyền

Mọi yêu cầu gửi đến 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ã thông báo uỷ quyền.

Các yêu cầu gửi đến 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 cho nội dung trên YouTube của bạn. Phạm vi này cung cấp quyền truy cập vào các chỉ số về 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 các báo cáo tài chính của YouTube Analytics cho nội dung trên YouTube của bạn. Phạm vi này cung 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 ước tính và hiệu suất quảng cáo.
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 trên YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner Xem và quản lý tài sản cũng như nội dung được liên kết 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à mục trong nhóm trên YouTube Analytics.

Lưu ý: Các chỉ số doanh thu ước tính và hiệu suất quảng cáo hiện không đượ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ề báo cáo được hỗ trợ sẽ xác định những bộ lọc có thể dùng cho từng 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 được thể hiện trong dấu ngoặc đơn. Ví dụ: đối với tuỳ chọn lọc video(,country), bạn bắt buộc phải sử dụng bộ lọc video và không bắt buộc phải sử dụng bộ lọc quốc gia.

API này cũng hỗ trợ khả năng chỉ định nhiều giá trị cho 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 cho 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 báo cáo mà API hỗ trợ. Bảng sau đâ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 về 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
Kích thước:
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 1 hoặc nhiều views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Bộ lọc:
Sử dụng 0 hoặc 1 country, province, continent, 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 chứa 2 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ị từ mỗi hàng trong một yêu cầu API, miễn là tổ hợp đó tuân theo các quy tắc sử dụng trong bảng. Ví dụ: các giá trị tham số dimensions hợp lệ cho báo cáo này bao gồm:

  • dimensions=day
  • dimensions=day,subscribedStatus
  • 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 và yêu cầu phải sử dụng 0 hoặc 1.

Thuật ngữ về bảng báo cáo

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

  • Các từ này có nghĩa là bạn phải cung cấp giá trị:
    • Bắt buộc: Bạn phải thêm giá trị này.
    • Sử dụng đúng 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ể đưa vào bất kỳ hoặc tất cả giá trị trong nhóm, nhưng phải đưa vào ít nhất một giá trị.
  • Các thuật ngữ này có nghĩa là giá trị không bắt buộc:
    • Không bắt buộc: Bạn có thể thêm giá trị này.
    • Sử dụng 0 hoặc 1: Bạn có thể chọn đưa một giá trị vào 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
Kích thước:
[Không có]
Chỉ số:
Sử dụng 1 hoặc nhiều lượt xem, redViews, bình luận, lượt thích, lượt không thích, videosAddedToPlaylists, videosRemovedFromPlaylists, số lượt chia sẻ, 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*, doanh thu trên mỗi nghìn lượt hiển thị*
Bộ lọc:
Sử dụng 0 hoặc 1 country, continent, 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 ở 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 mô tả ở trên.

Nội dung
Kích thước:
[Không có]
Chỉ số:
Sử dụng 1 hoặc nhiều views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
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 trong những 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
Kích thước:
Sử dụng đúng 1 ngày, tháng
Không bắt buộc creatorContentType
Chỉ số:
Sử dụng 1 hoặc nhiều lượt xem, redViews, bình luận, lượt thích, lượt không thích, videosAddedToPlaylists, videosRemovedFromPlaylists, số lượt chia sẻ, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, số người dùng riêng biệt, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cPM*
Bộ lọc:
Sử dụng 0 hoặc 1 country, continent, 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 những 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 tại một tiểu bang cụ thể của Hoa Kỳ hoặc tại Đặ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 mô tả ở trên.

Nội dung
Kích thước:
Sử dụng đúng 1 ngày, tháng
Không bắt buộc creatorContentType
Chỉ số:
Sử dụng 1 hoặc nhiều views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Bộ lọc:
Bắt buộc province
Sử dụng 0 hoặc 1 video, nhóm

Vị trí đị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 cho một kênh. Bạn có thể lọc báo cáo để chỉ trả về dữ liệu cho một video cụ thể.

Nội dung
Kích thước:
Bắt buộc country
Không bắt buộc creatorContentType
Chỉ số:
Sử dụng 1 hoặc nhiều lượt xem, redViews, bình luận, lượt thích, lượt không thích, videosAddedToPlaylists, videosRemovedFromPlaylists, số lượt chia sẻ, 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*, doanh thu trên mỗi nghìn lượt hiển thị*
Bộ lọc:
Sử dụng 0 hoặc 1 continent, 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
Kích thước:
Bắt buộc province
Không bắt buộc creatorContentType
Chỉ số:
Sử dụng 1 hoặc nhiều views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Bộ lọc:
Bắt buộc country==US
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 một 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
Kích thước:
Bắt buộc city
Sử dụng từ 0 trở lên creatorContentType, country, province, subscribedStatus

Lưu ý: Nếu thêm phương diện province, 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 1 hoặc nhiều views, estimatedMinutesWatched, averageViewDuration, averageViewPercentage
Bộ lọc:
Sử dụng 0 hoặc 1 country, province, continent, subContinent
Sử dụng 0 hoặc 1 video, nhóm
Các lựa chọn sắp xếp: -views
-estimatedMinutesWatched

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

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 Khu vực thị trường được chỉ định (DMA). Đối với báo cáo này, bạn phải đặt giá trị tham số filters thành country==US hoặc lọc theo một tỉnh cụ thể (tiểu bang ở Hoa Kỳ).

Nội dung
Kích thước:
Bắt buộc dma
Sử dụng 0 hoặc 1 ngày
tháng
creatorContentType
subscribedStatus
Chỉ số:
Sử dụng 1 hoặc nhiều lượt xem
estimatedMinutesWatched
averageViewDuration
averageViewPercentage
Bộ lọc:
Sử dụng 0 hoặc 1 country==US
province
Sử dụng 0 hoặc 1 video
nhóm
Các lựa chọn sắp xếp: -views
-estimatedMinutesWatched

Thông tin chi tiết về việc 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:

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

Lưu ý: Bạn không thể sử 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 sẽ liệt kê hai báo cáo. Một báo cáo hỗ trợ phương diện (và bộ lọc) liveOrOnDemand, còn 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 các chỉ số về hoạt động của người dùng đối với những 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à cũng có thể lọc báo cáo theo quốc gia, lục địa hoặc subContinent.

Nội dung
Kích thước:
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 1 hoặc nhiều lượt xem, redViews, lượt thích, lượt không thích, videosAddedToPlaylists, videosRemovedFromPlaylists, số lượt chia sẻ, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Bộ lọc:
Sử dụng 0 hoặc 1 country, continent, 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ủa tỉnh

Báo cáo này cung cấp các chỉ số về hoạt động của người dùng đối với những 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
Kích thước:
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 1 hoặc nhiều views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Bộ lọc:
Sử dụng 0 hoặc 1 video, nhóm
Sử dụng từ 0 trở lên province, subscribedStatus

Thông tin chi tiết về lượt phát có 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 đối với các báo cáo này vì dù sao bạn cũng cần sử dụng các thông số yêu cầu startDate và endDate để chỉ định phạm vi ngày mà báo cáo sẽ bao gồm. Phương diện (nếu có) cho biết bạn muốn dữ liệu trong báo cáo được tổng hợp theo ngày, tháng, v.v.

Thông tin chi tiết về lượt phát có phương diện 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ể. Phương diện này hỗ trợ phương diện (và bộ lọc) liveOrOnDemand.

Nội dung
Kích thước:
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 1 hoặc nhiều views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Bộ lọc:
Sử dụng 0 hoặc 1 country, province, continent, 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 có 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ể. Phương diện này hỗ trợ chỉ số averageViewPercentage.

Nội dung
Kích thước:
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 1 hoặc nhiều views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Bộ lọc:
Sử dụng 0 hoặc 1 country, province, continent, 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ề lượt phát theo quốc gia

Thông tin chi tiết về lượt phát theo quốc gia kèm theo số liệu thống kê về 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. Phương diện này hỗ trợ phương diện (và bộ lọc) liveOrOnDemand.

Nội dung
Kích thước:
Bắt buộc country
Sử dụng từ 0 trở lên creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Chỉ số:
Sử dụng 1 hoặc nhiều views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Bộ lọc:
Sử dụng 0 hoặc 1 continent, 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 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. Phiên bản này hỗ trợ thêm 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
Kích thước:
Bắt buộc country
Sử dụng từ 0 trở lên creatorContentType, subscribedStatus, youtubeProduct
Chỉ số:
Sử dụng 1 hoặc nhiều views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Bộ lọc:
Sử dụng 0 hoặc 1 continent, 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ề lượt phát theo tỉnh, kèm theo số liệu thống kê về liveOrOnDemand

Báo cáo này cung cấp số liệu thống kê chi tiết về lượt phát ở các tiểu bang của Hoa Kỳ và Quận Columbia. Phương diện này hỗ trợ phương diện (và bộ lọc) liveOrOnDemand.

Nội dung
Kích thước:
Bắt buộc province
Sử dụng từ 0 trở lên creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Chỉ số:
Sử dụng 1 hoặc nhiều views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Bộ lọc:
Bắt buộc country==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 theo tỉnh với chỉ số averageViewPercentage

Báo cáo sau đây tương tự như báo cáo trước. Phiên bản này hỗ trợ thêm 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
Kích thước:
Bắt buộc province
Sử dụng từ 0 trở lên creatorContentType, subscribedStatus, youtubeProduct
Chỉ số:
Sử dụng 1 hoặc nhiều views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Bộ lọc:
Bắt buộc country==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 diễn ra lượt phát video.

Nội dung
Kích thước:
Bắt buộc insightPlaybackLocationType
Sử dụng từ 0 trở lên creatorContentType, day, liveOrOnDemand, subscribedStatus
Chỉ số:
Sử dụng 1 hoặc nhiều lượt xem, estimatedMinutesWatched
Bộ lọc:
Sử dụng 0 hoặc 1 country, province, continent, 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 một giá trị cho thông 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 của một kênh.

Nội dung
Kích thước:
Bắt buộc insightPlaybackLocationDetail
Không bắt buộc creatorContentType
Chỉ số:
Sử dụng 1 hoặc nhiều lượt xem, estimatedMinutesWatched
Bộ lọc:
Bắt buộc insightPlaybackLocationType==EMBEDDED
Sử dụng 0 hoặc 1 country, province, continent, subContinent
Sử dụng 0 hoặc 1 video, nhóm
Sử dụng từ 0 trở lên liveOrOnDemand, subscribedStatus
Các lựa chọn sắp xếp: -views
-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.

Lưu ý: Báo cáo này sẽ trả về lỗi nếu tích của số video được truy vấn X số ngày trong phạm vi ngày vượt quá 50.000. Ví dụ: một truy vấn truy xuất dữ liệu cho 500 mã video có thể yêu cầu dữ liệu trong tối đa 100 ngày. Để giảm số lượng hàng mà một yêu cầu trả về, hãy chia truy vấn của bạn thành nhiều truy vấn chỉ định ít video hơn hoặc đặt phạm vi ngày ngắn hơn.

Nội dung
Kích thước:
Bắt buộc insightTrafficSourceType
Sử dụng từ 0 trở lên creatorContentType, day, liveOrOnDemand, subscribedStatus
Chỉ số:
Sử dụng 1 hoặc nhiều lượt xem, estimatedMinutesWatched
Bộ lọc:
Sử dụng 0 hoặc 1 country, province, continent, 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ề 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 thông 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 những nguồn giới thiệu đã tạo ra nhiều lượt xem nhất cho nội dung của kênh. Các 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 những nguồn lưu lượng truy cập có báo cáo. Ví dụ: nếu bạn đặt bộ lọc insightTrafficSourceType thành ADVERTISING, báo cáo sẽ liệt kê những loại quảng cáo tạo ra nhiều lượt xem hoặc thời gian xem nhất cho nội dung của kênh.

Nội dung
Kích thước:
Bắt buộc insightTrafficSourceDetail
Không bắt buộc creatorContentType
Chỉ số:
Sử dụng 1 hoặc nhiều lượt xem, estimatedMinutesWatched
Bộ lọc:
Bắt buộc insightTrafficSourceType (xem ghi chú bên dưới bảng)
Sử dụng 0 hoặc 1 country, province, continent, subContinent
Sử dụng 0 hoặc 1 video, nhóm
Sử dụng từ 0 trở lên liveOrOnDemand, subscribedStatus
Các lựa chọn sắp xếp: -views
-estimatedMinutesWatched

Lưu ý: Báo cáo này chỉ được hỗ trợ cho một số nguồn lưu lượng truy cập cụ thể. Một số nguồn lưu lượng truy cập không được hỗ trợ là VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES và NO_LINK_EMBEDDED.

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 xảy ra trên thiết bị di động hoặc máy chơi trò chơi.

Nội dung
Kích thước:
Bắt buộc deviceType
Sử dụng từ 0 trở lên creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Chỉ số:
Sử dụng 1 hoặc nhiều lượt xem, estimatedMinutesWatched
Bộ lọc:
Sử dụng 0 hoặc 1 country, province, continent, 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ề lượt 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
Kích thước:
Bắt buộc operatingSystem
Sử dụng từ 0 trở lên creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Chỉ số:
Sử dụng 1 hoặc nhiều lượt xem, estimatedMinutesWatched
Bộ lọc:
Sử dụng 0 hoặc 1 country, province, continent, 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ề lượt 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 xảy ra trên máy tính bảng Android hoặc trên thiết bị máy tính để bàn Windows.

Nội dung
Kích thước:
Bắt buộc deviceType, operatingSystem
Sử dụng từ 0 trở lên creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Chỉ số:
Sử dụng 1 hoặc nhiều lượt xem, estimatedMinutesWatched
Bộ lọc:
Sử dụng 0 hoặc 1 country, province, continent, 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ề lượt xem dựa trên nhóm tuổi và giới tính của người xem.

Nội dung
Kích thước:
Sử dụng 1 hoặc nhiều ageGroup, gender
Sử dụng từ 0 trở lên creatorContentType, liveOrOnDemand, subscribedStatus
Chỉ số:
Sử dụng 1 hoặc nhiều viewerPercentage
Bộ lọc:
Sử dụng 0 hoặc 1 country, province, continent, subContinent
Sử dụng 0 hoặc 1 video, nhóm
Sử dụng từ 0 trở lên liveOrOnDemand, subscribedStatus
Lưu ý: Các giá trị viewerPercentage trong báo cáo này không được chuẩn hoá cho các giá trị hoặc tổ hợp giá trị khác nhau cho phương diện chi tiết về lượt phát (subscribedStatus, liveOrOnDemand hoặc youtubeProduct).

Ví dụ: báo cáo sử dụng phương diện subscribedStatus sẽ trả về dữ liệu viewerPercentage tổng cộng là 100% cho số lượt xem của người đăng ký và dữ liệu viewerPercentage tổng cộng là 100% cho số lượt xem của người không đăng ký. (Tổng giá trị của tất 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ị (hoặc tổ hợp giá trị) cho các phương diện chi tiết về lượt phát.

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 các nền tảng xã hội.

Nội dung
Kích thước:
Bắt buộc sharingService
Sử dụng từ 0 trở lên creatorContentType, subscribedStatus
Chỉ số:
Sử dụng 1 hoặc nhiều cổ phiếu
Bộ lọc:
Sử dụng 0 hoặc 1 country, continent, 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 một video, đồng thời cho biết tần suất người xem các phần cụ thể 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. Các chỉ số này có thể được chia thành hai danh mục:

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

    Các chỉ số này cho biết mức độ hiệu quả của video trong việc giữ chân người xem.

    • audienceWatchRatio là tỷ lệ so sánh số lần một phần của video được xem với tổng số lượt xem của video.
    • relativeRetentionPerformance cho biết mức độ giữ chân người xem của một video trong khi phát so với các video khác trên YouTube có thời lượng tương tự.

  • Số liệu thống kê chi tiết về lượt xem

    Các chỉ số này cung cấp thông tin về tần suất người xem xem các phần cụ thể của video.

    • startedWatching cho biết tần suất người xem bắt đầu xem một video trong một đoạn cụ thể của video.
    • stoppedWatching cho biết tần suất người xem dừng xem video trong một đoạn video cụ thể.
    • totalSegmentImpressions cho biết tần suất một phân đoạn cụ thể của video được xem.

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

Nội dung
Kích thước:
Bắt buộc elapsedVideoTimeRatio
Chỉ số:
Sử dụng 1 hoặc nhiều audienceWatchRatio
relativeRetentionPerformance
startedWatching
stoppedWatching
totalSegmentImpressions
Bộ lọc:
Bắt buộc video
Sử dụng từ 0 trở lên audienceType
subscribedStatus
youtubeProduct

Số người xem đồng thời (đối với sự kiện phát trực tiếp)

Báo cáo này cho biết số người xem đồng thời ở một vị trí nhất định đối với một video phát trực tiếp. Bộ lọc chỉ định video. Phương diện vị trí thường đại diện cho một phút.

Nội dung
Kích thước:
Sử dụng 0 hoặc 1 livestreamPosition
Chỉ số:
Sử dụng 1 hoặc nhiều averageConcurrentViewers
peakConcurrentViewers
Bộ lọc:
Bắt buộc video

Video hàng đầu

Lưu ý: Những 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ừ 200 trở xuống. Dữ liệu trước ngày 1 tháng 1 năm 2013 chỉ có sẵn cho 10 video hàng đầu. Không giống như hầu hết các báo cáo khác, những báo cáo này cũng yêu cầu bạn chỉ định một giá trị cho thông số yêu cầu sort.

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ê các 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
Kích thước:
Bắt buộc video
Không bắt buộc creatorContentType
Chỉ số:
Sử dụng 1 hoặc nhiều lượt xem, redViews, bình luận, lượt thích, lượt không thích, videosAddedToPlaylists, videosRemovedFromPlaylists, số lượt chia sẻ, 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*, doanh thu trên mỗi nghìn lượt hiển thị*
Bộ lọc:
Sử dụng 0 hoặc 1 country, continent, subContinent
Các lựa chọn sắp xếp: -views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

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 tại một tiểu bang cụ thể của Hoa Kỳ hoặc tại Đặ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 mô tả ở trên.

Nội dung
Kích thước:
Bắt buộc video
Không bắt buộc creatorContentType
Chỉ số:
Sử dụng 1 hoặc nhiều views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Bộ lọc:
Bắt buộc province
Không bắt buộc subscribedStatus
Các lựa chọn sắp xếp: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Video hàng đầu dành cho người xem đã đăng ký hoặc đã huỷ đă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 đối với người xem đã đăng ký hoặc chưa đă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 cho phép bạn truy xuất các video hàng đầu ở một tiểu bang cụ thể của Hoa Kỳ cho những người xem đã đăng ký hoặc chưa đăng ký, nhưng báo cáo này hỗ trợ ít chỉ số hơn.

Nội dung
Kích thước:
Bắt buộc video
Không bắt buộc creatorContentType
Chỉ số:
Sử dụng 1 hoặc nhiều lượt xem, redViews, lượt thích, lượt không thích, videosAddedToPlaylists, videosRemovedFromPlaylists, số lượt chia sẻ, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Bộ lọc:
Không bắt buộc subscribedStatus
Sử dụng 0 hoặc 1 country, continent, subContinent
Các lựa chọn sắp xếp: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Video hàng đầu theo Sản phẩm của YouTube (<= 200 kết quả)

Báo cáo này liệt kê các video hàng đầu của kênh, đồng thời hỗ trợ bộ lọc địa lý và thông tin chi tiết về lượt phát. 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 bộ lọc youtubeProduct.

Nội dung
Kích thước:
Bắt buộc video
Không bắt buộc creatorContentType
Chỉ số:
Sử dụng 1 hoặc nhiều views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Bộ lọc:
Sử dụng 0 hoặc 1 country, province, continent, subContinent
Sử dụng từ 0 trở lên subscribedStatus, youtubeProduct
Các lựa chọn sắp xếp: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Video hàng đầu có bộ lọc thông tin chi tiết về lượt 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, được lọc theo bất kỳ hoặc tất cả cá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
Kích thước:
Bắt buộc video
Không bắt buộc creatorContentType
Chỉ số:
Sử dụng 1 hoặc nhiều views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Bộ lọc:
Sử dụng 0 hoặc 1 country, province, continent, subContinent
Sử dụng từ 0 trở lên liveOrOnDemand, subscribedStatus, youtubeProduct
Các lựa 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 video trong danh sách phát của chủ sở hữu kênh. Có hai phiên bản của các báo cáo này và đối với mỗi báo cáo có sẵn, các phần sau đây sẽ chứa 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. Các báo cáo được đề xuất hỗ trợ một nhóm chỉ số mở rộng, bao gồm cả chỉ số video tổng hợp 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ả định dạng yêu cầu API cũ, trong đó yêu cầu phương diện isCurated. Các báo cáo này chỉ hỗ trợ các chỉ số trong danh sách phát. Xin lưu ý rằng phương diện isCurated không còn được dùng cho tất cả báo cáo. Lưu ý cảnh báo bên dưới giải thích 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ố tổng hợp về video

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

Hã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ố video tổng hợp 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 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 các video đó, nhưng chỉ tính số lượt xem xảy ra trong bối cảnh danh sách phát.

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

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ể.

Sử dụng isCurated
Nội dung
Kích thước:
[Không có]
Chỉ số:
Sử dụng 1 hoặc nhiều lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Bộ lọc:
Bắt buộc isCurated==1
Sử dụng 0 hoặc 1 danh sách phát, nhóm
Sử dụng 0 hoặc 1 country, province, continent, 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ể.

Sử dụng isCurated
Nội dung
Kích thước:
Sử dụng đúng 1 ngày, tháng
Sử dụng từ 0 trở lên subscribedStatus, youtubeProduct
Chỉ số:
Sử dụng 1 hoặc nhiều lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Bộ lọc:
Bắt buộc isCurated==1
Sử dụng 0 hoặc 1 danh sách phát, nhóm
Sử dụng 0 hoặc 1 country, province, continent, subContinent
Sử dụng từ 0 trở lên subscribedStatus, youtubeProduct

Vị trí địa lý của người dùng

Hoạt động trên 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 các 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.

Sử dụng isCurated
Nội dung
Kích thước:
Bắt buộc country
Sử dụng từ 0 trở lên subscribedStatus, youtubeProduct
Chỉ số:
Sử dụng 1 hoặc nhiều lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Bộ lọc:
Bắt buộc isCurated==1
Sử dụng 0 hoặc 1 danh sách phát, nhóm
Sử dụng 0 hoặc 1 continent, subContinent
Sử dụng từ 0 trở lên subscribedStatus, youtubeProduct

Hoạt động liên quan đến 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 liên quan đến danh sách phát tại các tiểu bang ở Hoa Kỳ và Quận 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 cho Hoa Kỳ.

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 nơi diễn ra lượt phát video trong danh sách phát của bạn.

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 một giá trị cho thông 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.

Nên
Nội dung
Kích thước:
Bắt buộc insightPlaybackLocationDetail
Chỉ số:
Sử dụng 1 hoặc nhiều 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
Các lựa chọn sắp xếp: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts
Sử dụng isCurated
Nội dung
Kích thước:
Bắt buộc insightPlaybackLocationDetail
Chỉ số:
Sử dụng 1 hoặc nhiều 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 country, province, continent, subContinent
Không bắt buộc subscribedStatus
Các lựa 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 truy cập vào nội dung trong 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.

Thông tin chi tiết về 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 những nguồn 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. Các nguồn 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ó báo cáo.

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

Nên
Nội dung
Kích thước:
Bắt buộc insightTrafficSourceDetail
Chỉ số:
Sử dụng 1 hoặc nhiều lượt xem, 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
Các lựa chọn sắp xếp: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts
Sử dụng isCurated
Nội dung
Kích thước:
Bắt buộc insightTrafficSourceDetail
Chỉ số:
Sử dụng 1 hoặc nhiều 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 country, province, continent, subContinent
Không bắt buộc subscribedStatus
Các lựa chọn sắp xếp: -views
-estimatedMinutesWatched
-playlistStarts

Lưu ý: Báo cáo này chỉ được hỗ trợ cho một số nguồn lưu lượng truy cập cụ thể. Một số nguồn lưu lượng truy cập không được hỗ trợ là VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES và NO_LINK_EMBEDDED.

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 các video trong danh sách phát của bạn. Ví dụ: chỉ số này xác định số lượt xem xảy ra trên thiết bị di động hoặc máy chơi trò chơi.

Sử dụng isCurated
Nội dung
Kích thước:
Bắt buộc deviceType
Sử dụng từ 0 trở lên day, subscribedStatus, youtubeProduct
Chỉ số:
Sử dụng 1 hoặc nhiều lượt xem, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Bộ lọc:
Bắt buộc isCurated==1
Sử dụng 0 hoặc 1 danh sách phát, nhóm
Sử dụng 0 hoặc 1 country, province, continent, 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ề lượt xem dựa trên hệ điều hành của người xem. Ví dụ: thuộc tính này xác định số lượt xem xảy ra trên thiết bị Android hoặc trên PlayStation.

Sử dụng isCurated
Nội dung
Kích thước:
Bắt buộc operatingSystem
Sử dụng từ 0 trở lên day, subscribedStatus, youtubeProduct
Chỉ số:
Sử dụng 1 hoặc nhiều lượt xem, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Bộ lọc:
Bắt buộc isCurated==1
Sử dụng 0 hoặc 1 danh sách phát, nhóm
Sử dụng 0 hoặc 1 country, province, continent, 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ề lượt 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 xảy ra trên máy tính bảng Android hoặc thiết bị máy tính để bàn Windows.

Sử dụng isCurated
Nội dung
Kích thước:
Bắt buộc deviceType, operatingSystem
Sử dụng từ 0 trở lên day, subscribedStatus, youtubeProduct
Chỉ số:
Sử dụng 1 hoặc nhiều lượt xem, estimatedMinutesWatched, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Bộ lọc:
Bắt buộc isCurated==1
Sử dụng 0 hoặc 1 danh sách phát, nhóm
Sử dụng 0 hoặc 1 country, province, continent, 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

Sử dụng isCurated
Nội dung
Kích thước:
Sử dụng 1 hoặc nhiều 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
Sử dụng 0 hoặc 1 danh sách phát, nhóm
Sử dụng 0 hoặc 1 country, province, continent, 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á cho 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ề dữ liệu viewerPercentage tổng cộng là 100% cho các lượt xem đã đăng ký và dữ liệu viewerPercentage tổng cộng là 100% cho các lượt xem chưa đăng ký. (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 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 đặt tham số maxResults thành một giá trị số nguyên từ 200 trở xuống. Dữ liệu trước ngày 1 tháng 1 năm 2013 chỉ có sẵn cho 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, những báo cáo này cũng yêu cầu bạn chỉ định một giá trị cho thông 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.

Sử dụng isCurated
Nội dung
Kích thước:
Bắt buộc danh sách phát
Chỉ số:
Sử dụng 1 hoặc nhiều lượt xem, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Bộ lọc:
Bắt buộc isCurated==1
Sử dụng 0 hoặc 1 country, province, continent, subContinent
Sử dụng từ 0 trở lên danh sách phát, subscribedStatus, youtubeProduct
Các lựa chọn sắp xếp: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-playlistStarts

Báo cáo về gói thành viên

Lượt huỷ gói thành viên

Báo cáo này cung cấp số liệu thống kê về lý do người dùng huỷ gói hội viên của kênh.

Nội dung
Kích thước:
Sử dụng 0 hoặc 1 membershipsCancellationSurveyReason
Chỉ số:
Bắt buộc membershipsCancellationSurveyResponses

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 các chỉ số dựa trên lượt hiển thị cho quảng cáo chạy trong lúc phát video. Những 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ị.

Sau đây là các chỉ số hiệu suất quảng cáo dựa trên số lượt hiển thị:

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, các chỉ số này không có trong báo cáo hiệu suất quảng cáo.

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

Nội dung
Kích thước:
Bắt buộc adType
Không bắt buộc ngày
Chỉ số:
Sử dụng 1 hoặc nhiều grossRevenue, adImpressions, cpm
Bộ lọc:
Sử dụng 0 hoặc 1 video, nhóm
Sử dụng 0 hoặc 1 country, continent, subContinent