附录：按广告素材类型将用户界面字段映射到 API 字段
下表列出了界面字段与按广告素材类型划分的相应 API 字段之间的对应关系。请注意，某些 API 字段需要通过为所提供资源分配的角色或类型来进一步指定规范。
标准图片广告素材
| 广告素材类型：CREATIVE_TYPE_STANDARD |
| Hosting 来源：HOSTING_SOURCE_HOSTED |
|
名称
|
|
|
广告素材资源
|
|
必需
|
|
API 字段名称：资源
|
|
资产角色：ASSET_ROLE_MAIN
|
|
|
着陆页网址
|
|
必需
|
|
API 字段名称：exitEvents[].url
|
|
退出事件类型：EXIT_EVENT_TYPE_DEFAULT
|
|
|
状态
|
|
|
附加的 HTML 跟踪代码
|
|
可选
|
|
API 字段名称：additionalTag
|
|
|
集成代码
|
|
可选
|
|
API 字段名称：IntegrationCode
|
|
|
备注
|
|
|
审核状态
|
|
HTML5 广告素材
| 广告素材类型：CREATIVE_TYPE_STANDARD |
| Hosting 来源：HOSTING_SOURCE_HOSTED |
|
名称
|
|
|
广告素材资源
|
|
必需
|
|
API 字段名称：资源
|
|
资产角色：ASSET_ROLE_MAIN
|
|
|
状态
|
|
|
备用图片
|
|
可选
|
|
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
|
|
|
备注
|
|
|
审核状态
|
|
第三方展示广告素材
| 广告素材类型：CREATIVE_TYPE_STANDARD |
| 托管来源：HOSTING_SOURCE_THIRD_PARTY |
|
名称
|
|
|
状态
|
|
|
维度
|
|
|
着陆页网址
|
|
必需
|
|
API 字段名称：exitEvents[].url
|
|
退出事件类型：EXIT_EVENT_TYPE_DEFAULT
|
|
|
需要 MRAID
|
|
|
需要 HTML5
|
|
|
第三方跟踪代码
|
|
必需
|
|
API 字段名称：thirdPartyTag
|
|
|
需执行 ping 操作才能归因
|
|
可选
|
|
API 字段名称：requirePingForAttribution
|
|
|
集成代码
|
|
可选
|
|
API 字段名称：IntegrationCode
|
|
|
备注
|
|
|
审核状态
|
|
第三方展开式广告
| 广告素材类型：CREATIVE_TYPE_EXPANDABLE |
| 托管来源：HOSTING_SOURCE_THIRD_PARTY |
|
名称
|
|
|
状态
|
|
|
维度
|
|
|
着陆页网址
|
|
必需
|
|
API 字段名称：exitEvents[].url
|
|
退出事件类型：EXIT_EVENT_TYPE_DEFAULT
|
|
|
需要 MRAID
|
|
|
需要 HTML5
|
|
|
展开方向
|
|
必需
|
|
API 字段名称：expandDirection
|
|
|
悬停时展开
|
|
可选
|
|
API 字段名称：expandOnHover
|
|
|
第三方
|
|
必需
|
|
API 字段名称：thirdPartyTag
|
|
|
需执行 ping 操作才能归因
|
|
可选
|
|
API 字段名称：requirePingForAttribution
|
|
|
集成代码
|
|
可选
|
|
API 字段名称：IntegrationCode
|
|
|
备注
|
|
|
审核状态
|
|
第三方视频广告素材
| 广告素材类型：CREATIVE_TYPE_VIDEO |
| 托管来源：HOSTING_SOURCE_THIRD_PARTY |
|
名称
|
|
|
状态
|
|
|
VAST 代码网址
|
|
|
VPAID
|
|
|
HTML5 视频
|
|
|
需执行 ping 操作才能归因
|
|
可选
|
|
API 字段名称：requirePingForAttribution
|
|
|
集成代码
|
|
可选
|
|
API 字段名称：IntegrationCode
|
|
|
备注
|
|
|
审核状态
|
|
第三方音频广告素材
| 广告素材类型：CREATIVE_TYPE_AUDIO |
| 托管来源：HOSTING_SOURCE_THIRD_PARTY |
|
名称
|
|
|
状态
|
|
|
VAST 代码网址
|
|
|
需执行 ping 操作才能归因
|
|
可选
|
|
API 字段名称：requirePingForAttribution
|
|
|
集成代码
|
|
可选
|
|
API 字段名称：IntegrationCode
|
|
|
备注
|
|
|
审核状态
|
|
视频广告素材
| 广告素材类型：CREATIVE_TYPE_VIDEO |
| Hosting 来源：HOSTING_SOURCE_HOSTED |
|
名称
|
|
|
状态
|
|
|
源文件
|
|
必需
|
|
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 来源：HOSTING_SOURCE_HOSTED |
|
名称
|
|
|
状态
|
|
|
源文件
|
|
必需
|
|
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_square |
| Hosting 来源：HOSTING_SOURCE_HOSTED |
|
名称
|
|
|
状态
|
|
|
徽标
|
|
必需
|
|
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 跟踪广告
|
|
|
展示跟踪网址 1
|
|
可选
|
|
API 字段名称：trackingUrls[]
|
|
|
展示跟踪网址 2
|
|
可选
|
|
API 字段名称：trackingUrls[]
|
|
|
JavaScript 跟踪网址
|
|
|
集成代码
|
|
可选
|
|
API 字段名称：IntegrationCode
|
|
|
备注
|
|
|
审核状态
|
|
原生视频广告素材
| 广告素材类型：CREATIVE_TYPE_NATIVE_VIDEO |
| Hosting 来源：HOSTING_SOURCE_HOSTED |
|
名称
|
|
|
状态
|
|
|
徽标
|
|
必需
|
|
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 字段名称：IntegrationCode
|
|
|
备注
|
|
|
审核状态
|
|
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2023-12-01。
[null,null,["最后更新时间 (UTC)：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."]]],[]]
