Dimensions

Tài liệu này xác định các phương diện mà API YouTube Analytics hỗ trợ. API này hỗ trợ các truy vấn được nhắm mục tiêu theo thời gian thực để tạo báo cáo YouTube Analytics tuỳ chỉnh.

Phương diện là những tiêu chí phổ biến dùng để tổng hợp dữ liệu, chẳng hạn như ngày xảy ra hoạt động của người dùng hoặc quốc gia nơi người dùng sinh sống.

Mỗi báo cáo truy vấn xác định các phương diện mà báo cáo này hỗ trợ. Ví dụ: khi truy xuất hoạt động của người dùng theo thời gian, bạn cần chọn khoảng thời gian dữ liệu sẽ được báo cáo: ngày hoặc tháng. Trong bất kỳ báo cáo nào, mỗi hàng dữ liệu đều có một tổ hợp giá trị phương diện duy nhất.

Để truy xuất báo cáo truy vấn, hãy gọi phương thức reports.query của API YouTube Analytics. Trong yêu cầu của bạn, hãy sử dụng thông số dimensions để chỉ định các phương diện mà YouTube sẽ sử dụng để tính toán giá trị chỉ số trong báo cáo.

Phương diện cốt lõi

Mặc dù YouTube Analytics API phải tuân thủ Chính sách về việc ngừng sử dụng được quy định trong Điều khoản dịch vụ, các phương diện không phải là phương diện chính (và là chỉ số không phải là chỉ số chính) tuân theo chính sách. Trong các định nghĩa trên trang này, bất kỳ phương diện nào là phương diện chính đều được được xác định rõ ràng như vậy.

Danh sách sau đây xác định các phương diện chính của API.

Hãy xem danh sách các API YouTube tuân theo Chính sách về việc ngừng cung cấp để biết thêm thông tin.

Bộ lọc

Tất cả báo cáo truy vấn đều hỗ trợ bộ lọc. Bộ lọc xác định những giá trị thứ nguyên phải có trong tập dữ liệu được truy xuất. Do đó, chúng sẽ giới hạn phản hồi của API để chỉ bao gồm dữ liệu khớp với một giá trị hoặc tập hợp giá trị cụ thể. Ví dụ: thay vì truy xuất chỉ số hoạt động của người dùng cho tất cả các quốc gia, bạn có thể sử dụng bộ lọc để chỉ truy xuất dữ liệu cho một quốc gia cụ thể.

Trong yêu cầu truy xuất báo cáo truy vấn, tham số yêu cầu filters (không bắt buộc) chỉ định các giá trị phương diện mà bạn muốn lọc dữ liệu. Ví dụ: để truy xuất chỉ số hoạt động của người dùng ở Châu Âu, bạn cần đặt giá trị tham số filters thành continent==150.

Lưu ý quan trọng: Yêu cầu API để truy xuất báo cáo của chủ sở hữu nội dung phải lọc dữ liệu bằng cách sử dụng một trong các phương diện thực thể báo cáo hoặc sử dụng tổ hợp các phương diện claimedStatus và uploaderType được hỗ trợ.

Kích thước

Các phần sau đây xác định các phương diện được dùng trong báo cáo truy vấn của API YouTube Analytics. Trừ phi có ghi chú khác, các phương diện này được dùng trong cả báo cáo kênh và báo cáo của chủ sở hữu nội dung. Các phương diện chỉ có thể được sử dụng làm bộ lọc cũng được xác định.

Tài nguyên

Các phương diện này tương ứng với các tài nguyên mà kênh và chủ sở hữu nội dung quản lý trên YouTube:

Lưu ý: API này cho phép bạn chỉ định nhiều giá trị cho các phương diện video, playlist và channel khi các phương diện đó được dùng làm bộ lọc. Để thực hiện việc này, hãy đặt giá trị tham số filters thành danh sách mã nhận dạng kênh, danh sách phát hoặc video được phân tách bằng dấu phẩy mà phản hồi của API sẽ được lọc ra. Giá trị tham số có thể chỉ định tối đa 500 mã nhận dạng.

video (phương diện chính)
Mã nhận dạng của một video trên YouTube. Trong API dữ liệu YouTube, đây là giá trị của video thuộc tính id của tài nguyên. This is a core dimension and is subject to the Deprecation Policy.
danh sách phát
Mã nhận dạng của danh sách phát trên YouTube. Trong API dữ liệu YouTube, đây là giá trị thuộc tính id của tài nguyên playlist.
kênh (phương diện chính) (chỉ dùng trong báo cáo của chủ sở hữu nội dung)
Mã nhận dạng của một kênh YouTube. Trong API dữ liệu YouTube, đây là giá trị thuộc tính id của tài nguyên channel. This is a core dimension and is subject to the Deprecation Policy.

Phương diện channel thường được dùng trong báo cáo của chủ sở hữu nội dung vì các báo cáo đó thường tổng hợp dữ liệu cho nhiều kênh.
nhóm (chỉ bộ lọc)
Mã nhận dạng của một nhóm trong YouTube Analytics. Bạn có thể lấy giá trị này bằng cách sử dụng phương thức groups.list của API YouTube Analytics. Khi bạn sử dụng bộ lọc group, phản hồi của API sẽ chứa dữ liệu về tất cả các video, danh sách phát hoặc kênh trong nhóm đó.

Ví dụ

Các yêu cầu mẫu sau đây sử dụng phương diện hoặc bộ lọc của thực thể báo cáo:

  • Ví dụ về kênh

    • Số liệu thống kê cơ bản
      • 10 video hàng đầu – Các video được xem nhiều nhất của một kênh
      • 10 hàng đầu – Tỷ lệ nhấp vào chú thích cho các video được xem nhiều nhất trên kênh
      • Số liệu thống kê cho một danh sách phát cụ thể
      • 10 danh sách phát hàng đầu – Các danh sách phát được xem nhiều nhất của một kênh
    • Khu vực địa lý
      • 10 hàng đầu – Các video được xem nhiều nhất ở một quốc gia cụ thể
      • 10 video hàng đầu – Các video được xem nhiều nhất ở Châu Âu

  • Ví dụ về chủ sở hữu nội dung

    • Số liệu thống kê cơ bản
      • 10 video hàng đầu – Các video được xem nhiều nhất của chủ sở hữu nội dung
      • 10 video hàng đầu – Các video được xem nhiều nhất của chủ sở hữu nội dung
      • 10 video hàng đầu – Các video được xem nhiều nhất trên kênh của một chủ sở hữu nội dung
      • 10 hàng đầu – Tỷ lệ nhấp vào chú thích cho các video được xem nhiều nhất trên kênh
      • 10 hàng đầu – Danh sách phát được xem nhiều nhất của chủ sở hữu nội dung
    • Khu vực địa lý
      • 10 video hàng đầu – Các video được xem nhiều nhất ở Châu Âu của chủ sở hữu nội dung
      • 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ỳ

