Yêu cầu API mẫu

Báo cáo video

Chỉ số về thời gian xem hằng ngày của các 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 các video của một kênh. Báo cáo này 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

Chỉ số hằng ngày về chú thích 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 vào 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. 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

Lượt xem danh sách phát hằng ngày của một kênh

Yêu cầu này truy xuất số lượt xem hằng ngày (một 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 của 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 của danh sách phát đối với kênh của người dùng đã xác thự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 cụ thể

Truy vấn này truy xuất số lượt xem, chỉ số thời gian xem và số người đăng ký theo quốc gia cho các video của một kênh. 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 video của kênh. 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,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, 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 theo quốc gia cho các 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 tiên.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

Chỉ số theo tỉnh cho các tiểu bang ở Hoa Kỳ và Washington, D.C.

Yêu cầu này truy xuất thông tin chi tiết theo tỉnh về số lượt xem, số phút xem ước tính và thời lượng xem trung bình của các video trên kênh. Dữ liệu này 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 tỉnh bang.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Top 10 – Những video được xem nhiều nhất ở một quốc gia cụ thể

Truy vấn này truy xuất 10 video được xem nhiều nhất của kênh, được tính theo số lượt xem trong phạm vi ngày đã chỉ định, ở một quốc gia cụ thể. 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 giá trị cho tham số yêu cầu sort và đặt tham số maxResults thành giá trị số nguyên từ 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ố ở Hoa Kỳ có nhiều lượt xem nội dung của kênh nhất trong phạm vi ngày đã chỉ định. Bạn có thể sửa đổi truy vấn để 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 (Tiểu lục địa) 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 của từng loại nội dung

Truy vấn này truy xuất danh sách 10 thành phố ở Hoa Kỳ có 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 đã chỉ định, khi bất kỳ thành phố nào của Hoa Kỳ có tổng thời gian xem nội dung của kênh nhiều nhất mỗi ngày. Kết quả truy vấn sẽ xác định tổng thời gian xem, ngày diễn ra thời gian xem và thành phố nơi nội dung được ước tính là đã được xem. 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

Top 10 – 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 của kênh ở Châu Âu, được đo 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 (Tiểu lục địa) 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 giá trị cho tham số yêu cầu sort và đặt tham số maxResults thành giá trị số nguyên từ 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 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ể (một chỉ số video tổng hợp), số lượt xem danh sách phát (chỉ số trong danh sách phát) và chỉ số thời gian xem cho các danh sách phát của một kênh. 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 danh sách phát của kênh. Các hàng được sắp xếp theo thứ tự giảm dần về số phút xem.

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatched

Top 10 – 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 đã chỉ định. Kết quả được sắp xếp theo số lần bắt đầu 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 cũng như đặt tham số maxResults thành 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ừ nhiều vị trí phát

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 kênh cụ thể. Kết quả được tổng hợp dựa trên loại trang hoặc ứng dụng nơi diễn ra lượt phát video và đượ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 và thời gian xem hằng ngày ở nhiều vị trí phát

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ủa 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. 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 một 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 Trình khám phá API, bạn phải thay thế chuỗi VIDEO_ID trong giá trị tham 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 các video 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 và thời gian xem danh sách phát ở nhiều vị trí phát

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ượt bắt đầu danh sách phát của một danh sách phát cụ thể trên một kênh. Kết quả được tổng hợp dựa trên loại trang hoặc ứng dụng nơi xảy ra 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 danh sách phát.

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStarts

Số lượt xem và thời gian xem danh sách phát hằng ngày ở 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), số 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ủa 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 nơi xảy ra 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

Lượt thích và lượt 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 từng loại nội dung trên một 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 ở 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 của các video trên kênh ở 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, mô tả cách người dùng truy cập vào video.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

Số lượt xem và thời gian xem hằng ngày từ các nguồn lưu lượng truy cập

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 các 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 thứ tự thời gian.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

10 cụm từ tìm kiếm hàng đầu trên YouTube giúp video thu hút nhiều lưu lượng truy cập nhất

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 Trình khám phá API, bạn phải thay thế chuỗi VIDEO_ID trong giá trị tham số filters bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã video.

