Kể từ
ngày 8 tháng 9 năm 2025, mỗi mục hàng mới sẽ cần phải khai báo xem mục hàng đó có phân phát quảng cáo chính trị ở Liên minh Châu Âu (EU) hay không. Display & Video 360 API và các tệp SDF được tải lên mà không cung cấp thông tin khai báo sẽ không thành công. Hãy xem
trang thông báo về những nội dung không dùng nữa để biết thêm thông tin về cách cập nhật quy trình tích hợp để đưa ra nội dung khai báo này.
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ò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
|
|
|
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
|
|
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: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003eThis 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.\u003c/p\u003e\n"],["\u003cp\u003eEach 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.\u003c/p\u003e\n"],["\u003cp\u003eCreative asset specifications, such as required and optional assets, are outlined for Native Video creatives, including details about their roles and corresponding API field names.\u003c/p\u003e\n"],["\u003cp\u003eCampaign Manager 360 tracking ad can optionally be included using the \u003ccode\u003ecmTrackingAd\u003c/code\u003e API field.\u003c/p\u003e\n"],["\u003cp\u003eThis mapping enables developers to understand how UI inputs translate into API data for seamless creative management and integration within the system.\u003c/p\u003e\n"]]],[],null,[]]
