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à những tiêu chí chung được 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 đều 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 mọi báo cáo, mỗi hàng dữ liệu đều có một tổ hợp giá trị phương diện riêng biệ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 của bạn, hãy sử dụng tham số dimensions để chỉ định các phương diện mà YouTube 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 ngừng cung cấp được quy định trong Điều khoản dịch vụ, nhưng các phương diện không phải là phương diện cốt lõi (và các chỉ số không phải là chỉ số cốt lõi) 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 của YouTube chịu sự điều chỉnh của Chính sách ngừng cung cấp.

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ị phương diện phải có trong tập dữ liệu được truy xuất. Do đó, các tham số này 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 các chỉ số về hoạt động của người dùng ở 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 sẽ 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ị tham 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 một tổ hợp được hỗ trợ của phương diện claimedStatus và uploaderType.

Kích thước

Các phần sau đây xác định những phương diện được dùng trong báo cáo truy vấn của YouTube Analytics API. Trừ phi có ghi chú khác, những phương diện này được dùng trong cả báo cáo kênh và chủ sở hữu nội dung. Những phương diện chỉ có thể 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 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 này 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ị tham số filters thành một danh sách gồm các mã video, danh sách phát hoặc kênh được phân tách bằng dấu phẩy mà phản hồi API sẽ lọc. 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ã nhận dạng của một video trên YouTube. Trong YouTube Data API, đây là giá trị của thuộc tính id trong tài nguyên video. This is a core dimension and is subject to the Deprecation Policy.
playlist
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 trong tài nguyên playlist.
channel (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 trong 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ì những báo cáo đó thường tổng hợp dữ liệu cho nhiều kênh.
group (chỉ lọc)
Mã nhận dạng 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 YouTube Analytics API. Khi bạn sử dụng bộ lọc group, phản hồi của API sẽ chứa dữ liệu của 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 bộ lọc hoặc phương diện thực thể báo cáo:

  • Ví dụ về kênh

    • Số liệu thống kê cơ bản
      • Top 10 – Những video được xem nhiều nhất trên 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 một kênh
      • Số liệu thống kê cho một danh sách phát cụ thể
      • Top 10 – Most watched playlists for a channel (10 danh sách phát được xem nhiều nhất trên một kênh)
    • Khu vực địa lý
      • Top 10 – Những video được xem nhiều nhất ở một quốc gia cụ thể
      • Top 10 – Những 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
      • 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 một 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 một 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
    • Khu vực địa lý
      • Top 10 – Những video được xem nhiều nhất ở Châu Âu đối với một chủ sở hữu nội dung
      • Top 10 – Danh sách phát được tạo 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 chỉ số doanh thu ước tính.

country (phương diện cốt lõi)
Quốc gia đượ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ã quốc gia gồm 2 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 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ổ của Hoa Kỳ được liên kết với các chỉ số trong hàng của báo cáo. Giá trị phương diện là một 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 xác định được tiểu bang tương ứng ở Hoa Kỳ. Khi một yêu cầu API có chứa 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 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 vùng lãnh thổ hải ngoại của Hoa Kỳ vì những vùng 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 tiểu bang của những quốc gia khác ngoài Hoa Kỳ.

dma
Giá trị 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) được 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ỉ bộ lọc)
Mã khu vực thống kê của Liên Hợp Quốc (LHQ). API này hỗ trợ các giá trị sau:
Giá trị
002 Châu Phi
019 Châu Mỹ (Bắc Mỹ, Mỹ La-tinh, Nam Mỹ và vùng Caribe)
142 Châu Á
150 Châu Âu
009 Châu Đại dương
Bạn chỉ có thể 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ỉ bộ lọc)
Mã khu vực thống kê của Liên Hợp Quốc xác định một tiểu vùng địa lý. Cục Thống kê 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ục này liên kết với từng khu vực.