Ví dụ: bạn có thể chạy truy vấn cho một video hoặc thay thế VIDEO_ID để xác định những 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ả video trong một danh sách phát cụ thể để xác định những cụm từ tìm kiếm tạo ra nhiều lưu lượng truy cập nhất cho bất kỳ video nào trong danh sách phát đó.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Top 10 – Những trang web bên ngoài mang đến 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 Trình khám phá API, bạn phải thay thế chuỗi VIDEO_ID trong giá trị tham số filters bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã video cho các 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 và thời gian xem danh sách phát từ các nguồn lưu lượng truy cập khác nhau ở một quốc gia

Yêu cầu này truy xuất số lượt xem (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 và thời gian xem ước tính cho 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, mô tả cách thức mà 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 và thời gian xem danh sách phát hằng ngày 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. Phương thức này cũng truy xuất tổng số lượt xem (một chỉ số video tổng hợp). 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 thứ tự thời gian.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=day

Báo cáo video

Các 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 các 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ị phát video. 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

Chỉ số hằng ngày về hệ điều hành cho 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 các 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 mà người dùng đã phát video. 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ố hằng ngày về hệ điều hành và loại thiết bị

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ị. 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 về danh sách phát

Chỉ số hằng ngày về loại thiết bị cho số 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), số 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 đối với danh sách phát 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ị mà lượt xem danh sách phát đã diễn ra. 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ằng ngày về hệ điều hành cho số 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), số 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 cho các danh sách phát 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 mà lượt xem danh sách phát đã xảy ra. 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ề độ tuổi và giới tính của những người xem ở California đã xem video của kênh. Kết quả được sắp xếp theo giới tính, sau đó là theo nhóm tuổi. Bạn có thể sửa đổi truy vấn này để truy xuất 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 hoặc 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

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ề độ tuổi và giới tính của những người xem ở California đã xem danh sách phát của kênh. Kết quả được sắp xếp theo giới tính, sau đó là 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 cho tất cả người xem ở một quốc gia, châu lục, tiểu lục địa hoặc 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

Chỉ số về hoạt động chia sẻ, được tổng hợp theo dịch vụ mà 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 theo dịch vụ chia sẻ (Google+, Twitter, v.v.) và được sắp xếp theo thứ tự giảm dần của số lượt chia sẻ.

dimensions=sharingService
metrics=shares
sort=-shares

Chỉ số về tỷ lệ giữ chân người xem của một video

Báo cáo này đo lường khả năng giữ chân người xem của một video. Mỗi lần, bạn chỉ có thể truy xuất báo cáo cho một video. 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 những video bạn đã tải lên. Xin lưu ý rằng báo cáo tỷ lệ giữ chân đối tượng không hỗ trợ việc 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 để hạn chế câu trả lời sao cho chỉ chứa dữ liệu về lượt xem tự nhiên, là kết quả của một 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 một video đề xuất. Do đó, báo cáo này không bao gồm dữ liệu về số lượt xem từ quảng cáo TrueView trong luồng hoặc quảng cáo TrueView trong màn hình hiển thị. Bạn có thể xoá bộ lọc này để truy xuất dữ liệu tỷ lệ giữ chân người xem của video từ tất cả các loại đối tượng.

Xin lưu ý rằng dữ liệu cho bộ lọc audienceType có từ ngày 25 tháng 9 năm 2013. API sẽ không trả về dữ liệu cho những truy vấn sử dụng bộ lọc để cố gắng truy xuất dữ liệu từ những ngày trước đó. Các cụm từ tìm kiếm không sử dụng bộ lọc này sẽ hoạt động cho mọi ngày 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 của kênh và hiệu suất quảng cáo

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 của một kênh. Báo cáo này trả về một hàng dữ liệu chứa tổng số cho từng chỉ số được yêu cầu trong phạm vi ngày đã chỉ định.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Chỉ số hiệu suất quảng cáo và doanh thu hằng ngày

Yêu cầu này truy xuất doanh thu hằng ngày và các chỉ số hiệu suất quảng cáo của một kênh.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Chỉ số hiệu suất quảng cáo và doanh thu 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ủa kênh. Kết quả được sắp xếp theo thứ tự giảm dần theo doanh thu, có nghĩa là quốc gia đầu tiên được liệt kê sẽ là quốc gia mà đối tác có doanh thu ròng lớn nhất.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

Top 10 – 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 của 10 video có doanh thu lớn nhất trên kênh. Kết quả được sắp xếp theo thứ tự giảm dần theo số tiền doanh thu, 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 nhiều loại quảng cáo

