如需了解格式，请参阅概览。
| 字段 | 必填 | 类型 | 可写入 | 说明 |
|---|---|---|---|---|
| 广告 ID | 仅在修改现有广告时为必需字段 | integer | 否 | 广告组广告的数字 ID 值。如果留空，系统会创建一个新广告并为其分配唯一 ID。 |
| 广告组 ID | 是 | integer | 否 | 父广告组的数字 ID 值。您可为要与此广告同时创建的广告组指定一个自定义标识符（例如，“ext[custom ad group ID]”）。 |
| 广告组名称 | 否 | 字符串 | 否 | 广告组名称 |
| 名称 | 是 | 字符串 | 是 | 条目的名称。 |
| 状态 | 是 | 字符串 | 是 | 相应条目的状态设置。
|
| 广告类型 | YouTube 广告和需求开发广告必需的 | 字符串 | 是 | 广告的广告格式。 插播视频广告和信息流广告是按每次观看费用 (CPV) 出售的 YouTube 视频广告类型。导视广告是时长不超过 6 秒的 YouTube 视频广告，按每千次展示费用 (CPM) 出售。不可跳过的视频广告是时长介于 6 到 15 秒之间的插播 YouTube 广告，按每千次展示费用 (CPM) 出售。YouTube 音频广告是 YouTube 广告。自适应视频广告是一种 YouTube 广告类型，可采用多种格式投放。如果视频时长足够短，经济实惠地扩大覆盖面广告将作为 YouTube 导视广告投放；否则，将作为 YouTube 插播广告投放。需求开发视频广告以多种格式投放，包括但不限于 YouTube。需求开发图片广告会展示图片。需求开发轮播广告会展示卡片。需求开发产品广告会展示商品。 请选择以下值之一：
|
| 视频 ID | YouTube 广告和需求开发视频广告的必需属性 | 字符串 | 是 | 广告所用 YouTube 视频的 ID。 每个 YouTube 视频 ID 还可以与一个合成内容证明状态值配对，该值用于指定在受当地 AI 标签法规约束的地区投放视频时，是否要为视频添加标签，表明视频是由 AI 创建或编辑的：
如果为某个 YouTube 视频 ID 提供的值为“ON”或“OFF”，相应证明将应用于相应广告客户名下对该 YouTube 视频 ID 的所有现有使用情况。如需详细了解，请参阅使用 SDF 在广告中添加 AI 标签。 列表格式 = (YouTube 视频 ID；合成内容证明状态)；(YouTube 视频 ID；合成内容证明状态)；等等） 例如：“(abdefg; ON);(hijlk; OFF);(mnopq;)” |
| 显示网址 | 是，适用于插播广告和导视广告 | 字符串 | 是 | 广告显示网址 |
| 着陆页网址 | 插播广告、导视广告和需求开发广告必需 | 字符串 | 是 | 广告着陆页网址 |
| DCM 跟踪 - 展示位置 ID | 仅在更新 DCM 跟踪广告时为必需 | integer | 是 | 相应跟踪广告的 DCM 展示位置的数字 ID 值。 如需移除 DCM 跟踪广告，请将“DCM 跟踪 - 展示位置 ID”“DCM 跟踪 - 广告 ID”和“DCM 跟踪 - 广告素材 ID”这三列留空。 |
| DCM 跟踪 - 广告 ID | 仅在更新 DCM 跟踪广告时为必需 | integer | 是 | 相应跟踪广告的 DCM 广告的数字 ID 值。如需移除 DCM 跟踪广告，请将“DCM 跟踪 - 展示位置 ID”“DCM 跟踪 - 广告 ID”和“DCM 跟踪 - 广告素材 ID”这三列留空。 |
| DCM 跟踪 - 广告素材 ID | 仅在更新 DCM 跟踪广告时为必需 | integer | 是 | 相应跟踪广告的广告素材的数字 ID 值。如需移除 DCM 跟踪广告，请将“DCM 跟踪 - 展示位置 ID”“DCM 跟踪 - 广告 ID”和“DCM 跟踪 - 广告素材 ID”这三列留空。 |
| 点击跟踪代码网址 | 否 | 字符串 | 是 | 广告点击跟踪代码网址 |
| 点击跟踪代码网址参数 | 否 | 字符串，列表的列表 | 是 | 点击跟踪代码网址自定义参数。格式 = (name1; value1;); (name2; value2;); 等等。 |
| 号召性用语 | 当“标题”不为空或“广告类型”为“需求开发视频广告”“需求开发图片广告”“轮播式需求开发广告”时，此属性为必需属性 | 字符串 | 是 | 号召性用语按钮的标签（1 行，最多 10 个字符）。 |
| 标题 | 需求开发广告的必需属性 | 字符串 | 是 | 号召性用语重叠式广告的标题（1 行，最多 15 个字符）。 |
| 显示网址路径 1 | 否 | 字符串 | 是 | 显示网址路径 1 |
| 显示网址路径 2 | 否 | 字符串 | 是 | 显示网址路径 2 |
| 信息流视频缩略图 | 是（适用于信息流视频广告） | 字符串 | 是 | 用于视频发现广告的视频缩略图
|
| 信息流视频广告标题 | 信息流视频广告和需求开发广告必需 | 字符串 | 是 | 发现广告或自适应广告的标题文字，或需求开发广告的长标题。 |
| 广告内容描述第 1 行 | 信息流视频广告和需求开发广告必需 | 字符串 | 是 | 发现广告内容描述 1 的文字或自适应广告内容描述 |
| 广告内容描述 2 | 信息流视频广告必需 | 字符串 | 是 | 发现广告内容描述 2 的文本 |
| 信息流视频广告着陆页 | 是（适用于信息流视频广告） | 字符串 | 是 | 发现广告着陆页 |
| 移动着陆页网址 | 否 | 字符串 | 是 | 适用于移动设备的广告着陆页网址 |
| 商家名称 | 如果未在广告客户一级设置，则需求开发广告必须设置此项 | 字符串 | 是 | 所宣传的商家的名称。如果未设置此列，且广告客户级设置了默认值，则系统会应用该默认值。 自 2026 年 10 月 12 日起，如果未在广告客户级设置此列，则所有 YouTube 自适应广告都必须设置此列。 |
| 着陆页网址后缀 | 否 | 字符串 | 是 | 着陆页网址的后缀 |
| 徽标资产 ID | 如果未在广告客户一级设置，则需求开发广告必须设置此项 | 字符串、列表 | 是 | 徽标的资产 ID 列表。此列表按升序数字顺序生成。如果未设置此列，且广告客户级设置了默认值，则系统会应用该默认值。 自 2026 年 10 月 12 日起，如果未在广告客户级设置此列，则所有 YouTube 自适应广告都必须设置此列。 |
| 营销图片素材资源 ID | 当“广告类型”为“需求开发图片广告”时为必需 | 字符串、列表 | 是 | 营销图片的资产 ID 列表。此列表按升序生成。 |
| 需求开发广告卡片 | 当“广告类型”为“轮播式需求开发广告”时为必需 | 字符串，列表的列表 | 是 | 这会定义一个卡片列表，格式如下： （最终到达网址；最终到达移动网址；网址；标题；号召性用语文字；营销图片素材资源 ID；其他营销素材资源 ID…）。 例如：(google.com; mobile.google.com; Headline; Click Here; 10020; 20020; 30020)。每项营销资产都必须具有独特的宽高比。如果某则广告下的一张卡片包含方形营销图片，那么该广告下的所有卡片都必须包含方形营销图片（这也适用于其他宽高比）。 |
| 随播横幅广告素材资源 ID | 否 | 字符串、列表 | 是 | 随播横幅广告的资产 ID 列表。此列表按升序数字顺序生成。此功能适用于视频效果广告、需求开发视频广告、插播广告、导视广告和不可跳过的广告。列表格式 = 100; 200; |
| 暂停时广告图片素材资源 ID | 否 | 字符串、列表 | 是 | 暂停时广告图片的资产 ID 列表。 例如：(100;200;300;) SDF 对即时交易订单项及其广告组和广告的支持目前处于 Beta 版阶段，仅适用于已列入许可名单的合作伙伴。即时交易订单项下的广告不会包含在下载的文件中，必须通过 Display & Video 360 界面的 YouTube 即时交易创建工作流程上传。 |
| 父级广告素材 ID | 否 | integer | 否 | 父级 Display & Video 360 广告素材的数字 ID 值。 |