Bạn chỉ có thể 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à nhiều số liệu khác) của một kênh
    • Khu vực địa lý
      • Chỉ số thời gian xem theo quốc gia cho các video trên một kênh
      • Chỉ số chú thích theo quốc gia cho video của một kênh
      • Các chỉ số theo tỉnh cho các tiểu bang của 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 tạo 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 khác nhau
    • 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 khác nhau ở 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
      • Top 10 – Những video được xem nhiều nhất ở một quốc gia cụ thể
      • Top 10 – Những 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) cho tất cả video do bạn tự tải lên
    • Khu vực địa lý
      • Các chỉ số về 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 từng quốc gia cho nội dung tự tải lên
      • Các chỉ số theo tỉnh cho các tiểu bang của Hoa Kỳ và Washington D.C.
      • Các chỉ số về 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 tạo 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 khác nhau
    • 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 được xem nhiều nhất ở Châu Âu đối với 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 rằng 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. Tham số yêu cầu startDate và endDate chỉ định khoảng thời gian mà báo cáo sẽ 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ê theo đị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 từ 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 được chỉ định. Do đó, những ngày mà đồng hồ được điều chỉnh theo Giờ tiết kiệm ánh sáng ban ngày sẽ biểu thị khoảng thời gian 23 giờ và những ngày mà đồng hồ được điều chỉnh ngược lại sẽ biểu thị khoảng thời gian 25 giờ.

Phương diện tháng đề cập đến khoảng thời gian bắt đầu từ 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 cốt lõi)
Khi bạn sử dụng phương diện này, dữ liệu trong báo cáo sẽ được tổng hợp hằng ngày và mỗi hàng chứa dữ liệu của 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ê hằng ngày về lượt xem 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 cốt lõi)
Dữ liệu trong báo cáo được tổng hợp theo tháng dương lịch. Tương tự 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 kỹ hơn nữa. Trong báo cáo, ngày được liệt kê theo đị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ì cả hai tham số start-date và end-date đều phải được đặt 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 theo thời gian:

  • Ví dụ về kênh

    • Dựa trên thời gian
      • Chỉ số thời gian xem hằng ngày của video trên một kênh
      • Số liệu hằng ngày về chú thích cho 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 khác nhau
    • 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 khác nhau
    • Thiết bị/Hệ điều hành
      • Chỉ số hằng ngày về loại thiết bị cho hệ điều hành Android
      • Số liệu 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 đối với nội dung tự tải lên
      • Chỉ số chú thích cho nội dung đã xác nhận quyền sở hữu
      • Số lượt xem danh sách phát hằng ngày của chủ sở hữu nội dung
    • Vị trí phát: Số lượt xem và thời gian xem hằng ngày ở các vị trí phát khác nhau
    • 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 khác nhau
    • Thiết bị/Hệ điều hành
      • Chỉ số hằng ngày về loại thiết bị đối với video đã được xác nhận quyền sở hữu
      • Số liệu hằng ngày về hệ điều hành của những video đã được xác nhận quyền sở hữu mà người dùng 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

Những 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 diễn 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 nơi diễn ra hoạt động 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 danh sách video mà người dùng đăng ký theo dõi hoặc trong một tính năng duyệt xem khác của YouTube.

  • CHANNEL – Dữ liệu này 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 nơi video được nhúng bằng cách sử dụng mã 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, nơi 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 những ứ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 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, lượt phát sẽ 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 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 đó, lượt phát trên thiết bị di động sẽ đượ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 lượt phát diễn ra.

  • SEARCH – Dữ liệu này 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 này mô tả những lượt 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 có 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à 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 các URL hoặc ứng dụng được liên kết với những 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 lại
      • Số lượt xem và thời gian xem ở 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 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 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 lại
      • Số lượt xem và thời gian xem ở 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 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 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ố 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à video Shorts trên YouTube.
