Yêu cầu API mẫu

Báo cáo video

Chỉ số thời gian xem hằng ngày cho video của 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 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ố 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 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. 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

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), lượt xem danh sách phát (chỉ số trong danh sách phát), số lần bắt đầu danh sách phát, số phút đã xem ước tính và số lượt xem mỗi lần bắt đầu của danh sách phát đã được xác thực trên kênh của người dùng. 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 cụ thể

Truy vấn này truy xuất số lượt xem, chỉ số thời gian xem và số liệu đăng ký theo quốc gia cụ thể cho video của một kênh. Báo cáo này trả về một hàng dữ liệu của mỗi quốc gia nơi có người xem video trên kênh đó. Các hàng được sắp xếp theo thứ tự 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 vào 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, điều này có nghĩa là quốc gia có tỷ lệ nhấp vào chú thích cao nhất sẽ được liệt kê đầu tiên.

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 dữ liệu chi tiết theo từng tỉnh về số lượt xem, số phút đã xem ước tính và thời lượng xem trung bình cho video của 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 tỉnh Mã ISO 3166-2.

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

10 hàng đầu – Các 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, đo bằng số lượt xem trong phạm vi ngày được chỉ định, ở 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 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 tại Hoa Kỳ theo tổng số lượt xem

Truy vấn này truy xuất danh sách 10 thành phố của Hoa Kỳ chiếm số lượt xem nội dung của kênh nhiều nhất 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 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 nó. 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 tại Hoa Kỳ theo tổng số lượt xem cho từng loại nội dung

Truy vấn này sẽ truy xuất danh sách 10 thành phố ở Hoa Kỳ chiếm số lượt xem nội dung của kênh nhiều 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 tại 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 đối với nội dung của kênh. 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

10 video hàng đầu – Các 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 và một trong các giá trị hợp lệ của nó. 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 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 danh sách phát của kênh theo quốc gia cụ thể

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), lượt xem danh sách phát (chỉ số trong danh sách phát), và thời gian xem cho danh sách phát của kênh. Báo cáo sẽ trả về một hàng dữ liệu cho mỗi hàng quốc gia nơi danh sách phát của kênh đã được xem. Các hàng được sắp xếp theo thứ tự 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 tại 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ố 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ừ 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 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ó phát lại video và 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 và thời gian xem hằng ngày từ 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ủ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. 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 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ể. Các 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. 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 danh sách một hoặc nhiều mã video được phân tách bằng dấu phẩy của những 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 danh sách phát và thời gian xem ở nhiều vị trí phát

