Trang này trình bày các yêu cầu mẫu của API YouTube Analytics. Mỗi ví dụ mô tả ngắn gọn báo cáo được truy xuất, sau đó cho thấy các giá trị thông số dimensions, metrics, filters và sort tương ứng. (Các tài liệu về báo cáo kênh và báo cáo của chủ sở hữu nội dung xác định những báo cáo mà API hỗ trợ.)
Mỗi ví dụ đều liên kết đến và điền các giá trị được hiển thị vào Google APIs Explorer. Các ví dụ này cũng sử dụng ngày bắt đầu và ngày kết thúc mặc định (YYYY-MM-DD) là 2023-09-01 và 2024-03-31.
Sau khi liên kết với APIs Explorer, bạn vẫn phải chỉ định kênh hoặc chủ sở hữu nội dung mà bạn đang truy xuất báo cáo. API Explorer sẽ điền giá trị tham số ids bằng channel==MINE hoặc contentOwner==CONTENT_OWNER_ID, tuỳ thuộc vào truy vấn mà bạn đã nhấp vào. Đối với báo cáo kênh, bạn có thể thay đổi MINE thành mã nhận dạng kênh của người dùng đã xác thực. Đối với báo cáo của chủ sở hữu nội dung, bạn cần thay thế CONTENT_OWNER_ID bằng mã nhận dạng chủ sở hữu nội dung của mình.
Bạn cũng phải được xác thực là kênh hoặc chủ sở hữu nội dung được chỉ định để APIs Explorer có thể ủy quyền cho các yêu cầu API của bạn bằng OAuth 2.0.
Sắp xếp yêu cầu theo nhiều phương diện/chỉ số
API này hỗ trợ khả năng sắp xếp dữ liệu phản hồi bằng nhiều phương diện hoặc chỉ số. Ví dụ: yêu cầu bên dưới truy xuất dữ liệu nguồn lưu lượng truy cập hằng ngày cho các video của một kênh cụ thể. Mỗi hàng trong tập hợp kết quả xác định số lượt xem và thời gian xem ước tính bắt nguồn từ một loại nguồn lưu lượng truy cập cụ thể (ví dụ: EXT_URL) vào một ngày cụ thể.
dimensions=day,insightTrafficSourceType metrics=views,estimatedWatchTime sort=day,-views
Trong câu trả lời, các kết quả được sắp xếp theo trình tự thời gian. Trong tập hợp kết quả cho từng ngày, kết quả được sắp xếp theo thứ tự giảm dần theo số lượt xem. Vì vậy, hàng đầu tiên trong tập hợp kết quả chứa dữ liệu cho nguồn lưu lượng truy cập đã tạo ra nhiều lượt xem nhất vào ngày đầu tiên trong phạm vi ngày được yêu cầu. Hàng thứ hai chứa dữ liệu về nguồn lưu lượng truy cập đã tạo ra số lượt xem cao nhất tiếp theo vào ngày đầu tiên.
Báo cáo kênh
Báo cáo video
Tổng số lượt xem, thời gian xem ước tính và các thông tin khác cho một kênh
Truy vấn này truy xuất các chỉ số tổng hợp về nội dung của kênh. Báo cáo trả về một hàng dữ liệu có chứa tổng số cho mỗi chỉ số được yêu cầu trong phạm vi ngày được chỉ định.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
Số lượt xem theo quốc gia cụ thể (và các dữ liệu khác) của một kênh
Truy vấn này truy xuất các chỉ số cho một quốc gia cụ thể của một kênh. Báo cáo trả về một hàng dữ liệu có chứa tổng số cho mỗi chỉ số được yêu cầu trong phạm vi ngày được chỉ định.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=country==US
10 video hàng đầu – Các video được xem nhiều nhất của một kênh
Truy vấn này truy xuất 10 video được xem nhiều nhất của kênh, được đo bằng số phút đã xem ước tính trong phạm vi ngày được chỉ định. Kết quả được sắp xếp theo số phút đã xem ước tính theo thứ tự giảm dần.
Lưu ý: Báo cáo này yêu cầu bạn chỉ định một giá trị cho tham số yêu cầu sort và đặt tham số maxResults thành một giá trị số nguyên 10 trở xuống.
dimensions=video metrics=estimatedMinutesWatched,views,likes,subscribersGained maxResults=10 sort=-estimatedMinutesWatched
10 hàng đầu – Tỷ lệ nhấp vào chú thích cho những video được xem nhiều nhất của một kênh
Yêu cầu này truy xuất số lượt xem, tỷ lệ nhấp vào chú thích, tỷ lệ đóng chú thích và số lượt hiển thị chú thích cho 10 video được xem nhiều nhất của kênh. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần, tức là video có nhiều lượt xem nhất sẽ được liệt kê trước.
Lưu ý: Báo cáo này yêu cầu bạn chỉ định một giá trị cho tham số yêu cầu sort và đặt tham số maxResults thành một giá trị số nguyên 10 trở xuống.
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions maxResults=10 sort=-views
Báo cáo danh sách phát
Tổng số lượt xem danh sách phát của một kênh
Yêu cầu này sẽ truy xuất tổng số lượt bắt đầu phát của danh sách phát, số phút đã xem ước tính, số lượt xem (một chỉ số tổng hợp về video), số lượt xem danh sách phát (chỉ số trong danh sách phát) và số lượt xem trên mỗi lần bắt đầu của danh sách phát đối với các danh sách phát trên kênh của người dùng đã xác thực.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
Số liệu thống kê cho một danh sách phát cụ thể
Yêu cầu này sẽ truy xuất tổng số lượt bắt đầu phát của danh sách phát, số phút đã xem ước tính, số lượt xem (một chỉ số tổng hợp về video), số lượt xem danh sách phát (chỉ số trong danh sách phát) và số lượt xem trên mỗi lần bắt đầu của một danh sách phát cụ thể. Xin lưu ý rằng để chạy truy vấn này trong API Explorer (Trình khám phá API), bạn phải thay thế chuỗi PLAYLIST_ID trong giá trị tham số filters bằng mã nhận dạng danh sách phát của một danh sách phát trong kênh của người dùng đã xác thực.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
Để truy xuất số liệu thống kê tổng hợp cho nhiều danh sách phát, bạn cũng có thể thay thế chuỗi PLAYLIST_ID bằng một danh sách gồm tối đa 500 mã nhận dạng danh sách phát được phân tách bằng dấu phẩy cho các danh sách phát trên kênh của người dùng đã xác thực.
10 hàng đầu – Danh sách phát được xem nhiều nhất của một kênh
Truy vấn này truy xuất 10 danh sách phát có nhiều lượt xem nhất trên kênh, được đo lường bằng số lượt xem danh sách phát trong phạm vi ngày được chỉ định. Thẻ này cũng truy xuất một vài chỉ số khác về danh sách phát, chẳng hạn như số lần người xem bắt đầu phát từng danh sách phát và thời lượng trung bình mà khán giả đã xem video trong danh sách phát đó sau khi danh sách phát bắt đầu. Kết quả được sắp xếp theo lượt xem danh sách phát theo thứ tự giảm dần.
Lưu ý: Vì báo cáo này sử dụng phương diện playlist, nên bạn phải chỉ định một giá trị cho tham số yêu cầu sort và đặt tham số maxResults thành một giá trị số nguyên từ 10 trở xuống.
dimensions=playlist metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves maxResults=10 sort=-playlistViews
Báo cáo video
Chỉ số thời gian xem hằng ngày cho video trên một kênh
Truy vấn này truy xuất số lượt xem hàng ngày, chỉ số thời gian xem và số người đăng ký mới cho video của kênh. Báo cáo trả về một hàng dữ liệu cho mỗi ngày trong phạm vi ngày được yêu cầu. Các hàng được sắp xếp theo thứ tự thời gian.
dimensions=day metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=day
Số liệu chú thích hằng ngày cho video của một kênh
Yêu cầu này truy xuất số lượt xem hàng ngày, tỷ lệ nhấp của chú thích, tỷ lệ đóng chú thích và số lượt hiển thị chú thích cho nội dung của kênh. Các kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=day
Báo cáo danh sách phát
Số lượt xem danh sách phát hằng ngày của một kênh
Yêu cầu này sẽ truy xuất số lượt xem hằng ngày (chỉ số video tổng hợp), số lượt xem danh sách phát (chỉ số trong danh sách phát), số lượt bắt đầu danh sách phát, số phút đã xem ước tính và số lượt xem trên mỗi lần bắt đầu danh sách phát của kênh của người dùng đã xác thực. Các kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart sort=day
Báo cáo video
Chỉ số thời gian xem video của một kênh theo quốc gia
Truy vấn này truy xuất số lượt xem theo quốc gia cụ thể, chỉ số thời gian xem và số liệu đăng ký cho các video của một kênh. Báo cáo trả về một hàng dữ liệu cho mỗi quốc gia nơi người dùng xem video của kênh. Các hàng được sắp xếp theo số phút xem giảm dần.
dimensions=country metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=-estimatedMinutesWatched
Chỉ số chú thích theo quốc gia cụ thể cho video của kênh
Yêu cầu này truy xuất số lượt xem theo quốc gia cụ thể, tỷ lệ nhấp của chú thích, tỷ lệ đóng chú thích và số lượt hiển thị chú thích cho video của kênh đó. Kết quả được sắp xếp theo tỷ lệ nhấp vào chú thích theo thứ tự giảm dần, tức là quốc gia có tỷ lệ nhấp vào chú thích cao nhất sẽ được liệt kê trước.
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=-annotationClickThroughRate
Chỉ số theo tỉnh cụ thể cho các tiểu bang của Hoa Kỳ và Washington D.C.
Yêu cầu này truy xuất bảng phân tích số lượt xem theo tỉnh, số phút đã xem ước tính và thời lượng xem trung bình cho các video của kênh. Dữ liệu bao gồm các tiểu bang của Hoa Kỳ và Washington D.C. Kết quả được sắp xếp theo thứ tự bảng chữ cái theo mã ISO 3166-2 của các tỉnh.
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
10 video hàng đầu – Các video có nhiều lượt xem nhất ở một quốc gia cụ thể
Truy vấn này truy xuất 10 video có nhiều lượt xem nhất của kênh, được đo lường bằng số lượt xem trong phạm vi ngày được chỉ định tại một quốc gia được chỉ định. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần.
Lưu ý: Báo cáo này yêu cầu bạn chỉ định một giá trị cho tham số yêu cầu sort và đặt tham số maxResults thành một giá trị số nguyên 10 trở xuống.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=country==US maxResults=10 sort=-views
10 thành phố hàng đầu ở Hoa Kỳ theo tổng số lượt xem
Truy vấn này truy xuất danh sách 10 thành phố tại Hoa Kỳ chiếm nhiều lượt xem nội dung của kênh nhất trong phạm vi ngày được chỉ định. Bạn có thể sửa đổi cụm từ tìm kiếm để yêu cầu dữ liệu cho một quốc gia khác bằng cách chọn một giá trị hợp lệ khác cho bộ lọc đó. Tương tự, bạn có thể sửa đổi truy vấn để truy xuất dữ liệu cho một tiểu lục địa, chẳng hạn như Tây Âu hoặc Đông Nam Á, bằng cách sử dụng bộ lọc subContinent và một trong các giá trị hợp lệ của bộ lọc đó. Các bộ lọc khác cũng được hỗ trợ. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần.
dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views
10 thành phố hàng đầu ở Hoa Kỳ theo tổng số lượt xem đối với từng loại nội dung
Truy vấn này truy xuất danh sách 10 thành phố tại Hoa Kỳ chiếm nhiều lượt xem nội dung của kênh nhất trong phạm vi ngày được chỉ định cho mỗi creatorContentType được hỗ trợ. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần.
dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views
10 thành phố hàng đầu ở Hoa Kỳ theo tổng thời gian xem
Truy vấn này truy xuất danh sách 10 ngày hàng đầu trong phạm vi ngày được chỉ định khi bất kỳ thành phố nào tại Hoa Kỳ chiếm tổng thời gian xem nội dung hàng ngày lớn nhất của kênh. Kết quả truy vấn xác định tổng thời gian xem, ngày xuất hiện thời gian xem và thành phố ước tính khán giả xem nội dung đó. Kết quả được sắp xếp theo thứ tự giảm dần của tổng thời gian xem.
dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime
10 video hàng đầu – Những video được xem nhiều nhất tại Châu Âu
Truy vấn này truy xuất 10 video được xem nhiều nhất của kênh ở Châu Âu, được đo lường bằng số lượt xem trong phạm vi ngày được chỉ định. Bạn có thể sửa đổi truy vấn để yêu cầu dữ liệu cho một Châu lục khác bằng cách chọn một giá trị hợp lệ khác cho bộ lọc đó. Tương tự, bạn có thể sửa đổi truy vấn để truy xuất dữ liệu cho một tiểu lục địa, chẳng hạn như Tây Âu hoặc Đông Nam Á, bằng cách sử dụng bộ lọc subContinent và một trong các giá trị hợp lệ của bộ lọc đó. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần.
Lưu ý: Báo cáo này yêu cầu bạn chỉ định một giá trị cho tham số yêu cầu sort và đặt tham số maxResults thành một giá trị số nguyên 10 trở xuống.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=continent==150 maxResults=10 sort=-views
Báo cáo danh sách phát
Chỉ số thời gian xem theo quốc gia cụ thể cho danh sách phát của một kênh
Truy vấn này truy xuất số lượt xem theo quốc gia cụ thể (chỉ số video tổng hợp), lượt xem danh sách phát (chỉ số trong danh sách phát) và thời gian xem cho các danh sách phát của kênh. Báo cáo này trả về một hàng dữ liệu cho từng quốc gia nơi người dùng xem các danh sách phát của kênh. Các hàng được sắp xếp theo số phút xem giảm dần.
dimensions=country metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-estimatedMinutesWatched
10 danh sách phát hàng đầu – Các danh sách phát được bắt đầu nhiều nhất ở Hoa Kỳ
Truy vấn này truy xuất 10 danh sách phát mà người xem ở Hoa Kỳ bắt đầu xem thường xuyên nhất trong phạm vi ngày được chỉ định. Kết quả được sắp xếp theo số danh sách phát bắt đầu theo thứ tự giảm dần.
Lưu ý: Vì báo cáo này sử dụng phương diện playlist, nên bạn phải chỉ định một giá trị cho tham số yêu cầu sort và đặt tham số maxResults thành một giá trị số nguyên từ 10 trở xuống.
dimensions=playlist metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration filters=isCurated==1;country==US maxResults=10 sort=-playlistStarts
Báo cáo video
Số lượt xem và thời gian xem từ các vị trí phát khác nhau
Truy vấn này truy xuất số lượt xem và thời gian xem ước tính cho các video của một kênh cụ thể. Kết quả được tổng hợp dựa trên loại trang hoặc ứng dụng có lượt phát video. Ngoài ra, các kết quả được sắp xếp theo thứ tự giảm dần theo số lượt xem.
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views sort=-views
Số lượt xem hằng ngày và thời gian xem ở các vị trí phát khác nhau
Truy vấn này truy xuất số lượt xem hàng ngày và thời gian xem ước tính ở Hoa Kỳ cho một kênh cụ thể. Kết quả được nhóm theo ngày cho từng loại trang hoặc ứng dụng có lượt phát video. Các kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US sort=day
10 hàng đầu – Các trang web của bên thứ ba tạo ra nhiều lượt xem nhất cho video được nhúng
Truy vấn này truy xuất số lượt xem và thời gian xem ước tính cho một video hoặc nhóm video cụ thể. Kết quả được nhóm theo trang web của bên thứ ba nơi video được nhúng. Kết quả được sắp xếp theo thứ tự giảm dần theo số lượt xem. Xin lưu ý rằng để chạy truy vấn này trong APIs Explorer, bạn phải thay thế chuỗi VIDEO_ID trong giá trị thông số filters bằng danh sách được phân tách bằng dấu phẩy gồm một hoặc nhiều mã video cho video mà bạn đã tải lên.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Báo cáo danh sách phát
Số lượt xem danh sách phát và thời gian xem ở các vị trí phát khác nhau
Truy vấn này truy xuất số lượt xem (chỉ số video tổng hợp), lượt xem danh sách phát (chỉ số trong danh sách phát), thời gian xem ước tính và số lần bắt đầu danh sách phát của một kênh cụ thể. Kết quả được tổng hợp dựa trên loại trang hoặc ứng dụng có lượt phát video và kết quả được sắp xếp theo thứ tự giảm dần theo số lần bắt đầu phát của danh sách phát.
dimensions=insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=-playlistStarts
Số lượt xem danh sách phát hằng ngày và thời gian xem ở nhiều vị trí phát
Truy vấn này truy xuất số lượt bắt đầu danh sách phát hằng ngày, số lượt xem (chỉ số video tổng hợp), lượt xem danh sách phát (chỉ số trong danh sách phát) và thời gian xem ước tính ở Hoa Kỳ cho các danh sách phát cụ thể của một kênh. Kết quả được nhóm theo ngày cho từng loại trang hoặc ứng dụng có lượt xem danh sách phát. Kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day,insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews filters=country==US sort=day
Báo cáo video
Số lượt thích và không thích theo loại nội dung
Truy vấn này truy xuất số lượt thích và không thích cho mỗi loại nội dung trên kênh.
dimensions=creatorContentType metrics=likes,dislikes
Báo cáo video
Số lượt xem và thời gian xem từ các nguồn lưu lượng truy cập khác nhau trong một quốc gia
Yêu cầu này truy xuất số lượt xem và thời gian xem ước tính cho video của kênh này ở một quốc gia cụ thể. Các chỉ số này được tổng hợp theo nguồn lưu lượng truy cập, cho biết cách người dùng xem video.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=country==US
Số lượt xem hằng ngày và thời gian xem từ các nguồn lưu lượng truy cập khác nhau
Yêu cầu này truy xuất số lượt xem hàng ngày và thời gian xem ước tính hàng ngày cho video của kênh. Các chỉ số này được tổng hợp hằng ngày theo nguồn lưu lượng truy cập và được sắp xếp theo trình tự thời gian.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched sort=day
10 cụm từ hàng đầu – Cụm từ tìm kiếm trên YouTube tạo ra nhiều lưu lượng truy cập nhất cho một video
Truy vấn này truy xuất 10 cụm từ tìm kiếm đã tạo ra nhiều lượt xem nhất từ kết quả tìm kiếm trên YouTube cho một hoặc nhiều video cụ thể. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần. Xin lưu ý rằng để chạy truy vấn này trong APIs Explorer, bạn phải thay thế chuỗi VIDEO_ID trong giá trị thông số filters bằng một danh sách gồm tối đa 500 mã video được phân tách bằng dấu phẩy.
Ví dụ: bạn có thể chạy truy vấn cho một video duy nhất hoặc thay thế VIDEO_ID để xác định cụm từ tìm kiếm tạo ra nhiều lưu lượng truy cập nhất cho video đó. Bạn cũng có thể liệt kê tất cả các video trong một danh sách phát cụ thể để xác định cụm từ tìm kiếm tạo ra nhiều lưu lượng truy cập nhất cho video bất kỳ trong danh sách phát đó.
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
10 trang web hàng đầu – Các trang web bên ngoài tạo ra nhiều lưu lượng truy cập nhất cho một video
Truy vấn này truy xuất 10 trang web bên ngoài đã tạo ra nhiều lượt xem nhất cho một video hoặc nhóm video cụ thể. Kết quả được sắp xếp theo thời gian xem ước tính theo thứ tự giảm dần. Xin lưu ý rằng để chạy truy vấn này trong APIs Explorer, bạn phải thay thế chuỗi VIDEO_ID trong giá trị thông số filters bằng một danh sách gồm tối đa 500 mã video được phân tách bằng dấu phẩy cho video mà bạn đã tải lên.
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
Báo cáo danh sách phát
Số lượt xem danh sách phát và thời gian xem từ nhiều nguồn lưu lượng truy cập trong một quốc gia
Yêu cầu này truy xuất số lượt xem (một chỉ số tổng hợp về video), số lượt xem danh sách phát (chỉ số trong danh sách phát), số lượt bắt đầu phát của danh sách phát và thời gian xem ước tính của lượt xem danh sách phát ở một quốc gia cụ thể. Các chỉ số này được tổng hợp theo nguồn lưu lượng truy cập, cho biết cách người dùng truy cập vào danh sách phát.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews filters=country==US
Số lượt xem danh sách phát hằng ngày và thời gian xem từ nhiều nguồn lưu lượng truy cập
Yêu cầu này truy xuất số lượt xem danh sách phát hằng ngày của kênh (chỉ số trong danh sách phát), số lượt bắt đầu phát danh sách phát và thời gian xem ước tính. Báo cáo này cũng truy xuất tổng số lượt xem (một chỉ số tổng hợp về video). Các chỉ số này được tổng hợp hằng ngày theo nguồn lưu lượng truy cập và được sắp xếp theo trình tự thời gian.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=day
Báo cáo video
Chỉ số hằng ngày về loại thiết bị cho hệ điều hành Android
Truy vấn này truy xuất số lượt xem hàng ngày và thời gian xem ước tính trên thiết bị Android cho video của một kênh cụ thể. Kết quả được nhóm theo ngày cho từng loại thiết bị có lượt phát video. Các kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=operatingSystem==ANDROID sort=day
Các chỉ số hằng ngày về hệ điều hành trên thiết bị di động
Truy vấn này truy xuất số lượt xem hàng ngày và thời gian xem ước tính trên thiết bị di động cho video của một kênh cụ thể. Kết quả được nhóm theo ngày cho từng hệ điều hành có phát lại video. Các kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=deviceType==MOBILE sort=day
Chỉ số về hệ điều hành và loại thiết bị hằng ngày
Truy vấn này truy xuất số lượt xem hằng ngày và thời gian xem ước tính của một kênh. Số liệu thống kê được nhóm theo hệ điều hành và loại thiết bị. Các kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
Báo cáo danh sách phát
Chỉ số hằng ngày về loại thiết bị cho lượt xem danh sách phát trên hệ điều hành Android
Truy vấn này truy xuất số lượt xem hằng ngày (chỉ số video tổng hợp), lượt xem danh sách phát (chỉ số trong danh sách phát) và thời gian xem ước tính trên thiết bị Android cho một danh sách phát cụ thể. Kết quả được nhóm theo ngày cho từng loại thiết bị có lượt xem danh sách phát. Các kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day,deviceType metrics=views,estimatedMinutesWatched,playlistViews filters=operatingSystem==ANDROID sort=day
Chỉ số hệ điều hành hằng ngày cho lượt xem danh sách phát trên thiết bị di động
Truy vấn này truy xuất số lượt xem hằng ngày (chỉ số video tổng hợp), lượt xem danh sách phát (chỉ số trong danh sách phát) và thời gian xem ước tính trên thiết bị di động đối với một danh sách phát cụ thể. Kết quả được nhóm theo ngày cho từng hệ điều hành có lượt xem danh sách phát. Các kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day,operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE sort=day
Báo cáo video
Thông tin nhân khẩu học của người xem ở California (nhóm tuổi và giới tính)
Báo cáo này truy xuất số liệu thống kê về nhóm tuổi và giới tính của người xem ở California đã xem video của kênh này. Kết quả được sắp xếp theo giới tính, sau đó theo nhóm tuổi. Bạn có thể sửa đổi truy vấn này để lấy cùng một số liệu thống kê cho tất cả người xem trên toàn thế giới hoặc tất cả người xem ở một quốc gia, lục địa, tiểu lục địa hay một tiểu bang khác của Hoa Kỳ bằng cách điều chỉnh giá trị thông số filters.
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
Báo cáo danh sách phát
Thông tin nhân khẩu học của người xem danh sách phát ở California (nhóm tuổi và giới tính)
Báo cáo này truy xuất số liệu thống kê về nhóm tuổi và giới tính của người xem ở California
đã xem danh sách phát của kênh này. Kết quả được sắp xếp theo giới tính, sau đó theo nhóm tuổi. Bạn có thể sửa đổi cụm từ tìm kiếm này để lấy cùng một số liệu thống kê cho tất cả người xem trên toàn thế giới hoặc tất cả người xem ở một quốc gia, lục địa, tiểu lục địa hay một tiểu bang khác của Hoa Kỳ bằng cách điều chỉnh giá trị tham số filters.
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
Các chỉ số về chia sẻ, được tổng hợp theo dịch vụ nơi video được chia sẻ
Yêu cầu này truy xuất số lần người dùng đã sử dụng nút Share để chia sẻ video của một kênh. Kết quả được tổng hợp bằng cách chia sẻ dịch vụ (Google+, Twitter, v.v.) và sắp xếp theo số lượng chia sẻ giảm dần.
dimensions=sharingService metrics=shares sort=-shares
Chỉ số về tỷ lệ giữ chân người xem của video
Báo cáo này đo lường khả năng giữ chân người xem của video. Mỗi lần, bạn chỉ có thể truy xuất báo cáo cho một video. Xin lưu ý rằng để chạy truy vấn này trong APIs Explorer, bạn phải thay thế chuỗi VIDEO_ID trong giá trị tham số filters bằng mã video của một trong các video mà bạn đã tải lên. Lưu ý rằng báo cáo tỷ lệ giữ chân người xem không hỗ trợ khả năng chỉ định nhiều giá trị cho bộ lọc video.
Trong ví dụ này, báo cáo sử dụng bộ lọc audienceType để giới hạn câu trả lời sao cho chỉ chứa dữ liệu về số lượt xem tự nhiên (là kết quả của hành động trực tiếp của người dùng, chẳng hạn như tìm kiếm video hoặc nhấp vào video đề xuất). Do đó, báo cáo không bao gồm dữ liệu cho lượt xem từ quảng cáo TrueView trong luồng hoặc TrueView trong hiển thị. Bạn có thể xoá bộ lọc để truy xuất dữ liệu về tỷ lệ giữ chân người xem của video từ tất cả các kiểu đối tượng.
Lưu ý rằng dữ liệu cho bộ lọc audienceType có sẵn kể từ ngày 25 tháng 9 năm 2013. API sẽ không trả về dữ liệu cho các truy vấn sử dụng bộ lọc để cố truy xuất dữ liệu từ các ngày trước đó. Các truy vấn không sử dụng bộ lọc sẽ hoạt động cho bất kỳ ngày nào sau ngày 1 tháng 7 năm 2008.
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
Chỉ số doanh thu của kênh và hiệu suất quảng cáo
Yêu cầu này truy xuất chỉ số hiệu suất quảng cáo và doanh thu của kênh. Báo cáo trả về một hàng dữ liệu có chứa tổng số cho mỗi chỉ số được yêu cầu trong phạm vi ngày được chỉ định.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
Chỉ số doanh thu hằng ngày và hiệu suất quảng cáo
Yêu cầu này truy xuất chỉ số hiệu suất quảng cáo và doanh thu hàng ngày của kênh.
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
Chỉ số doanh thu và hiệu suất quảng cáo theo quốc gia
Yêu cầu này truy xuất chỉ số hiệu suất quảng cáo và doanh thu của kênh theo quốc gia cụ thể. Kết quả được sắp xếp theo thứ tự giảm dần theo số tiền doanh thu, có nghĩa là quốc gia đầu tiên được liệt kê sẽ là quốc gia nơi đối tác có doanh thu ròng cao nhất.
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks sort=-estimatedRevenue
10 video hàng đầu – Video có doanh thu cao nhất
Yêu cầu này truy xuất các chỉ số về doanh thu và hiệu suất quảng cáo cho 10 video có doanh thu cao nhất của kênh. Kết quả được sắp xếp theo thứ tự doanh thu giảm dần, tức là video đầu tiên sẽ là video có doanh thu ước tính cao nhất.
dimensions=video metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks maxResults=10 sort=-estimatedRevenue
Chỉ số hiệu suất quảng cáo cho các loại quảng cáo
Yêu cầu này truy xuất chỉ số hiệu suất quảng cáo cho nội dung được xác nhận quyền sở hữu của chủ sở hữu nội dung. Kết quả được nhóm theo loại quảng cáo, cho phép bạn so sánh doanh thu và giá trị CPM trên các loại quảng cáo khác nhau.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType
Báo cáo của chủ sở hữu nội dung
Báo cáo video
Tổng số lượt xem, thời gian xem ước tính và các thông tin khác cho tất cả nội dung đã được xác nhận quyền sở hữu
Truy vấn này truy xuất chỉ số tổng hợp cho nội dung đã xác nhận quyền sở hữu của chủ sở hữu nội dung. Báo cáo trả về một hàng dữ liệu có chứa tổng số cho mỗi chỉ số được yêu cầu trong phạm vi ngày được chỉ định.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed
Số lượt xem theo quốc gia cụ thể (và các số liệu khác) của tất cả video tự tải lên
Truy vấn này truy xuất chỉ số cho một quốc gia cụ thể của những video mà chủ sở hữu nội dung đã tải lên. Báo cáo trả về một hàng dữ liệu có chứa tổng số cho mỗi chỉ số được yêu cầu trong phạm vi ngày được chỉ định.
metrics=views,comments,likes,dislikes,shares filters=uploaderType==self;country==FR
Tổng số lượt xem (và các dữ liệu khác) cho tất cả nội dung của bên thứ ba đã được xác nhận quyền sở hữu
Truy vấn này truy xuất chỉ số tổng hợp cho những video mà chủ sở hữu nội dung đã xác nhận quyền sở hữu nhưng không tải lên. Báo cáo trả về một hàng dữ liệu có chứa tổng số cho mỗi chỉ số được yêu cầu trong phạm vi ngày được chỉ định.
metrics=views,comments,likes,dislikes,shares filters=uploaderType==thirdParty;claimedStatus==claimed
Tổng số lượt xem (và các dữ liệu khác) của tất cả nội dung tự tải lên
Truy vấn này truy xuất chỉ số tổng hợp cho những video mà chủ sở hữu nội dung đã tải lên. Báo cáo trả về một hàng dữ liệu có chứa tổng số cho mỗi chỉ số được yêu cầu trong phạm vi ngày được chỉ định.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self
Tổng số lượt xem (và các dữ liệu khác) của tất cả nội dung tự tải lên và đã được xác nhận quyền sở hữu
Truy vấn này truy xuất chỉ số tổng hợp cho những video mà chủ sở hữu nội dung đã tải lên và cũng xác nhận quyền sở hữu. Báo cáo trả về một hàng dữ liệu có chứa tổng số cho mỗi chỉ số được yêu cầu trong phạm vi ngày được chỉ định.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self;claimedStatus==claimed
10 video hàng đầu – Những video được xem nhiều nhất của một chủ sở hữu nội dung
Truy vấn này truy xuất 10 video được xem nhiều nhất, được đo lường theo số lượt xem trong phạm vi ngày được chỉ định, mà chủ sở hữu nội dung đã tải lên. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần.
dimensions=video metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions filters=uploaderType==self maxResults=10 sort=-views
10 video hàng đầu – Những video được xem nhiều nhất của một chủ sở hữu nội dung
Truy vấn này truy xuất 10 video được xem nhiều nhất, được đo bằng số phút đã xem ước tính trong phạm vi ngày được chỉ định, mà chủ sở hữu nội dung đã tải lên. Kết quả được sắp xếp theo số phút đã xem ước tính theo thứ tự giảm dần.
dimensions=video metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained filters=uploaderType==self maxResults=10 sort=-estimatedMinutesWatched
10 video hàng đầu – Những video được xem nhiều nhất trên kênh của một chủ sở hữu nội dung
Truy vấn này truy xuất 10 video được xem nhiều nhất của một kênh hoặc nhóm kênh cụ thể mà chủ sở hữu nội dung quản lý. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần. Xin lưu ý rằng để chạy truy vấn này trong APIs Explorer, bạn phải thay thế chuỗi CHANNEL_ID trong giá trị thông số filters bằng một danh sách gồm tối đa 500 mã nhận dạng kênh được phân tách bằng dấu phẩy cho kênh của bạn.
dimensions=video metrics=views filters=channel==CHANNEL_ID maxResults=10 sort=-views
10 hàng đầu – Tỷ lệ nhấp vào chú thích cho những video được xem nhiều nhất của một kênh
Yêu cầu này truy xuất số lượt xem, tỷ lệ nhấp của chú thích, tỷ lệ đóng chú thích và số lượt hiển thị chú thích cho 10 video được xem nhiều nhất trong một kênh hoặc nhóm kênh được chỉ định. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần, tức là video có nhiều lượt xem nhất sẽ được liệt kê trước. Xin lưu ý rằng để chạy truy vấn này trong APIs Explorer, bạn phải thay thế chuỗi CHANNEL_ID trong giá trị thông số filters bằng một danh sách gồm tối đa 500 mã nhận dạng kênh được phân tách bằng dấu phẩy cho kênh của bạn.
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=channel==CHANNEL_ID maxResults=10 sort=-views
Báo cáo danh sách phát
Lượt xem danh sách phát trên các kênh của chủ sở hữu nội dung
Yêu cầu này truy xuất tổng số lần bắt đầu phát của danh sách phát, số phút đã xem ước tính của danh sách phát, số lượt xem
danh sách phát và số lượt xem trên mỗi lần bắt đầu của danh sách phát đối với các danh sách phát trên kênh của chủ sở hữu nội dung. Chỉ số
playlistViews chỉ tính các lượt xem video xảy ra trong bối cảnh
của một danh sách phát. Vì mọi chỉ số được yêu cầu đều là chỉ số trong danh sách phát, nên yêu cầu cũng không cần phải có bộ lọc danh sách phát hoặc nhóm.
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
Số liệu thống kê cho một danh sách phát cụ thể
Yêu cầu này sẽ truy xuất tổng số lượt bắt đầu phát của danh sách phát, số phút đã xem ước tính, số lượt xem (một chỉ số tổng hợp về video), số lượt xem danh sách phát (chỉ số trong danh sách phát) và số lượt xem trên mỗi lần bắt đầu của một danh sách phát cụ thể. Xin lưu ý rằng để chạy truy vấn này trong API Explorer (Trình khám phá API), bạn phải thay thế chuỗi PLAYLIST_ID trong giá trị tham số filters bằng mã nhận dạng danh sách phát của một danh sách phát trên một trong các kênh của chủ sở hữu nội dung.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
Để truy xuất số liệu thống kê tổng hợp cho nhiều danh sách phát, bạn cũng có thể thay thế chuỗi PLAYLIST_ID bằng một danh sách gồm tối đa 500 mã nhận dạng danh sách phát được phân tách bằng dấu phẩy cho các danh sách phát trên kênh của chủ sở hữu nội dung.
Báo cáo video
Chỉ số thời gian xem hằng ngày đối với nội dung tự tải lên
Truy vấn này truy xuất chỉ số thời gian xem hằng ngày cũng như số lượt xem, số lượt phát có thể kiếm tiền và số lượt hiển thị của những video mà chủ sở hữu nội dung đã tải lên. Báo cáo trả về một hàng dữ liệu cho mỗi ngày trong phạm vi ngày được yêu cầu và các hàng được sắp xếp theo thứ tự thời gian.
dimensions=day metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions filters=uploaderType==self sort=day
Chỉ số về chú thích cho nội dung đã được xác nhận quyền sở hữu
Yêu cầu này truy xuất số lượt xem hằng ngày, tỷ lệ nhấp của chú thích, tỷ lệ đóng chú thích và số lượt hiển thị chú thích cho nội dung được xác nhận quyền sở hữu của chủ sở hữu nội dung. Các kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=claimedStatus==claimed sort=day
Báo cáo danh sách phát
Số lượt xem danh sách phát hằng ngày của một chủ sở hữu nội dung
Yêu cầu này truy xuất chỉ số về các lượt tương tác hằng ngày của người dùng với các video trong danh sách phát của chủ sở hữu nội dung. Các chỉ số được truy xuất trong báo cáo là playlistViews, playlistStarts, playlistEstimatedMinutesWatched và viewsPerPlaylistStart. Tất cả các chỉ số này đều là chỉ số trong danh sách phát. Vì mọi chỉ số được yêu cầu đều là chỉ số trong danh sách phát, nên yêu cầu không nhất thiết phải thêm bộ lọc danh sách phát hoặc nhóm.
dimensions=day metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart sort=day
Báo cáo video
Chỉ số thời gian xem theo quốc gia cụ thể đối với nội dung tự tải lên
Truy vấn này truy xuất số lượt xem, chỉ số thời gian xem và doanh thu quảng cáo ước tính cho từng quốc gia. Chỉ số này dành cho những video mà chủ sở hữu nội dung đã tải lên. Báo cáo trả về một hàng dữ liệu cho mỗi quốc gia nơi video được xem và các hàng được sắp xếp theo thứ tự giảm dần số phút đã xem.
dimensions=country metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue filters=uploaderType==self sort=-estimatedMinutesWatched
Chỉ số chú thích theo quốc gia cụ thể cho nội dung tự tải lên
Yêu cầu này truy xuất số lượt xem theo quốc gia cụ thể, tỷ lệ nhấp của chú thích, tỷ lệ đóng chú thích và số lượt hiển thị chú thích cho video do chủ sở hữu nội dung tải lên. Kết quả được sắp xếp theo tỷ lệ nhấp vào chú thích theo thứ tự giảm dần, tức là quốc gia có tỷ lệ nhấp vào chú thích cao nhất sẽ được liệt kê trước.
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=uploaderType==self sort=-annotationClickThroughRate
Chỉ số theo tỉnh cụ thể cho các tiểu bang của Hoa Kỳ và Washington D.C.
Yêu cầu này truy xuất bảng phân tích số lượt xem theo tỉnh, số phút đã xem ước tính và thời lượng xem trung bình cho các video đã được xác nhận quyền sở hữu của chủ sở hữu nội dung. Dữ liệu bao gồm các tiểu bang của Hoa Kỳ và Washington D.C. Kết quả được sắp xếp theo thứ tự bảng chữ cái theo mã ISO 3166-2 của các tỉnh.
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
10 thành phố hàng đầu ở Hoa Kỳ theo tổng số lượt xem
Truy vấn này truy xuất danh sách 10 thành phố tại Hoa Kỳ chiếm nhiều lượt xem nhất trong các video đã được xác nhận quyền sở hữu của chủ sở hữu nội dung trong phạm vi ngày được chỉ định. Bạn có thể sửa đổi cụm từ tìm kiếm để yêu cầu dữ liệu cho một quốc gia khác bằng cách chọn một giá trị hợp lệ khác cho bộ lọc đó. Tương tự, bạn có thể sửa đổi truy vấn để truy xuất dữ liệu cho một tiểu lục địa, chẳng hạn như Tây Âu hoặc Đông Nam Á, bằng cách sử dụng bộ lọc subContinent và một trong các giá trị hợp lệ của bộ lọc đó. Các bộ lọc khác cũng được hỗ trợ. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần.
dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views
10 thành phố hàng đầu ở Hoa Kỳ theo tổng số lượt xem đối với từng loại nội dung
Truy vấn này truy xuất danh sách 10 thành phố tại Hoa Kỳ chiếm nhiều lượt xem nhất từ nội dung được xác nhận quyền sở hữu của chủ sở hữu nội dung trong phạm vi ngày được chỉ định cho mỗi creatorContentType được hỗ trợ. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần.
dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views
10 thành phố hàng đầu ở Hoa Kỳ theo tổng thời gian xem
Truy vấn này truy xuất danh sách 10 ngày hàng đầu trong phạm vi ngày được chỉ định khi bất kỳ thành phố nào ở Hoa Kỳ chiếm tổng thời gian xem hàng ngày lớn nhất cho nội dung đã được xác nhận quyền sở hữu của chủ sở hữu nội dung. Kết quả truy vấn xác định tổng thời gian xem, ngày xuất hiện thời gian xem và thành phố ước tính khán giả xem nội dung đó. Kết quả được sắp xếp theo thứ tự giảm dần của tổng thời gian xem.
dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime
10 video hàng đầu – Những video được xem nhiều nhất ở Châu Âu
Truy vấn này truy xuất 10 video được xem nhiều nhất ở Châu Âu, trong số các video do chủ sở hữu nội dung xác nhận quyền sở hữu, và được đo lường theo số lượt xem trong phạm vi ngày được chỉ định. Bạn có thể sửa đổi truy vấn để yêu cầu dữ liệu cho một Châu lục khác bằng cách chọn một giá trị hợp lệ khác cho bộ lọc đó. Tương tự, bạn có thể sửa đổi truy vấn để truy xuất dữ liệu cho một tiểu lục địa, chẳng hạn như Tây Âu hoặc Đông Nam Á, bằng cách sử dụng bộ lọc subContinent và một trong các giá trị hợp lệ của bộ lọc đó. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=claimedStatus==claimed;filters=continent==150 maxResults=10 sort=-estimatedMinutesWatched
Báo cáo danh sách phát
Chỉ số thời gian xem theo quốc gia cụ thể cho danh sách phát của một chủ sở hữu nội dung
Truy vấn này truy xuất số lượt xem danh sách phát theo quốc gia cụ thể và chỉ số thời gian xem danh sách phát cho tất cả các danh sách phát trên kênh của chủ sở hữu nội dung. Báo cáo này trả về một hàng dữ liệu cho mỗi quốc gia nơi người dùng xem các danh sách phát đó. Các hàng được sắp xếp theo thứ tự giảm dần về số phút xem.
dimensions=country metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-playlistEstimatedMinutesWatched
10 danh sách phát hàng đầu – Các danh sách phát được bắt đầu nhiều nhất ở Hoa Kỳ
Truy vấn này truy xuất 10 danh sách phát từ các kênh của chủ sở hữu nội dung mà người xem ở Hoa Kỳ bắt đầu xem thường xuyên nhất trong phạm vi ngày được chỉ định. Kết quả được sắp xếp theo số lần bắt đầu phát của danh sách phát theo thứ tự giảm dần.
Lưu ý: Vì báo cáo này sử dụng phương diện
playlist, nên bạn phải
chỉ định một giá trị cho tham số yêu cầu sort và cũng đặt tham số
maxResults thành một giá trị số nguyên từ 10 trở xuống.
dimensions=playlist metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration filters=country==US maxResults=10 sort=-playlistStarts
Báo cáo video
Số lượt thích và không thích theo loại nội dung
Truy vấn này truy xuất số lượt thích và không thích cho mỗi loại nội dung trên một kênh hoặc nhóm kênh cụ thể. Xin lưu ý rằng để chạy truy vấn này trong APIs Explorer, bạn phải thay thế chuỗi CHANNEL_ID trong giá trị thông số filters bằng một danh sách gồm tối đa 500 mã nhận dạng kênh được phân tách bằng dấu phẩy cho kênh của bạn.
dimensions=creatorContentType metrics=likes,dislikes filters=channel==CHANNEL_ID
Báo cáo video
Số lượt xem và thời gian xem từ các vị trí phát khác nhau
Truy vấn này truy xuất số lượt xem và thời gian xem ước tính cho các video đã tải lên một kênh hoặc nhóm kênh cụ thể. Kết quả được tổng hợp dựa trên loại trang hoặc ứng dụng có lượt phát video. Ngoài ra, các kết quả được sắp xếp theo thứ tự giảm dần theo số lượt xem. Xin lưu ý rằng để chạy truy vấn này trong APIs Explorer, bạn phải thay thế chuỗi CHANNEL_ID trong giá trị thông số filters bằng một danh sách gồm tối đa 500 mã nhận dạng kênh được phân tách bằng dấu phẩy cho kênh của bạn.
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=channel==CHANNEL_ID sort=-views
Số lượt xem hằng ngày và thời gian xem ở các vị trí phát khác nhau
Truy vấn này truy xuất số lượt xem hàng ngày và thời gian xem ước tính ở Hoa Kỳ cho các video được tải lên một kênh hoặc nhóm kênh cụ thể. Kết quả được nhóm theo ngày cho từng loại trang hoặc ứng dụng có lượt phát video. Kết quả được sắp xếp theo thứ tự thời gian đảo ngược. Xin lưu ý rằng để chạy truy vấn này trong APIs Explorer, bạn phải thay thế chuỗi CHANNEL_ID trong giá trị thông số filters bằng một danh sách gồm tối đa 500 mã nhận dạng kênh được phân tách bằng dấu phẩy cho kênh của bạn.
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US;channel==CHANNEL_ID sort=-day
10 hàng đầu – Các trang web của bên thứ ba tạo ra nhiều lượt xem nhất cho video được nhúng
Truy vấn này truy xuất số lượt xem và thời gian xem ước tính cho một video hoặc nhóm video cụ thể. Kết quả được nhóm theo trang web của bên thứ ba nơi video được nhúng. Kết quả được sắp xếp theo thứ tự giảm dần theo số lượt xem. Xin lưu ý rằng để chạy truy vấn này trong APIs Explorer, bạn phải thay thế chuỗi VIDEO_ID trong giá trị thông số filters bằng một danh sách gồm tối đa 500 mã video được phân tách bằng dấu phẩy cho video mà bạn đã tải lên.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Báo cáo danh sách phát
Số lượt xem danh sách phát và thời gian xem ở các vị trí phát khác nhau
Truy vấn này truy xuất số lượt xem danh sách phát, thời gian xem ước tính của danh sách phát và số lượt bắt đầu phát của tất cả danh sách phát trên kênh của một chủ sở hữu nội dung. Kết quả được tổng hợp dựa trên loại trang hoặc ứng dụng có lượt phát video và sắp xếp kết quả theo thứ tự giảm dần theo số lần bắt đầu phát của danh sách phát.
dimensions=insightPlaybackLocationType metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts sort=-playlistStarts
Số lượt xem danh sách phát và thời gian xem ở các vị trí phát khác nhau
Truy vấn này truy xuất số lần bắt đầu danh sách phát hằng ngày, số lượt xem danh sách phát và thời gian xem ước tính của danh sách phát ở Hoa Kỳ cho tất cả các danh sách phát trên kênh của một chủ sở hữu nội dung. Kết quả được trả về cho từng loại trang hoặc ứng dụng có lượt xem danh sách phát.
dimensions=day,insightPlaybackLocationType metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched filters=country==US
Báo cáo video
Số lượt xem và thời gian xem từ các nguồn lưu lượng truy cập khác nhau
Yêu cầu này truy xuất số lượt xem và thời gian xem ước tính cho video của chủ sở hữu nội dung. Các chỉ số này được tổng hợp theo nguồn lưu lượng truy cập, cho biết cách người dùng xem video.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self
Số lượt xem hằng ngày và thời gian xem từ các nguồn lưu lượng truy cập khác nhau
Yêu cầu này truy xuất số lượt xem hằng ngày và thời gian xem ước tính hằng ngày cho video của chủ sở hữu nội dung. Các chỉ số được tổng hợp hằng ngày theo nguồn lưu lượng truy cập và được sắp xếp theo trình tự thời gian đảo ngược.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self sort=-day
Lưu ý: Hai báo cáo mẫu tiếp theo 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 đó, các báo cáo này không có sẵn cho nguồn đó. Xem định nghĩa insightTrafficSourceType để biết thông tin chi tiết về các nguồn lưu lượng truy cập có sẵn các loại báo cáo này.
10 cụm từ hàng đầu – Cụm từ tìm kiếm trên YouTube tạo ra nhiều lưu lượng truy cập nhất cho một video
Truy vấn này truy xuất 10 cụm từ tìm kiếm tạo ra nhiều lượt xem nhất từ kết quả tìm kiếm trên YouTube cho một video hoặc nhóm video cụ thể. Kết quả được sắp xếp theo số lượt xem theo thứ tự giảm dần. Xin lưu ý rằng để chạy truy vấn này trong APIs Explorer, bạn phải thay thế chuỗi VIDEO_ID trong giá trị thông số filters bằng một danh sách gồm tối đa 500 mã video được phân tách bằng dấu phẩy cho video mà bạn đã tải lên.
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
10 trang web hàng đầu – Các trang web bên ngoài tạo ra nhiều lưu lượng truy cập nhất cho một video
Truy vấn này truy xuất 10 trang web bên ngoài đã tạo ra nhiều lượt xem nhất từ kết quả tìm kiếm của Google cho một video hoặc nhóm video cụ thể. Kết quả được sắp xếp theo thời gian xem ước tính theo thứ tự giảm dần. Xin lưu ý rằng để chạy truy vấn này trong APIs Explorer, bạn phải thay thế chuỗi VIDEO_ID trong giá trị thông số filters bằng một danh sách gồm tối đa 500 mã video được phân tách bằng dấu phẩy cho video mà bạn đã tải lên.
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
Báo cáo danh sách phát
Số lượt xem danh sách phát và thời gian xem từ nhiều nguồn lưu lượng truy cập trong một quốc gia
Yêu cầu này truy xuất số lượt xem danh sách phát, số lượt bắt đầu phát của danh sách phát và thời gian xem ước tính của danh sách phát đối với các lượt xem danh sách phát ở một quốc gia cụ thể. Các chỉ số này được tổng hợp theo nguồn lưu lượng truy cập thể hiện cách người dùng truy cập vào danh sách phát.
dimensions=insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=country==US
Số lượt xem danh sách phát và thời gian xem từ các nguồn lưu lượng truy cập khác nhau
Yêu cầu này truy xuất số lượt xem danh sách phát, số lượt bắt đầu phát và thời gian xem ước tính của danh sách phát
cho các danh sách phát trên một hoặc nhiều kênh của chủ sở hữu nội dung. Các chỉ số này được tổng hợp theo
nguồn lưu lượng truy cập. Xin lưu ý rằng để chạy truy vấn này trong APIs Explorer, bạn phải thay thế chuỗi CHANNEL_ID trong giá trị thông số filters bằng một danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã nhận dạng kênh cho kênh của bạn.
dimensions=day,insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID
Báo cáo video
Chỉ số hằng ngày về loại thiết bị cho video đã được xác nhận quyền sở hữu
Truy vấn này truy xuất số lượt xem hằng ngày và thời gian xem ước tính theo loại thiết bị đối với những video do một chủ sở hữu nội dung cụ thể xác nhận quyền sở hữu. Kết quả được nhóm theo ngày cho từng loại thiết bị có lượt phát video. Các kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed sort=day
Chỉ số hệ điều hành hằng ngày cho video đã được xác nhận quyền sở hữu được xem trên thiết bị di động
Truy vấn này truy xuất số lượt xem hàng ngày và thời gian xem ước tính theo hệ điều hành đối với số lượt xem video đã được một chủ sở hữu nội dung cụ thể xác nhận quyền sở hữu diễn ra trên thiết bị di động. Kết quả được nhóm theo ngày cho từng hệ điều hành nơi phát lại video. Các kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed;deviceType==MOBILE sort=day
Chỉ số về hệ điều hành và loại thiết bị hằng ngày
Truy vấn này truy xuất số lượt xem hằng ngày và thời gian xem ước tính cho những video đã được một chủ sở hữu nội dung cụ thể xác nhận quyền sở hữu. Số liệu thống kê được nhóm theo hệ điều hành và loại thiết bị. Các kết quả được sắp xếp theo thứ tự thời gian.
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
Báo cáo danh sách phát
Chỉ số loại thiết bị cho lượt xem danh sách phát trên hệ điều hành Android
Truy vấn này truy xuất số lượt xem danh sách phát và thời gian xem ước tính của danh sách phát trên thiết bị Android đối với danh sách phát trên một hoặc nhiều kênh của một chủ sở hữu nội dung. Kết quả được trả về cho từng loại thiết bị có lượt xem danh sách phát. Xin lưu ý rằng để chạy truy vấn này trong Trình khám phá API, bạn phải thay thế chuỗi CHANNEL_ID trong giá trị thông số filters bằng một danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã nhận dạng kênh cho kênh của bạn.
dimensions=deviceType metrics=playlistViews,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID;operatingSystem==ANDROID
Chỉ số hệ điều hành cho lượt xem danh sách phát trên thiết bị di động
Truy vấn này truy xuất số lượt xem danh sách phát và thời gian xem ước tính của danh sách phát trên thiết bị di động đối với danh sách phát trên bất kỳ kênh nào của chủ sở hữu nội dung. Kết quả được trả về cho từng hệ điều hành nơi lượt xem danh sách phát diễn ra.
dimensions=operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE
Báo cáo video
Thông tin nhân khẩu học của người xem ở California (nhóm tuổi và giới tính)
Báo cáo này truy xuất số liệu thống kê về nhóm tuổi và giới tính của người xem ở California đã xem nội dung do chủ sở hữu nội dung xác nhận quyền sở hữu. Kết quả được sắp xếp theo giới tính, sau đó theo nhóm tuổi. Bạn có thể sửa đổi truy vấn này để lấy cùng một số liệu thống kê cho tất cả người xem trên toàn thế giới hoặc tất cả người xem ở một quốc gia, lục địa, tiểu lục địa hay một tiểu bang khác của Hoa Kỳ bằng cách điều chỉnh giá trị thông số filters.
dimensions=ageGroup,gender metrics=viewerPercentage filters=claimedStatus==claimed;province==US-CA sort=gender,ageGroup
Các chỉ số về chia sẻ, được tổng hợp theo dịch vụ nơi video được chia sẻ
Yêu cầu này truy xuất số lần người dùng đã sử dụng nút Share để chia sẻ video mà chủ sở hữu nội dung đã tải lên. Kết quả được tổng hợp bằng cách chia sẻ dịch vụ (Google+, Twitter, v.v.) và sắp xếp theo số lượng chia sẻ giảm dần.
dimensions=sharingService metrics=shares filters=uploaderType==self sort=-shares
Chỉ số về tỷ lệ giữ chân người xem của video
Báo cáo này đo lường khả năng giữ chân người xem của video. Mỗi lần, bạn chỉ có thể truy xuất báo cáo cho một video. Xin lưu ý rằng để chạy truy vấn này trong APIs Explorer, bạn phải thay thế chuỗi VIDEO_ID trong giá trị tham số filters bằng mã video của một trong các video mà bạn đã tải lên. Lưu ý rằng báo cáo tỷ lệ giữ chân người xem không hỗ trợ khả năng chỉ định nhiều giá trị cho bộ lọc video.
Trong ví dụ này, báo cáo sử dụng bộ lọc audienceType để giới hạn câu trả lời sao cho chỉ chứa dữ liệu về số lượt xem tự nhiên (là kết quả của hành động trực tiếp của người dùng, chẳng hạn như tìm kiếm video hoặc nhấp vào video đề xuất). Do đó, báo cáo không bao gồm dữ liệu cho lượt xem từ quảng cáo TrueView trong luồng hoặc TrueView trong hiển thị. Bạn có thể xoá bộ lọc để truy xuất dữ liệu về tỷ lệ giữ chân người xem của video từ tất cả các kiểu đối tượng.
Lưu ý rằng dữ liệu cho bộ lọc audienceType có sẵn kể từ ngày 25 tháng 9 năm 2013. API sẽ không trả về dữ liệu cho các truy vấn sử dụng bộ lọc để cố truy xuất dữ liệu từ các ngày trước đó. Các truy vấn không sử dụng bộ lọc sẽ hoạt động cho bất kỳ ngày nào sau ngày 1 tháng 7 năm 2008.
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
Chỉ số về doanh thu và hiệu suất quảng cáo cho nội dung đã được xác nhận quyền sở hữu
Yêu cầu này truy xuất chỉ số doanh thu và hiệu suất quảng cáo cho nội dung đã xác nhận quyền sở hữu của chủ sở hữu nội dung. Báo cáo trả về một hàng dữ liệu có chứa tổng số cho mỗi chỉ số được yêu cầu trong phạm vi ngày được chỉ định.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed
Chỉ số doanh thu hằng ngày và hiệu suất quảng cáo
Yêu cầu này truy xuất chỉ số hiệu suất quảng cáo và doanh thu hàng ngày cho nội dung được xác nhận quyền sở hữu của chủ sở hữu nội dung.
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed
Chỉ số doanh thu và hiệu suất quảng cáo theo quốc gia
Yêu cầu này truy xuất chỉ số hiệu suất quảng cáo và doanh thu theo quốc gia cụ thể cho nội dung được xác nhận quyền sở hữu của chủ sở hữu nội dung. Kết quả được sắp xếp theo thứ tự giảm dần theo số tiền doanh thu. Điều này có nghĩa là quốc gia đầu tiên được liệt kê sẽ là quốc gia nơi đối tác có doanh thu ước tính cao nhất.
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed sort=-estimatedRevenue
10 video hàng đầu – Video có doanh thu cao nhất
Yêu cầu này truy xuất chỉ số hiệu suất quảng cáo và doanh thu cho 10 video mà chủ sở hữu nội dung đã xác nhận quyền sở hữu và có doanh thu cao nhất. Kết quả được sắp xếp theo thứ tự doanh thu giảm dần, tức là video đầu tiên sẽ là video có doanh thu ước tính cao nhất.
dimensions=video metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed maxResults=10 sort=-estimatedRevenue
Chỉ số hiệu suất quảng cáo cho các loại quảng cáo
Yêu cầu này truy xuất chỉ số hiệu suất quảng cáo cho nội dung được xác nhận quyền sở hữu của chủ sở hữu nội dung. Kết quả được nhóm theo loại quảng cáo, cho phép bạn so sánh doanh thu và giá trị CPM trên các loại quảng cáo khác nhau.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType