Dimensions

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

Phương diện là các tiêu chí phổ biến dùng để tổng hợp dữ liệu, chẳng hạn như ngày diễn 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 sẽ xác định những phương diện mà báo cáo đó hỗ trợ. Ví dụ: khi truy xuất hoạt động của người dùng theo thời gian, bạn chọn khoảng thời gian mà 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 YouTube Analytics API. Trong yêu cầu, 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 chính

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

Danh sách sau đây xác định các phương diện cốt lõi của API.

Để biết thêm thông tin, hãy xem danh sách các API YouTube tuân theo Chính sách ngừng sử dụng.

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 các giá trị phương diện phải có trong tập dữ liệu được truy xuất. Do đó, các bộ lọc này giới hạn phản hồi 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 các chỉ số về 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 các chỉ số về hoạt động của người dùng ở Châu Âu, bạn sẽ đặt giá trị thông số filters thành continent==150.

Lưu ý quan trọng: Các 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 hỗ trợ của các phương diện claimedStatus và uploaderType.

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 sử dụng trong cả báo cáo kênh và chủ sở hữu nội dung. Hệ thống cũng xác định những phương diện chỉ có thể dùng làm bộ lọc.

Tài nguyên

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

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

video (phương diện cốt lõi)
Mã của một video trên YouTube. Trong YouTube Data API, đây là giá trị của thuộc tính id của tài nguyên video. This is a core dimension and is subject to the Deprecation Policy.
danh sách phát
Mã nhận dạng của một danh sách phát trên YouTube. Trong YouTube Data API, đây là giá trị của 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 YouTube Data API, đây là giá trị của 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 các báo cáo dành cho chủ sở hữu nội dung vì những báo cáo đó thường tổng hợp dữ liệu cho nhiều kênh.
nhóm (chỉ lọc)
Mã của một nhóm trong YouTube Analytics. Bạn có thể truy xuất giá trị này bằ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 API sẽ chứa dữ liệu cho tất 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 các phương diện hoặc bộ lọc thực thể báo cáo:

  • Ví dụ về kênh

    • Thống kê cơ bản
      • Top 10 – Những video được xem nhiều nhất của một kênh
      • Top 10 – Tỷ lệ nhấp vào chú thích của những 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ể
      • Top 10 – Danh sách phát được xem nhiều nhất của một kênh
    • Địa lý
      • Top 10 – Những video được xem nhiều nhất ở một quốc gia cụ thể
      • Top 10 – Video được xem nhiều nhất ở Châu Âu

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

    • Thống kê cơ bản
      • Top 10 – Những video được xem nhiều nhất của một chủ sở hữu nội dung
      • Top 10 – Những video được xem nhiều nhất của một chủ sở hữu nội dung
      • Top 10 – Những video được xem nhiều nhất trên kênh của chủ sở hữu nội dung
      • Top 10 – Tỷ lệ nhấp vào chú thích của những video được xem nhiều nhất trên kênh
      • Top 10 – Danh sách phát được xem nhiều nhất của một chủ sở hữu nội dung
    • Địa lý
      • Top 10 – Những video được xem nhiều nhất ở Châu Âu của một chủ sở hữu nội dung
      • Top 10 – Danh sách phát được bắt đầu nhiều nhất ở Hoa Kỳ

Khu vực địa lý

Các phương diện này xác định một khu vực địa lý liên kết với 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.

country (phương diện cốt lõi)
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 ISO-3166-1 gồm hai chữ cái, 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 xác định được 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ổ ở 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 ở 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 các chỉ số mà YouTube không xác định được tiểu bang liên quan ở Hoa Kỳ. Khi một yêu cầu API bao gồm province trong giá trị tham số dimensions, yêu cầu đó cũng phải hạn chế dữ liệu ở Hoa Kỳ bằng cách đưa 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 xa xôi của Hoa Kỳ vì các lãnh thổ đó cũng có mã quốc gia ISO 3166-1 riêng. Ngoài ra, tính năng này cũng không hỗ trợ các đơn vị phụ thuộc của quốc gia ngoài Hoa Kỳ.

