Dimensions

Tài liệu này xác định các phương diện mà API Báo cáo của YouTube hỗ trợ. API này truy xuất báo cáo hàng loạt chứa dữ liệu trong YouTube Analytics của một kênh hoặc chủ sở hữu nội dung.

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 hàng loạt hỗ trợ một danh sách phương diện được xác định trước và 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. Do đó, tổ hợp các giá trị phương diện của mỗi hàng sẽ đóng vai trò là khoá chính cho hàng đó. Bạn không cần chỉ định cũng như không có lựa chọn chỉ định những phương diện nào được đưa vào báo cáo.

Phương diện chính

Mặc dù YouTube Reporting API tuân theo Chính sách về việc ngừng cung cấp được nêu 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. Tất cả các phương diện này cũng là phương diện cốt lõi trong YouTube Analytics 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.

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 hàng loạt của YouTube Reporting 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.

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:

video_id (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.
playlist_id
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_id (phương diện chính)
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.
asset_id (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 tài sản được quản lý trong hệ thống Content ID của YouTube. Tài sản là nội dung đại diện cho tài sản trí tuệ của bạn trong hệ thống đó. Trên trang web YouTube, bạn có thể tìm thấy mã tài sản trong Trình quản lý nội dung của YouTube. Bạn cũng có thể truy xuất các báo cáo này bằng API Content ID của YouTube.

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_code (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 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_code
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ỳ.

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

Khoảng thời gian

date (phương diện chính)
Phương diện này xác định ngày liên kết với các chỉ số trong mỗi hàng báo cáo. Trong báo cáo hàng loạt, ngày là khoảng thời gian bắt đầu từ 00:00 theo giờ Thái Bình Dương 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. Tuỳ thuộc vào thời điểm trong năm, Giờ Thái Bình Dương là UTC-7 hoặc UTC-8.

Xin lưu ý rằng mặc dù ngày thường đại diện cho khoảng thời gian 24 giờ, nhưng ngày mà đồng hồ được điều chỉnh tiến lên theo Giờ mùa hè đại diện cho khoảng thời gian 23 giờ và ngày mà đồng hồ được điều chỉnh lùi lại đại diện cho khoảng thời gian 25 giờ. This is a core dimension and is subject to the Deprecation Policy.

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.

playback_location_type
Phương diện này xác định loại trang hoặc ứng dụng nơi hoạt động của người dùng diễn ra. Bảng sau đây liệt kê các giá trị phương diện:
Giá trị Mô tả
0 Dữ liệu này liên quan đến hoạt động 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.
1 Dữ liệu này liên quan đến hoạt động 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>.
2 Dữ liệu liên quan đến hoạt động diễn ra trên trang kênh YouTube.
5 Dữ liệu liên quan đến các chỉ số không thể phân loại vào một trong các loại vị trí khác được liệt kê.
7 Dữ liệu này liên quan đến 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.
8 Dữ liệu này liên quan đến những lượt xem diễn ra ngay trên trang kết quả tìm kiếm của YouTube.
10 Dữ liệu này liên quan đến những lượt xem diễn ra trên trang Shorts của YouTube.
11 Dữ liệu này liên quan đến những lượt xem diễn ra trên trang sự kiện phát trực tiếp dạng dọc.
12 Dữ liệu này liên quan đến số lượt xem trên thẻ Đoạn nhạc của YouTube Music.
playback_location_detail
Phương diện này chỉ định URL hoặc ứng dụng nơi diễn ra lượt phát. Phương diện này chỉ được hỗ trợ cho những lượt xem diễn ra trong trình phát được nhúng, tức là giá trị phương diện chỉ được điền vào những hàng có giá trị của phương diện là 1. Trong các hàng khác, giá trị của phương diện này trống.

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

live_or_on_demand
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.
onDemand 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.
subscribed_status
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ị subscribed_status là subscribed và một lượt xem có giá trị subscribed_status là unsubscribed.

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

traffic_source_type
Phương diện này xác định loại trang giới thiệu liên kết với các chỉ số về hoạt động của người dùng. Loại liên kết giới thiệu mô tả cách người dùng truy cập vào video hoặc kênh liên kết với hàng dữ liệu trong báo cáo. Bảng sau đây liệt kê các giá trị phương diện:
Giá trị Mô tả
0 Trực tiếp hoặc không xác định
Giá trị này bao gồm lưu lượng truy cập trực tiếp vào một trang cũng như các trang không xác định được trang giới thiệu. Trong báo cáo truy vấn, loại nguồn lưu lượng truy cập này được xác định là NO_LINK_OTHER hoặc UNKNOWN_MOBILE_OR_DIRECT.
1 Quảng cáo trên YouTube
Người xem được một quảng cáo giới thiệu đến video. Trong báo cáo nguồn lưu lượng truy cập, nếu giá trị của phương diện này là 1, thì phương diện traffic_source_detail sẽ xác định loại quảng cáo đã xuất hiện cho người xem. Trong báo cáo truy vấn, loại nguồn lưu lượng truy cập này được xác định là ADVERTISING. Các giá trị có thể là:
Giá trị Mô tả
ctp_engagement_ad Quảng cáo tương tác nhấp để phát
engagement_ad Quảng cáo tương tác
googlemediaads Quảng cáo tìm kiếm của Google
insearch_display TrueView trong tìm kiếm và trong hiển thị
instream TrueView trong luồng phát
instream-select Quảng cáo trong luồng phát có thể bỏ qua dành riêng
unknown Quảng cáo YouTube chưa được phân loại
video_wall Hộp hiển thị video
yva Quảng cáo video trên trang chủ
3 Tính năng duyệt xem
Người xem được giới thiệu từ một trang trên YouTube dẫn đến video hoặc kênh. Trong báo cáo nguồn lưu lượng truy cập, nếu giá trị của phương diện này là 3, thì phương diện traffic_source_detail sẽ xác định tính năng đã giới thiệu lưu lượng truy cập. Trong báo cáo truy vấn, loại nguồn lưu lượng truy cập này được xác định là SUBSCRIBER. Các giá trị có thể là:
Giá trị Mô tả
explore Trẻ em: khám phá
learning Trẻ em: học tập
music Nguồn cấp dữ liệu nhạc
my-history Nhật ký xem
my-subscriptions Đăng ký của tôi
my-uploads Tệp tải lên của tôi
podcasts Trang đích cho podcast
shows Trẻ em: chương trình
watch-later Xem sau
what-to-watch Xem gì
4 Kênh YouTube
Người xem được chuyển hướng từ một trang kênh YouTube. Trong báo cáo nguồn lưu lượng truy cập, nếu giá trị của phương diện này là 4, thì phương diện traffic_source_detail sẽ chỉ định mã nhận dạng kênh cho kênh đó. Trong báo cáo truy vấn, loại nguồn lưu lượng truy cập này được xác định là YT_CHANNEL.
5 Tìm kiếm trên YouTube
Người xem được chuyển hướng từ trang kết quả tìm kiếm trên YouTube. Trong báo cáo nguồn lưu lượng truy cập, nếu giá trị của phương diện này là 5, thì phương diện traffic_source_detail sẽ chỉ định cụm từ tìm kiếm có liên quan. Trong báo cáo truy vấn, loại nguồn lưu lượng truy cập này được xác định là YT_SEARCH.
7 Video đề xuất
Người xem được giới thiệu từ danh sách video có liên quan trên một trang xem video khác. Trong báo cáo nguồn lưu lượng truy cập, nếu giá trị của phương diện này là 7, thì phương diện traffic_source_detail sẽ xác định mã video cho video đó. Trong báo cáo truy vấn, loại nguồn lưu lượng truy cập này được xác định là RELATED_VIDEO hoặc YT_RELATED.
8 Các tính năng khác của YouTube
Người xem được chuyển hướng từ một trang trên YouTube không thuộc bất kỳ loại nguồn lưu lượng truy cập nào khác trong danh sách. Trong báo cáo nguồn lưu lượng truy cập, nếu giá trị của phương diện này là 8, thì phương diện traffic_source_detail sẽ xác định URL của trang. Trong báo cáo truy vấn, loại nguồn lưu lượng truy cập này được xác định là YT_OTHER_PAGE. Các giá trị có thể là:
Giá trị Mô tả
creator YouTube Studio
g-crec Kênh đề xuất
offline Ngoại tuyến
promotion Quảng cáo dành cho đối tác
unknown Không xác định
widget Tiện ích trên màn hình chính Android
youtu.be youtu.be
ytremote Điều khiển YouTube từ xa
9 Bên ngoài
Người xem được giới thiệu từ một đường liên kết trên một trang web khác. 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. Trong báo cáo nguồn lưu lượng truy cập, nếu giá trị của phương diện này là 9, thì phương diện traffic_source_detail sẽ xác định trang web bên ngoài. Trong báo cáo truy vấn, loại nguồn lưu lượng truy cập này được xác định là EXT_URL.
11 Cạc video và chú thích
Người xem được giới thiệu bằng cách nhấp vào chú thích hoặc thẻ trong một video khác. Trong báo cáo truy vấn, loại nguồn lưu lượng truy cập này được xác định là ANNOTATION.
14 Danh sách phát
Lượt xem xảy ra khi video được phát trong một danh sách phát. Trong báo cáo truy vấn, loại nguồn lưu lượng truy cập này được xác định là PLAYLIST.

Xin lưu ý rằng nguồn lưu lượng truy cập này khác với loại nguồn 18, tức là lượt xem bắt nguồn từ trang liệt kê tất cả video trong danh sách phát.
17 Thông báo
Người xem được chuyển hướng từ một email hoặc thông báo của YouTube. Trong báo cáo truy vấn, loại nguồn lưu lượng truy cập này được xác định là NOTIFICATION. Các giá trị có thể là:
Giá trị Mô tả
inbox
push
sdig Số lượt xem bắt nguồn từ thông báo trong bản tóm tắt dành cho người đăng ký
uploaded_other Số lượt xem bắt nguồn từ thông báo không phải thông báo đẩy, chẳng hạn như email hoặc thông báo trong hộp thư đến, được gửi đến người đăng ký khi một video được tải lên
uploaded_push Số lượt xem bắt nguồn từ thông báo đẩy gửi đến người đăng ký khi một video được tải lên
18 Trang danh sách phát
Lượt xem bắt nguồn từ một trang liệt kê tất cả video trong một danh sách phát. Trong báo cáo truy vấn, loại nguồn lưu lượng truy cập này được xác định là YT_PLAYLIST_PAGE.

Xin lưu ý rằng nguồn lưu lượng truy cập này khác với loại nguồn 14, tức là lượt xem xảy ra khi video đang phát trong một danh sách phát.
19 Chương trình từ nội dung đã được xác nhận quyền sở hữu
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. Trong báo cáo truy vấn, nguồn lưu lượng truy cập này được xác định là CAMPAIGN_CARD. 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.
20 Màn hình kết thúc tương tác của video
Lượt xem bắt nguồn từ màn hình kết thúc của một video khác. Trong báo cáo truy vấn, loại nguồn lưu lượng truy cập này được xác định là END_SCREEN.
23 Câu chuyện
Người xem được giới thiệu bằng cách vuốt dọc từ video trước đó trong trải nghiệm xem Câu chuyện.
24 Video ngắn
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.
25 Trang sản phẩm
Video trên trang sản phẩm đưa người xem đến một kênh khác.
26 Trang hashtag
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 Shorts.
27 Trang âm thanh
Lượt xem bắt nguồn từ trang tổng hợp âm thanh của video Shorts.
28 Live Redirect
Số lượt xem bắt nguồn từ tính năng Live Redirect.
29 Podcast
Lượt xem bắt nguồn từ trang Podcast trên YouTube.
30 Video phối lại
Lượt xem bắt nguồn từ đường liên kết đến video phối lại trong trình phát Shorts.
31 Trang video trực tiếp dạng dọc
Số lượt xem bắt nguồn từ trang video trực tiếp dạng dọc.
32 Video có liên quan
Lượt xem bắt nguồn từ đường liên kết đến video có liên quan trong trình phát Shorts.
traffic_source_detail
Phương diện này cung cấp thêm thông tin chi tiết về nguồn lưu lượng truy cập mà giá trị phương diện traffic_source_type của hàng. Giá trị phương diện này được điền sẵn cho các giá trị phương diện traffic_source_type sau:
  • 1 – Giá trị phương diện xác định loại quảng cáo đã hiển thị cho người xem. Hãy xem định nghĩa về traffic_source_type để biết danh sách các giá trị có thể có.
  • 3 – Giá trị phương diện xác định tính năng của YouTube đã dẫn đến lưu lượng truy cập được giới thiệu. Hãy xem định nghĩa về traffic_source_type để biết danh sách các giá trị có thể có.
  • 4 – Giá trị phương diện này cho biết mã nhận dạng kênh đã giới thiệu người xem.
  • 5 – Giá trị phương diện này cho biết cụm từ tìm kiếm đã dẫn đến lưu lượng truy cập được giới thiệu.
  • 7 – Giá trị phương diện xác định video đã giới thiệu người xem.
  • 8 – Giá trị phương diện xác định loại trang YouTube đã dẫn đến lưu lượng truy cập được giới thiệu. Hãy xem định nghĩa về traffic_source_type để biết danh sách các giá trị có thể có.
  • 9 – Giá trị phương diện xác định trang bên ngoài đã giới thiệu lưu lượng truy cập.
  • 17 – Giá trị phương diện xác định loại thông báo đã dẫn đến lưu lượng truy cập được giới thiệu. Hãy xem định nghĩa về traffic_source_type để biết danh sách các giá trị có thể có.
  • 19 – Giá trị phương diện xác định video đã giới thiệu người xem.
  • 20 – Giá trị phương diện xác định video đã giới thiệu người xem.
  • 25 – Giá trị phương diện xác định mã sản phẩm, tức là mã nhận dạng trong Sơ đồ tri thức của Google.
  • 26 – Giá trị phương diện xác định hashtag đã dẫn đến lưu lượng truy cập được giới thiệu.
  • 27 – Giá trị phương diện xác định video đã giới thiệu người xem.
  • 28 – Giá trị phương diện này cho biết mã nhận dạng kênh đã giới thiệu người xem thông qua tính năng Live Redirect.
  • 30 – Giá trị phương diện này cho biết video đã giới thiệu người xem.

Thiết bị

device_type
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. Bảng sau đây liệt kê các giá trị phương diện hợp lệ:
Giá trị Mô tả
100 Không xác định
101 Máy tính
102 TV
103 Máy chơi trò chơi
104 Điện thoại di động
105 Máy tính bảng
operating_system
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. Bảng sau đây liệt kê các giá trị phương diện hợp lệ:
Giá trị Mô tả
1 Khác
2 Windows
3 Windows Mobile
4 Android
5 iOS
6 Symbian
7 Blackberry
9 Macintosh
10 PlayStation
11 Bada
12 WebOS
13 Linux
14 Hiptop
15 MeeGo
16 Wii
17 Xbox
18 PlayStation Vita
19 TV thông minh
20 Nintendo 3DS
21 Chromecast
22 Tizen
23 Firefox
24 RealMedia
25 KaiOS
26 Roku
27 Nintendo Switch
28 Apple tvOS
29 Fire OS
30 ChromeOS
31 Vidaa
32 VegaOS

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.

age_group (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 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:
  • AGE_13_17
  • AGE_18_24
  • AGE_25_34
  • AGE_35_44
  • AGE_45_54
  • AGE_55_64
  • AGE_65_
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à GENDER_OTHER. This is a core dimension and is subject to the Deprecation Policy.

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

sharing_service (phương diện chính)
Phương diện này xác định dịch vụ được dùng để chia sẻ video. Bạn có thể chia sẻ video trên YouTube (hoặc 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ệ:
Giá trị Mô tả
0 Không xác định
1 Digg
4 reddit
5 StumbleUpon
6 mixi
7 Yahoo! Nhật Bản
8 goo
9 Ameba
10 Facebook
11 Myspace
12 NUjij
18 Tuenti
20 menéame
21 Wykop
22 Skyrock
25 Fotka
28 hi5
31 Twitter
32 Cyworld
34 Blogger
36 VKontakte (ВКонтакте)
37 Rakuten (楽天市場)
38 LiveJournal
39 Odnoklassniki (Одноклассники)
40 tumblr.
42 LinkedIn
43 Google+
44 Weibo
45 Pinterest
46 Email
47 Facebook Messenger
49 WhatsApp
50 Hangouts
51 Gmail
52 Kakao (Kakao Talk)
53 Khác
55 Sao chép vào bảng nhớ tạm
59 Nhúng
60 Tin nhắn văn bản
61 Nhắn tin trên Android
62 Tin nhắn Verizon
63 Tin nhắn văn bản HTC
64 Cuộc trò chuyện về Sony
65 Go SMS
66 Email của LGE
67 Line
68 Viber
69 Kik
70 Skype
71 Blackberry Messenger
72 WeChat
73 KAKAO Story
74 Dropbox
75 Telegram
76 Trang Facebook
77 GroupMe
78 Email trên Android
79 Motorola Messaging
80 Chia sẻ lân cận
81 Naver
82 Hộp thoại hoạt động hệ thống iOS
83 Google Inbox
84 Android Messenger
85 YouTube Music
86 YouTube Gaming
87 YouTube Kids
88 YouTube TV
89 Xem YouTube cùng bạn bè
90 Allo
91 Bài đăng trên thẻ Cộng đồng của YouTube
92 Đăng lại lên thẻ Cộng đồng trên YouTube
93 Tin nhắn KaiOS
94 Sao chép/dán trên Maps
95 Chia sẻ với trẻ
96 Hộp thoại hoạt động trên hệ thống web
97 Snapchat
98 Màn hình xem trước khi chia sẻ lên Snapchat từ YouTube Music
99 Chia sẻ đến máy ảnh Snapchat
100 Hộp thoại chia sẻ của hệ thống Android
101 Lưu vào phần Ảnh trên thiết bị
102 Instagram
103 Hộp thoại hoạt động trực tiếp của hệ thống
104 Discord
105 Tin trên Instagram
106 Tin trên Facebook
107 Chia sẻ trực tiếp trên Meet
108 Tin nhắn của Samsung
109 WhatsApp Business
110 Samsung Notes
111 Google Keep
112 Facebook Lite
113 IMO
114 YouTube Mango
115 Chia sẻ lên nhóm trên Facebook
116 Google Chat
117 Mời cộng tác viên tham gia danh sách phát
118 Chia sẻ nhanh
119 Chia sẻ nhanh (Samsung)
120 Mã QR đã hiển thị
121 Phông xanh trên YouTube Shorts
122 Chia sẻ video không có quảng cáo
123 Ứng dụng Google
124 Google Chrome
125 Phản ứng không nhìn thấy
126 Đường liên kết của lời mời (Android)
127 Đường liên kết của lời mời (iOS)
128 Phối lại

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

Chú thích

annotation_type
Phương diện này xác định cách chú thích xuất hiện trong video. Bảng sau đây liệt kê các giá trị phương diện có thể có:
Giá trị Mô tả
0 Không xác định
1 Lưu ý
3 Tiêu điểm
4 Tiêu đề
8 Bong bóng lời thoại
9 Hãng nhạc
10 Hình mờ trong thương hiệu
11 Video nổi bật
12 Danh sách phát nổi bật
30 Gọi hành động
Trung tâm trợ giúp của YouTube cung cấp thêm thông tin chi tiết về các loại chú thích cũng như quy trình thêm chú thích vào video.
annotation_id
Mã nhận dạng mà YouTube sử dụng để xác định duy nhất một chú thích.

Thẻ

card_type
Phương diện này xác định loại thẻ đã hiển thị cho người dùng. Bảng sau đây liệt kê các giá trị phương diện có thể có:
Giá trị Mô tả
0 Không xác định
60 Đường liên kết
61 Gây quỹ
62 Video
63 Danh sách phát
65 Tính năng Tài trợ của người hâm mộ
66 Hàng hoá
68 Trang web được liên kết
69 Kênh
Trung tâm trợ giúp của YouTube cung cấp thêm thông tin chi tiết về các loại thẻ cũng như quy trình thêm thẻ vào video.
card_id
Mã nhận dạng mà YouTube dùng để xác định riêng biệt một thẻ.

Màn hình kết thúc

end_screen_element_type
Phương diện này xác định loại thành phần màn hình kết thúc đã hiển thị cho người dùng. Bảng sau đây liệt kê các loại thành phần màn hình kết thúc và giá trị của các thành phần đó:
Giá trị Mô tả
501 Video – Thành phần này quảng bá một video khác trên YouTube.
502 Danh sách phát – Thành phần này quảng bá danh sách phát trên YouTube.
503 Trang web – Thành phần này liên kết đến trang web được liên kết của bạn.
504 Kênh – Thành phần này liên kết đến một kênh khác.
505 Đăng ký – Thành phần này khuyến khích người xem đăng ký kênh của bạn.
506 Đã liên kết
507 Huy động vốn cộng đồng – Phần tử này liên kết đến một trang web huy động vốn cộng đồng đã được phê duyệt.
508 Hàng hoá – Phần tử này liên kết đến một trang web bán hàng hoá đã được phê duyệt.
509 Video tải lên gần đây nhất – Thành phần này liên kết đến video bạn tải lên gần đây nhất trên kênh.
510 Phù hợp nhất với người xem
end_screen_element_id
Mã nhận dạng mà YouTube dùng để xác định riêng từng thành phần màn hình kết thúc.

Phụ đề

subtitle_language
Phương diện này xác định ngôn ngữ phụ đề được sử dụng lâu nhất trong lượt xem. Những lượt xem mà phụ đề hầu như bị tắt sẽ không được tính. Hãy xem tài liệu về báo cáo kênh hoặc báo cáo của chủ sở hữu nội dung để biết thêm thông tin về những báo cáo có chứa phương diện này.
subtitle_language_autotranslated
Phương diện này xác định ngôn ngữ phụ đề được dịch tự động và được dùng lâu nhất trong lượt xem. Những lượt xem mà phụ đề hầu như bị tắt sẽ không được tính. Hãy xem tài liệu về báo cáo kênh hoặc báo cáo của chủ sở hữu nội dung để biết thêm thông tin về những báo cáo có chứa phương diện này.

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

ad_type
Phương diện ad_type đượ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. Bảng sau đây liệt kê 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.
Giá trị Mô tả Giá trị trong báo cáo cụm từ tìm kiếm
1 Quảng cáo dạng video có thể bỏ qua (Đấu giá) auctionTrueviewInstream
2 Quảng cáo hiển thị (Đấu giá) auctionDisplay
3 Quảng cáo dạng video không thể bỏ qua (Đấu giá) auctionInstream
5 Quảng cáo hiển thị (Đặt trước) reservedDisplay
6 Quảng cáo dạng video không thể bỏ qua (Đặt trước) reservedInstream
13 Không xác định unknown
15 Quảng cáo dạng video có thể bỏ qua (Đặt trước) reservedInstreamSelect
19 Quảng cáo đệm (đấu giá) auctionBumperInstream
20 Quảng cáo đệm (đặt trước) reservedBumperInstream

Lưu ý: Báo cáo truy vấn có thể trả về một số loại quảng cáo bổ sung đã được sử dụng trước đây trên YouTube.

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

Các phương diện sau chỉ được dùng trong báo cáo của chủ sở hữu nội dung.

claimed_status (chỉ dùng trong báo cáo của chủ sở hữu nội dung)
Phương diện này cho biết rằng một hàng dữ liệu chỉ 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. Bảng trong phần định nghĩa về phương diện uploader_type cung cấp thêm thông tin chi tiết về cách sử dụng phương diện này.
uploader_type (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 biết một hàng dữ liệu có 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 (chẳng hạn như video do người dùng tải lên) hay không. Các giá trị hợp lệ là self và thirdParty. Đây là phương diện cốt lõi và tuân theo Chính sách về việc ngừng cung cấp.

Bảng sau đây trình bày các kiểu kết hợp được hỗ trợ cho phương diện claimed_status và uploader_type:

Giá trị claimed_status Giá trị uploader_type Mô tả
[Chưa đặt] bản thân Hàng này chứa 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 bản thân Hàng này chứa dữ liệu về nội dung đã được xác nhận quyền sở hữu do chủ sở hữu nội dung tải lên.
đã xác nhận quyền sở hữu thirdParty Hàng này chứa 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.