Yêu cầu này truy xuất các 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 giá trị doanh thu và CPM giữa các loại quảng cáo.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

Báo cáo video

Chỉ số về thời gian xem hằng ngày đối với nội dung do chính bạn tải lên

Truy vấn này truy xuất các chỉ số về 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ị 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 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ố 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 vào 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. 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 các chỉ số về lượt tương tác hằng ngày của người dùng với 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 này 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ì tất cả 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 cần phải bao gồ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 đối với nội dung do người dùng 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 ước tính từ quảng cáo cho từng quốc gia. Các chỉ số này là dành cho những video do chủ sở hữu nội dung tải lên. Báo cáo sẽ 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 về 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 đối với nội dung do người dùng 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 vào chú thích, tỷ lệ đóng chú thích và số lượt hiển thị chú thích cho video đã tải lên của chủ sở hữu nội dung. 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 tiên.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

Chỉ số theo tỉnh cho các tiểu bang ở Hoa Kỳ và Washington, D.C.

Yêu cầu này sẽ truy xuất thông tin chi tiết theo tỉnh về số lượt xem, số phút xem ước tính và thời lượng xem trung bình của những video được xác nhận quyền sở hữu của chủ sở hữu nội dung. Dữ liệu này 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ố ở Hoa Kỳ có nhiều lượt xem nhất đối với các video đã được xác nhận quyền sở hữu của chủ sở hữu nội dung trong khoảng thời gian đã chỉ định. Bạn có thể sửa đổi truy vấn để 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 (Tiểu lục địa) 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 của từng loại nội dung

Truy vấn này truy xuất danh sách 10 thành phố ở Hoa Kỳ có nhiều lượt xem nhất đối với 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ỳ có tổng thời gian xem hằng ngày lớn nhất đối với 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 cho biết tổng thời gian xem, ngày xảy ra thời gian xem và thành phố nơi nội dung được xem theo ước tính. 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

Top 10 – 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ố những video do chủ sở hữu nội dung xác nhận quyền sở hữu, được đo 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 lục địa 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 (Tiểu lục địa) 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 cho danh sách phát của 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 và chỉ số thời gian xem danh sách phát cho tất cả danh sách phát trong các 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 danh sách phát. Các hàng được sắp xếp theo thứ tự giảm dần theo số phút xem.

dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatched

Top 10 – 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 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 giá trị cho tham số yêu cầu sort và cũng đặt tham số maxResults thành 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

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à lượt không thích cho từng 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 Trình khám phá API, bạn phải thay thế chuỗi CHANNEL_ID trong giá trị tham số filters bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã kênh cho các 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ừ nhiều vị trí phát

Truy vấn này truy xuất số lượt xem và thời gian xem ước tính của các video được 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 nơi diễn ra lượt phát video và đượ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 Trình khám phá API, bạn phải thay thế chuỗi CHANNEL_ID trong giá trị tham số filters bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã kênh cho các kênh của bạn.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

Số lượt xem và thời gian xem hằng ngày ở nhiều vị trí phát

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 những 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ự đảo ngược. Lưu ý: Để chạy truy vấn này trong APIs Explorer, bạn phải thay thế chuỗi CHANNEL_ID trong giá trị tham số filters bằng danh sách tối đa 500 mã nhận dạng kênh được phân tách bằng dấu phẩy cho các 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 một 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 Trình khám phá API, bạn phải thay thế chuỗi VIDEO_ID trong giá trị tham số filters bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã video cho các 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 từ 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ần bắt đầu phát danh sách phát cho tất cả danh sách phát trong kênh của 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 nơi diễn ra lượt phát video và được sắp xếp theo thứ tự giảm dần theo số lần bắt đầu 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 từ các vị trí phát khác nhau

Truy vấn này truy xuất số lượt bắt đầu xem danh sách phát hằng ngày, số lượt xem danh sách phát và thời gian xem danh sách phát ước tính tại Hoa Kỳ cho tất cả danh sách phát trong kênh của chủ sở hữu nội dung. Kết quả được trả về cho từng loại trang hoặc ứng dụng nơi xảy ra 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

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, mô tả cách người dùng truy cập vào video.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

Số lượt xem và thời gian xem hằng ngày 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 hằng ngày và thời gian xem ước tính hằng ngày cho các video của chủ sở hữu nội dung. 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 thứ tự đảo ngược theo thứ tự thời gian.

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