dma
Mã nhận dạng gồm 3 chữ số mà Nielsen sử dụng để xác định Khu vực 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 liên kết với các chỉ số trong hàng báo cáo. Dữ liệu cho phương diện này có sẵn cho các ngày bắt đầu từ ngày 1 tháng 1 năm 2022.
lục địa (chỉ dùng để 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à vùng Caribê)
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 tham số filters thành continent==REGION_CODE, chỉ định giá trị REGION_CODE trong bảng.
subContinent (chỉ lọc)
Mã khu vực thống kê của Liên Hợp Quốc xác định một tiểu khu vực địa lý. Phòng Thống kê của Liên Hợp Quốc liệt kê các tiểu khu vực cũng như các quốc gia 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 tham số filters thành subContinent==REGION_CODE, chỉ định giá trị REGION_CODE trong danh sách của 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 theo vị trí đị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 số liệu khác) của một kênh
    • Địa lý
      • Chỉ số về thời gian xem theo quốc gia cho các video của một kênh
      • Chỉ số chú thích theo quốc gia cho video của một kênh
      • Chỉ số theo tỉnh cho các tiểu bang ở Hoa Kỳ và Washington, D.C.
      • Chỉ số thời gian xem theo quốc gia cho danh sách phát của một kênh
      • Top 10 – Danh sách phát được bắt đầu nhiều nhất ở Hoa Kỳ
    • Vị trí phát: Số lượt xem và thời gian xem hằng ngày ở các 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 ở một quốc gia
    • 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)
    • Video hàng đầu
      • Top 10 – Những video được xem nhiều nhất ở một quốc gia cụ thể
      • Top 10 – 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à các số liệu khác) cho tất cả video do bạn tự tải lên
    • Địa lý
      • 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
      • 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
      • Chỉ số theo tỉnh cho các tiểu bang ở Hoa Kỳ và Washington, D.C.
      • 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
      • Top 10 – Danh sách phát được bắt đầu nhiều nhất ở Hoa Kỳ
    • Vị trí phát: Số lượt xem và thời gian xem hằng ngày ở các vị trí phát
    • 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)
    • Video hàng đầu: Top 10 – Video được xem nhiều nhất ở Châu Âu của một chủ sở hữu nội dung
    • Doanh thu/Hiệu suất quảng cáo: Các chỉ số về doanh thu và hiệu suất quảng cáo theo quốc gia

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ư một ngày, một tuần hoặc một tháng. Thông số yêu cầu startDate và endDate chỉ định khoảng thời gian mà báo cáo bao gồm dữ liệu. Xin 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 thực hiện truy vấn. Trong báo cáo, ngày được liệt kê ở định dạng YYYY-MM-DD.

Lưu ý quan trọng: Tất cả ngày đều đề cập đến khoảng thời gian bắt đầu lúc 00:00 theo giờ Thái Bình Dương (UTC-7 hoặc UTC-8) và kết thúc lúc 23:59 theo giờ Thái Bình Dương vào ngày, tháng và năm đã chỉ định. Do đó, những ngày mà đồng hồ được điều chỉnh về phía trước cho Giờ mùa hè sẽ đại diện cho khoảng thời gian 23 giờ và những ngày mà đồng hồ được điều chỉnh về phía sau sẽ đại diện cho khoảng thời gian 25 giờ.

