Trang này được dịch bởi Cloud Translation API.

Dimensions

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

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

Mỗi báo cáo hàng loạt hỗ trợ một danh sách phương diện được xác định trước và trong bất kỳ báo cáo nào, mỗi hàng dữ liệu đều có một tổ hợp giá trị phương diện riêng. Do đó, tổ hợp giá trị phương diện của mỗi hàng hoạt động như khoá chính cho hàng đó. Bạn không cần chỉ định cũng như không chỉ định phương diện nào được đưa vào báo cáo.

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

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

Danh sách sau đây xác định các phương diện chính của API. Tất cả đều là các phương diện chính trong API YouTube Analytics.

age_group
channel_id
country_code
date
gender
sharing_service
uploader_type
video_id

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

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 API Báo cáo YouTube. Trừ phi có ghi chú khác, các phương diện này được dùng trong cả báo cáo kênh và báo cáo của chủ sở hữu nội dung.

Tài nguyên

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

video_id
playlist_id
channel_id
asset_id

video_id (phương diện chính): Mã nhận dạng của một video trên YouTube. Trong API dữ liệu YouTube, đây là giá trị của video thuộc tính id của tài nguyên. This is a core dimension and is subject to the Deprecation Policy.
playlist_id: Mã nhận dạng của danh sách phát trên YouTube. Trong API dữ liệu YouTube, đây là giá trị thuộc tính id của tài nguyên playlist.
channel_id (phương diện chính): Mã nhận dạng của một kênh YouTube. Trong API dữ liệu YouTube, đây là giá trị thuộc tính id của tài nguyên channel. This is a core dimension and is subject to the Deprecation Policy.
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ý bằng hệ thống Content ID của YouTube. Nội dung là bản trình bày 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 ID nội dung trong Trình quản lý nội dung YouTube. Bạn cũng có thể truy xuất các video đó bằng API Content ID của YouTube.

Khu vực địa lý

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

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

Khoảng thời gian

