发送反馈
附录：按广告素材类型将用户界面字段映射到 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-04-09。
需要向我们提供更多信息？
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC)：2025-04-09。"],[[["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."]]],[]]