Phương diện tháng đề cập đến khoảng thời gian bắt đầu lúc 00:00 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 tìm thấy 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. Cũng như với 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 chi tiết 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 các phương diện hoặc bộ lọc theo thời gian:

  • Ví dụ về kênh

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

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 diễn ra hoạt động của người dùng.

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 nơi diễn ra lượt phát video. Các giá trị có thể có cho phương diện này là:

  • BROWSE – Dữ liệu này mô tả số 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 xem khác trên YouTube.

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

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

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

  • MOBILE – Dữ liệu này mô tả số lượt xem xảy ra 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, các lượt phát không còn được phân loại là lượt phát MOBILE trong báo cáo của YouTube Analytics nữa. Giá trị này có thể vẫn xuất hiệ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 nơi diễn ra 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 này mô tả số lượt xem xảy ra trên trang xem video trên YouTube 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 theo cách khác.

insightPlaybackLocationDetail
Dữ liệu được tổng hợp dựa trên trang chứa trình phát. Xin lưu ý rằng báo cáo này chỉ hỗ trợ những lượt xem xảy ra trong trình phát được nhúng và báo cáo này sẽ xác định những 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 thông tin 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 liên kết với 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 phương diện vị trí phát:

  • Ví dụ về kênh

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

Thông tin chi tiết về việc phát

creatorContentType
Phương diện này xác định loại nội dung được liên kết với các chỉ số về hoạt động của người dùng trong hàng dữ liệu. Dữ liệu cho phương diện này có sẵn cho các ngày bắt đầu 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 buổi phát trực tiếp trên YouTube.
SHORTS Nội dung được xem là một video ngắn trên YouTube.
STORY Nội dung được xem là một Story trên YouTube.
VIDEO_ON_DEMAND Nội dung được 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 các chỉ số hoạt động của người dùng trong hàng dữ liệu có được liên kết với lượt xem của một sự kiện phát trực tiếp hay không. Dữ liệu cho phương diện này 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 này mô tả hoạt động của người dùng diễn ra trong một sự kiện phát trực tiếp.
ON_DEMAND Dữ liệu của hàng này mô tả hoạt động của người dùng không xảy ra trong một sự kiện phát trực tiếp.
subscribedStatus
Phương diện này cho biết liệu các chỉ số về hoạt động của người dùng trong hàng dữ liệu có liên kết với những người xem đã đăng ký kênh của video hoặc danh sách phát hay không. Các giá trị có thể sử dụng là SUBSCRIBED và UNSUBSCRIBED.

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

