自
2025 年 9 月 8 日起，每個新委刊項都必須聲明是否會放送歐盟政治廣告。如果透過 Display & Video 360 API 和 SDF 上傳的檔案未提供聲明，系統就會失敗。如要進一步瞭解如何更新整合服務以進行這項聲明，請參閱
淘汰項目頁面。
附錄：依廣告素材類型將使用者介面欄位對應至 API 欄位
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
下表將 UI 欄位與對應的 API 欄位對應，並以廣告素材類型區隔。請注意，部分 API 欄位需要透過為提供的資源指派角色或類型，進一步指定。
標準圖片廣告素材
| 廣告素材類型：CREATIVE_TYPE_STANDARD |
| 代管來源：HOSTING_SOURCE_HOSTED |
|
名稱 |
|
|
廣告素材資源 |
|
必填
|
|
API 欄位名稱：assets
|
|
資產角色：ASSET_ROLE_MAIN
|
|
|
到達網頁網址
|
|
必填
|
|
API 欄位名稱：exitEvents[].url
|
|
退出事件類型：EXIT_EVENT_TYPE_DEFAULT
|
|
|
狀態
|
|
|
附加的 HTML 追蹤代碼
|
|
|
整合代碼 |
|
選填
|
|
API 欄位名稱：integrationCode
|
|
| 注意事項 |
|
|
稽核狀態
|
|
HTML5 廣告素材
| 廣告素材類型：CREATIVE_TYPE_STANDARD |
| 代管來源：HOSTING_SOURCE_HOSTED |
|
名稱 |
|
|
廣告素材資源 |
|
必填
|
|
API 欄位名稱：assets
|
|
資產角色：ASSET_ROLE_MAIN
|
|
|
狀態
|
|
|
備用圖片 |
|
選填
|
|
API 欄位名稱：assets
|
|
資產角色：ASSET_ROLE_BACKUP
|
|
|
備用到達網頁網址
|
|
選填
|
|
API 欄位名稱：exitEvents[].url
|
|
退出事件類型：EXIT_EVENT_TYPE_BACKUP
|
|
|
備用圖片離開事件報表標籤
|
|
選填
|
|
API 欄位名稱：exitEvents[].reportingName
|
|
退出事件類型：EXIT_EVENT_TYPE_BACKUP
|
|
|
友善載入圖片 |
|
選填
|
|
API 欄位名稱：assets
|
|
資產角色：ASSET_ROLE_POLITE_LOAD
|
|
|
退出 |
|
必填
|
|
API 欄位名稱：exitEvents[]
|
|
退出事件類型：EXIT_EVENT_TYPE_DEFAULT
|
|
|
計數器
|
|
選填
|
|
API 欄位名稱：counterEvents[]
|
|
|
計時器
|
|
選填
|
|
API 欄位名稱：timerEvents[]
|
|
|
附加的 HTML 追蹤代碼
|
|
|
整合代碼 |
|
選填
|
|
API 欄位名稱：integrationCode
|
|
| 注意事項 |
|
|
稽核狀態
|
|
第三方多媒體廣告素材
| 廣告素材類型：CREATIVE_TYPE_STANDARD |
| 代管來源：HOSTING_SOURCE_THIRD_PARTY |
|
名稱 |
|
|
狀態
|
|
|
維度
|
|
|
到達網頁網址
|
|
必填
|
|
API 欄位名稱：exitEvents[].url
|
|
退出事件類型：EXIT_EVENT_TYPE_DEFAULT
|
|
|
需要 MRAID
|
|
|
需要 HTML5
|
|
|
第三方代碼 |
|
必填
|
|
API 欄位名稱：thirdPartyTag
|
|
|
必須發出通知才能進行歸因
|
|
選填
|
|
API 欄位名稱：requirePingForAttribution
|
|
|
整合代碼 |
|
選填
|
|
API 欄位名稱：integrationCode
|
|
| 注意事項 |
|
|
稽核狀態
|
|
第三方可展開式廣告素材
| 廣告素材類型：CREATIVE_TYPE_EXPANDABLE |
| 代管來源：HOSTING_SOURCE_THIRD_PARTY |
|
名稱 |
|
|
狀態
|
|
|
維度
|
|
|
到達網頁網址
|
|
必填
|
|
API 欄位名稱：exitEvents[].url
|
|
退出事件類型：EXIT_EVENT_TYPE_DEFAULT
|
|
|
需要 MRAID
|
|
|
需要 HTML5
|
|
|
展開方向 |
|
必填
|
|
API 欄位名稱：expandingDirection |
|
|
滑鼠懸停時展開 |
|
選填
|
|
API 欄位名稱：expandOnHover
|
|
|
第三方 |
|
必填
|
|
API 欄位名稱：thirdPartyTag
|
|
|
必須發出通知才能進行歸因
|
|
選填
|
|
API 欄位名稱：requirePingForAttribution
|
|
|
整合代碼 |
|
選填
|
|
API 欄位名稱：integrationCode
|
|
| 注意事項 |
|
|
稽核狀態
|
|
第三方影片廣告素材
| 廣告素材類型：CREATIVE_TYPE_VIDEO |
| 代管來源：HOSTING_SOURCE_THIRD_PARTY |
|
名稱 |
|
|
狀態
|
|
|
VAST 代碼網址 |
|
|
VPAID
|
|
|
HTML5 影片 |
|
|
必須發出通知才能進行歸因
|
|
選填
|
|
API 欄位名稱：requirePingForAttribution
|
|
|
整合代碼 |
|
選填
|
|
API 欄位名稱：integrationCode
|
|
| 注意事項 |
|
|
稽核狀態
|
|
第三方音訊廣告素材
| 廣告素材類型：CREATIVE_TYPE_AUDIO |
| 代管來源：HOSTING_SOURCE_THIRD_PARTY |
|
名稱 |
|
|
狀態
|
|
|
VAST 代碼網址 |
|
|
必須發出通知才能進行歸因
|
|
選填
|
|
API 欄位名稱：requirePingForAttribution
|
|
|
整合代碼 |
|
選填
|
|
API 欄位名稱：integrationCode
|
|
| 注意事項 |
|
|
稽核狀態
|
|
影片廣告素材
| 廣告素材類型：CREATIVE_TYPE_VIDEO |
| 代管來源：HOSTING_SOURCE_HOSTED |
|
名稱 |
|
|
狀態
|
|
|
來源檔案 |
|
必填
|
|
API 欄位名稱：assets
|
|
資產角色：ASSET_ROLE_MAIN
|
|
|
到達網頁網址
|
|
必填
|
|
API 欄位名稱：exitEvents[].url
|
|
退出事件類型：EXIT_EVENT_TYPE_DEFAULT
|
|
|
加入略過按鈕 |
|
|
略過偏移量 |
|
|
進度偏移 |
|
選填
|
|
API 欄位名稱：progressOffset
|
|
|
通用廣告 ID |
|
選填
|
|
API 欄位名稱：universalAdId
|
|
|
OBA
|
|
|
隨播廣告素材
|
|
選填
|
|
API 欄位名稱：companionCreativeIds
|
|
|
提供檔案 |
|
|
第三方網址
|
|
選填
|
|
API 欄位名稱：thirdPartyUrls
|
|
|
整合代碼 |
|
選填
|
|
API 欄位名稱：integrationCode
|
|
| 注意事項 |
|
|
稽核狀態
|
|
音訊廣告素材
| 廣告素材類型：CREATIVE_TYPE_AUDIO |
| 代管來源：HOSTING_SOURCE_HOSTED |
|
名稱 |
|
|
狀態
|
|
|
來源檔案 |
|
必填
|
|
API 欄位名稱：assets
|
|
資產角色：ASSET_ROLE_MAIN
|
|
|
到達網頁網址
|
|
必填
|
|
API 欄位名稱：exitEvents[].url
|
|
退出事件類型：EXIT_EVENT_TYPE_DEFAULT
|
|
|
隨播廣告 (上傳或指派)
|
|
必填
|
|
API 欄位名稱：companionCreativeIds
|
|
|
提供檔案名稱 |
|
唯讀
|
|
API 欄位名稱：transcodes[].name
|
|
|
提供檔案類型 |
|
唯讀
|
|
API 欄位名稱：transcodes[].mimeType
|
|
|
放送檔案音訊位元率
|
|
唯讀
|
|
API 欄位名稱：transcodes[].audioBitRateKbps
|
|
|
提供檔案音訊取樣率 |
|
唯讀
|
|
API 欄位名稱：transcodes[].audioSampleRateHz
|
|
|
第三方網址
|
|
選填
|
|
API 欄位名稱：thirdPartyUrls
|
|
|
整合代碼 |
|
選填
|
|
API 欄位名稱：integrationCode
|
|
| 注意事項 |
|
|
稽核狀態
|
|
原生多媒體廣告素材
| 廣告素材類型：CREATIVE_TYPE_NATIVE、CREATIVE_TYPE_NATIVE_SITE_SQUARE |
| 代管來源：HOSTING_SOURCE_HOSTED |
|
名稱 |
|
|
狀態 |
|
|
標誌 |
|
必填
|
|
API 欄位名稱：assets
|
|
資產角色：ASSET_ROLE_ICON
|
|
|
圖片 / 正方形圖片
|
|
必填
|
|
API 欄位名稱：assets
|
|
資產角色：ASSET_ROLE_MAIN
|
|
|
標題
|
|
必填
|
|
API 欄位名稱：assets
|
|
素材資源角色：ASSET_ROLE_HEADLINE
|
|
|
長廣告標題
|
|
選填
|
|
API 欄位名稱：assets
|
|
素材資源角色：ASSET_ROLE_LONG_HEADLINE
|
|
|
內文
|
|
必填
|
|
API 欄位名稱：assets
|
|
資產角色：ASSET_ROLE_BODY
|
|
|
詳細內文
|
|
選填
|
|
API 欄位名稱：assets
|
|
資產角色：ASSET_ROLE_LONG_BODY
|
|
|
到達網頁網址
|
|
必填
|
|
API 欄位名稱：exitEvents[].url
|
|
退出事件類型：EXIT_EVENT_TYPE_DEFAULT
|
|
|
說明文字網址 |
|
必填
|
|
API 欄位名稱：assets
|
|
資產角色：ASSET_ROLE_CAPTION_URL
|
|
|
行動號召
|
|
必填
|
|
API 欄位名稱：assets
|
|
資產角色：ASSET_ROLE_CALL_TO_ACTION
|
|
|
Campaign Manager 360 追蹤廣告 |
|
|
曝光追蹤網址 1
|
|
選填
|
|
API 欄位名稱：trackingUrls[]
|
|
|
曝光追蹤網址 2
|
|
選填
|
|
API 欄位名稱：trackingUrls[]
|
|
|
JavaScript 追蹤網址 |
|
|
整合代碼 |
|
選填
|
|
API 欄位名稱：integrationCode
|
|
| 注意事項 |
|
|
稽核狀態
|
|
原生影片廣告素材
| 廣告素材類型：CREATIVE_TYPE_NATIVE_VIDEO |
| 代管來源：HOSTING_SOURCE_HOSTED |
|
名稱 |
|
|
狀態
|
|
|
標誌 |
|
必填
|
|
API 欄位名稱：assets
|
|
資產角色：ASSET_ROLE_ICON
|
|
|
影片 |
|
必填
|
|
API 欄位名稱：assets
|
|
資產角色：ASSET_ROLE_MAIN
|
|
|
封面圖片 |
|
必填
|
|
API 欄位名稱：assets
|
|
資產角色：ASSET_ROLE_COVER_IMAGE
|
|
|
廣告主名稱 |
|
必填
|
|
API 欄位名稱：assets
|
|
資產角色：ASSET_ROLE_ADVERTISER_NAME
|
|
|
標題
|
|
必填
|
|
API 欄位名稱：assets
|
|
素材資源角色：ASSET_ROLE_HEADLINE
|
|
|
長廣告標題
|
|
選填
|
|
API 欄位名稱：assets
|
|
素材資源角色：ASSET_ROLE_LONG_HEADLINE
|
|
|
內文
|
|
必填
|
|
API 欄位名稱：assets
|
|
資產角色：ASSET_ROLE_BODY
|
|
|
詳細內文
|
|
選填
|
|
API 欄位名稱：assets
|
|
資產角色：ASSET_ROLE_LONG_BODY
|
|
|
到達網頁網址
|
|
必填
|
|
API 欄位名稱：exitEvents[].url
|
|
退出事件類型：EXIT_EVENT_TYPE_DEFAULT
|
|
|
說明文字網址 |
|
必填
|
|
API 欄位名稱：assets
|
|
資產角色：ASSET_ROLE_CAPTION_URL
|
|
|
行動號召
|
|
必填
|
|
API 欄位名稱：assets
|
|
資產角色：ASSET_ROLE_CALL_TO_ACTION
|
|
|
曝光追蹤網址 1
|
|
選填
|
|
API 欄位名稱：trackingUrls[]
|
|
|
曝光追蹤網址 2
|
|
選填
|
|
API 欄位名稱：trackingUrls[]
|
|
|
JavaScript 追蹤網址 |
|
|
整合代碼 |
|
選填
|
|
API 欄位名稱：integrationCode
|
|
| 注意事項 |
|
|
稽核狀態
|
|
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-25 (世界標準時間)。
[null,null,["上次更新時間：2025-07-25 (世界標準時間)。"],[[["\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,[]]