Khu vực địa lý

Các phương diện này xác định khu vực địa lý liên quan đến hoạt động của người dùng, hiệu suất quảng cáo hoặc các chỉ số doanh thu ước tính.

quốc gia (phương diện chính)
Quốc gia liên kết với các chỉ số trong hàng báo cáo. Giá trị phương diện là mã quốc gia gồm hai chữ cái theo tiêu chuẩn ISO-3166-1, chẳng hạn như US, CN (Trung Quốc) hoặc FR (Pháp). Mã quốc gia ZZ được dùng để báo cáo những chỉ số mà YouTube không thể xác định quốc gia liên kết. This is a core dimension and is subject to the Deprecation Policy.
province
Tiểu bang hoặc lãnh thổ của Hoa Kỳ được liên kết với các chỉ số trong hàng báo cáo. Giá trị phương diện là mã ISO 3166-2 xác định một tiểu bang của Hoa Kỳ hoặc Đặc khu Columbia, chẳng hạn như US-MI (Michigan) hoặc US-TX (Texas). Mã tỉnh US-ZZ được dùng để báo cáo những chỉ số mà YouTube không thể xác định tiểu bang được liên kết của Hoa Kỳ. Khi một yêu cầu API đưa province vào giá trị tham số dimensions, yêu cầu đó cũng phải giới hạn dữ liệu ở Hoa Kỳ bằng cách thêm country==US vào giá trị tham số filters.

Lưu ý: Phương diện này không hỗ trợ các giá trị ISO 3166-2 xác định các khu vực ngoại thành của Hoa Kỳ vì các lãnh thổ đó cũng có mã quốc gia ISO 3166-1 riêng. Hệ thống cũng không hỗ trợ các đơn vị phân mục của các quốc gia không phải Hoa Kỳ.

dma
Mã nhận dạng gồm 3 chữ số mà Nielsen sử dụng để xác định Mảng thị trường được chỉ định (DMA) liên kết với các sự kiện xem được mô tả trong hàng dữ liệu.
city
Thành phố ước tính được liên kết với các chỉ số trong hàng trong báo cáo. Phương diện này chỉ có dữ liệu cho những ngày bắt đầu từ ngày 1 tháng 1 năm 2022.
châu lục (chỉ có bộ lọc)
Mã vùng thống kê của Liên Hợp Quốc (UN). API này hỗ trợ các giá trị sau:
Giá trị
002 Châu Phi
019 Châu Mỹ (Bắc Mỹ, Mỹ Latinh, Nam Mỹ và Caribbean)
142 Châu Á
150 Châu Âu
009 Châu Đại dương
Bạn chỉ có thể sử dụng phương diện này để lọc dữ liệu. Để sử dụng phương diện này, hãy đặt giá trị của filters tham số đến continent==REGION_CODE, chỉ định giá trị REGION_CODE từ bảng.
subContinent (chỉ bộ lọc)
Mã vùng thống kê của Liên Hợp Quốc xác định một tiểu vùng địa lý. Cơ quan Thống kê của Liên Hợp Quốc liệt kê các tiểu vùng cũng như các quốc gia mà Cơ quan này liên kết với từng khu vực.

Bạn chỉ có thể sử dụng phương diện này để lọc dữ liệu. Để sử dụng phương diện này, hãy đặt giá trị của thông số filters thành subContinent==REGION_CODE, sau đó chỉ định giá trị REGION_CODE từ danh sách Liên Hợp Quốc.

Ví dụ

Các yêu cầu mẫu sau đây sử dụng phương diện hoặc bộ lọc địa lý:

  • Ví dụ về kênh

    • Số liệu thống kê cơ bản: Số lượt xem theo quốc gia (và các thông tin khác) của kênh
    • Khu vực địa lý
      • Chỉ số thời gian xem video của một kênh theo quốc gia cụ thể
      • Chỉ số chú thích theo quốc gia cụ thể cho video của kênh
      • Chỉ số theo tỉnh cụ thể cho các tiểu bang của Hoa Kỳ và Washington D.C.
      • Chỉ số thời gian xem danh sách phát của kênh theo quốc gia cụ thể
      • 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ỳ
    • Vị trí phát: Số lượt xem hằng ngày và thời gian xem từ nhiều vị trí phát
    • Nguồn lưu lượng truy cập: 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
    • Nhân khẩu học: Thông tin nhân khẩu học của người xem ở California (nhóm tuổi và giới tính)
    • Video hàng đầu
      • 10 hàng đầu – Các video được xem nhiều nhất ở một quốc gia cụ thể
      • 10 video hàng đầu – Các video được xem nhiều nhất ở Châu Âu

  • Ví dụ về chủ sở hữu nội dung

    • Số liệu thống kê cơ bản: Số lượt xem theo quốc gia (và nhiều số liệu khác) của tất cả video tự tải lên
    • Khu vực địa lý
      • Chỉ số thời gian xem của nội dung tự tải lên theo quốc gia cụ thể
      • Chỉ số chú thích theo quốc gia cụ thể cho nội dung tự tải lên
      • Chỉ số theo tỉnh cụ thể cho các tiểu bang của Hoa Kỳ và Washington D.C.
      • 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ể
      • 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ỳ
    • Vị trí phát: Số lượt xem hằng ngày và thời gian xem từ nhiều vị trí phát
    • Nhân khẩu học: Thông tin nhân khẩu học của người xem ở California (nhóm tuổi và giới tính)
    • Video hàng đầu: 10 video hàng đầu – Các video được xem nhiều nhất ở Châu Âu của chủ sở hữu nội dung
    • Doanh thu/Hiệu suất quảng cáo: Chỉ số doanh thu và hiệu suất quảng cáo theo quốc gia cụ thể

Khoảng thời gian