Bảng sau đây 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 diễn ra trong một trong các ứng dụng YouTube chuyên biệt (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 đưa vào CORE.
GAMING Hoạt động của người dùng diễn ra trên 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 vào hoặc sau ngày 1 tháng 3 năm 2021. Dữ liệu trước ngày 1 tháng 3 năm 2021 được đưa vào 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 liên kết giới thiệu, mô tả cách người dùng truy cập vào video. Các giá trị có thể có cho phương diện này là:
  • ADVERTISING – Người xem được quảng cáo giới thiệu đến video. 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 loại quảng cáo.
  • ANNOTATION – Người xem truy cập vào video đó bằng cách nhấp vào chú thích trong một video khác.
  • CAMPAIGN_CARD – Số lượt xem bắt nguồn từ những video do người dùng tải lên và đã được xác nhận quyền sở hữu mà chủ sở hữu nội dung dùng để quảng bá nội dung được 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 – Số lượt xem được giới thiệu từ màn hình kết thúc của một video khác.
  • EXT_URL – Số lượt xem video được giới thiệu từ một đường 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ả trên Google Tìm kiếm.
  • HASHTAGS – Số lượt xem bắt nguồn từ trang hashtag của video theo yêu cầu hoặc trang tổng hợp hashtag của video ngắn.
  • LIVE_REDIRECT – Lượt xem video được giới thiệu từ Live Redirect.
  • NO_LINK_EMBEDDED – Video được nhúng trên một trang web khác khi được xem.
  • NO_LINK_OTHER – YouTube không xác định được nguồn 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 một video cũng như lưu lượng truy cập trên ứng dụng di động.
  • NOTIFICATION – Số lượt xem video được giới thiệu từ một email hoặc thông báo của YouTube.
  • PLAYLIST – Lượt xem video xảy ra khi video đang phát trong danh sách phát. Chỉ số này bao gồm cả lưu lượng truy cập từ trang danh sách phát.
  • PRODUCT_PAGE – Số lượt xem video được giới thiệu từ một trang Sản phẩm.
  • PROMOTED – Số lượt xem video được giới thiệu từ một nội dung quảng bá không trả phí trên YouTube, chẳng hạn như trang "Video nổi bật" trên YouTube.
  • RELATED_VIDEO – Số lượt xem video được giới thiệu từ trang thông tin của một 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, 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 trang xem video ngắn.
  • SOUND_PAGE – Lượt xem bắt nguồn từ các trang tổng hợp âm thanh trên Shorts.
  • SUBSCRIBER – Số lượt xem video được giới thiệu từ nguồn cấp dữ liệu trên trang chủ YouTube hoặc từ các tính năng đăng ký trên 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 mà từ đó 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, trường insightTrafficSourceDetail sẽ chỉ định mã nhận dạng kênh cho kênh đó.
  • YT_OTHER_PAGE – Số lượt xem video được giới thiệu từ một đường liên kết không phải là kết quả tìm kiếm hoặc đường liên kết đến video có liên quan xuất hiện trên trang 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 – Số 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, trường insightTrafficSourceDetail sẽ chỉ định cụm từ tìm kiếm.
  • VIDEO_REMIXES – Số lượt xem video được giới thiệu từ đường liên kết đến video 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, trường insightTrafficSourceDetail sẽ chỉ định video đã giới thiệu người xem.
insightTrafficSourceDetail
Dữ liệu trong báo cáo được tổng hợp dựa trên những trang giới thiệu đã tạo ra 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ụ thể. Danh sách sau đây xác định nguồn lưu lượng truy cập mà bạn có thể sử dụng 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 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ể sử dụng 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 trên Google Tìm kiếm
    • Quảng cáo video trên trang chủ
    • Quảng cáo trong luồng phát có thể bỏ qua (đã đặt trước)
    • 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 dẫn người xem đến video được xác định trong báo cáo.
  • END_SCREEN – Video dẫn 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 – Hashtag đã dẫn đến lượt xem.
  • NOTIFICATION – Email hoặc thông báo đã giới thiệu lưu lượng truy cập.
  • RELATED_VIDEO – Video có liên quan đã đưa người xem đến video được đề cập trong báo cáo.
  • SOUND_PAGE – Video dẫn đến lượt xem.
  • SUBSCRIBER – Mục trong trang chủ hoặc tính năng kênh đăng ký trên YouTube đã đưa người xem đến video được đề cập trong báo cáo. Có các giá trị hợp lệ như sau:
    • activity – Số lượt xem từ các mục trong trang kênh đăng ký trên trang chủ, bắt nguồn từ hoạt động không phải là nội dung tải lên và hoạt động xã hội trên kênh, bao gồm cả lượt thích, mục yêu thích, bài đăng thông báo và lượt thêm danh sách phát.
    • blogged – Số lượt xem từ các mục trong trang kênh đăng ký trên trang chủ, bắt nguồn từ các đường liên kết trên các blog hàng đầu.
    • mychannel – Số lượt xem bắt nguồn từ các mục trong các trang khác được liệt kê trên trang chủ, chẳng hạn như "Video đã thích", "Nhật ký xem" và "Xem sau".
    • podcasts – Số lượt xem bắt nguồn từ các mục trong trang đích của Podcast.
    • sdig – Số lượt xem bắt nguồn từ email cập nhật về gói thuê bao.
    • uploaded – Số lượt xem từ các mục uploaded trong trang kênh đăng ký trên 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 của người dùng trên YouTube.
  • YT_CHANNEL – Trang kênh nơi người xem xem video.
  • YT_OTHER_PAGE – Trang YouTube mà từ đó 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 dẫn đến 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ừ các nguồn lưu lượng truy cập ở một quốc gia
      • 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
      • Top 10 – Những 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ừ tìm kiếm hàng đầu 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 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
      • 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

  • 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ừ các nguồn lưu lượng truy cập
      • 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
      • Top 10 – Những 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ừ tìm kiếm hàng đầu 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 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
      • 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

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à chế độ xem đã xảy ra. 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à lượt xem đã diễn ra. 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 phương diện thiết bị:

  • Ví dụ về kênh

    • Thiết bị/Hệ điều hành
      • Các chỉ số hằng ngày về loại thiết bị cho hệ điều hành Android
      • Chỉ số hằng ngày về hệ điều hành cho 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ố 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
      • 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

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

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

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 rõ sự phân bố theo độ tuổi và giới tính của người xem. Trung tâm trợ giúp của YouTube có thêm thông tin về dữ liệu nhân khẩu học trong báo cáo YouTube Analytics.

ageGroup (phương diện cốt lõi)
Phương diện này xác định nhóm tuổi của những người dùng đã đăng nhập được liên kết với dữ liệu báo cáo. API này 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.
gender (phương diện cốt lõi)
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)

