附錄：依廣告素材類型將使用者介面欄位對應至 API 欄位
下表將 UI 欄位對應至對應的 API 欄位，並分別以廣告素材類型分隔。請注意，部分 API 欄位需要針對所提供資源指派的角色或類型，進一步指定。
標準圖片廣告素材
| 廣告素材類型：CREATIVE_TYPE_STANDARD |
| 代管來源：HOSTING_SOURCE_HOSTED |
|
名稱
|
|
|
廣告素材資源
|
|
必要
|
|
API 欄位名稱：資產 |
|
資產角色：ASSET_ROLE_MAIN
|
|
|
到達網頁網址
|
|
必要
|
|
API 欄位名稱：ExitEvents[].url
|
|
離開事件類型：EXIT_EVENT_TYPE_DEFAULT
|
|
|
狀態
|
|
必要
|
|
API 欄位名稱： entityStatus |
|
|
附加的 HTML 追蹤代碼
|
|
|
整合程式碼 |
|
選填
|
|
API 欄位名稱：IntegrationCode |
|
|
附註
|
|
|
稽核狀態
|
|
HTML5 廣告素材
| 廣告素材類型：CREATIVE_TYPE_STANDARD |
| 代管來源：HOSTING_SOURCE_HOSTED |
|
名稱
|
|
|
廣告素材資源
|
|
必要
|
|
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[] |
|
|
計時器
|
|
|
附加的 HTML 追蹤代碼
|
|
|
整合程式碼 |
|
選填
|
|
API 欄位名稱：IntegrationCode |
|
|
附註
|
|
|
稽核狀態
|
|
第三方多媒體廣告素材
| 廣告素材類型：CREATIVE_TYPE_STANDARD |
| 代管來源：HOSTING_SOURCE_THIRD_PARTY |
|
名稱
|
|
|
狀態
|
|
必要
|
|
API 欄位名稱： entityStatus |
|
|
維度
|
|
|
到達網頁網址
|
|
必要
|
|
API 欄位名稱：ExitEvents[].url
|
|
離開事件類型：EXIT_EVENT_TYPE_DEFAULT
|
|
|
需要 MRAID
|
|
|
需要 HTML5
|
|
|
第三方代碼
|
|
必要
|
|
API 欄位名稱：thirdPartyTag |
|
|
必須發出通知才能進行歸因
|
|
選填
|
|
API 欄位名稱：RequirePingForAttribution
|
|
|
整合程式碼 |
|
選填
|
|
API 欄位名稱：IntegrationCode |
|
|
附註
|
|
|
稽核狀態
|
|
第三方可展開式廣告素材
| 廣告素材類型：CREATIVE_TYPE_EXPANDABLE |
| 代管來源：HOSTING_SOURCE_THIRD_PARTY |
|
名稱
|
|
|
狀態
|
|
必要
|
|
API 欄位名稱： entityStatus |
|
|
維度
|
|
|
到達網頁網址
|
|
必要
|
|
API 欄位名稱：ExitEvents[].url
|
|
離開事件類型：EXIT_EVENT_TYPE_DEFAULT
|
|
|
需要 MRAID
|
|
|
需要 HTML5
|
|
|
展開方向
|
|
必要
|
|
API 欄位名稱：ExpandDirection
|
|
|
懸停時展開 |
|
選填
|
|
API 欄位名稱： expandOnHover
|
|
|
第三方
|
|
必要
|
|
API 欄位名稱：thirdPartyTag |
|
|
必須發出通知才能進行歸因
|
|
選填
|
|
API 欄位名稱：RequirePingForAttribution
|
|
|
整合程式碼 |
|
選填
|
|
API 欄位名稱：IntegrationCode |
|
|
附註
|
|
|
稽核狀態
|
|
第三方影片廣告素材
| 廣告素材類型：CREATIVE_TYPE_VIDEO |
| 代管來源：HOSTING_SOURCE_THIRD_PARTY |
|
名稱
|
|
|
狀態
|
|
必要
|
|
API 欄位名稱： entityStatus |
|
|
VAST 廣告代碼網址
|
|
|
VPAID
|
|
|
HTML5 影片
|
|
|
必須發出通知才能進行歸因
|
|
選填
|
|
API 欄位名稱：RequirePingForAttribution
|
|
|
整合程式碼 |
|
選填
|
|
API 欄位名稱：IntegrationCode |
|
|
附註
|
|
|
稽核狀態
|
|
第三方音訊廣告素材
| 廣告素材類型：CREATIVE_TYPE_AUDIO |
| 代管來源：HOSTING_SOURCE_THIRD_PARTY |
|
名稱
|
|
|
狀態
|
|
必要
|
|
API 欄位名稱： entityStatus |
|
|
VAST 廣告代碼網址
|
|
|
必須發出通知才能進行歸因
|
|
選填
|
|
API 欄位名稱：RequirePingForAttribution
|
|
|
整合程式碼 |
|
選填
|
|
API 欄位名稱：IntegrationCode |
|
|
附註
|
|
|
稽核狀態
|
|
影片廣告素材
| 廣告素材類型：CREATIVE_TYPE_VIDEO |
| 代管來源：HOSTING_SOURCE_HOSTED |
|
名稱
|
|
|
狀態
|
|
必要
|
|
API 欄位名稱： entityStatus |
|
|
來源檔案 |
|
必要
|
|
API 欄位名稱：資產 |
|
資產角色：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 欄位名稱： entityStatus |
|
|
來源檔案 |
|
必要
|
|
API 欄位名稱：資產 |
|
資產角色：ASSET_ROLE_MAIN
|
|
|
到達網頁網址
|
|
必要
|
|
API 欄位名稱：ExitEvents[].url
|
|
離開事件類型：EXIT_EVENT_TYPE_DEFAULT
|
|
|
隨播廣告素材 (上傳或指派)
|
|
必要
|
|
API 欄位名稱：CompanionCreativeIds
|
|
|
放送檔案名稱
|
|
|
放送檔案類型
|
|
唯讀 |
|
API 欄位名稱：轉碼 [].mimeType |
|
|
提供檔案音訊位元率
|
|
唯讀 |
|
API 欄位名稱：轉碼 [].audioBitRateKbps |
|
|
提供檔案音訊取樣率
|
|
唯讀 |
|
API 欄位名稱：轉碼 [].audioSampleRateHz |
|
|
第三方網址
|
|
選填
|
|
API 欄位名稱：thirdPartyUrls
|
|
|
整合程式碼 |
|
選填
|
|
API 欄位名稱：IntegrationCode |
|
|
附註
|
|
|
稽核狀態
|
|
原生多媒體廣告素材
| 廣告素材類型：CREATIVE_TYPE_NATIVE、CREATIVE_TYPE_NATIVE_SITE_PACKAGE |
| 代管來源：HOSTING_SOURCE_HOSTED |
|
名稱
|
|
|
狀態 |
|
必要
|
|
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 追蹤廣告
|
|
|
曝光追蹤網址 1
|
|
選填
|
|
API 欄位名稱：trackingUrls[]
|
|
|
曝光追蹤網址 2
|
|
選填
|
|
API 欄位名稱：trackingUrls[]
|
|
|
JavaScript 追蹤網址
|
|
|
整合程式碼 |
|
選填
|
|
API 欄位名稱：IntegrationCode |
|
|
附註
|
|
|
稽核狀態
|
|
原生影片廣告素材
| 廣告素材類型：CREATIVE_TYPE_NATIVE_VIDEO |
| 代管來源：HOSTING_SOURCE_HOSTED |
|
名稱
|
|
|
狀態
|
|
必要
|
|
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 欄位名稱：IntegrationCode |
|
|
附註
|
|
|
稽核狀態
|
|
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2023-12-01 (世界標準時間)。
[null,null,["上次更新時間：2023-12-01 (世界標準時間)。"],[[["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."]]],[]]
