附录：按广告素材类型将用户界面字段映射到 API 字段

下表列出了界面字段与按广告素材类型划分的相应 API 字段之间的对应关系。请注意，某些 API 字段需要通过为所提供资源分配的角色或类型来进一步指定规范。

标准图片广告素材

广告素材类型：CREATIVE_TYPE_STANDARD
Hosting 来源：HOSTING_SOURCE_HOSTED
名称	必需 API 字段名称：displayName
广告素材资源	必需 API 字段名称：资源 资产角色：ASSET_ROLE_MAIN
着陆页网址	必需 API 字段名称：exitEvents[].url 退出事件类型：EXIT_EVENT_TYPE_DEFAULT
状态	必需 API 字段名称：entityStatus
附加的 HTML 跟踪代码	可选 API 字段名称：additionalTag
集成代码	可选 API 字段名称：IntegrationCode
备注	可选 API 字段名称：说明
审核状态	只读 API 字段名称：reviewStatus

HTML5 广告素材

广告素材类型：CREATIVE_TYPE_STANDARD
Hosting 来源：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 字段名称：TimerEvents[]
附加的 HTML 跟踪代码	可选 API 字段名称：additionalTag
集成代码	可选 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
需执行 ping 操作才能归因	可选 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
需执行 ping 操作才能归因	可选 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
需执行 ping 操作才能归因	可选 API 字段名称：requirePingForAttribution
集成代码	可选 API 字段名称：IntegrationCode
备注	可选 API 字段名称：说明
审核状态	只读 API 字段名称：reviewStatus

第三方音频广告素材

广告素材类型：CREATIVE_TYPE_AUDIO
托管来源：HOSTING_SOURCE_THIRD_PARTY
名称	必需 API 字段名称：displayName
状态	必需 API 字段名称：entityStatus
VAST 代码网址	必需 API 字段名称：vastTagUrl
需执行 ping 操作才能归因	可选 API 字段名称：requirePingForAttribution
集成代码	可选 API 字段名称：IntegrationCode
备注	可选 API 字段名称：说明
审核状态	只读 API 字段名称：reviewStatus

视频广告素材

广告素材类型：CREATIVE_TYPE_VIDEO
Hosting 来源：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 来源：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_square
Hosting 来源：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_网址
号召性用语	必需 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 来源：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_网址
号召性用语	必需 API 字段名称：资源 资产角色：ASSET_ROLE_CALL_TO_ACTION
展示跟踪网址 1	可选 API 字段名称：trackingUrls[]
展示跟踪网址 2	可选 API 字段名称：trackingUrls[]
JavaScript 跟踪网址	可选 API 字段名称：jsTrackerUrl
集成代码	可选 API 字段名称：IntegrationCode
备注	可选 API 字段名称：说明
审核状态	只读 API 字段名称：reviewStatus