Các phương diện này cho biết báo cáo sẽ tổng hợp dữ liệu dựa trên một khoảng thời gian, chẳng hạn như ngày, tuần hoặc tháng. Thông số yêu cầu startDate và endDate chỉ định khoảng thời gian báo cáo có dữ liệu. Lưu ý rằng báo cáo thực sự trả về dữ liệu cho đến ngày cuối cùng mà tất cả các chỉ số được chỉ định trong yêu cầu đều có sẵn tại thời điểm truy vấn được thực hiện. Trong báo cáo, ngày được liệt kê ở định dạng YYYY-MM-DD.

Quan trọng: Tất cả ngày tháng đều chỉ khoảng thời gian bắt đầu từ 0 giờ sáng theo giờ Thái Bình Dương (UTC-7 hoặc UTC-8) và kết thúc lúc 23:59 giờ Thái Bình Dương vào ngày, tháng và năm được chỉ định. Do đó, những ngày mà đồng hồ được điều chỉnh về sau theo Giờ mùa hè sẽ biểu thị một khoảng thời gian 23 giờ, còn những ngày mà bạn điều chỉnh đồng hồ ngược lại tương ứng với khoảng thời gian 25 giờ.

Phương diện tháng là khoảng thời gian bắt đầu từ 12 giờ sáng theo giờ Thái Bình Dương (UTC-7 hoặc UTC-8) vào ngày đầu tiên của tháng và năm được chỉ định.

ngày (phương diện chính)
Khi bạn sử dụng phương diện này, dữ liệu trong báo cáo được tổng hợp hằng ngày và mỗi hàng chứa dữ liệu cho một ngày. Bạn có thể sử dụng các phương diện khác để phân tích dữ liệu chi tiết hơn nữa. Ví dụ: báo cáo nguồn lưu lượng truy cập có thể tổng hợp số liệu thống kê về lượt xem hằng ngày dựa trên cách người dùng tiếp cận video của bạn. This is a core dimension and is subject to the Deprecation Policy.
tháng (phương diện chính)
Dữ liệu trong báo cáo được tổng hợp theo tháng dương lịch. Giống như báo cáo hằng ngày, bạn có thể sử dụng các bộ lọc khác để phân đoạn dữ liệu sâu hơn nữa. Trong báo cáo, ngày được liệt kê ở định dạng YYYY-MM.

Lưu ý: Nếu truy vấn API của bạn sử dụng phương diện month, thì bạn phải đặt cả tham số start-date và end-date thành ngày đầu tiên của tháng. This is a core dimension and is subject to the Deprecation Policy.

Ví dụ

Các yêu cầu mẫu sau đây sử dụng phương diện hoặc bộ lọc tạm thời:

  • Ví dụ về kênh

    • Dựa trên thời gian
      • Chỉ số thời gian xem hằng ngày cho video của một kênh
      • Chỉ số chú thích hằng ngày cho video của một kênh
      • Lượt xem danh sách phát hằng ngày của một kênh
    • Vị trí phát: Số lượt xem hằng ngày và thời gian xem từ nhiều vị trí phát
    • Nguồn lưu lượng truy cập: 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
    • Thiết bị/hệ điều hành
      • Chỉ số loại thiết bị hằng ngày trên hệ điều hành Android
      • Chỉ số hệ điều hành hằng ngày trên thiết bị di động
      • Chỉ số hằng ngày về hệ điều hành và loại thiết bị

  • Ví dụ về chủ sở hữu nội dung

    • Dựa trên thời gian
      • Chỉ số thời gian xem hằng ngày của nội dung tự tải lên
      • Các chỉ số về chú thích cho nội dung đã được xác nhận quyền sở hữu
      • Lượt xem danh sách phát hằng ngày của một chủ sở hữu nội dung
    • Vị trí phát: Số lượt xem hằng ngày và thời gian xem từ nhiều vị trí phát
    • Nguồn lưu lượng truy cập: 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
    • Thiết bị/hệ điều hành
      • Chỉ số loại thiết bị hằng ngày cho video đã được xác nhận quyền sở hữu
      • 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
      • Chỉ số hằng ngày về hệ điều hành và loại thiết bị
    • Doanh thu/Hiệu suất quảng cáo: Chỉ số về doanh thu hằng ngày và hiệu suất quảng cáo

Vị trí phát

Các phương diện này cung cấp thông tin chi tiết về trang hoặc ứng dụng nơi hoạt động của người dùng xảy ra.

insightPlaybackLocationType
Dữ liệu trong báo cáo được tổng hợp dựa trên loại trang hoặc ứng dụng có lượt phát video. Các giá trị có thể cho phương diện này là:

  • BROWSE – Dữ liệu mô tả lượt xem diễn ra trên trang chủ hoặc màn hình chính của YouTube, trong trang kênh đăng ký của người dùng hoặc trong một tính năng duyệt web khác của YouTube.

  • CHANNEL – Dữ liệu mô tả các lượt xem xảy ra trên một trang kênh.

  • EMBEDDED – Dữ liệu mô tả những lượt xem xảy ra trên một trang web hoặc ứng dụng khác, nơi video được nhúng bằng cách nhúng <iframe> hoặc <object>.

  • EXTERNAL_APP – Dữ liệu mô tả những lượt xem xảy ra trong một ứng dụng của bên thứ ba, trong đó video được phát bằng phương thức khác với phương thức nhúng <iframe> hoặc <object>. Ví dụ: lượt phát trong các ứng dụng sử dụng API Trình phát Android của YouTube sẽ được phân loại theo giá trị này.

  • MOBILE – Dữ liệu này mô tả những lượt xem bắt nguồn trên trang web dành cho thiết bị di động của YouTube hoặc trên các ứng dụng API YouTube được phê duyệt, bao gồm cả thiết bị di động.

    Kể từ ngày 10 tháng 9 năm 2013, số lượt phát không còn được phân loại là lượt phát MOBILE trong các báo cáo của YouTube Analytics. Giá trị này có thể vẫn còn trong báo cáo vì dữ liệu cũ vẫn thuộc danh mục đó. Tuy nhiên, sau ngày đó, các lượt phát trên thiết bị di động được phân loại là lượt phát WATCH, EMBEDDED hoặc EXTERNAL_APP, tuỳ thuộc vào loại ứng dụng có lượt phát đó.

  • SEARCH – Dữ liệu mô tả những lượt xem diễn ra ngay trên trang kết quả tìm kiếm của YouTube.

  • WATCH – Dữ liệu mô tả số lượt xem trên trang xem YouTube của video hoặc trong một ứng dụng chính thức của YouTube, chẳng hạn như ứng dụng YouTube dành cho Android.

  • YT_OTHER – Dữ liệu mô tả các chế độ xem không được phân loại khác.

