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

下表將 UI 欄位對應至對應的 API 欄位,並分別以廣告素材類型分隔。請注意,部分 API 欄位需要針對所提供資源指派的角色或類型,進一步指定。

標準圖片廣告素材

廣告素材類型:CREATIVE_TYPE_STANDARD
代管來源:HOSTING_SOURCE_HOSTED
名稱
必要
API 欄位名稱:displayName
廣告素材資源
必要
API 欄位名稱:資產
資產角色:ASSET_ROLE_MAIN
到達網頁網址
必要
API 欄位名稱:ExitEvents[].url
離開事件類型:EXIT_EVENT_TYPE_DEFAULT
狀態
必要
API 欄位名稱: entityStatus
附加的 HTML 追蹤代碼
選填
API 欄位名稱:AttachTag
整合程式碼
選填
API 欄位名稱:IntegrationCode
附註
選填
API 欄位名稱:附註
稽核狀態
唯讀
API 欄位名稱:reviewStatus

HTML5 廣告素材

廣告素材類型:CREATIVE_TYPE_STANDARD
代管來源:HOSTING_SOURCE_HOSTED
名稱
必要
API 欄位名稱:displayName
廣告素材資源
必要
API 欄位名稱:資產
資產角色:ASSET_ROLE_MAIN
狀態
必要
API 欄位名稱: entityStatus
備用圖片
選填
API 欄位名稱:資產
資產角色:ASSET_ROLE_BACKUP
備用到達網頁網址
選填
API 欄位名稱:ExitEvents[].url
離開事件類型:EXIT_EVENT_TYPE_BACKUP
備用離開事件報表標籤
選填
API 欄位名稱:ExitEvents[].reportingName
離開事件類型:EXIT_EVENT_TYPE_BACKUP
友善載入圖片
選填
API 欄位名稱:資產
資產角色:ASSET_ROLE_POLITE_LOAD
離開事件
必要
API 欄位名稱: exitEvents[]
離開事件類型:EXIT_EVENT_TYPE_DEFAULT
計數器
選填
API 欄位名稱:counterEvents[]
計時器
選填
API 欄位名稱:timeEvents[]
附加的 HTML 追蹤代碼
選填
API 欄位名稱:AttachTag
整合程式碼
選填
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 欄位名稱:ExpandDirection
懸停時展開
選填
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 欄位名稱:資產
資產角色:ASSET_ROLE_MAIN
到達網頁網址
必要
API 欄位名稱:ExitEvents[].url
離開事件類型:EXIT_EVENT_TYPE_DEFAULT
包含「略過」按鈕
選填
API 欄位名稱:可略過
略過開始計費前的播放時長
選填
API 欄位名稱:SkipOffset
開始計費前的播放時長
選填
API 欄位名稱: progressOffset
通用廣告 ID
選填
API 欄位名稱:universalAdId
OBA
選填
API 欄位名稱:obaIcon
隨播廣告素材
選填
API 欄位名稱:CompanionCreativeIds
放送檔案
唯讀
API 欄位名稱:轉碼
第三方網址
選填
API 欄位名稱:thirdPartyUrls
整合程式碼
選填
API 欄位名稱:IntegrationCode
附註
選填
API 欄位名稱:附註
稽核狀態
唯讀
API 欄位名稱:reviewStatus

音訊廣告素材

廣告素材類型:CREATIVE_TYPE_AUDIO
代管來源:HOSTING_SOURCE_HOSTED
名稱
必要
API 欄位名稱:displayName
狀態
必要
API 欄位名稱: entityStatus
來源檔案
必要
API 欄位名稱:資產
資產角色:ASSET_ROLE_MAIN
到達網頁網址
必要
API 欄位名稱:ExitEvents[].url
離開事件類型:EXIT_EVENT_TYPE_DEFAULT
隨播廣告素材 (上傳或指派)
必要
API 欄位名稱:CompanionCreativeIds
放送檔案名稱
唯讀
API 欄位名稱:轉碼 [].name
放送檔案類型
唯讀
API 欄位名稱:轉碼 [].mimeType
提供檔案音訊位元率
唯讀
API 欄位名稱:轉碼 [].audioBitRateKbps
提供檔案音訊取樣率
唯讀
API 欄位名稱:轉碼 [].audioSampleRateHz
第三方網址
選填
API 欄位名稱:thirdPartyUrls
整合程式碼
選填
API 欄位名稱:IntegrationCode
附註
選填
API 欄位名稱:附註
稽核狀態
唯讀
API 欄位名稱:reviewStatus

原生多媒體廣告素材

廣告素材類型:CREATIVE_TYPE_NATIVE、CREATIVE_TYPE_NATIVE_SITE_PACKAGE
代管來源:HOSTING_SOURCE_HOSTED
名稱
必要
API 欄位名稱:displayName
狀態
必要
API 欄位名稱: entityStatus
標誌
必要
API 欄位名稱:資產
資產角色:ASSET_ROLE_ICON
圖片 / 正方形圖片
必要
API 欄位名稱:資產
資產角色:ASSET_ROLE_MAIN
廣告標題
必要
API 欄位名稱:資產
資產角色:ASSET_ROLE_HEADLINE
長標題
選填
API 欄位名稱:資產
資產角色:ASSET_ROLE_LONG_HEADLINE
內文
必要
API 欄位名稱:資產
資產角色:ASSET_ROLE_BODY
詳細內文
選填
API 欄位名稱:資產
資產角色:ASSET_ROLE_LONG_BODY
到達網頁網址
必要
API 欄位名稱:ExitEvents[].url
離開事件類型:EXIT_EVENT_TYPE_DEFAULT
字幕網址
必要
API 欄位名稱:資產
資產角色:ASSET_ROLE_CAPTION_URL
行動號召
必要
API 欄位名稱:資產
資產角色: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 欄位名稱:資產
資產角色:ASSET_ROLE_ICON
影片
必要
API 欄位名稱:資產
資產角色:ASSET_ROLE_MAIN
封面圖片
必要
API 欄位名稱:資產
資產角色:ASSET_ROLE_COVER_IMAGE
廣告客戶名稱
必要
API 欄位名稱:資產
資產角色:ASSET_ROLE_ADVERTISER_NAME
廣告標題
必要
API 欄位名稱:資產
資產角色:ASSET_ROLE_HEADLINE
長標題
選填
API 欄位名稱:資產
資產角色:ASSET_ROLE_LONG_HEADLINE
內文
必要
API 欄位名稱:資產
資產角色:ASSET_ROLE_BODY
詳細內文
選填
API 欄位名稱:資產
資產角色:ASSET_ROLE_LONG_BODY
到達網頁網址
必要
API 欄位名稱:ExitEvents[].url
離開事件類型:EXIT_EVENT_TYPE_DEFAULT
字幕網址
必要
API 欄位名稱:資產
資產角色:ASSET_ROLE_CAPTION_URL
行動號召
必要
API 欄位名稱:資產
資產角色:ASSET_ROLE_CALL_TO_ACTION
曝光追蹤網址 1
選填
API 欄位名稱:trackingUrls[]
曝光追蹤網址 2
選填
API 欄位名稱:trackingUrls[]
JavaScript 追蹤網址
選填
API 欄位名稱:jsTrackerUrl
整合程式碼
選填
API 欄位名稱:IntegrationCode
附註
選填
API 欄位名稱:附註
稽核狀態
唯讀
API 欄位名稱:reviewStatus