ngày (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 của báo cáo. Hàng loạt trong báo cáo, ngày là khoảng thời gian bắt đầu lúc 12 giờ sáng theo giờ Thái Bình Dương và kết thúc lúc 11:59 tối 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 gian 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 thể hiện khoảng thời gian 24 giờ, nhưng ngày mà đồng hồ được điều chỉnh chuyển tiếp cho Giờ mùa hè tương ứng với một khoảng thời gian 23 giờ và ngày mà đồng hồ được điều chỉnh lùi biểu thị 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 xảy ra.

playback_location_type

Phương diện này xác định loại trang hoặc ứng dụng nơi người dùng hoạt động xảy ra. Bảng sau đây liệt kê các giá trị phương diện:

Giá trị
`0`	Dữ liệu liên quan đến hoạt động diễn ra trên trang xem YouTube của video hoặc trong ứng dụng YouTube chính thức, chẳng hạn như ứng dụng YouTube dành cho Android.
`1`	Dữ liệu này có 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 cách nhúng `<iframe>` hoặc `<object>`.
`2`	Dữ liệu liên quan đến hoạt động đã xảy ra trên trang kênh YouTube.
`5`	Dữ liệu này liên quan đến những 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ủ hoặc màn hình chính của YouTube, trong trang Kênh đăng ký của người dùng hoặc trong một tính năng duyệt xem khác trên YouTube.
`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 trên YouTube.
`10`	Dữ liệu này liên quan đến những lượt xem trên trang YouTube Shorts.

playback_location_detail

Phương diện này chỉ định URL hoặc ứng dụng nơi phát nội dung. Phương diện này chỉ được hỗ trợ cho các lượt xem xảy ra trong trình phát được nhúng, tức là giá trị phương diện chỉ được điền sẵn trong 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.

Chi tiết phát

live_or_on_demand

Phương diện này cho biết liệu chỉ số hoạt động của người dùng trong hàng dữ liệu có liên kết với số lượt xem của một chương trình phát sóng trực tiếp hay không. Dữ liệu cho phương diện này chỉ có sẵn cho các ngày bắt đầu từ ngày 1 tháng 4 năm 2014.

Bảng sau đây liệt kê các giá trị phương diện:

Giá trị
`live`	Dữ liệu của hàng mô tả hoạt động của người dùng diễn ra trong một chương trình phát sóng trực tiếp.
`onDemand`	Dữ liệu của hàng mô tả hoạt động của người dùng không xảy ra trong chương trình phát sóng trực tiếp.

subscribed_status

Phương diện này cho biết liệu chỉ số hoạt động của người dùng trong hàng dữ liệu có liên kết với người xem đã đăng ký kênh của video hoặc danh sách phát hay không. Giá trị có thể là subscribed và unsubscribed.

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

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 đến một trang cũng như các trang mà đường liên kết giới thiệu không xác đị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à NO_LINK_OTHER hoặc UNKNOWN_MOBILE_OR_DIRECT.

1

Quảng cáo trên YouTube
Người xem được giới thiệu đến video thông qua một quảng cáo. 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 đã hiển thị 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ị
`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
`instream-select`	Quảng cáo trong luồng 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

Các tính năng duyệt xem
Người xem được giới thiệu từ một trang YouTube dẫn đến các 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 đã dẫn đến 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ị
`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 giới thiệu từ trang kênh YouTube. Trong một 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 giới thiệu từ phần 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 kế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_SEARCH.

7 Video đề xuất
Người xem được giới thiệu từ một trang thông tin 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 của 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 giới thiệu từ một trang YouTube không thuộc một trong các loại nguồn lưu lượng truy cập khác 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 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ị
`g-crec`	Kênh đề xuất
`offline`	Khi không có mạng
`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ả lượt giới thiệu từ kết quả của Google Tìm kiếm. 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 Thẻ và chú thích video
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 đang được phát trong 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, cho biết rằng lượt xem bắt nguồn từ trang liệt kê tất cả các video trong danh sách phát.

17

Thông báo
Người xem được giới thiệu qua 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ị
`inbox`
`push`
`sdig`	Số lượt xem bắt nguồn từ thông báo nằm trong thông báo của người đăng ký
`uploaded_other`	Số lượt xem bắt nguồn từ thông báo không đẩy, chẳng hạn như thông báo qua email hoặc hộp thư đến, gửi đến người đăng ký khi 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 video đang xem đã 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ả các video trong một danh sách phát. Trong các 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, cho biết rằng số lượt xem xảy ra khi video đang được phát trong danh sách phát.

19 Chương trình dựa trên nội dung đã được xác nhận quyền sở hữu
Lượt xem bắt nguồn từ các video do người dùng tải lên và đã được xác nhận quyền sở hữu mà chủ sở hữu nội dung đã dùng để quảng bá nội dung đã 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 Số lượt xem màn hình kết thúc tương tác của video
Số 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 Stories
Người xem được giới thiệu bằng cách vuốt dọc từ video trước trong giao diện xem Stories.

24 Video ngắn
Người xem thu hút sự chú ý của người xem khi vuốt dọc từ video trước trong phần xem video ngắn.

25 Trang sản phẩm
Video trên một 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ừ các trang hashtag (#) theo yêu cầu hoặc các trang tổng hợp hashtag của Shorts.

27 Trang âm thanh
Lượt xem bắt nguồn từ các trang tổng hợp nội dung âm thanh trên Shorts.

28 Live Redirect
Lượt xem bắt nguồn từ tính năng Live Redirect.

30 Video phối lại
Số lượt xem bắt nguồn từ một đường liên kết đến video được phối lại trong trình phát Shorts.

31 Trang sự kiện phát trực tiếp dạng dọc
Số lượt xem bắt nguồn từ trang sự kiện phát trực tiếp dạng dọc.

32 Video có liên quan
Số lượt xem bắt nguồn từ mộ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 là giá trị phương diện traffic_source_type của hàng. Giá trị phương diện này được điề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. Xem định nghĩa traffic_source_type để biết danh sách các giá trị có thể có.
3 – Giá trị thứ nguyên xác định tính năng YouTube đã dẫn đến lưu lượng truy cập được giới thiệu. Xem định nghĩa traffic_source_type để biết danh sách các giá trị có thể có.
4 – Giá trị phương diện chỉ định mã nhận dạng kênh mà người xem được giới thiệu.
5 – Giá trị phương diện chỉ định 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 mà từ đó người xem được giới thiệu.
8 – Giá trị thứ nguyên xác định loại trang YouTube đã dẫn đến lưu lượng truy cập được giới thiệu. Xem định nghĩa traffic_source_type để biết danh sách các giá trị có thể có.
9 – Giá trị thứ nguyên xác định trang bên ngoài mà lưu lượng truy cập được giới thiệu từ đó.
17 – Giá trị thứ nguyê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. Xem định nghĩa 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 mà từ đó người xem được giới thiệu.
20 – Giá trị phương diện xác định video mà từ đó người xem được giới thiệu.
25 – Giá trị thứ nguyên xác định ID sản phẩm, chính là ID Sơ đồ tri thức của Google.
26 – Giá trị thứ nguyê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 mà từ đó người xem được giới thiệu.
28 – Giá trị phương diện chỉ định mã nhận dạng kênh mà từ đó người xem được giới thiệu qua tính năng Live Redirect.
30 – Giá trị phương diện chỉ định video mà từ đó người xem được giới thiệu.

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à người dùng sử dụng để xem. Bảng sau đây liệt kê các giá trị phương diện hợp lệ:

Giá trị
`100`	Không xác định
`101`	Máy tính
`102`	TV
`103`	Bảng điều khiển 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à người dùng sử dụng để xem. Bảng sau đây liệt kê các giá trị phương diện hợp lệ:

Giá trị
`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`	Hệ điều hành Fire
`30`	ChromeOS
`31`	Vidaa

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

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

age_group (phương diện chính)

Phương diện này xác định nhóm tuổi của người dùng đã đăng nhập liên kết với dữ liệu báo cáo. API sử dụng các nhóm tuổi sau:

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.

giới tính (phương diện chính)

Phương diện này xác định giới tính của người dùng đã đăng nhập được liên kết với dữ liệu báo cáo. Các giá trị hợp lệ là FEMALE, MALE và GENDER_OTHER. This is a core dimension and is subject to the Deprecation Policy.

Hoạt động 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 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ệ:

Giá trị
`0`	Không xác định
`1`	Đào
`4`	reddit
`5`	StumbleUpon
`6`	mixi
`7`	Yahoo! Nhật Bản
`8`	con-dư
`9`	Ameba
`10`	Facebook
`11`	Myspace
`12`	NUjij
`18`	Tuenti
`20`	menéame
`21`	Wykop
`22`	Skyrock
`25`	Tiếng Fotka
`28`	hi5
`31`	Twitter
`32`	Thế giới vòng
`34`	Blogger
`36`	VKontakte (ChuyểnКонтакте)
`37`	Rakuten (楽天 sạc場)
`38`	LiveJournal
`39`	Tiếng Odnoklassniki (xuất hiện
`40`	tumblr.
`42`	LinkedIn
`43`	Google+
`44`	Weibo
`45`	Pinterest
`46`	Email
`47`	Facebook Messenger
`49`	WhatsApp
`50`	Hangouts
`51`	Gmail
`52`	Tiếng 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 qua Verizon
`63`	Tin nhắn văn bản của HTC
`64`	Cuộc trò chuyện của Sony
`65`	Chuyển tin nhắn SMS
`66`	Email LGE
`67`	Line
`68`	Viber
`69`	Kik
`70`	Skype
`71`	Messenger trên Blackberry
`72`	WeChat
`73`	Câu chuyện của KakaO
`74`	Dropbox
`75`	Telegram
`76`	Trang Facebook
`77`	GroupMe
`78`	Email về Android
`79`	Nhắn tin qua Motorola
`80`	Chia sẻ lân cận
`81`	Naver
`82`	Hộp thoại hoạt động hệ thống iOS
`83`	Hộp thư đến của Google
`84`	Android Messenger
`85`	YouTube Music
`86`	YouTube Gaming
`87`	YouTube Kids
`88`	YouTube TV

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 thức 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ị
`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 khác nhau cũng như quy trình thêm chú thích vào video của bạn.

annotation_id

Mã nhận dạng mà YouTube sử dụng để xác định riêng biệt một chú thích.

Thẻ

card_type

Phương diện này xác định loại thẻ mà người dùng nhìn thấy. Bảng sau đây liệt kê các giá trị phương diện có thể có:

Giá trị
`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 để nhận dạng duy nhấ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 mà người dùng nhìn thấy. 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ị
`501`	Video – Phần tử quảng bá một video khác trên YouTube.
`502`	Danh sách phát – Phần tử quảng bá danh sách phát trên YouTube.
`503`	Trang web – Phần tử liên kết đến trang web được liên kết của bạn.
`504`	Kênh – Phần tử liên kết đến một kênh khác.
`505`	Đăng ký - Phần tử khuyến khích đăng ký kênh của bạn.
`506`	Được 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ử liên kết đến một trang web hàng hoá được phê duyệt.
`509`	Video tải lên gần đây – Thành phần này liên kết đến video tải lên gần đây nhất trên kênh của bạn.
`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 biệt 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 dùng trong khoảng thời gian dài nhất trong quá trình xem. Những lượt xem mà phụ đề chủ yếu bị tắt sẽ không được tính. 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ề các 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 mà người dùng sử dụng trong khoảng thời gian dài nhất trong chế độ xem. Những lượt xem mà phụ đề chủ yếu bị tắt sẽ không được tính. 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ề các 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 dùng trong báo cáo hiệu suất quảng cáo và tổng hợp các chỉ số được yêu cầu dựa trên loại quảng cáo đã chạy trong các lượt phát video. Bảng sau đây liệt kê các giá trị phương diện có thể có. Truy cập vào Trung tâm trợ giúp YouTube để biết thêm thông tin về các định dạng quảng cáo trên YouTube.

Giá trị	Mô tả	Giá trị trong báo cáo truy vấn
`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 khác đã được sử dụng trước đây trên YouTube.

Phương diện của 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.

claim_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 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 của phương diện này là claimed. Bảng trong đị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.

upload_type (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 biết liệu một hàng dữ liệu có chứa 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à phương diện chính và tuân theo Chính sách về việc ngừng sử dụng.

Bảng bên dưới trình bày các cách kết hợp được hỗ trợ cho phương diện 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 dành 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.