insightPlaybackLocationDetail
Dữ liệu được tổng hợp dựa trên trang mà người chơi truy cập. Xin lưu ý rằng báo cáo này chỉ được hỗ trợ cho các lượt xem xuất hiện trong trình phát được nhúng và xác định các trình phát được nhúng đã tạo ra nhiều lượt xem nhất cho một video cụ thể. Do đó, báo cáo này cung cấp chế độ xem chi tiết hơn so với báo cáo vị trí phát bằng cách xác định URL hoặc ứng dụng được liên kết với các trình phát được nhúng hàng đầu.

Ví dụ

Các yêu cầu mẫu sau đây sử dụng kích thước vị trí phát:

  • Ví dụ về kênh

    • Vị trí phát
      • Số lượt xem và thời gian xem từ các vị trí phát khác nhau
      • Số lượt xem và thời gian xem hằng ngày từ các vị trí phát khác nhau
      • 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
      • Số lượt xem danh sách phát và thời gian xem ở nhiều vị trí phát
      • 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

  • Ví dụ về chủ sở hữu nội dung

    • Vị trí phát
      • Số lượt xem và thời gian xem từ các vị trí phát khác nhau
      • Số lượt xem và thời gian xem hằng ngày từ các vị trí phát khác nhau
      • 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
      • Số lượt xem danh sách phát và thời gian xem ở nhiều vị trí phát
      • 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

Chi tiết phát

creatorContentType
Phương diện này xác định loại nội dung liên kết với chỉ số hoạt động của người dùng trong hàng dữ liệu. Bạn có thể xem dữ liệu cho phương diện này từ ngày 1 tháng 1 năm 2019.

Bảng sau đây liệt kê các giá trị phương diện:
Giá trị
LIVE_STREAM Nội dung được xem là một sự kiện phát trực tiếp trên YouTube.
SHORTS Nội dung được xem là video ngắn trên YouTube.
STORY Nội dung được xem là một Câu chuyện trên YouTube.
VIDEO_ON_DEMAND Nội dung đã xem là một video trên YouTube không thuộc một trong các giá trị phương diện khác.
UNSPECIFIED Không xác định được loại nội dung của nội dung đã xem.
liveOrOnDemand
Phương diện này cho biết liệu chỉ số hoạt động của người dùng trong hàng dữ liệu có liên kết với số lượt xem của một chương trình phát sóng trực tiếp hay không. Dữ liệu cho phương diện này chỉ có sẵn cho các ngày bắt đầu từ ngày 1 tháng 4 năm 2014.

Bảng sau đây liệt kê các giá trị phương diện:
Giá trị
LIVE Dữ liệu của hàng mô tả hoạt động của người dùng diễn ra trong một chương trình phát sóng trực tiếp.
ON_DEMAND Dữ liệu của hàng mô tả hoạt động của người dùng không xảy ra trong chương trình phát sóng trực tiếp.
subscribedStatus
Phương diện này cho biết liệu chỉ số hoạt động của người dùng trong hàng dữ liệu có liên kết với người xem đã đăng ký kênh của video hoặc danh sách phát hay không. Giá trị có thể là SUBSCRIBED và UNSUBSCRIBED.

Xin lưu ý rằng giá trị phương diện là chính xác kể từ thời điểm hoạt động của người dùng diễn ra. Ví dụ: giả sử một người dùng chưa đăng ký kênh và xem một trong số các video của kênh đó, sau đó đăng ký kênh và xem một video khác, tất cả trong cùng một ngày. Báo cáo của kênh cho biết rằng một lượt xem có giá trị subscribedStatus là SUBSCRIBED và một lượt xem có giá trị subscribedStatus là UNSUBSCRIBED.
youtubeProduct
Phương diện này xác định dịch vụ YouTube nơi hoạt động của người dùng diễn ra. Dữ liệu cho phương diện này có từ ngày 18 tháng 7 năm 2015.

Bảng sau liệt kê các giá trị phương diện:
Giá trị
CORE Hoạt động của người dùng không xảy ra trong một trong các ứng dụng chuyên biệt của YouTube (YouTube Gaming, YouTube Kids hoặc YouTube Music). Trường hợp ngoại lệ: Hoạt động của người dùng diễn ra trong YouTube Music trước ngày 1 tháng 3 năm 2021 sẽ được tính vào CORE.
GAMING Hoạt động của người dùng đã diễn ra trong YouTube Gaming.
KIDS Hoạt động của người dùng đã diễn ra trong YouTube Kids.
MUSIC Hoạt động của người dùng diễn ra trong YouTube Music từ ngày 1 tháng 3 năm 2021 trở đi. Dữ liệu trước ngày 1 tháng 3 năm 2021 được bao gồm trong CORE. Dữ liệu theo thời gian thực không được ghi lại.
UNKNOWN Hoạt động của người dùng xảy ra trước ngày 18 tháng 7 năm 2015.

Nguồn lưu lượng truy cập

