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

下表将界面字段与相应的 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 字段名称：notes
审核状态	只读 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 字段名称：notes
审核状态	可选 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 字段名称：notes
审核状态	只读 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
需发出 ping 才能归因	可选 API 字段名称：requirePingForAttribution
集成代码	可选 API 字段名称：integrationCode
备注	可选 API 字段名称：notes
审核状态	只读 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 字段名称：notes
审核状态	只读 API 字段名称：reviewStatus

第三方音频广告素材

广告素材类型：CREATIVE_TYPE_AUDIO
托管来源：HOSTING_SOURCE_THIRD_PARTY
姓名	必填 API 字段名称：displayName
状态	必填 API 字段名称：entityStatus
VAST 代码网址	必填 API 字段名称：vastTagUrl
需发出 ping 才能归因	可选 API 字段名称：requirePingForAttribution
集成代码	可选 API 字段名称：integrationCode
备注	可选 API 字段名称：notes
审核状态	只读 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 字段名称：notes
审核状态	只读 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 字段名称：notes
审核状态	只读 API 字段名称：reviewStatus

原生展示广告素材

广告素材类型：CREATIVE_TYPE_NATIVE、CREATIVE_TYPE_NATIVE_SITE_SQUARE
托管来源：HOSTING_SOURCE_HOSTED
姓名	必填 API 字段名称：displayName
status	必填 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_网址
号召性用语	必填 API 字段名称：assets 素材资源角色：ASSET_ROLE_CALL_TO_ACTION
Campaign Manager 360 跟踪广告	可选 API 字段名称：cmTrackingAd
展示跟踪网址 1	可选 API 字段名称：trackingUrls[]
展示跟踪网址 2	可选 API 字段名称：trackingUrls[]
JavaScript 跟踪网址	可选 API 字段名称：jsTrackerUrl
集成代码	可选 API 字段名称：integrationCode
备注	可选 API 字段名称：notes
审核状态	只读 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_网址
号召性用语	必填 API 字段名称：assets 素材资源角色：ASSET_ROLE_CALL_TO_ACTION
展示跟踪网址 1	可选 API 字段名称：trackingUrls[]
展示跟踪网址 2	可选 API 字段名称：trackingUrls[]
JavaScript 跟踪网址	可选 API 字段名称：jsTrackerUrl
集成代码	可选 API 字段名称：integrationCode
备注	可选 API 字段名称：notes
审核状态	只读 API 字段名称：reviewStatus