Phụ lục: Liên kết các trường giao diện người dùng với các trường API theo loại mẫu quảng cáo

Bảng dưới đây liên kết các trường giao diện người dùng với các trường API tương ứng, được phân tách theo loại mẫu quảng cáo. Lưu ý rằng một số trường API yêu cầu thêm quy cách thông qua vai trò hoặc loại được chỉ định cho tài nguyên được cung cấp.

Mẫu quảng cáo dạng hình ảnh chuẩn

Loại mẫu quảng cáo: CREATIVE_TYPE_STANDARD
Nguồn lưu trữ: HOSTING_SOURCE_SOURCE
Tên	Bắt buộc Tên trường API: displayName
Thành phần mẫu quảng cáo	Bắt buộc Tên trường API: thành phần Vai trò của nội dung: ASSET_ROLE_MAIN
URL trang đích	Bắt buộc Tên trường API: exitEvents[].url Loại sự kiện thoát: EXIT_EVENT_TYPE_DEFAULT
Trạng thái	Bắt buộc Tên trường API: entityStatus
Thẻ theo dõi HTML đã thêm	Không bắt buộc Tên trường API: connectedTag
Mã tích hợp	Không bắt buộc Tên trường API: IntegrationCode
Ghi chú	Không bắt buộc Tên trường API: ghi chú
Trạng thái kiểm tra	Chỉ đọc Tên trường API: reviewStatus

Mẫu quảng cáo HTML5

Loại mẫu quảng cáo: CREATIVE_TYPE_STANDARD
Nguồn lưu trữ: HOSTING_SOURCE_SOURCE
Tên	Bắt buộc Tên trường API: displayName
Thành phần mẫu quảng cáo	Bắt buộc Tên trường API: thành phần Vai trò của nội dung: ASSET_ROLE_MAIN
Trạng thái	Bắt buộc Tên trường API: entityStatus
Hình ảnh dự phòng	Không bắt buộc Tên trường API: thành phần Vai trò của thành phần: ASSET_ROLE_BACKUP
URL trang đích sao lưu	Không bắt buộc Tên trường API: exitEvents[].url Loại sự kiện thoát: EXIT_EVENT_TYPE_BACKUP
Nhãn báo cáo thoát dự phòng	Không bắt buộc Tên trường API: exitEvents[].reportingName Loại sự kiện thoát: EXIT_EVENT_TYPE_BACKUP
Hình ảnh tải thông minh	Không bắt buộc Tên trường API: thành phần Vai trò của thành phần: ASSET_ROLE_POLITE_LOAD
Số lượt thoát	Bắt buộc Tên trường API: exitEvents[] Loại sự kiện thoát: EXIT_EVENT_TYPE_DEFAULT
Bộ đếm	Không bắt buộc Tên trường API:counterEvents[]
Hẹn giờ	Không bắt buộc Tên trường API: hẹn giờ[]
Thẻ theo dõi HTML đã thêm	Không bắt buộc Tên trường API: connectedTag
Mã tích hợp	Không bắt buộc Tên trường API: IntegrationCode
Ghi chú	Không bắt buộc Tên trường API: ghi chú
Trạng thái kiểm tra	Không bắt buộc Tên trường API: reviewStatus

Mẫu quảng cáo hiển thị của bên thứ ba

Loại mẫu quảng cáo: CREATIVE_TYPE_STANDARD
Nguồn lưu trữ: HOSTING_SOURCE_SOURCE_PARTY
Tên	Bắt buộc Tên trường API: displayName
Trạng thái	Bắt buộc Tên trường API: entityStatus
Kích thước	Bắt buộc Tên trường API: phương diện
URL trang đích	Bắt buộc Tên trường API: exitEvents[].url Loại sự kiện thoát: EXIT_EVENT_TYPE_DEFAULT
Yêu cầu MRAID	Không bắt buộc Tên trường API: requiredMraid
Yêu cầu HTML5	Không bắt buộc Tên trường API: requiredhtml5
Thẻ của bên thứ ba	Bắt buộc Tên trường API: thirdPartyTag
Yêu cầu ping để phân bổ	Không bắt buộc Tên trường API: requiredPingForAttribution
Mã tích hợp	Không bắt buộc Tên trường API: IntegrationCode
Ghi chú	Không bắt buộc Tên trường API: ghi chú
Trạng thái kiểm tra	Chỉ đọc Tên trường API: reviewStatus

Quảng cáo có thể mở rộng của bên thứ ba

Loại mẫu quảng cáo: CREATIVE_TYPE_EXPANDABLE
Nguồn lưu trữ: HOSTING_SOURCE_SOURCE_PARTY
Tên	Bắt buộc Tên trường API: displayName
Trạng thái	Bắt buộc Tên trường API: entityStatus
Kích thước	Bắt buộc Tên trường API: phương diện
URL trang đích	Bắt buộc Tên trường API: exitEvents[].url Loại sự kiện thoát: EXIT_EVENT_TYPE_DEFAULT
Yêu cầu MRAID	Không bắt buộc Tên trường API: requiredMraid
Yêu cầu HTML5	Không bắt buộc Tên trường API: requiredhtml5
Hướng mở rộng	Bắt buộc Tên trường API: expandDirection
Mở rộng khi di chuột	Không bắt buộc Tên trường API:expandOnHover
Bên thứ ba	Bắt buộc Tên trường API: thirdPartyTag
Yêu cầu ping để phân bổ	Không bắt buộc Tên trường API: requiredPingForAttribution
Mã tích hợp	Không bắt buộc Tên trường API: IntegrationCode
Ghi chú	Không bắt buộc Tên trường API: ghi chú
Trạng thái kiểm tra	Chỉ đọc Tên trường API: reviewStatus