insightTrafficSourceType
Dữ liệu trong báo cáo được tổng hợp dựa trên loại đường liên kết giới thiệu, thể hiện cách thức người dùng truy cập vào video. Các giá trị có thể cho phương diện này là:
  • ADVERTISING – Người xem được giới thiệu đến video thông qua một quảng cáo. Nếu bạn lọc dựa trên nguồn lưu lượng truy cập này, thì trường insightTrafficSourceDetail sẽ xác định loại quảng cáo.
  • ANNOTATION – Người xem đã xem video bằng cách nhấp vào chú thích trong một video khác.
  • CAMPAIGN_CARD – Lượt xem bắt nguồn từ video do người dùng tải lên được xác nhận quyền sở hữu mà chủ sở hữu nội dung đã sử dụng để quảng cáo nội dung đã xem. Nguồn lưu lượng truy cập này chỉ được hỗ trợ cho báo cáo của chủ sở hữu nội dung.
  • END_SCREEN – Lượt xem được dẫn đến từ màn hình kết thúc của một video khác.
  • EXT_URL – Lượt xem video được giới thiệu từ một liên kết trên một trang web khác. Nếu bạn lọc dựa trên nguồn lưu lượng truy cập này, trường insightTrafficSourceDetail sẽ xác định trang web. Nguồn lưu lượng truy cập này bao gồm cả lượt giới thiệu từ kết quả của Google Tìm kiếm.
  • HASHTAGS – Số lượt xem bắt nguồn từ các trang hashtag (#) theo yêu cầu hoặc các trang tổng hợp hashtag của Shorts.
  • LIVE_REDIRECT – Lượt xem video được tham khảo từ Live Redirect.
  • NO_LINK_EMBEDDED – Video được nhúng trên một trang web khác vào thời điểm xem.
  • NO_LINK_OTHER – YouTube không xác định liên kết giới thiệu cho lưu lượng truy cập. Danh mục này bao gồm lưu lượng truy cập trực tiếp đến video cũng như lưu lượng truy cập trên ứng dụng dành cho thiết bị di động.
  • NOTIFICATION – Lượt xem video được giới thiệu từ email hoặc thông báo từ YouTube.
  • PLAYLIST – Số lượt xem video xảy ra khi video đang được phát trong danh sách phát. Số liệu này bao gồm lưu lượng truy cập đến từ trang danh sách phát.
  • PRODUCT_PAGE – Số lượt xem video được giới thiệu từ trang Sản phẩm.
  • PROMOTED – Số lượt xem video được giới thiệu từ một quảng cáo không trả phí trên YouTube, chẳng hạn như "Video tiêu điểm" trên YouTube .
  • RELATED_VIDEO – Lượt xem video được giới thiệu từ một danh sách video có liên quan trên một trang xem video khác. Nếu bạn lọc dựa trên nguồn lưu lượng truy cập này, thì trường insightTrafficSourceDetail sẽ chỉ định mã video cho video đó.
  • SHORTS – Người xem được giới thiệu bằng cách vuốt dọc từ video trước trong phần xem video ngắn.
  • SOUND_PAGE – Lượt xem bắt nguồn từ các trang tổng hợp nội dung âm thanh trên Shorts.
  • SUBSCRIBER – Số lượt xem video được giới thiệu từ các nguồn cấp dữ liệu trên trang chủ YouTube hoặc từ các tính năng đăng ký của YouTube. Nếu bạn lọc dựa trên nguồn lưu lượng truy cập này, trường insightTrafficSourceDetail sẽ chỉ định các mục trong nguồn cấp dữ liệu trang chủ hoặc trang khác có lượt xem được giới thiệu.
  • YT_CHANNEL – Lượt xem video xảy ra trên trang kênh. Nếu bạn lọc dựa trên nguồn lưu lượng truy cập này, thì trường insightTrafficSourceDetail sẽ chỉ định mã nhận dạng kênh của kênh đó.
  • YT_OTHER_PAGE – Lượt xem video được giới thiệu từ một liên kết không phải là kết quả tìm kiếm hoặc liên kết video có liên quan đã xuất hiện trên một trang của YouTube. Nếu bạn lọc dựa trên nguồn lưu lượng truy cập này, trường insightTrafficSourceDetail sẽ xác định trang.
  • YT_SEARCH – Lượt xem video được giới thiệu từ kết quả tìm kiếm trên YouTube. Nếu bạn lọc dựa trên nguồn lưu lượng truy cập này, thì trường insightTrafficSourceDetail sẽ chỉ định cụm từ tìm kiếm.
  • VIDEO_REMIXES – Số lượt xem video được lấy từ đường liên kết đến video được phối lại trong trình phát Shorts. Nếu bạn lọc dựa trên nguồn lưu lượng truy cập này, thì trường insightTrafficSourceDetail sẽ chỉ định video mà người xem được giới thiệu.
insightTrafficSourceDetail
Dữ liệu trong báo cáo được tổng hợp dựa trên những đường liên kết giới thiệu mang lại nhiều lượt xem nhất cho một video cụ thể và một loại nguồn lưu lượng truy cập được chỉ định. Danh sách sau đây xác định các nguồn lưu lượng truy cập có báo cáo này. Đối với mỗi nguồn lưu lượng truy cập, danh sách này sẽ xác định thông tin mà phương diện insightTrafficSourceDetail cung cấp.
  • ADVERTISING – Loại quảng cáo đã dẫn đến lượt xem. Các giá trị có thể có là:
    • Quảng cáo tương tác nhấp để phát
    • Quảng cáo tương tác
    • Quảng cáo tìm kiếm của Google
    • Quảng cáo video trên trang chủ
    • Quảng cáo trong luồng có thể bỏ qua dành riêng
    • TrueView trong tìm kiếm và trong hiển thị
    • TrueView trong luồng
    • Quảng cáo YouTube chưa được phân loại
    • Hộp hiển thị video
  • CAMPAIGN_CARD – Video đã được xác nhận quyền sở hữu và dẫn người xem đến video được xác định trong báo cáo.
  • END_SCREEN – Video đưa người xem đến video được xác định trong báo cáo.
  • EXT_URL – Trang web đã giới thiệu người xem đến video.
  • HASHTAGS – Thẻ bắt đầu bằng # đã dẫn đến lượt xem.
  • NOTIFICATION – Email hoặc thông báo đã dẫn đến lưu lượng truy cập.
  • RELATED_VIDEO – Video có liên quan dẫn người xem đến video được đề cập trong báo cáo.
  • SOUND_PAGE – Video đã mang lại lượt xem.
  • SUBSCRIBER – Mục nguồn cấp dữ liệu trang chủ hoặc tính năng đăng ký trên YouTube đưa người xem đến video được đề cập trong báo cáo. Các giá trị hợp lệ là:
    • activity – Số lượt xem từ các mục trong nguồn cấp dữ liệu đăng ký trang chủ bắt nguồn từ hoạt động kênh không tải lên và không phải xã hội, bao gồm các lượt thích, mục yêu thích, bài đăng bản tin và hoạt động bổ sung danh sách phát.
    • blogged – Số lượt xem từ các mục trong nguồn cấp dữ liệu đăng ký trang chủ bắt nguồn từ các liên kết từ các blog hàng đầu.
    • mychannel – Lượt xem từ các mục trong các nguồn cấp dữ liệu khác được liệt kê trên trang chủ, chẳng hạn như "Thích", "Nhật ký xem", và "Xem sau".
    • podcasts – Số lượt xem bắt nguồn từ các mục trên trang đích của Podcast.
    • sdig – Số lượt xem bắt nguồn từ các email cập nhật gói thuê bao.
    • uploaded – Lượt xem từ các mục uploaded trong nguồn cấp dữ liệu đăng ký trang chủ.
    • / – Các lượt xem khác bắt nguồn từ trang chủ YouTube.
    • /my_subscriptions – Số lượt xem bắt nguồn từ Trang Kênh đăng ký của tôi trên YouTube.
  • YT_CHANNEL – Trang kênh nơi người xem đã xem video.
  • YT_OTHER_PAGE – Trang YouTube nơi người xem được giới thiệu đến video.
  • YT_SEARCH – Cụm từ tìm kiếm giúp người xem tìm thấy video.
  • VIDEO_REMIXES – Video đã mang lại lượt xem.

Ví dụ

Các yêu cầu mẫu sau đây sử dụng phương diện nguồn lưu lượng truy cập:

  • Ví dụ về kênh

    • Nguồn lưu lượng truy cập
      • 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
      • 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
      • 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
      • 10 cụm từ hàng đầu – Cụm từ tìm kiếm trên Google tạo ra nhiều lưu lượng truy cập nhất cho một video
      • 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
      • 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

  • Ví dụ về chủ sở hữu nội dung

    • Nguồn lưu lượng truy cập
      • Số lượt xem và thời gian xem từ nhiều nguồn lưu lượng truy cập
      • 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
      • 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
      • 10 cụm từ hàng đầu – Cụm từ tìm kiếm trên Google tạo ra nhiều lưu lượng truy cập nhất cho một video
      • 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
      • 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

Thiết bị

deviceType
Phương diện này xác định kiểu dáng vật lý của thiết bị mà người dùng sử dụng để xem. Danh sách sau đây xác định các loại thiết bị mà API trả về dữ liệu. Bạn cũng có thể sử dụng phương diện deviceType làm bộ lọc để hạn chế báo cáo hệ điều hành chỉ chứa dữ liệu cho một loại thiết bị cụ thể.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • UNKNOWN_PLATFORM
operatingSystem
Phương diện này xác định hệ thống phần mềm của thiết bị mà người dùng sử dụng để xem. Danh sách sau đây xác định các hệ điều hành mà API trả về dữ liệu. Bạn cũng có thể sử dụng operatingSystem làm bộ lọc để hạn chế báo cáo loại thiết bị chỉ chứa dữ liệu cho một hệ điều hành cụ thể.
  • ANDROID
  • BADA
  • BLACKBERRY
  • CHROMECAST
  • DOCOMO
  • FIREFOX
  • HIPTOP
  • IOS
  • KAIOS
  • LINUX
  • MACINTOSH
  • MEEGO
  • NINTENDO_3DS
  • OTHER
  • PLAYSTATION
  • PLAYSTATION_VITA
  • REALMEDIA
  • SMART_TV
  • SYMBIAN
  • TIZEN
  • VIDAA
  • WEBOS
  • WII
  • WINDOWS
  • WINDOWS_MOBILE
  • XBOX

Ví dụ

Các yêu cầu mẫu sau đây sử dụng kích thước thiết bị:

  • Ví dụ về kênh

    • Thiết bị/hệ điều hành
      • Chỉ số loại thiết bị hằng ngày trên hệ điều hành Android
      • Chỉ số hệ điều hành hằng ngày trên thiết bị di động
      • Chỉ số hằng ngày về hệ điều hành và loại thiết bị
      • 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
      • 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

  • Ví dụ về chủ sở hữu nội dung

    • Thiết bị/hệ điều hành
      • Chỉ số loại thiết bị hằng ngày cho video đã được xác nhận quyền sở hữu
      • 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
      • Chỉ số hằng ngày về hệ điều hành và loại thiết bị
      • 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
      • 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

Thông tin nhân khẩu học

Phương diện nhân khẩu học giúp bạn hiểu được mức phân bổ về độ tuổi và giới tính của người xem. Trung tâm trợ giúp YouTube chứa thêm thông tin về dữ liệu nhân khẩu học trong các báo cáo YouTube Analytics.

ageGroup (phương diện chính)
Phương diện này xác định nhóm tuổi của người dùng đã đăng nhập liên kết với dữ liệu báo cáo. API sử dụng các nhóm tuổi sau:
  • age13-17
  • age18-24
  • age25-34
  • age35-44
  • age45-54
  • age55-64
  • age65-
This is a core dimension and is subject to the Deprecation Policy.
giới tính (phương diện chính)
Phương diện này xác định giới tính của người dùng đã đăng nhập được liên kết với dữ liệu báo cáo. Các giá trị hợp lệ là female, male và user_specified. This is a core dimension and is subject to the Deprecation Policy.

Ví dụ

Các yêu cầu mẫu sau đây sử dụng phương diện nhân khẩu học:

  • Ví dụ về kênh

    • Thông tin nhân khẩu học
      • Thông tin nhân khẩu học của người xem ở California (nhóm tuổi và giới tính)
      • 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)

  • Ví dụ về chủ sở hữu nội dung

    • Thông tin nhân khẩu học
      • Thông tin nhân khẩu học của người xem ở California (nhóm tuổi và giới tính)
      • 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)

