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ợ những 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 được dùng để dữ liệu tổng hợp, chẳng hạn như ngày mà hoạt động của người dùng diễn ra 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 đó 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ẽ 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ù YouTube Analytics API tuân theo Chính sách về việc ngừng cung cấp được xác định trong Điều khoản dịch vụ, nhưng các phương diện không cốt lõi (và các chỉ số không cốt lõi) không tuân theo 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 như vậy.

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 về việc 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 các 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 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ị tham số filters thành continent==150.

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 của pháp nhân báo cáo hoặc sử dụng một 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 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, các phương diện này được dùng trong cả báo cáo kênh và báo cáo 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 cho phép bạn chỉ định nhiều giá trị cho các phương diện video, playlist và channel khi chúng được dùng làm bộ lọc. Để làm việc này, hãy đặt giá trị tham số filters thành một danh sách được phân tách bằng dấu phẩy gồm các mã video, danh sách phát hoặc mã nhận dạng kênh mà bạn muốn lọc phản hồi của 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ã 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 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.
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 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ì những báo cáo đó thường tổng hợp dữ liệu cho nhiều kênh.
group (chỉ bộ 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 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 phương diện hoặc bộ lọc của pháp nhân báo cáo:

  • Ví dụ về kênh

    • Số liệu thống kê cơ bản
      • Top 10 – Video được xem nhiều nhất trên một kênh
      • 10 video 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ê về một danh sách phát cụ thể
      • Top 10 – Danh sách phát được xem nhiều nhất trên 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

    • Số liệu thống kê cơ bản
      • Top 10 – Video được xem nhiều nhất của một chủ sở hữu nội dung
      • Top 10 – Các 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
      • 10 video 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
      • 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 – Các 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 quan đến 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 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 các 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ỳ 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 các chỉ số mà YouTube không thể xác định tiểu bang liên kết tại Hoa Kỳ. Khi một yêu cầu API có chứa province trong giá trị tham số dimensions, thì 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 lãnh thổ hải ngoại của Hoa Kỳ vì các lãnh thổ đó cũng có mã quốc gia ISO 3166-1 riêng. Tính năng này cũng không hỗ trợ các đơn vị hành chính của những quốc gia không phải Hoa Kỳ.

dma
Giá trị 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.
continent (chỉ bộ lọc)
Mã khu vực thống kê của Liên Hợp Quốc (UN). API này hỗ trợ các giá trị sau:
Giá trị Mô tả
002 Châu Phi
019 Châu Mỹ (Bắc Mỹ, Mỹ Latinh, Nam Mỹ và Caribe)
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ỉ 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ơ quan 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 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 đị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 thông tin khác) của một kênh
    • Địa lý
      • Chỉ số thời gian xem theo quốc gia cho các video của kênh
      • Chỉ số chú thích theo quốc gia cho video của kênh
      • 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 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 từ 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
    • 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à nhiều thông tin khác) cho tất cả video do bạn tự tải lên
    • Địa lý
      • Chỉ số về thời gian xem theo quốc gia đối với nội dung do bạn tự tải lên
      • Chỉ số chú thích theo quốc gia cho nội dung tự tải lên
      • Chỉ số theo tỉnh cho các tiểu bang của Hoa Kỳ và Washington D.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 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 từ các vị trí phát khác nhau
    • 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: 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ố hiệu suất về doanh thu và quảng cáo theo từng 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 phải 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. Các tham 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 truy vấn được thực hiện. Trong báo cáo, ngày được liệt kê theo định dạng YYYY-MM-DD.

Quan trọng: Tất cả các ngày đều là 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 tiến lên theo Giờ mùa hè sẽ có 23 giờ và những ngày mà đồng hồ được điều chỉnh lùi lại sẽ có 25 giờ.

Phương diện tháng đề cập đến khoảng thời gian bắt đầu từ 12 giờ đêm 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.

