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 hàng loạt báo cáo chứa dữ liệu YouTube Analytics của một 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 diễn ra hoạt động của người dùng hoặc quốc gia nơi người dùng sinh sống.
Mỗi báo cáo 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 biệt. Do đó, tổ hợp các giá trị phương diện của mỗi hàng sẽ hoạt động như khoá chính cho hàng đó. Bạn không cần chỉ định cũng như không cần chỉ định phương diện nào được đưa vào báo cáo.
Kích thước chính
Mặc dù API Báo cáo của YouTube 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ụ, nhưng các phương diện không phải chính (và các chỉ số không phải chính) sẽ không phải tuân thủ chính sách này. 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 xác định rõ ràng theo cách đó.
Danh sách sau đây xác định các phương diện chính của API. Tất cả đều là phương diện chính trong API YouTube Analytics.
Hãy xem danh sách các API YouTube tuân thủ Chính sách về việc ngừng sử dụng để biết thêm thông tin.
Kích thước
Những 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 sẽ đượ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 sau tương ứng với 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 chính)
- Mã nhận dạng của video trên YouTube. Trong API dữ liệu YouTube, đây là giá trị thuộc tính
id
của tài nguyênvideo
. 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 API dữ liệu YouTube, đây là giá trị thuộc tính
id
của tài nguyênplaylist
. - 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ênchannel
. 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 tài sản được quản lý trong hệ thống Content ID của YouTube. Tài sản 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 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 video đó bằng Content ID API 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 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ặcFR
(Pháp). Mã quốc giaZZ
dùng để báo cáo những chỉ số mà YouTube không thể xác định quốc gia có liên quan. 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 giúp 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ặcUS-TX
(Texas). Mã tỉnhUS-ZZ
dùng để báo cáo những chỉ số mà YouTube không thể xác định tiểu bang có liên quan 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 vi của Hoa Kỳ vì những 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ợ 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 tương ứng 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 này đề cập đến 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 23:59 theo giờ Thái Bình Dương vào ngày, tháng và năm đã 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 biểu thị khoảng thời gian 24 giờ, nhưng ngày tháng mà đồng hồ được điều chỉnh tiến theo Quy ước giờ mùa hè là khoảng thời gian 23 giờ, còn ngày tháng được điều chỉnh ngược lại là 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 hoạt động của người dù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 xảy 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 liên quan đến hoạt động xảy ra trên một trang web hoặc ứng dụng khác, trong đó video được nhúng bằng phương thức nhúng <iframe>
hoặc<object>
.2
Dữ liệu này liên quan đến hoạt động xảy ra trên một 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 được vào một trong các loại vị trí khác nêu trên. 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, trên 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 các 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 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 video. 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 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ề quá trình 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 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 những ngày bắt đầu từ ngày 1 tháng 4 năm 2014.
Bảng sau 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 đã xảy ra trong một chương trình 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 xảy ra trong thời gian 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 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ể là
subscribed
vàunsubscribed
.
Xin lưu ý rằng giá trị phương diện là giá trị chính xác tại thời điểm diễn ra hoạt động của người dùng. Ví dụ: giả sử một người dùng chưa đăng ký một kênh và xem một trong các video của kênh đó, sau đó đăng ký kênh đó và xem một video khác, tất cả diễn ra 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 các chỉ số về 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 vào 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ặcUNKNOWN_MOBILE_OR_DIRECT
.1
Quảng cáo trên YouTube
Người xem được 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 đã 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 đi kèm kết quả tìm kiếm của Google insearch_display
TrueView trong tìm kiếm và trong hiển thị instream
Quảng cáo 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 đã 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ị explore
Trẻ em: khám phá learning
Trẻ em: đang học music
Nguồn cấp dữ liệu nhạc my-history
Nhật ký xem my-subscriptions
Gói thuê bao của tôi my-uploads
Tệp tải lên của tôi podcasts
Trang đích của 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 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ừ các 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ừ 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ặcYT_RELATED
.8
Các tính năng khác trên 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 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ị 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ừ đườ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 giới thiệu từ kết quả tìm kiếm của 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
Thẻ và chú thích video
Người xem được giới thiệu bằng cách nhấp vào một thẻ hoặc chú thích 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 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ồn18
, cho biết 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 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ừ các thông báo thuộc thông báo tổng hợp của 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ư thông báo qua email hoặc thông báo trong hộp thư đến, được 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 được gửi tới người đăng ký khi 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ả 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ồn14
, cho biết số lượt xem xảy ra khi video đang được phát trong danh sách phát.19
Lập 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ừ các video do người dùng tải lên đã được xác nhận quyền sở hữu mà chủ sở hữu nội dung dùng để quảng bá nội dung đã được xem. 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 các báo cáo của chủ sở hữu nội dung.20
Màn hình kết thúc của video tương tác
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 chuyển đến trang xem Stories bằng cách vuốt dọc màn hình của video trước trong phần xem Stories.24
Video ngắn
Người xem được chuyển đến trang xem video ngắn bằng cách vuốt dọc màn hình của video trước.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ừ các trang hashtag theo yêu cầu hoặc trang tổng hợp hashtag của video ngắn.27
Trang âm thanh
Lượt xem bắt nguồn từ các trang tổng hợp âm thanh trên Shorts.28
Live Redirect
Lượt xem bắt nguồn từ Live Redirect.30
Video phối lại
Lượt xem bắt nguồn từ một đường liên kết đến video 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
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 mà giá trị phương diện traffic_source_type của hàng là. 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 được 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ị phương diện xác định tính năng trên YouTube đã tạo ra 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ị thứ nguyên xác định video mà người xem được giới thiệu.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. 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 tham chiếu đến.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. Xem định nghĩa traffic_source_type để biết danh sách các giá trị có thể có.19
– Giá trị thứ nguyên xác định video mà người xem được giới thiệu.20
– Giá trị thứ nguyên xác định video mà người xem được giới thiệu.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ị thứ nguyên xác định video mà 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à người xem được giới thiệu qua tính năng Live Redirect.30
– Giá trị kích thước chỉ định video mà 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ị mang đến lượt 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
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ị có lượt xem xảy ra.
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
Fire OS 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 rõ sự phân bổ về độ tuổi và giới tính của người xem. Trung tâm trợ giúp của 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 được 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_
- giới tính (phương diện cốt lõi)
- Phương diện này xác định giới tính của người dùng đã đăng nhập 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 cốt lõi)
- Phương diện này xác định dịch vụ bạn đã 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
Cắm xuống đất 4
Reddit 5
StumbleUpon 6
mixi 7
Người bán trên Yahoo! Nhật Bản 8
goo 9
Ameba 10
Facebook 11
Myspace 12
NUjij 18
Lễ hội Tuenti 20
hoa cúc menéame 21
Wykop 22
Xanh đá 25
Tiếng Fotka 28
hi5 31
Twitter 32
Thế giới khổng lồ 34
Blogger 36
VKontakte (thay Контакте) 37
Rakuten (楽天與場) 38
LiveJournal 39
Tiếng Odnoklassniki (hãy дноклассники) 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 của Verizon 63
Tin nhắn văn bản của HTC 64
Cuộc trò chuyện của Sony 65
Dùng SMS 66
Email LGE 67
Line 68
Viber 69
Tiếng 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 Android 79
Nhắn tin cho 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
Messenger trên Android 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
Ô lời thoại 9
Hãng nhạc 10
Hình mờ thương hiệu 11
Video nổi bật 12
Danh sách phát nổi bật 30
Lời kêu gọi hành động - annotation_id
- Mã nhận dạng mà YouTube dùng để nhận dạng riêng 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ị 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 - 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 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 chúng:
Giá trị 501
Video – Phần tử quảng cáo một video khác trên YouTube. 502
Danh sách phát - Phần tử quảng cáo 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ý cho kênh của bạn. 506
Được liên kết 507
Huy động vốn cộng đồng – Thành phần 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 bán hàng hoá được phê duyệt. 509
Video tải lên gần đây - Phần tử 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 sử dụng để xác định riêng mộ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 thời gian dài nhất trong lượt xem. Số lượt xem mà phần lớn phụ đề 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 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, được dùng lâu nhất trong lượt xem. Số lượt xem mà phần lớn phụ đề 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 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ố theo yêu cầu dựa trên các 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ó. Hãy truy cập vào 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ị Nội dung 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ề cho một số loại quảng cáo khác từng được sử dụng 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 cho phương diện này là
claimed
. Bảng trong phần định nghĩa phương diệnuploader_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 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 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ụ thể 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 thủ Chính sách về việc ngừng sử dụng.
Bảng dưới đây cho thấy các cách kết hợp được hỗ trợ cho phương diệnclaimed_status
vàuploader_type
:
Giá trị claimed_status
Giá trị uploader_type
Nội dung mô tả [Chưa đặt] bản thân Hàng chứa dữ liệu YouTube Analytics cho nội dung đã xác nhận quyền sở hữu và chưa đượ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 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 một bên thứ ba tải lên.