附錄：依廣告素材類型將使用者介面欄位對應至 API 欄位

下表將 UI 欄位與對應的 API 欄位對應，並以廣告素材類型區隔。請注意，部分 API 欄位需要透過為提供的資源指派角色或類型，進一步指定。

標準圖片廣告素材

廣告素材類型：CREATIVE_TYPE_STANDARD
代管來源：HOSTING_SOURCE_HOSTED
名稱	必填 API 欄位名稱：displayName
廣告素材資源	必填 API 欄位名稱：assets 資產角色：ASSET_ROLE_MAIN
到達網頁網址	必填 API 欄位名稱：exitEvents[].url 退出事件類型：EXIT_EVENT_TYPE_DEFAULT
狀態	必填 API 欄位名稱：entityStatus
附加的 HTML 追蹤代碼	選填 API 欄位名稱：appendedTag
整合代碼	選填 API 欄位名稱：integrationCode
注意事項	選填 API 欄位名稱：附註
稽核狀態	唯讀 API 欄位名稱：reviewStatus

HTML5 廣告素材

廣告素材類型：CREATIVE_TYPE_STANDARD
代管來源：HOSTING_SOURCE_HOSTED
名稱	必填 API 欄位名稱：displayName
廣告素材資源	必填 API 欄位名稱：assets 資產角色：ASSET_ROLE_MAIN
狀態	必填 API 欄位名稱：entityStatus
備用圖片	選填 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 欄位名稱：appendedTag
整合代碼	選填 API 欄位名稱：integrationCode
注意事項	選填 API 欄位名稱：附註
稽核狀態	選填 API 欄位名稱：reviewStatus

第三方多媒體廣告素材

廣告素材類型：CREATIVE_TYPE_STANDARD
代管來源：HOSTING_SOURCE_THIRD_PARTY
名稱	必填 API 欄位名稱：displayName
狀態	必填 API 欄位名稱：entityStatus
維度	必填 API 欄位名稱：維度
到達網頁網址	必填 API 欄位名稱：exitEvents[].url 退出事件類型：EXIT_EVENT_TYPE_DEFAULT
需要 MRAID	選填 API 欄位名稱：requireMraid
需要 HTML5	選填 API 欄位名稱：requireHtml5
第三方代碼	必填 API 欄位名稱：thirdPartyTag
必須發出通知才能進行歸因	選填 API 欄位名稱：requirePingForAttribution
整合代碼	選填 API 欄位名稱：integrationCode
注意事項	選填 API 欄位名稱：附註
稽核狀態	唯讀 API 欄位名稱：reviewStatus

第三方可展開式廣告素材

廣告素材類型：CREATIVE_TYPE_EXPANDABLE
代管來源：HOSTING_SOURCE_THIRD_PARTY
名稱	必填 API 欄位名稱：displayName
狀態	必填 API 欄位名稱：entityStatus
維度	必填 API 欄位名稱：維度
到達網頁網址	必填 API 欄位名稱：exitEvents[].url 退出事件類型：EXIT_EVENT_TYPE_DEFAULT
需要 MRAID	選填 API 欄位名稱：requireMraid
需要 HTML5	選填 API 欄位名稱：requireHtml5
展開方向	必填 API 欄位名稱：expandingDirection
滑鼠懸停時展開	選填 API 欄位名稱：expandOnHover
第三方	必填 API 欄位名稱：thirdPartyTag
必須發出通知才能進行歸因	選填 API 欄位名稱：requirePingForAttribution
整合代碼	選填 API 欄位名稱：integrationCode
注意事項	選填 API 欄位名稱：附註
稽核狀態	唯讀 API 欄位名稱：reviewStatus

第三方影片廣告素材