day (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ê 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.
month (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. 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ê 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 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 các video trên kênh
      • Chỉ số chú thích hằng ngày cho video của 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 từ 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
      • 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 đối với nội dung do bạn tự tải lên
      • Chỉ số về 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 từ 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 đã xác nhận quyền sở hữu
      • Chỉ số hằng ngày về hệ điều hành của thiết bị di động mà người dùng dùng để xem video đã được xác nhận quyền sở hữu
      • 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: Doanh thu hằng ngày và các chỉ số 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 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ả những lượt xem diễn ra trên Trang chủ YouTube hoặc màn hình chính, 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 của YouTube.

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

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

  • EXTERNAL_APP – Dữ liệu này mô tả những lượt xem diễn 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ụ: lượt phát trong các ứng dụng sử dụng API Trình phát YouTube cho Android sẽ được phân loại bằng giá trị này.

  • IMMERSIVE_LIVE_FEED – Dữ liệu mô tả số lượt xem diễn ra trên trang sự kiện phát trực tiếp dạng dọc.

  • MOBILE – Dữ liệu mô tả những lượt xem diễn 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. 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 trên 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 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.

  • SHORTS_FEED – Dữ liệu mô tả những lượt xem diễn ra trên trang YouTube Shorts.

  • WATCH – Dữ liệu này mô tả những lượt xem diễn ra trên trang xem video của 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ả 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 diễn 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 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
      • 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ừ nhiều vị trí phát
      • Top 10 – Các trang web bên thứ ba tạo ra nhiều lượt xem nhất cho video được nhúng
      • Số lượt xem và thời gian xem danh sách phát từ các vị trí phát khác nhau
      • Số lượt xem và thời gian xem danh sách phát hằng ngày 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ừ nhiều vị trí phát
      • Top 10 – Các trang web bên thứ ba tạo ra nhiều lượt xem nhất cho video được nhúng
      • Số lượt xem và thời gian xem danh sách phát từ các vị trí phát khác nhau
      • Số lượt xem và thời gian xem danh sách phát hằng ngày từ nhiều vị trí phát

Thông tin chi tiết về lượt phát

creatorContentType
Phương diện này xác định loại nội dung liên quan đến 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ị Mô tả
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à một video Shorts trên YouTube.
STORY Nội dung được xem là một YouTube Stories.
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 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ị Mô tả
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 sự kiện 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 sự kiện 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 là 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ý kênh và xem một video của kênh đó, sau đó đăng ký kênh và xem một video khác, tất cả đều 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 người dùng hoạt động. Dữ liệu cho phương diện này có sẵn 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ị Mô tả
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). 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 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 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 trang web giới thiệu, mô tả cách người dùng tìm thấy video. Các giá trị có thể có cho phương diện này là:
  • ADVERTISING – Người xem được một 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, thì 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 một chú thích trong một video khác.
  • CAMPAIGN_CARD – Lượt xem bắt nguồn từ những video đã được xác nhận quyền sở hữu và 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 – 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, thì trường insightTrafficSourceDetail sẽ xác định trang web. Nguồn lưu lượng truy cập này bao gồm các lượt giới thiệu từ kết quả tìm kiếm trên Google.
  • HASHTAGS – Lượt xem bắt nguồn từ trang hashtag của VOD hoặc trang tổng hợp hashtag của 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 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 vào video cũng như lưu lượng truy cập trên ứng dụng di động.
  • NOTIFICATION – Lượt xem video đến từ một email hoặc thông báo của YouTube.
  • PLAYLIST – Lượt xem video diễn ra khi video được phát trong một danh sách phát. Nguồn 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 được giới thiệu từ một trang sản phẩm.
  • PROMOTED – Lượt xem video được giới thiệu từ một chương trình quảng bá không tốn phí trên YouTube, chẳng hạn như trang "Video nổi bật" của YouTube.
  • RELATED_VIDEO – 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, thì trường insightTrafficSourceDetail sẽ chỉ định mã video cho video đó.
  • SHORTS – Người xem được chuyển hướng bằng cách vuốt dọc từ video trước đó trong trải nghiệm xem video ngắn.
  • SOUND_PAGE – Số lượt xem bắt nguồn từ trang tổng hợp âm thanh của Shorts.
  • SUBSCRIBER – Số lượt xem video đến 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ý 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ác mục trên trang chủ hoặc trang khác đã giới thiệu lượt xem.
  • YT_CHANNEL – Lượt xem video diễn 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 cho kênh đó.
  • YT_OTHER_PAGE – 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 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, thì 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, thì trường insightTrafficSourceDetail sẽ chỉ định cụm từ tìm kiếm.
  • VIDEO_REMIXES – Lượt xem video đến từ đường liên kết của 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, thì trường insightTrafficSourceDetail sẽ chỉ định video đã giới thiệu người xem.
  • WATCH_WITH – Lượt xem video đến từ một luồng phát có phần bình luận của nhà sáng tạo/tính năng "Xem cùng". 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 đã 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 web 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 có thể 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ể 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 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 dành riêng
    • 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 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 đã 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 trên 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 giá trị hợp lệ là:
    • 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 tải lên và không phải hoạt độ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ản tin và lượt thêm vào danh sách phát.
    • blogged – Số lượt xem từ các mục trong nguồn cấp dữ liệu trang Kênh đăng ký trên trang chủ bắt nguồn từ đườ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 những trang khác được liệt kê trên trang chủ, chẳng hạn như "Video đã thích", "Video đã xem" và "Xem sau".
    • podcasts – Số lượt xem bắt nguồn từ các mục trên trang đích Podcast.
    • sdig – Lượt xem bắt nguồn từ email cập nhật về gói thuê bao.
    • 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 – 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 trên YouTube đã giới thiệu người xem đến video.
  • YT_SEARCH – Cụm từ tìm kiếm đưa người xem đến video.
  • VIDEO_REMIXES – Video mang lại lượt xem.
  • WATCH_WITH – 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ừ 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 hằng ngày từ các nguồn lưu lượng truy cập khác nhau
      • 10 cụm từ tìm kiếm hàng đầu trên YouTube mang lại 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ìm kiếm mang lại 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 hằng ngày của danh sách phát từ các nguồn lưu lượng truy cập khác nhau

  • 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 khác nhau
      • 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
      • 10 cụm từ tìm kiếm hàng đầu trên YouTube mang lại 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ìm kiếm mang lại 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 hằng ngày của danh sách phát từ các nguồn lưu lượng truy cập khác nhau

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à 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 để giới hạn 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à 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 để giới hạn báo cáo về 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
      • 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ị đối với 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 đố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ố hằng ngày về loại thiết bị đối với video đã xác nhận quyền sở hữu
      • Chỉ số hằng ngày về hệ điều hành của thiết bị di động mà người dùng dùng để xem video đã được xác nhận quyền sở hữu
      • 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ị đối với 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 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ổ về nhóm tuổi và giới tính của đối tượng. 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 các báo cáo của YouTube Analytics.

ageGroup (phương diện chính)
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 quan đến dữ liệu báo cáo, bao gồm cả những người dùng mà YouTube ước tính là dưới 18 tuổi. 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 quan đến 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)