Truy vấn này truy xuất số lượt xem (một 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 cho danh sách phát của một kênh cụ thể. Kết quả là được tổng hợp dựa trên loại trang hoặc ứng dụng nơi phát lại video và kết quả được sắp xếp theo thứ tự giảm dần theo số điểm bắt đầu 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 từ nhiều vị trí phát

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 (một 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 danh sách phát của một kênh cụ thể. Kết quả được nhóm theo ngày cho mỗi loại trang hoặc ứng dụng nơi diễn 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 kênh.

dimensions=creatorContentType
metrics=likes,dislikes

Báo cáo video

Số lượt xem 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 và thời gian xem ước tính cho các video của 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ừ 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 đối với các video trên 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ừ hàng đầu – Các 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. Lưu ý: Để 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 danh sách 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 riêng lẻ 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 nào 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

10 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. 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 danh sách tối đa 500 mã video được phân tách bằng dấu phẩy cho những video 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ừ 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 (một chỉ số video tổng hợp), lượt xem danh sách phát (chỉ số trong danh sách phát), số lần bắt đầu phát danh sách phát và thời gian xem ước tính đối với lượt xem danh sách phát ở một quốc gia cụ thể. Chiến lược phát hành đĩa đơn các chỉ số được tổng hợp theo nguồn lưu lượng truy cập, thể hiện 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 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 lượt xem danh sách phát hàng ngày của kênh (một trong danh sách phát), số lần bắt đầu danh sách phát và thời gian xem ước tính. Thao tá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ố 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,playlistStarts,playlistViews
sort=day

Báo cáo video

Chỉ số loại thiết bị hằng ngày trên 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ị 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

Chỉ số hệ điều hành hằng ngày 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 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 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=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ị. 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ị hằng ngày đối với lượt xem danh sách phát trên hệ điều hành Android

Truy vấn này truy xuất chế độ xem hàng ngày (một 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 danh sách phát của một kênh cụ thể. Kết quả là đượ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 đố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 chế độ xem hàng ngày (một 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 cho danh sách phát của một kênh cụ thể. Kết quả là đượ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. 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=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 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 đó theo nhóm tuổi. Chiến dịch này có thể sửa đổi để 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 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ị thông số filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=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 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 video

Báo cáo này đánh giá 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. 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ế 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 không bao gồm dữ liệu về số 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 để lấy 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 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 đó. Những truy vấn không sử dụng bộ lọc này 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

Các chỉ số về hiệu suất quảng cáo và doanh thu của kênh

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 kênh. Báo cáo trả về một hàng dữ liệu duy nhất chứa tổng số cho từng 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ố hiệu suất quảng cáo và doanh thu hằng ngày

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ố 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

10 video hàng đầu – Những 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. Các kết quả được sắp xếp theo thứ tự giảm dần theo 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 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 giá trị doanh thu và giá trị CPM trên nhiều loại quảng cáo.

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

Báo cáo video

Chỉ số thời gian xem hằng ngày của 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

Các 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 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. 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

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ề hoạt động tương tác hằng ngày của người dùng với video trong trang chủ sở hữu nội dung danh sách phát. 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 là chỉ số trong danh sách phát. Vì tất cả cá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 bao gồm cả 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 của nội dung tự tải lên 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à doanh thu quảng cáo ước tính cho mỗi quốc gia. Đây là chỉ số dành cho những video mà 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 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 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, điều này có nghĩa là quốc gia có tỷ lệ nhấp vào chú thích cao nhất sẽ được liệt kê đầu tiên.

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 dữ liệu chi tiết theo từng tỉnh về số lượt xem, số phút đã xem ước tính và thời lượng xem trung bình cho 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 tỉnh Mã ISO 3166-2.

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

10 thành phố hàng đầu tại Hoa Kỳ theo tổng số lượt xem

Truy vấn này truy xuất danh sách 10 thành phố của Hoa Kỳ chiếm 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 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 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 nó. 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 tại Hoa Kỳ theo tổng số lượt xem cho từng loại nội dung

Truy vấn này truy xuất danh sách 10 thành phố ở Hoa Kỳ chiếm số lượt xem nhiều 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 tại 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 một thành phố bất kỳ ở Hoa Kỳ chiếm 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 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=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

10 video hàng đầu – Các 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 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 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,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 danh sách phát của chủ sở hữu nội dung theo quốc gia cụ thể

Truy vấn này truy xuất số lượt xem danh sách phát và chỉ số thời gian xem danh sách phát theo quốc gia cụ thể cho tất cả danh sách phát trên kênh của chủ sở hữu nội dung. Báo cáo sẽ trả về một hàng dữ liệu cho mỗi hàng quốc gia nơi danh sách phát được xem. Các hàng được sắp xếp theo thứ tự giảm dần của 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 tại 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 trong Hoa Kỳ bắt đầu xem thường xuyên nhất trong phạm vi ngày được chỉ định. Kết quả là đượ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 playlist, bạn phải chỉ định một giá trị cho tham số yêu cầu sort và cũng đặt th 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

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 hoặc nhóm kênh cụ thể. 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=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 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 có lượt phát lại video và kết quả được sắp xếp theo thứ tự giảm dần theo số lượt xem. 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=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

Số lượt xem và thời gian xem hằng ngày từ 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ỳ đối với 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 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ể. Các 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. 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 danh sách tối đa 500 mã video được phân tách bằng dấu phẩy cho những 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 danh sách phát và thời gian xem ở nhiều vị trí phát

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à lần bắt đầu phát danh sách phát cho 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 về loại trang hoặc ứng dụng nơi phát lại video và kết quả được sắp xếp theo thứ tự giảm dần theo số lần bắt đầu 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 ở 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 danh sách phát và số lượt xem danh sách phát ước tính ở Hoa Kỳ đối với tất cả danh sách phát trên 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 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ừ nhiều 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 đối với 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ự thời gian 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 một số 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êm thông tin chi tiết nên các báo cáo này không có sẵn cho nguồn đó. Xem định nghĩa insightTrafficSourceType để biết chi tiết về nguồn lưu lượng truy cập có các loại báo cáo này.

10 cụm từ hàng đầu – Các 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. 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 danh sách tối đa 500 mã video được phân tách bằng dấu phẩy cho những video bạn đã tải lên.

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

10 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. 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 danh sách tối đa 500 mã video được phân tách bằng dấu phẩy cho những video 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ừ 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 danh sách phát, số lần bắt đầu của danh sách phát và số lần xem danh sách phát ước tính tính theo lượt xem danh sách phá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=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 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 danh sách phát trong một hoặc nhiều kênh của một 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. 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ị tham số filters được phân tách bằng dấu phẩy danh sách tối đa 500 mã nhận dạng 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ố loại thiết bị hằng ngày 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 của những video đã được xác nhận quyền sở hữu và đượ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 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 đố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. 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

Các chỉ số về loại thiết bị liên quan đến 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 danh sách phát trên thiết bị Android cho danh sách phát trong 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 xuất hiện. Lưu ý rằng để chạy truy vấn này trong API Explorer, bạn phải thay thế chuỗi CHANNEL_ID trong filters giá trị tham số có 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=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 danh sách phát trên thiết bị di động cho danh sách phát trên bất kỳ kênh nào của chủ sở hữu nội dung. Hệ thống trả về kết quả cho mỗi hệ điều hành mà lượt xem danh sách phát xuất hiện.

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 lấy 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 đã đượ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 mà 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à được sắp xếp theo thứ tự giảm dần của 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 đánh giá 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. 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ế 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 không bao gồm dữ liệu về số 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 để lấy 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 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 đó. Những truy vấn không sử dụng bộ lọc này 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 các 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 của chủ sở hữu nội dung. Báo cáo trả về một hàng dữ liệu duy nhất chứa tổng số cho từng 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ố hiệu suất quảng cáo và doanh thu hằng ngày

Yêu cầu này truy xuất chỉ số doanh thu hằng ngày và hiệu suất quảng cáo đố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.

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

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 các chỉ số về doanh thu và hiệu suất quảng cáo 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 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 ước tính lớn nhất.

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

10 video hàng đầu – Những video có doanh thu cao nhất

Yêu cầu này truy xuất chỉ số doanh thu và hiệu suất quảng cáo cho 10 video đã được chủ sở hữu nội dung xác nhận quyền sở hữu và có doanh thu cao nhất. Các kết quả được sắp xếp theo thứ tự giảm dần theo 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 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 giá trị doanh thu và giá trị CPM trên nhiều loại quảng cáo.

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