Hoạt động tương tác và chia sẻ nội dung

sharingService (phương diện chính)
Phương diện này xác định dịch vụ được dùng để chia sẻ video. Bạn có thể chia sẻ video trên YouTube (hoặc qua trình phát YouTube) bằng nút "Chia sẻ" .
This is a core dimension and is subject to the Deprecation Policy.
Bảng sau đây liệt kê các giá trị phương diện hợp lệ:
Dịch vụ chia sẻ Giá trị API
Ameba AMEBA
Email về Android ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Nhắn tin trên Android ANDROID_MMS
Messenger trên Blackberry BBM
Blogger BLOGGER
Sao chép vào bảng nhớ tạm COPY_PASTE
Thế giới vòng CYWORLD
Đào DIGG
Dropbox DROPBOX
Nhúng EMBED
Email MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Trang Facebook FACEBOOK_PAGES
Tiếng Fotka FOTKA
Gmail GMAIL
con-dư GOO
Google+ GOOGLEPLUS
Chuyển tin nhắn SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
Tin nhắn văn bản của HTC HTC_MMS
Hộp thư đến của Google INBOX
Hộp thoại hoạt động hệ thống iOS IOS_SYSTEM_ACTIVITY_DIALOG
Câu chuyện của KakaO KAKAO_STORY
Tiếng Kakao (Kakao Talk) KAKAO
Kik KIK
Email LGE LGE_EMAIL
Line LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
menéame MENEAME
mixi MIXI
Nhắn tin qua Motorola MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
Chia sẻ lân cận NEARBY_SHARE
NUjij NUJIJ
Tiếng Odnoklassniki (xuất hiện ODNOKLASSNIKI
Khác OTHER
Pinterest PINTEREST
Rakuten (楽天 sạc場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
Cuộc trò chuyện của Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
Tin nhắn văn bản TEXT_MESSAGE
Tuenti TUENTI
tumblr. TUMBLR
Twitter TWITTER
Không xác định UNKNOWN
Tin nhắn qua Verizon VERIZON_MMS
Viber VIBER
VKontakte (ChuyểnКонтакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
Wykop WYKOP
Yahoo! Nhật Bản YAHOO
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV

Hãy xem tài liệu trợ giúp để biết thêm thông tin.

Ví dụ

Các yêu cầu mẫu sau đây sử dụng phương diện mạng xã hội:

  • Ví dụ về kênh

    • Mạng xã hội: Chỉ số về việc chia sẻ, tổng hợp theo dịch vụ nơi video được chia sẻ

  • Ví dụ về chủ sở hữu nội dung

    • Mạng xã hội: Chỉ số về việc chia sẻ, tổng hợp theo dịch vụ nơi video được chia sẻ

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

elapsedVideoTimeRatio
Kích thước này chỉ định tỷ lệ thời lượng của phần video đã trôi qua so với thời lượng video. Các phương diện và chỉ số về tỷ lệ giữ chân người dùng được dùng để đo lường tỷ lệ giữ chân người xem theo thời gian, còn phương diện elapsedVideoTimeRatio là thông tin đo lường thời gian. Ví dụ: giá trị 0.4 cho biết rằng dữ liệu báo cáo tương ứng cho biết dữ liệu về tỷ lệ giữ chân người dùng sau khi 40% thời lượng video đã trôi qua.

API trả về 100 điểm dữ liệu cho mỗi video với các giá trị tỷ lệ nằm trong khoảng từ 0.01 đến 1.0. Những khoảng thời gian dữ liệu được đo lường trong các lần phát video được giãn cách đều nhau cho mỗi video. Điều này có nghĩa là đối với một video dài hai phút, khoảng thời gian giữa các điểm dữ liệu là 1,2 giây. Tuy nhiên, đối với video dài hai giờ, khoảng thời gian giữa các điểm dữ liệu là 72 giây. Giá trị của phương diện biểu thị thời điểm kết thúc không bao gồm khoảng thời gian.
audienceType (chỉ bộ lọc)
Giá trị phương diện xác định loại lưu lượng truy cập liên kết với dữ liệu báo cáo. Các giá trị được hỗ trợ: ORGANIC, AD_INSTREAM và AD_INDISPLAY. Hãy tham khảo Trung tâm trợ giúp của YouTube để xem nội dung giải thích về các loại nguồn lưu lượng truy cập này.

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

Ví dụ

Các yêu cầu mẫu sau đây sử dụng phương diện tỷ lệ giữ chân người xem:

Phát trực tiếp

livestreamPosition
Phương diện này chỉ định một phút cụ thể trong sự kiện phát video trực tiếp. Các chỉ số báo cáo cho biết số lượng người dùng đang xem sự kiện phát trực tiếp tại thời điểm đó.

Huỷ gói thành viên

membershipsCancellationSurveyReason
Số lượng người dùng YouTube đã huỷ gói hội viên của kênh trong cuộc khảo sát đã hoàn thành kênh cụ thể trong suốt kỳ báo cáo. Bảng sau đây liệt kê các giá trị phương diện hợp lệ:
Giá trị API Giải thích
UNKNOWN Người dùng chưa hoàn tất khảo sát.
DISLIKE_PERKS Người dùng không thích các đặc quyền trong gói hội viên.
PERKS_NOT_DELIVERED Người dùng này cho biết các đặc quyền dành cho hội viên đã hứa hẹn chưa được cung cấp.
CANNOT_ACCESS_PERKS Người dùng không sử dụng được các đặc quyền.
NO_LONGER_INTERESTED Người dùng không còn quan tâm đến chương trình hội viên của kênh.
FEEL_UNAPPRECIATED Người dùng cảm thấy họ không được trân trọng vì họ là hội viên của kênh.
FINANCIAL_REASONS Người dùng đã huỷ vì lý do tài chính.
JOIN_LIMITED_TIME Người dùng chỉ có ý định tham gia trong một thời gian có hạn.
OTHER Người dùng có một lý do khác để huỷ gói thuê bao.

Hiệu suất quảng cáo

adType
Phương diện adType dùng trong báo cáo hiệu suất quảng cáo và tổng hợp các chỉ số được yêu cầu dựa trên loại quảng cáo đã chạy trong các lượt phát video. Danh sách sau đây giải thích các giá trị phương diện có thể có. Truy cập vào Trung tâm trợ giúp YouTube để biết thêm thông tin về các định dạng quảng cáo trên YouTube.

  • auctionBumperInstream – Quảng cáo dạng video không thể bỏ qua, được đặt thông qua phiên đấu giá, có thời lượng tối đa 6 giây mà khán giả phải xem trước khi có thể xem video.

  • auctionDisplay – Quảng cáo đa phương tiện hoặc quảng cáo hình ảnh xuất hiện dưới dạng lớp phủ ở cuối trình phát video, dưới dạng đơn vị quảng cáo 300x250 trên trang xem video hoặc kết hợp cả hai. Khi chạy, lớp phủ sẽ tự động đóng sau khi hiển thị trong một khoảng thời gian nhất định và người dùng cũng có thể đóng lớp phủ này. Nếu một lớp phủ và một biểu ngữ hiển thị cùng nhau, thì mỗi quảng cáo sẽ được tính là một lượt hiển thị riêng biệt.

  • auctionInstream – Quảng cáo dạng video không thể bỏ qua chạy trước, trong hoặc sau video chính.

  • auctionTrueviewInslate – Người xem chọn một trong các quảng cáo dạng video trong số các lựa chọn xuất hiện trước video. See the TrueView documentation for more information.

  • auctionTrueviewInstream – Quảng cáo dạng video có thể bỏ qua chạy trước hoặc trong video chính. Xem tài liệu về TrueView để biết thêm thông tin.

  • auctionUnknown – Quảng cáo đã được mua thông qua phiên đấu giá của AdWords nhưng chưa được phân loại vào một trong những loại quảng cáo khác.

  • reservedBumperInstream – Quảng cáo dạng video không thể bỏ qua, được bán trên cơ sở đặt trước, có thời lượng tối đa 6 giây mà khán giả phải xem trước khi có thể xem video.

  • reservedClickToPlay – Quảng cáo dạng video mà người dùng phải nhấp vào để bắt đầu phát. Một lần hiển thị quảng cáo được ghi lại bất kỳ lúc nào đơn vị quảng cáo nhấp để phát hiển thị, bất kể người dùng có bắt đầu phát lại hay không. Những video này được bán trên cơ sở đặt trước.

  • reservedDisplay – Quảng cáo đa phương tiện hoặc quảng cáo hình ảnh xuất hiện dưới dạng lớp phủ ở cuối trình phát video, dưới dạng đơn vị quảng cáo 300x250 trên trang xem video hoặc kết hợp cả hai. Khi chạy, lớp phủ sẽ tự động đóng sau khi hiển thị trong một khoảng thời gian nhất định và người dùng cũng có thể đóng lớp phủ này. Nếu một lớp phủ và một biểu ngữ hiển thị cùng nhau, thì mỗi quảng cáo sẽ được tính là một lượt hiển thị riêng biệt.

  • reservedInstream – Quảng cáo dạng video không thể bỏ qua được chèn vào trước, trong hoặc sau video chính.

  • reservedInstreamSelect

  • reservedMasthead – Một quảng cáo lớn, có thể bao gồm video và các thành phần đồ hoạ xuất hiện trên trang chủ.

  • reservedUnknown – Một quảng cáo được bán trên cơ sở đặt trước mà không thể được phân loại vào một trong những loại quảng cáo khác.

  • unknown – YouTube không thể phân loại loại quảng cáo này.

Ví dụ

Các báo cáo mẫu sau đây truy xuất chỉ số hiệu suất quảng cáo hoặc doanh thu:

  • Ví dụ về kênh

    • Doanh thu/quảng cáo
      • Các chỉ số về hiệu suất quảng cáo và doanh thu của kênh
      • Chỉ số hiệu suất quảng cáo và doanh thu hằng ngày
      • Chỉ số hiệu suất quảng cáo và doanh thu theo quốc gia
      • 10 video hàng đầu – Những video có doanh thu cao nhất
      • Chỉ số hiệu suất quảng cáo cho các loại quảng cáo

  • Ví dụ về chủ sở hữu nội dung

    • Doanh thu/quảng cáo
      • 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
      • Chỉ số hiệu suất quảng cáo và doanh thu hằng ngày
      • Chỉ số hiệu suất quảng cáo và doanh thu theo quốc gia
      • 10 video hàng đầu – Những video có doanh thu cao nhất
      • Chỉ số hiệu suất quảng cáo cho các loại quảng cáo

Danh sách phát

isCurated (chỉ dùng bộ lọc)
Bộ lọc này cho biết rằng yêu cầu đang truy xuất dữ liệu về lượt xem video đã xảy ra trong ngữ cảnh của danh sách phát.

Ví dụ

Tất cả yêu cầu mẫu truy xuất báo cáo danh sách phát đều sử dụng bộ lọc isCurated.

Phương diện của chủ sở hữu nội dung

Các phương diện sau đây chỉ được hỗ trợ cho báo cáo của chủ sở hữu nội dung.

Lưu ý quan trọng: Yêu cầu API để truy xuất báo cáo của chủ sở hữu nội dung phải lọc dữ liệu bằng một trong các phương diện sau:
  • video
  • channel
  • Tổ hợp phương diện claimedStatus và uploaderType được hỗ trợ như xác định bên dưới.
claimStatus (chỉ dùng trong báo cáo của chủ sở hữu nội dung)
Phương diện này cho phép bạn cho biết rằng phản hồi của API chỉ nên chứa chỉ số cho nội dung đã được xác nhận quyền sở hữu. Giá trị hợp lệ duy nhất của phương diện này là claimed. Nếu tham số filters giới hạn truy vấn trong claimedStatus==claimed, API sẽ chỉ truy xuất dữ liệu cho nội dung đã được xác nhận quyền sở hữu. Bảng trong định nghĩa về phương diện uploaderType cung cấp thêm thông tin chi tiết về cách sử dụng phương diện này.
uploadType (phương diện chính) (chỉ dùng trong báo cáo của chủ sở hữu nội dung)
Phương diện này cho phép bạn cho biết liệu phản hồi của API có chứa chỉ số cho nội dung do chủ sở hữu nội dung được chỉ định tải lên và/hoặc nội dung do bên thứ ba tải lên, chẳng hạn như video do người dùng tải lên hay không. Các giá trị hợp lệ là self và thirdParty. Đây là phương diện chính và phải tuân theo Chính sách về việc ngừng sử dụng.

Bảng bên dưới trình bày các cách kết hợp được hỗ trợ cho phương diện claimedStatus và uploaderType (cả hai đều được dùng trong thông số filters:

)
Giá trị claimedStatus Giá trị uploaderType Mô tả
[Chưa đặt] bản thân Truy xuất dữ liệu YouTube Analytics đối với nội dung đã xác nhận quyền sở hữu và chưa xác nhận quyền sở hữu do chủ sở hữu nội dung tải lên.
đã xác nhận quyền sở hữu [Chưa đặt] Truy xuất dữ liệu về nội dung đã được xác nhận quyền sở hữu do chủ sở hữu nội dung hoặc bên thứ ba tải lên.
đã xác nhận quyền sở hữu bản thân Truy xuất dữ liệu về nội dung được xác nhận quyền sở hữu do chủ sở hữu nội dung tải lên.
đã xác nhận quyền sở hữu thirdParty Truy xuất dữ liệu về nội dung được xác nhận quyền sở hữu do bên thứ ba tải lên.

Ví dụ

Nhiều yêu cầu API mẫu cho báo cáo của chủ sở hữu nội dung sử dụng tổ hợp phương diện claimedStatus và uploaderType được hỗ trợ để lọc dữ liệu.