廣告素材類型：CREATIVE_TYPE_VIDEO
代管來源：HOSTING_SOURCE_THIRD_PARTY
名稱	必填 API 欄位名稱：displayName
狀態	必填 API 欄位名稱：entityStatus
VAST 代碼網址	必填 API 欄位名稱：vastTagUrl
VPAID	唯讀 API 欄位名稱：vpaid
HTML5 影片	唯讀 API 欄位名稱：html5Video
必須發出通知才能進行歸因	選填 API 欄位名稱：requirePingForAttribution
整合代碼	選填 API 欄位名稱：integrationCode
注意事項	選填 API 欄位名稱：附註
稽核狀態	唯讀 API 欄位名稱：reviewStatus

第三方音訊廣告素材

廣告素材類型：CREATIVE_TYPE_AUDIO
代管來源：HOSTING_SOURCE_THIRD_PARTY
名稱	必填 API 欄位名稱：displayName
狀態	必填 API 欄位名稱：entityStatus
VAST 代碼網址	必填 API 欄位名稱：vastTagUrl
必須發出通知才能進行歸因	選填 API 欄位名稱：requirePingForAttribution
整合代碼	選填 API 欄位名稱：integrationCode
注意事項	選填 API 欄位名稱：附註
稽核狀態	唯讀 API 欄位名稱：reviewStatus

影片廣告素材

廣告素材類型：CREATIVE_TYPE_VIDEO
代管來源：HOSTING_SOURCE_HOSTED
名稱	必填 API 欄位名稱：displayName
狀態	必填 API 欄位名稱：entityStatus
來源檔案	必填 API 欄位名稱：assets 資產角色：ASSET_ROLE_MAIN
到達網頁網址	必填 API 欄位名稱：exitEvents[].url 退出事件類型：EXIT_EVENT_TYPE_DEFAULT
加入略過按鈕	選填 API 欄位名稱：skippable
略過偏移量	選填 API 欄位名稱：skipOffset
進度偏移	選填 API 欄位名稱：progressOffset
通用廣告 ID	選填 API 欄位名稱：universalAdId
OBA	選填 API 欄位名稱：obaIcon
隨播廣告素材	選填 API 欄位名稱：companionCreativeIds
提供檔案	唯讀 API 欄位名稱：transcodes
第三方網址	選填 API 欄位名稱：thirdPartyUrls
整合代碼	選填 API 欄位名稱：integrationCode
注意事項	選填 API 欄位名稱：附註
稽核狀態	唯讀 API 欄位名稱：reviewStatus

音訊廣告素材

廣告素材類型：CREATIVE_TYPE_AUDIO
代管來源：HOSTING_SOURCE_HOSTED
名稱	必填 API 欄位名稱：displayName
狀態	必填 API 欄位名稱：entityStatus
來源檔案	必填 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
注意事項	選填 API 欄位名稱：附註
稽核狀態	唯讀 API 欄位名稱：reviewStatus

原生多媒體廣告素材

廣告素材類型：CREATIVE_TYPE_NATIVE、CREATIVE_TYPE_NATIVE_SITE_SQUARE
代管來源：HOSTING_SOURCE_HOSTED
名稱	必填 API 欄位名稱：displayName
狀態	必填 API 欄位名稱：entityStatus
標誌	必填 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 追蹤廣告	選填 API 欄位名稱：cmTrackingAd
曝光追蹤網址 1	選填 API 欄位名稱：trackingUrls[]
曝光追蹤網址 2	選填 API 欄位名稱：trackingUrls[]
JavaScript 追蹤網址	選填 API 欄位名稱：jsTrackerUrl
整合代碼	選填 API 欄位名稱：integrationCode
注意事項	選填 API 欄位名稱：附註
稽核狀態	唯讀 API 欄位名稱：reviewStatus

原生影片廣告素材

廣告素材類型：CREATIVE_TYPE_NATIVE_VIDEO
代管來源：HOSTING_SOURCE_HOSTED
名稱	必填 API 欄位名稱：displayName
狀態	必填 API 欄位名稱：entityStatus
標誌	必填 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 欄位名稱：jsTrackerUrl
整合代碼	選填 API 欄位名稱：integrationCode
注意事項	選填 API 欄位名稱：附註
稽核狀態	唯讀 API 欄位名稱：reviewStatus