10 cụm từ tìm kiếm hàng đầu trên YouTube giúp video thu hút nhiều lưu lượng truy cập nhất

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ừ trang 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 Trình khám phá API, bạn phải thay thế chuỗi VIDEO_ID trong giá trị tham số filters bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã video cho các video mà bạn đã tải lên.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Top 10 – Những trang web bên ngoài mang đến 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 Trình khám phá API, bạn phải thay thế chuỗi VIDEO_ID trong giá trị tham số filters bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã video cho các 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 và thời gian xem danh sách phát từ các nguồn lưu lượng truy cập khác nhau ở 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ần bắt đầu danh sách phát và thời gian xem ước tính của danh sách phát cho lượt xem danh sách phát ở một quốc gia được chỉ định. Các chỉ số được tổng hợp theo nguồn lưu lượng truy cập, mô tả 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 và thời gian xem danh sách phát 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, số lần bắt đầu 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 danh sách phát thuộc một hoặc nhiều kênh của một chủ sở hữu nội dung. Các chỉ số đượ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 Trình khám phá API, bạn phải thay thế chuỗi CHANNEL_ID trong giá trị tham số filters bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã kênh cho các kênh của bạn.

dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID

Báo cáo video

Chỉ số về loại thiết bị hằng ngày đối với 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 trên từng loại thiết bị có lượt phát video. 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ằng ngày về hệ điều hành đối với những 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 do 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 diễn ra lượt phát 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ố hằng ngày về hệ điều hành và loại thiết bị

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 những video do 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ố về loại thiết bị cho số 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 về danh sách phát trên thiết bị Android đối với các danh sách phát thuộc 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ị mà lượt xem danh sách phát đã xảy ra. 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ị tham số filters bằng danh sách được phân tách bằng dấu phẩy gồm tối đa 500 mã kênh cho các kênh của bạn.

dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROID

Chỉ số hệ điều hành đối với 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 trong bất kỳ kênh nào của chủ sở hữu nội dung. Hệ thống sẽ trả về kết quả cho từng hệ điều hành xảy ra lượt xem danh sách phát.

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ề độ tuổi và giới tính của những người xem ở California đã xem 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 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 cho tất cả người xem ở một quốc gia, châu lục, tiểu lục địa hoặc 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=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

Chỉ số về việc chia sẻ, 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 do chủ sở hữu nội dung tải lên. Kết quả được tổng hợp theo dịch vụ chia sẻ (Google+, Twitter, v.v.) và sắp xếp theo thứ tự giảm dần về số lượt chia sẻ.

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 một 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 Trình khám phá API, 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 những video 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 để hạn chế phản hồi chỉ chứa dữ liệu về lượt xem tự nhiên. Đây là kết quả của một hành động trực tiếp của người dùng, chẳng hạn như tìm kiếm một video hoặc nhấp vào một video được đề xuất. Do đó, báo cáo này không bao gồm dữ liệu về số lượt xem từ quảng cáo TrueView trong luồng hoặc quảng cáo TrueView trong màn hình hiển thị. Bạn có thể xoá bộ lọc này để truy xuất dữ liệu tỷ lệ giữ chân người xem của video từ tất cả các loại đối tượng.

Lưu ý rằng dữ liệu cho bộ lọc audienceType có sẵn 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ố gắng truy xuất dữ liệu từ các ngày trước đó. Các cụm từ tìm kiếm không sử dụng bộ lọc này sẽ hoạt động cho mọi ngày 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 các chỉ số về doanh thu và hiệu suất quảng cáo cho nội dung mà chủ sở hữu nội dung đã xác nhận quyền sở hữu. Báo cáo này trả về một hàng dữ liệu chứa tổng số cho từng chỉ số được yêu cầu trong phạm vi ngày đã 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ố doanh thu và hiệu suất quảng cáo 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 các chỉ số về hiệu suất quảng cáo và doanh thu theo quốc gia đối với 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ố doanh thu, tức là quốc gia đầu tiên được liệt kê sẽ là quốc gia mà đối tác có doanh thu ước tính lớn nhất.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

Top 10 – 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 của 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ự giảm dần theo số tiền doanh thu, 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 nhiều loại quảng cáo

Yêu cầu này truy xuất các 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 giá trị doanh thu và CPM giữa các loại quảng cáo.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType