自
2025 年 9 月 8 日起，每个新订单项都需要声明是否会投放欧盟 (EU) 政治广告。Display & Video 360 API 和未提供声明的 SDF 上传操作将会失败。如需详细了解如何更新集成以进行此声明，请参阅我们的
弃用页面。
附录：按广告素材类型将用户界面字段映射到 API 字段
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
下表将界面字段与相应的 API 字段进行了映射，以广告素材类型分隔。请注意，某些 API 字段需要通过为所提供资源分配的角色或类型进行进一步说明。
标准图片广告素材
| 广告素材类型：CREATIVE_TYPE_STANDARD |
| 托管来源：HOSTING_SOURCE_HOSTED |
|
姓名
|
|
|
广告素材资源
|
|
必填
|
|
API 字段名称：assets
|
|
资产角色：ASSET_ROLE_MAIN
|
|
|
着陆页网址
|
|
必填
|
|
API 字段名称：exitEvents[].url
|
|
退出事件类型：EXIT_EVENT_TYPE_DEFAULT
|
|
|
状态
|
|
|
附加的 HTML 跟踪代码
|
|
|
集成代码
|
|
可选
|
|
API 字段名称：integrationCode
|
|
| 备注
|
|
|
审核状态
|
|
HTML5 广告素材
| 广告素材类型：CREATIVE_TYPE_STANDARD |
| 托管来源：HOSTING_SOURCE_HOSTED |
|
姓名
|
|
|
广告素材资源
|
|
必填
|
|
API 字段名称：assets
|
|
资产角色：ASSET_ROLE_MAIN
|
|
|
状态
|
|
|
备用图片
|
|
可选
|
|
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 字段名称：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 字段名称：expandingDirection
|
|
|
当鼠标指针悬停时展开
|
|
可选
|
|
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_SOURCE_HOSTED |
|
姓名
|
|
|
状态
|
|
|
源文件
|
|
必填
|
|
API 字段名称：assets
|
|
资产角色：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 字段名称：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
|
|
| 备注
|
|
|
审核状态
|
|
原生展示广告素材
| 广告素材类型：CREATIVE_TYPE_NATIVE、CREATIVE_TYPE_NATIVE_SITE_SQUARE |
| 托管来源：HOSTING_SOURCE_HOSTED |
|
姓名
|
|
|
status
|
|
|
徽标
|
|
必填
|
|
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 跟踪广告
|
|
|
展示跟踪网址 1
|
|
可选
|
|
API 字段名称：trackingUrls[]
|
|
|
展示跟踪网址 2
|
|
可选
|
|
API 字段名称：trackingUrls[]
|
|
|
JavaScript 跟踪网址
|
|
|
集成代码
|
|
可选
|
|
API 字段名称：integrationCode
|
|
| 备注
|
|
|
审核状态
|
|
原生视频广告素材
| 广告素材类型：CREATIVE_TYPE_NATIVE_VIDEO |
| 托管来源：HOSTING_SOURCE_HOSTED |
|
姓名
|
|
|
状态
|
|
|
徽标
|
|
必填
|
|
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 字段名称：integrationCode
|
|
| 备注
|
|
|
审核状态
|
|
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-25。
[null,null,["最后更新时间 (UTC)：2025-07-25。"],[[["\u003cp\u003eThis 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.\u003c/p\u003e\n"],["\u003cp\u003eEach 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.\u003c/p\u003e\n"],["\u003cp\u003eCreative asset specifications, such as required and optional assets, are outlined for Native Video creatives, including details about their roles and corresponding API field names.\u003c/p\u003e\n"],["\u003cp\u003eCampaign Manager 360 tracking ad can optionally be included using the \u003ccode\u003ecmTrackingAd\u003c/code\u003e API field.\u003c/p\u003e\n"],["\u003cp\u003eThis mapping enables developers to understand how UI inputs translate into API data for seamless creative management and integration within the system.\u003c/p\u003e\n"]]],[],null,[]]