STORY Nội dung đã xem là một YouTube Story.
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ị khác của phương diện.
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ố về hoạt động của người dùng trong hàng dữ liệu có liên quan đến lượt xem 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 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 chương trình phát sóng 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 diễn ra trong một chương trình phát sóng 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 quan đến 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 chính xác tại 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ý 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ụ của 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ó 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 chuyên biệt của YouTube (YouTube Gaming, YouTube Kids hoặc YouTube Music). 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 diễn 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 nguồn 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 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, 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 – Lượt xem đến từ những video đã được xác nhận quyền sở hữu do người dùng tải lên 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 – Lượt xem đến từ màn hình kết thúc của một video khác.
  • EXT_URL – Số lượt xem video đến 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 – Lượt xem bắt nguồn từ trang hashtag của video theo yêu cầu hoặc trang hashtag của video Shorts.
  • LIVE_REDIRECT – Lượt xem video đến từ tính năng 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 đơn vị 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 vào 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 đến từ email hoặc thông báo của YouTube.
  • PLAYLIST – Lượt xem video xảy ra khi video đang được phát trong danh sách phát. Chỉ số này bao gồm lưu lượng truy cập đến từ trang danh sách phát.
  • PRODUCT_PAGE – Lượt xem video đến từ một trang Sản phẩm.
  • PROMOTED – Lượt xem video đến từ một chương trình quảng bá không trả phí trên YouTube, chẳng hạn như trang "Video nổi bật" của YouTube.
  • RELATED_VIDEO – Số lượt xem video đến 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, trường insightTrafficSourceDetail sẽ chỉ định mã video cho video đó.
  • SHORTS – Người xem được chuyển đến từ video trước đó trong chế độ xem video Shorts bằng cách vuốt dọc.
  • SOUND_PAGE – Lượt xem bắt nguồn từ trang âm thanh trên Shorts.
  • SUBSCRIBER – Lượt xem video đến từ nguồn cấp dữ liệu trên trang chủ của 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 trên 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 của kênh đó.
  • YT_OTHER_PAGE – Số lượt xem video đến từ một đường liên kết không phải là đường liên kết đến kết quả tìm kiếm hoặc 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 đến 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 – Lượt xem video được giới thiệu thông qua đườ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 mà người xem được giới thiệu đến.
insightTrafficSourceDetail
Dữ liệu trong báo cáo được tổng hợp dựa trên những nguồn 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áo cáo này cung cấp. Đố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ể 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 Mạng Tìm kiếm của Google
    • Quảng cáo video trên trang chủ
    • Quảng cáo trong luồng phát có thể bỏ qua được đặt trước
    • TrueView trong tìm kiếm và trong hiển thị
    • TrueView trong luồng phát
    • 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 video cho người xem.
  • 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ó trong báo cáo.
  • SOUND_PAGE – Video tạo ra lượt xem.
  • SUBSCRIBER – Mục trong nguồn cấp dữ liệu trên trang chủ hoặc tính năng kênh đăng ký trên YouTube đã đưa người xem đến video có trong báo cáo. Các giá trị hợp lệ là:
    • activity – Số lượt xem bắt nguồn từ các mục trong trang kênh đăng ký trên trang chủ, nhưng không phải do hoạt động tải lên và hoạt động trên mạng xã hội của kênh, bao gồm cả lượt thích, lượt thêm vào danh sách yêu thích, bài đăng trên bảng thông báo và lượt thêm vào danh sách phát.
    • blogged – Số lượt xem bắt nguồn từ các mục trong trang kênh đăng ký trên trang chủ, do người xem nhấp vào đường liên kết từ các blog hàng đầu.
    • mychannel – Số lượt xem bắt nguồn từ các mục trong những trang khác 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 thông báo về hoạt động đăng ký.
    • uploaded – Số lượt xem bắt nguồn từ uploaded mục 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 – Lượt xem đến từ trang Kênh tôi đăng ký 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à 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 tạo ra 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 ở 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
      • Top 10 – 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
      • Top 10 – 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 và thời gian xem danh sách phát từ nhiều 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 của danh sách phát theo từng 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
      • Top 10 – 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
      • Top 10 – 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 và thời gian xem danh sách phát từ nhiều 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 của danh sách phát theo từng 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 thiết bị thực tế mà lượt xem diễn 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
  • AUTOMOTIVE
  • WEARABLE
  • 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à trên đó lượt xem đã diễn ra. Danh sách sau đây xác định những hệ điều hành mà API trả về dữ liệu. Bạn cũng có thể 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
      • Chỉ số hằng ngày về loại thiết bị cho hệ điều hành Android
      • Số liệu 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ị
      • Số liệu hằng ngày về loại thiết bị đối với lượt xem danh sách phát trên hệ điều hành Android
      • Số liệu hằng ngày về hệ điều hành cho 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ố hằng ngày về loại thiết bị đối với video đã được xác nhận quyền sở hữu
      • Số liệu hằng ngày về hệ điều hành của những video đã được xác nhận quyền sở hữu mà người dùng 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ị
      • Số liệu hằng ngày về loại thiết bị đối với lượt xem danh sách phát trên hệ điều hành Android
      • Số liệu hằng ngày về hệ điều hành cho 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 nắm được sự phân bổ theo độ tuổi và giới tính của khán giả. 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 những 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
