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 các chỉ số về hoạt động của người dùng cho một kênh cụ thể và đo lường những chỉ số như số lượt xem video, số lượt đánh giá và số lượt đăng ký.
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 này 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 riêng biệ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 của 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 mã nhận dạng 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 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ả các yêu cầu gửi đến YouTube Analytics API đề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 YouTube Analytics API 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 của YouTube Analytics cho nội dung trên YouTube. Phạm vi này cho phép 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 đánh giá. |
| https://www.googleapis.com/auth/yt-analytics-monetary.readonly |
Xem báo cáo của YouTube Analytics về tài chính cho nội dung trên YouTube. Phạm vi này cho phép 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 YouTube Analytics API, 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 của YouTube Analytics. |
| https://www.googleapis.com/auth/youtubepartner |
Xem và quản lý tài sản cũng như nội dung được kết hợp của bạn trên YouTube. Trong YouTube Analytics API, 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 của YouTube Analytics. |
Lưu ý: Báo cáo kênh hiện không hỗ trợ các chỉ số về doanh thu ước tính và hiệu suất quảng cáo. 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 về tiền tệ trong những báo cáo đó.
Bộ lọc
Các bảng giải thích về những 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 các bảng, bộ lọc xuất hiện trong dấu ngoặc đơn là không bắt buộc. Ví dụ: đối với lựa chọn lọc video(,country), bạn phải dùng bộ lọc video và có thể dùng bộ lọc quốc gia (không bắt buộc).
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 vẫn đúng ngay cả khi bộ lọc không được liệt kê là một 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 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ữ được dùng trong các bảng xác định những 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 chi tiết về lượt phát bằng phương diện thời gian và chỉ số averageViewPercentage.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
Bảng này có 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 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=daydimensions=day,subscribedStatusdimensions=month,subscribedStatus,youtubeProductdimensions=month,youtubeProduct
Tuy nhiên, giá trị tham số day,month không hợp lệ vì sử dụng 2 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ữ trong bảng báo cáo
Các bảng sử dụng thuật ngữ sau đây để cho biết liệu phương diện là bắt buộc hay không bắt buộc:
- Các thuật ngữ 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ị.
- 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ể thêm bất kỳ hoặc tất cả giá trị trong nhóm, nhưng bạn phải thêm í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ể chọn thêm giá trị này.
- Sử dụng 0 hoặc 1: Bạn có thể chọn thêm một giá trị trong nhóm.
- Sử dụng 0 hoặc nhiều: 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 các 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 của một video hoặc quốc gia cụ thể.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
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 nhóm nhỏ các chỉ số có trong báo cáo theo quốc gia như mô tả ở trên.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
| Sử dụng 1 hoặc nhiều |
engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Bộ lọc: |
|
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 các hành động của người dùng trên một kênh trong 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 của một video hoặc quốc gia cụ thể.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
| Sử dụng 1 hoặc nhiều |
engagedViews, views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, uniques, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm* |
|
| Bộ lọc: |
|
Hoạt động của người dùng ở các tiểu bang tại 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 ở 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 nhóm nhỏ các chỉ số có trong báo cáo theo quốc gia như mô tả ở trên.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
| Sử dụng 1 hoặc nhiều |
engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Bộ lọc: |
|
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 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 |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
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ị tham số filters thành country==US.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
| Sử dụng 1 hoặc nhiều |
engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Bộ lọc: |
|
Hoạt động của người dùng theo thành phố (tối đa 250 kết quả)
Lưu ý: Báo cáo này yêu cầu bạn đặt tham số maxResults thành giá trị nguyên là 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 thông 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ố.
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 của Hoa Kỳ).
Thông tin chi tiết về quá trình phát
Báo cáo chi tiết về hoạt động phát cung cấp số liệu thống kê liên quan đến các thuộc tính xem sau đây:
- Lượt xem đó là của một video phát trực tiếp hay một 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 mục con sau đây liệt kê 2 báo cáo. Một báo cáo hỗ trợ phương diện (và bộ lọc) liveOrOnDemand, 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 các 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, lục địa hoặc subContinent.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
| Sử dụng 1 hoặc nhiều |
engagedViews, views, redViews, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Bộ lọc: |
|
Hoạt động của người dùng theo trạng thái đăng ký đối với các 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 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: |
|
| Chỉ số: |
| Sử dụng 1 hoặc nhiều |
engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Bộ lọc: |
|
Thông tin phát lại 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à phương diện không bắt buộc đối với những báo cáo này vì dù sao đi nữa, 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. Nếu có, phương diện này 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.
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ề hoạt động phát cho các khoảng thời gian cụ thể. Chỉ số này hỗ trợ phương diện (và bộ lọc) liveOrOnDemand.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
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ề hoạt động phát cho các khoảng thời gian cụ thể. Chỉ số này hỗ trợ chỉ số averageViewPercentage.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
Thông tin phát lại 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ê 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. Chỉ số này hỗ trợ phương diện (và bộ lọc) liveOrOnDemand.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
Thông tin chi tiết về lượt phát theo quốc gia bằng chỉ số averageViewPercentage
Báo cáo sau đây tương tự như báo cáo trước. Chỉ số này hỗ trợ 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: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
Thông tin chi tiết về lượt phát theo tỉnh
Thông tin chi tiết về lượt phát theo tỉnh, có 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 cho các tiểu bang ở Hoa Kỳ và Quận Columbia. Chỉ số này hỗ trợ phương diện (và bộ lọc) liveOrOnDemand.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
Thông tin chi tiết về lượt phát theo tỉnh, có chỉ số averageViewPercentage
Báo cáo sau đây tương tự như báo cáo trước. Chỉ số này hỗ trợ 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: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
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 |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
Thông tin chi tiết về vị trí phát (tối đa 25 kết quả)
Lưu ý: Báo cáo này yêu cầu bạn đặt tham số maxResults thành giá trị nguyên là 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.
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 phát sinh 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 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 |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
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 giá trị nguyên là 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 trên 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 những nguồn lưu lượng truy cập mà báo cáo có thể cung cấp. 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 nhiều lượt xem hoặc thời gian xem nhất cho nội dung của kênh.
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ể. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES và NO_LINK_EMBEDDED là một số nguồn lưu lượng truy cập không được hỗ trợ.
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 |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
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 |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
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 chạy Windows.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
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 |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
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 khác nhau.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
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 xem các phần cụ thể của video. Phương diện elapsedVideoTimeRatio đo lường khoảng thời gian đã trôi qua của video đối với các giá trị chỉ số tương ứng. Các chỉ số này có thể được chia thành 2 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 khả năng giữ chân người xem của một video trong quá trình 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 những phần cụ thể của video.
Lưu ý: Báo cáo này không hỗ trợ khả năng 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 |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
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 tại một vị trí nhất định của một video phát trực tiếp.
Bộ lọc này chỉ định video. Kích thước vị trí thường biểu thị một phút.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
Video hàng đầu
Lưu ý: Các báo cáo này yêu cầu bạn đặt tham số maxResults thành giá trị 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 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ê những video hàng đầu của kênh. Bạn có thể lọc báo cáo để liệt kê những video hàng đầu theo quốc gia, châu lục hoặc subContinent.
Video hàng đầu theo tiểu bang (tối đa 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ể 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 nhóm nhỏ các chỉ số có trong báo cáo theo quốc gia như mô tả ở trên.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
| Sử dụng 1 hoặc nhiều |
engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Bộ lọc: |
|
| Các lựa chọn sắp xếp: |
-views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched |
Video hàng đầu cho người xem đã đăng ký hoặc chưa đăng ký(tối đa 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 để liệt kê những 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ể của Hoa Kỳ cho 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 |
| Phương diện: |
|
| Chỉ số: |
| Sử dụng 1 hoặc nhiều |
engagedViews, views, redViews, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Bộ lọc: |
|
| 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 (tối đa 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ề lượt phát cũng như bộ lọc theo khu vự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à thêm chế độ hỗ trợ cho bộ lọc youtubeProduct.
Video hàng đầu có bộ lọc chi tiết về lượt phát (tối đa 200 kết quả)
Báo cáo này liệt kê những video hàng đầu của kênh, lọc theo một hoặc tất cả các phương diện chi tiết về hoạt động 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.
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 đối với các video trong danh sách phát của chủ sở hữu kênh. Có 2 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 mục sau đây sẽ mô tả từng phiên bản:
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, đồng thời thuộc sở hữu của kênh sở hữu danh sách phát đó. Các chỉ số cho video thuộc quyền sở hữu của các kênh khác không được tính trong quá trình tổng hợp. Do đó, nếu một kênh tạo danh sách phát chỉ chứa những 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ố tổng hợp về video mà YouTube hỗ trợ.
Các 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 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 những lượt xem xảy ra trong 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ể.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
| Sử dụng 1 hoặc nhiều |
engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
| Bộ lọc: |
|
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ể.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
| Sử dụng 1 hoặc nhiều |
engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
| Bộ lọc: |
|
Khu vực địa lý của người dùng
Hoạt động liên quan đế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 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.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
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 của danh sách phát ở các tiểu bang của 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ỳ.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
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.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
Thông tin chi tiết về vị trí phát (tối đa 25 kết quả)
Lưu ý: Báo cáo này yêu cầu bạn đặt tham số maxResults thành giá trị số nguyên là 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.
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 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.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
| Sử dụng 1 hoặc nhiều |
engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
| Bộ lọc: |
|
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 giá trị số nguyên là 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 các video trong danh sách phát của kênh. 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 xác định những nguồn lưu lượng truy cập mà báo cáo có thể cung cấp.
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 nhiều lượt xem hoặc thời gian xem nhất cho danh sách phát của kênh.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
| Sử dụng 1 hoặc nhiều |
engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
| Bộ lọc: |
|
| Các lựa chọn sắp xếp: |
-playlistViews
-playlistEstimatedMinutesWatched
-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ể. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES và NO_LINK_EMBEDDED là một số nguồn lưu lượng truy cập không được hỗ trợ.
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 tìm thấy 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.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
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 |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
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 trên máy tính bảng Android hoặc thiết bị máy tính chạy Windows.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
Thông tin nhân khẩu học của người xem
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
Danh sách phát hàng đầu
Lưu ý: Các báo cáo này yêu cầu bạn đặt tham số maxResults thành giá trị 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 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ê những 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 được chỉ định.
Báo cáo về 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ê cho biết lý do người dùng huỷ gói hội viên của kênh.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
|
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 những quảng cáo chạy trong quá trình 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ể tạo ra nhiều lượt hiển thị.
Các chỉ số hiệu suất quảng cáo dựa trên lượt hiển thị là:
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 đưa vào báo cáo hiệu suất quảng cáo.
| Nội dung |
| Phương diện: |
|
| Chỉ số: |
|
| Bộ lọc: |
|