Tương tác và chia sẻ nội dung

sharingService (phương diện cốt lõi)
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 thông 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
Ứng dụng Email của Android ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Ứng dụng nhắn tin của Android ANDROID_MMS
BlackBerry Messenger BBM
Blogger BLOGGER
Sao chép vào bảng nhớ tạm COPY_PASTE
Cyworld CYWORLD
Digg DIGG
Dropbox DROPBOX
Nhúng EMBED
Email MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Trang Facebook FACEBOOK_PAGES
Fotka FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
Tin nhắn văn bản của HTC HTC_MMS
Google Inbox INBOX
Hộp thoại Hoạt động hệ thống iOS IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Kik KIK
Email LGE LGE_EMAIL
Line LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
menéame MENEAME
mixi MIXI
Ứng dụng nhắn tin của Motorola MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
Chia sẻ lân cận NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
Khác OTHER
Pinterest PINTEREST
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
Sony Conversations 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
Verizon Messages VERIZON_MMS
Viber VIBER
VKontakte (ВКонтакте) 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

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 xã hội:

  • Ví dụ về kênh

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

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

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

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

elapsedVideoTimeRatio
Phương diện này chỉ định tỷ lệ phần trăm thời lượng đã trôi qua của video so với thời lượng video. Các phương diện và chỉ số về tỷ lệ giữ chân đượ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à phương diện đo lường thời gian. Ví dụ: giá trị 0.4 cho biết dữ liệu báo cáo tương ứng cho thấy dữ liệu về tỷ lệ giữ chân sau khi người dùng xem 40% video.

API này trả về 100 điểm dữ liệu cho mỗi video có giá trị tỷ lệ từ 0.01 đến 1.0. Thời điểm đo lường dữ liệu trong quá trình phát video được chia đều cho mỗi video. Điều này có nghĩa là đối với một video dài 2 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 2 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 giá trị đầu và giá trị cuối của khoảng thời gian.
audienceType (chỉ lọc)
Giá trị phương diện xác định loại lưu lượng truy cập được 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 xem Trung tâm trợ giúp của YouTube để biết 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ó sẵn kể 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ừ các ngày trước đó. Các cụm từ tìm kiếm không sử dụng bộ lọc sẽ hoạt động cho mọi ngày 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 trực tiếp dạng video. Các chỉ số trong 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 đó.

Lượt huỷ gói thành viên