Email Android ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Nhắn tin trên 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

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

  • Ví dụ về kênh

    • Mạng xã hội: Chia sẻ các chỉ số được 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: Chia sẻ các chỉ số được tổng hợp theo dịch vụ nơi video được chia sẻ

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

elapsedVideoTimeRatio
Phương diện này chỉ định tỷ lệ giữa phần đã trôi qua của video với độ dài của video. 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, trong đó 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 giữ chân sau khi 40% thời lượng video đã trôi qua.

API này trả về 100 điểm dữ liệu cho mỗi video với cá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 phân bổ đề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ị điểm kết thúc của khoảng thời gian (không bao gồm).
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 thông tin 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 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 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 luồng video phát trực tiếp. Các chỉ số trong báo cáo cho biết số lượng người dùng 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ố lượng khảo sát mà người dùng YouTube đã hoàn thành sau khi huỷ gói hội viên của họ đối với kênh được chỉ định trong khoảng thời gian 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 dành cho hội viên.
PERKS_NOT_DELIVERED Người dùng cho biết các đặc quyền dành cho hội viên như đã hứa 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 nữa.
FEEL_UNAPPRECIATED Người dùng cảm thấy không được trân trọng khi 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 giới 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 quá trình 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 truy cập 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à khán giả phải xem hết quảng cáo thì mới có thể xem video.

  • auctionDisplay – Một 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 dưới dạng 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ữ xuất hiện 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 phát trước, trong hoặc sau video chính.

  • auctionTrueviewInslate – Người xem chọn một trong số các quảng cáo dạng video trong danh sách 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 – Một 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 hình thức đặ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 quảng cáo này được bán theo hình thức đặt trước.

  • reservedDisplay – Một 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 dưới dạng 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ữ xuất hiện 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 khi video chính.

  • reservedInstreamSelect

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

  • reservedUnknown – Một 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 phân loại được 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ố về hiệu suất hoặc doanh thu của quảng cáo:

  • 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ố về doanh thu và hiệu suất quảng cáo hằng ngày
      • Chỉ số về doanh thu và hiệu suất quảng cáo theo từng quốc gia
      • Top 10 – Các 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
      • Các 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ố về doanh thu và hiệu suất quảng cáo hằng ngày
      • Chỉ số về doanh thu và hiệu suất quảng cáo theo từng quốc gia
      • Top 10 – Các 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

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 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 một phản hồi API chỉ nên chứa các chỉ số cho nội dung đã 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 tham số filters hạn chế truy vấn thành 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 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.
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 các chỉ số về 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à một phương diện cốt lõi và phải tuân theo Chính sách ngừng sử dụng.

Bảng dưới đây cho thấy các tổ hợp được hỗ trợ cho phương diện claimedStatus và uploaderType. Cả hai phương diện này đều được 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 cho 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 bị 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 một tổ hợp được hỗ trợ gồm phương diện claimedStatus và uploaderType để lọc dữ liệu.