展示广告和Video 360 API v2 将于
2024 年 9 月 3 日停用。请在此之前
迁移到 v3,以免服务中断。
附录:按广告素材类型将用户界面字段映射到 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。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{
"last_modified": "最后更新时间 (UTC):2023-12-01。",
"state": ""
}