自
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。
需要向我们提供更多信息？ [[["易于理解","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-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,[]]
