提供意見
附錄：依廣告素材類型將使用者介面欄位對應至 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 (世界標準時間)。
想進一步說明嗎？
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-07-25 (世界標準時間)。"],[[["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."]]],[]]
