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
|
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2023-12-01 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2023-12-01 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."]]],[]]