Mức độ 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 của 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
Allo ALLO
Ameba AMEBA
Email trên Android ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Nhắn tin trên Android ANDROID_MMS
Hộp thoại chia sẻ của hệ thống Android ANDROID_SYSTEM_SHARE_DIALOG
Blackberry Messenger BBM
Nhận một lượt thể hiện cảm xúc BLIND_REACT
Blogger BLOGGER
Sao chép vào bảng nhớ tạm COPY_PASTE
Cyworld CYWORLD
Digg DIGG
Hộp thoại hoạt động trực tiếp của hệ thống DIRECT_SYSTEM_ACTIVITY_DIALOG
Discord DISCORD
Mã QR đã hiển thị DISPLAYED_QR_CODE
Dropbox DROPBOX
Nhúng EMBED
Email MAIL
Facebook FACEBOOK
Facebook Lite FACEBOOK_LITE
Facebook Messenger FACEBOOK_MESSENGER
Trang Facebook FACEBOOK_PAGES
Chia sẻ lên nhóm trên Facebook FACEBOOK_SHARE_TO_GROUP
Tin trên Facebook FACEBOOK_STORIES
Fotka FOTKA
Gmail GMAIL
goo GOO
Ứng dụng Google GOOGLE_APP
Google Chat GOOGLE_CHAT
Google Chrome GOOGLE_CHROME
Google Inbox INBOX
Google Keep GOOGLE_KEEP
Google+ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
Tin nhắn văn bản HTC HTC_MMS
IMO IMO
Instagram INSTAGRAM
Tin trên Instagram INSTAGRAM_STORIES
Đường liên kết của lời mời (Android) INVITE_LINK_ANDROID
Đường liên kết của lời mời (iOS) INVITE_LINK_IOS
Mời cộng tác viên tham gia danh sách phát INVITE_PLAYLIST_COLLABORATORS
Hộp thoại hoạt động hệ thống iOS IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Tin nhắn KaiOS KAIOS_MESSAGES
Kik KIK
Email của LGE LGE_EMAIL
Line LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
Sao chép/dán trên Maps MAPS_COPY_PASTE
Chia sẻ trực tiếp trên Meet MEET_LIVE_SHARING
menéame MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
Chia sẻ lân cận NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
Khác OTHER
Pinterest PINTEREST
Chia sẻ nhanh QUICK_SHARE
Chia sẻ nhanh (Samsung) QUICK_SHARE_SAMSUNG
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
Phối lại REMIX
Tin nhắn của Samsung SAMSUNG_MESSAGES
Samsung Notes SAMSUNG_NOTES
Lưu vào phần Ảnh trên thiết bị SAVE_TO_DEVICE_PHOTOS
Chia sẻ video không có quảng cáo SHARE_AD_FREE
Chia sẻ đến máy ảnh Snapchat SHARE_TO_SNAPCHAT_CAMERA
Chia sẻ với trẻ SHARE_WITH_KIDS
Skype SKYPE
Skyrock SKYBLOG
Snapchat SNAPCHAT
Cuộc trò chuyện về 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 Verizon VERIZON_MMS
Viber VIBER
VKontakte (ВКонтакте) VKONTAKTE
Hộp thoại hoạt động trên hệ thống web WEB_SYSTEM_ACTIVITY_DIALOG
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
WhatsApp Business WHATS_APP_BUSINESS
Wykop WYKOP
Yahoo! Nhật Bản YAHOO
Bài đăng trên thẻ Cộng đồng của YouTube YOUTUBE_COMMUNITY_POST
Đăng lại lên thẻ Cộng đồng trên YouTube YOUTUBE_COMMUNITY_REPOST
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Mango YOUTUBE_MANGO
YouTube Music YOUTUBE_MUSIC
Màn hình xem trước khi chia sẻ lên Snapchat từ YouTube Music YTM_SHARE_TO_SNAPCHAT_PREVIEW
Phông xanh trên YouTube Shorts YOUTUBE_SHORTS_GREEN_SCREEN
YouTube TV YOUTUBE_TV
Xem YouTube cùng bạn bè YOUTUBE_WATCH_WITH_FRIENDS

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: Các chỉ số về hoạt động 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: Các chỉ số về hoạt động 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ệ giữa phần video đã phát và thời lượng của video. Phương diện và chỉ số về tỷ lệ giữ chân người xem đượ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ép đo 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 tỷ lệ giữ chân người xem 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 giá trị tỷ lệ nằm trong khoảng 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 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 liên quan đến 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ó sẵn từ ngày 25 tháng 9 năm 2013. API này không trả về dữ liệu cho những cụm từ tìm kiếm sử dụng bộ lọc để cố gắng truy xuất dữ liệu từ những ngày trước đó. Các truy vấn không sử dụng bộ lọc 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 luồng video trực tiếp. Các chỉ số báo cáo cho biết số 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ố lượng bản khảo sát do những người dùng YouTube đã huỷ gói hội viên của kênh được chỉ định trong kỳ báo cáo hoàn thành. 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 thành bản 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 họ không nhận được các đặc quyền dành cho hội viên như đã hứa.
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 chương trình 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àm 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 một thời gian.
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 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 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à khán giả phải xem hết thì mới có thể xem video.

  • auctionDisplay – Quảng cáo nội dung đa phương tiện hoặc quảng cáo dạng 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 quảng cáo lớp phủ và quảng cáo 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, chạy 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 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á của 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ó thời lượng tối đa 6 giây và bắt buộc phải xem thì mới 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. 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 – Quảng cáo nội dung đa phương tiện hoặc quảng cáo dạng 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 quảng cáo lớp phủ và quảng cáo 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 video chính.

  • reservedInstreamSelect

  • reservedMasthead – Quảng cáo lớn, có thể bao gồm cá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 và hiệu suất quảng cáo của kênh
      • 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 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 đã được 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 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.

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 chỉ định rằng phản hồi của API chỉ được 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 đối với claimedStatus==claimed, thì API sẽ chỉ truy xuất dữ liệu cho nội dung đã xác nhận quyền sở hữu. Bảng trong phần đị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 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ó nên chứa các 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 về việc ngừng cung cấp.

Bảng sau đây cho thấy các kiểu kết hợp được hỗ trợ cho phương diện claimedStatus và uploaderType, cả hai đều được dùng trong tham 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 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 bản thân Lấy 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 Lấy dữ liệu cho 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 một tổ hợp được hỗ trợ gồm các phương diện claimedStatus và uploaderType để lọc dữ liệu.