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
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
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. Xin lưu ý rằng một số trường API yêu cầu thông số kỹ thuật bổ sung 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_HOSTED
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 thành phần: 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: appendedTag
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ó thể đọ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_HOSTED
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 thành phần: 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 khỏi quá trình sao lưu
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ần 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: timerEvents[]
Thẻ theo dõi HTML đã thêm
Không bắt buộc
Tên trường API: appendedTag
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_THIRD_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: requireMraid
Yêu cầu HTML5
Không bắt buộc
Tên trường API: requireHtml5
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: requirePingForAttribution
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ó thể đọc
Tên trường API: reviewStatus
Mẫu 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_THIRD_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: requireMraid
Yêu cầu HTML5
Không bắt buộc
Tên trường API: requireHtml5
Hướng mở rộng
Bắt buộc
Tên trường API: expandingDirection
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: requirePingForAttribution
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ó thể đọc
Tên trường API: reviewStatus
Mẫu quảng cáo dạng 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_THIRD_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ó thể đọc
Tên trường API: vpaid
Video HTML5
Chỉ có thể đọ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: requirePingForAttribution
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ó thể đọc
Tên trường API: reviewStatus
Mẫu quảng cáo dạng â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_THIRD_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: requirePingForAttribution
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ó thể đọc
Tên trường API: reviewStatus
Sáng Tạo Video
Loại mẫu quảng cáo: CREATIVE_TYPE_VIDEO
Nguồn lưu trữ: HOSTING_SOURCE_HOSTED
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 thành phần: 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: skipOffset
Xử lý mức chênh lệch
Không bắt buộc
Tên trường API: progressOffset
Mã nhận dạng cho 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
Phân phát tệp
Chỉ có thể đọc
Tên trường API: bản 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ó thể đọ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_HOSTED
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 thành phần: 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 đồng hành (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ó thể đọc
Tên trường API: transcodes[].name
Loại tệp phân phát
Chỉ có thể đọc
Tên trường API: transcodes[].mimeType
Tốc độ bit của âm thanh trong tệp
Chỉ có thể đọc
Tên trường API: transcodes[].audioBitRateKbps
Tốc độ lấy mẫu âm thanh của tệp phân phát
Chỉ có thể đọc
Tên trường API: transcodes[].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ó thể đọ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_SQUARE
Nguồn lưu trữ: HOSTING_SOURCE_HOSTED
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 thành phần: ASSET_ROLE_ICON
Hình ảnh / Hình ảnh vuông
Bắt buộc
Tên trường API: thành phần
Vai trò của thành phần: ASSET_ROLE_MAIN
Dòng 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ò của 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 thành phần: 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ò của thành phần: 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 thành phần: ASSET_ROLE_CAPTION_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: trackingUrls[]
URL theo dõi lượt hiển thị 2
Không bắt buộc
Tên trường API: trackingUrls[]
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ó thể đọ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_HOSTED
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 thành phần: ASSET_ROLE_ICON
Video
Bắt buộc
Tên trường API: thành phần
Vai trò của thành phần: ASSET_ROLE_MAIN
Ảnh bìa
Bắt buộc
Tên trường API: thành phần
Vai trò của thành phần: 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
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-04-09 UTC."],[[["This document provides a comprehensive mapping of UI fields to their corresponding API fields for various creative types, including Standard Image, HTML5, Third-Party Display, Third-Party Expandable, Third-Party Video, Third-Party Audio, Video, Audio, Native Display, and Native Video."],["Each creative type has a specific set of required and optional fields, along with their API field names and any further specifications for asset roles or exit event types."],["Creative asset specifications, such as required and optional assets, are outlined for Native Video creatives, including details about their roles and corresponding API field names."],["Campaign Manager 360 tracking ad can optionally be included using the `cmTrackingAd` API field."],["This mapping enables developers to understand how UI inputs translate into API data for seamless creative management and integration within the system."]]],[]]