Quảng cáo video của bên thứ ba

Loại mẫu quảng cáo: CREATIVE_TYPE_VIDEO
Nguồn lưu trữ: HOSTING_SOURCE_SOURCE_PARTY
Tên	Bắt buộc Tên trường API: displayName
Trạng thái	Bắt buộc Tên trường API: entityStatus
URL của thẻ VAST	Bắt buộc Tên trường API: VASTTagUrl
VPAID	Chỉ đọc Tên trường API: vpaid
Video HTML5	Chỉ đọc Tên trường API: html5Video
Yêu cầu ping để phân bổ	Không bắt buộc Tên trường API: requiredPingForAttribution
Mã tích hợp	Không bắt buộc Tên trường API: IntegrationCode
Ghi chú	Không bắt buộc Tên trường API: ghi chú
Trạng thái kiểm tra	Chỉ đọc Tên trường API: reviewStatus

Mẫu quảng cáo âm thanh của bên thứ ba

Loại mẫu quảng cáo: CREATIVE_TYPE_AUDIO
Nguồn lưu trữ: HOSTING_SOURCE_SOURCE_PARTY
Tên	Bắt buộc Tên trường API: displayName
Trạng thái	Bắt buộc Tên trường API: entityStatus
URL của thẻ VAST	Bắt buộc Tên trường API: VASTTagUrl
Yêu cầu ping để phân bổ	Không bắt buộc Tên trường API: requiredPingForAttribution
Mã tích hợp	Không bắt buộc Tên trường API: IntegrationCode
Ghi chú	Không bắt buộc Tên trường API: ghi chú
Trạng thái kiểm tra	Chỉ đọc Tên trường API: reviewStatus

Nội dung video

Loại mẫu quảng cáo: CREATIVE_TYPE_VIDEO
Nguồn lưu trữ: HOSTING_SOURCE_SOURCE
Tên	Bắt buộc Tên trường API: displayName
Trạng thái	Bắt buộc Tên trường API: entityStatus
Tệp nguồn	Bắt buộc Tên trường API: thành phần Vai trò của nội dung: ASSET_ROLE_MAIN
URL trang đích	Bắt buộc Tên trường API: exitEvents[].url Loại sự kiện thoát: EXIT_EVENT_TYPE_DEFAULT
Bao gồm nút bỏ qua	Không bắt buộc Tên trường API: có thể bỏ qua
Bỏ qua mức chênh lệch	Không bắt buộc Tên trường API: ignoreOffset
Xử lý mức chênh lệch	Không bắt buộc Tên trường API: progressOffset
Mã quảng cáo toàn cầu	Không bắt buộc Tên trường API: universalAdId
OBA (quảng cáo dựa trên hành vi trên mạng)	Không bắt buộc Tên trường API: obaIcon
Mẫu quảng cáo đồng hành	Không bắt buộc Tên trường API: companionCreativeIds
Tệp phân phát	Chỉ đọc Tên trường API: chuyển mã
URL bên thứ ba	Không bắt buộc Tên trường API: thirdPartyUrls
Mã tích hợp	Không bắt buộc Tên trường API: IntegrationCode
Ghi chú	Không bắt buộc Tên trường API: ghi chú
Trạng thái kiểm tra	Chỉ đọc Tên trường API: reviewStatus

Mẫu quảng cáo dạng âm thanh

Loại mẫu quảng cáo: CREATIVE_TYPE_AUDIO
Nguồn lưu trữ: HOSTING_SOURCE_SOURCE
Tên	Bắt buộc Tên trường API: displayName
Trạng thái	Bắt buộc Tên trường API: entityStatus
Tệp nguồn	Bắt buộc Tên trường API: thành phần Vai trò của nội dung: ASSET_ROLE_MAIN
URL trang đích	Bắt buộc Tên trường API: exitEvents[].url Loại sự kiện thoát: EXIT_EVENT_TYPE_DEFAULT
Thành phần đi kèm (Tải lên hoặc chỉ định)	Bắt buộc Tên trường API: companionCreativeIds
Tên tệp phân phát	Chỉ đọc Tên trường API: chuyển mã [].name
Loại tệp phân phát	Chỉ đọc Tên trường API: chuyển mã [].mimeType
Đang cung cấp tệp tốc độ bit âm thanh của tệp	Chỉ đọc Tên trường API: chuyển mã [].audioBitRateKbps
Tốc độ lấy mẫu âm thanh của tệp đang phân phát	Chỉ đọc Tên trường API: chuyển mã [].audioSampleRateHz
URL bên thứ ba	Không bắt buộc Tên trường API: thirdPartyUrls
Mã tích hợp	Không bắt buộc Tên trường API: IntegrationCode
Ghi chú	Không bắt buộc Tên trường API: ghi chú
Trạng thái kiểm tra	Chỉ đọc Tên trường API: reviewStatus