membershipsCancellationSurveyReason
Số người dùng YouTube đã hoàn tất bản khảo sát và đã huỷ gói hội viên của kênh trong khoảng thời gian báo cáo. Bảng sau đây liệt kê các giá trị kích thước hợp lệ:
Giá trị API Giải thích
UNKNOWN Người dùng chưa hoàn tất bài khảo sát.
DISLIKE_PERKS Người dùng không thích các đặc quyền của gói thành viên.
PERKS_NOT_DELIVERED Người dùng cho biết các đặc quyền thành viên đã hứa hẹn không được cung cấp.
CANNOT_ACCESS_PERKS Người dùng không thể sử dụng các đặc quyền.
NO_LONGER_INTERESTED Người dùng không còn quan tâm đến gói hội viên của kênh.
FEEL_UNAPPRECIATED Người dùng cảm thấy không được trân trọng khi là thành 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 khoảng thời gian có hạn.
OTHER Người dùng có lý do khác để huỷ.

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

adType
Phương diện adType được 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 các loại quảng cáo đã chạy trong khi phát video. Danh sách sau đây giải thích các giá trị phương diện có thể có. Hãy xem Trung tâm trợ giúp của 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 và người xem phải xem hết thì mới có thể xem video.

  • auctionDisplay – Quảng cáo dạng nội dung đa phương tiện hoặc 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ế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 số nhiều quảng cáo dạng video trong số các lựa chọn xuất hiện trước một 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. Hãy 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á AdWords nhưng chưa được phân loại vào một trong các loại quảng cáo khác.

  • reservedBumperInstream – Quảng cáo dạng video không thể bỏ qua, được bán theo cơ chế đặt trước, có độ dài tối đa 6 giây mà khán giả phải xem hết thì mới xem được 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. Lượt hiển thị quảng cáo được ghi lại bất cứ khi 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 hay không. Những sản phẩm này được bán theo cơ chế đặt trước.

  • reservedDisplay – Quảng cáo dạng nội dung đa phương tiện hoặc 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ế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 – Quảng cáo lớn, có thể bao gồm cả thành phần video và đồ hoạ, xuất hiện trên trang chủ.

  • reservedUnknown – Quảng cáo được bán theo hình thức đặt trước và không thể phân loại vào một trong các 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 các chỉ số về hiệu suất quảng cáo hoặc doanh thu:

  • Ví dụ về kênh

    • Doanh thu/Quảng cáo
      • Chỉ số về doanh thu của kênh và hiệu suất quảng cáo
      • Chỉ số doanh thu hằng ngày và 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
      • Top 10 – Video có doanh thu cao nhất
      • Chỉ số hiệu suất quảng cáo cho nhiều 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 của nội dung đã xác nhận quyền sở hữu
      • Chỉ số doanh thu hằng ngày và 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
      • Top 10 – Video có doanh thu cao nhất
      • Chỉ số hiệu suất quảng cáo cho nhiều loại quảng cáo

Phương diện 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: Các 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
  • Một tổ hợp được hỗ trợ của các phương diện claimedStatus và uploaderType như được xác định bên dưới.
claimedStatus (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 API chỉ được chứa các chỉ số cho nội dung được xác nhận quyền sở hữu. Giá trị hợp lệ duy nhất cho phương diện này là claimed. Nếu thông số filters hạn chế truy vấn ở claimedStatus==claimed, thì 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 của 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.
uploaderType (phương diện cốt lõi) (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 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 hay không, chẳng hạn như video do người dùng tải lên. Các giá trị hợp lệ là self và thirdParty. Đây là phương diện cốt lõi và tuân theo Chính sách ngừng sử dụng.

Bảng bên dưới cho thấy các tổ hợp được hỗ trợ cho phương diện claimedStatus và uploaderType, cả hai đều được sử dụng trong tham số filters:

Giá trị claimedStatus Giá trị uploaderType Mô tả
[Chưa đặt] self Truy xuất dữ liệu YouTube Analytics cho 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 self Truy xuất dữ liệu cho 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 chủ sở hữu nội dung sử dụng tổ hợp được hỗ trợ của phương diện claimedStatus và uploaderType để lọc dữ liệu.