Mẫu quảng cáo hiển thị gốc

Loại mẫu quảng cáo: CREATIVE_TYPE_NATIVE, CREATIVE_TYPE_NATIVE_SITE_ cùng
Nguồn lưu trữ: HOSTING_SOURCE_SOURCE
Tên	Bắt buộc Tên trường API: displayName
trạng thái	Bắt buộc Tên trường API: entityStatus
Biểu trưng	Bắt buộc Tên trường API: thành phần Vai trò của tài sản: ASSET_ROLE_ICON
Hình ảnh / Ảnh hình vuông	Bắt buộc Tên trường API: thành phần Vai trò của nội dung: ASSET_ROLE_MAIN
Tiêu đề	Bắt buộc Tên trường API: thành phần Vai trò của thành phần: ASSET_ROLE_HEADLINE
Dòng tiêu đề dài	Không bắt buộc Tên trường API: thành phần Vai trò thành phần: ASSET_ROLE_LONG_HEADLINE
Văn bản chính	Bắt buộc Tên trường API: thành phần Vai trò của nội dung: ASSET_ROLE_BODY
Văn bản có nội dung dài	Không bắt buộc Tên trường API: thành phần Vai trò nội dung: ASSET_ROLE_LONG_BODY
URL trang đích	Bắt buộc Tên trường API: exitEvents[].url Loại sự kiện thoát: EXIT_EVENT_TYPE_DEFAULT
URL chú thích	Bắt buộc Tên trường API: thành phần Vai trò của nội dung: ASSET_ROLE_OWNER_URL
Lời kêu gọi hành động	Bắt buộc Tên trường API: thành phần Vai trò của thành phần: ASSET_ROLE_CALL_TO_ACTION
Quảng cáo theo dõi Campaign Manager 360	Không bắt buộc Tên trường API: cmTrackingAd
URL theo dõi lượt hiển thị 1	Không bắt buộc Tên trường API: theo dõiUrls[]
URL theo dõi lượt hiển thị 2	Không bắt buộc Tên trường API: theo dõiUrls[]
URL theo dõi JavaScript	Không bắt buộc Tên trường API: jsTrackerUrl
Mã tích hợp	Không bắt buộc Tên trường API: IntegrationCode
Ghi chú	Không bắt buộc Tên trường API: ghi chú
Trạng thái kiểm tra	Chỉ đọc Tên trường API: reviewStatus

Mẫu quảng cáo dạng video gốc

Loại mẫu quảng cáo: CREATIVE_TYPE_NATIVE_VIDEO
Nguồn lưu trữ: HOSTING_SOURCE_SOURCE
Tên	Bắt buộc Tên trường API: displayName
Trạng thái	Bắt buộc Tên trường API: entityStatus
Biểu trưng	Bắt buộc Tên trường API: thành phần Vai trò của tài sản: ASSET_ROLE_ICON
Video	Bắt buộc Tên trường API: thành phần Vai trò của nội dung: ASSET_ROLE_MAIN
Ảnh bìa	Bắt buộc Tên trường API: thành phần Vai trò nội dung: ASSET_ROLE_COVER_IMAGE
Tên nhà quảng cáo	Bắt buộc Tên trường API: thành phần Vai trò của thành phần: ASSET_ROLE_ADVERTISER_NAME
Tiêu đề	Bắt buộc Tên trường API: thành phần Vai trò của thành phần: ASSET_ROLE_HEADLINE
Dòng tiêu đề dài	Không bắt buộc Tên trường API: thành phần Vai trò thành phần: ASSET_ROLE_LONG_HEADLINE
Văn bản chính	Bắt buộc Tên trường API: thành phần Vai trò của nội dung: ASSET_ROLE_BODY
Văn bản có nội dung dài	Không bắt buộc Tên trường API: thành phần Vai trò nội dung: ASSET_ROLE_LONG_BODY
URL trang đích	Bắt buộc Tên trường API: exitEvents[].url Loại sự kiện thoát: EXIT_EVENT_TYPE_DEFAULT
URL chú thích	Bắt buộc Tên trường API: thành phần Vai trò của nội dung: ASSET_ROLE_OWNER_URL
Lời kêu gọi hành động	Bắt buộc Tên trường API: thành phần Vai trò của thành phần: ASSET_ROLE_CALL_TO_ACTION
URL theo dõi lượt hiển thị 1	Không bắt buộc Tên trường API: theo dõiUrls[]
URL theo dõi lượt hiển thị 2	Không bắt buộc Tên trường API: theo dõiUrls[]
URL theo dõi JavaScript	Không bắt buộc Tên trường API: jsTrackerUrl
Mã tích hợp	Không bắt buộc Tên trường API: IntegrationCode
Ghi chú	Không bắt buộc Tên trường API: ghi chú
Trạng thái kiểm tra	Chỉ đọc Tên trường API: reviewStatus