如需了解格式说明，请参阅概览。
| 字段 | 必需 | 类型 | 可写入 | 说明 |
|---|---|---|---|---|
| 广告系列 ID | 仅当修改现有广告系列时才必须指定这项设置 | 整数 | 否 | 广告系列的数字 ID 值。如果留空，系统会创建一个新广告系列 ID 并为其分配唯一 ID。 （可选）创建新广告系列时，您可以使用自定义标识符为新广告系列分配订单项。 自定义标识符的格式为“ext[自定义标识符]”，例如 ext123。 待文件被上传并处理后，系统会将所有自定义标识符替换为由 DBM 分配的 ID，并会根据所用的自定义标识符将相关对象关联起来（例如，将订单项与广告系列关联）。 |
| 广告客户 ID | 是 | 整数 | 否 | 广告客户的数字 ID 值。必须是有效的现有广告客户 ID |
| 名称 | 是 | 字符串 | 是 | 条目的名称。 |
| 时间戳 | 修改现有条目时必须指定这项设置 | 整数 | 否 | 条目的时间戳。系统会使用此时间戳来验证相应条目在下载和上传期间是否未发生更改。 |
| 状态 | 是 | 字符串 | 是 | 条目的状态设置。
|
| 广告系列目标 | 是 | 字符串 | 是 | 选择一个适用的广告系列目标：
|
| 广告系列目标 KPI | 是 | 字符串 | 是 | 选择一个适用的广告系列目标 KPI：
|
| 广告系列目标 KPI 值 | 是 | float | 是 | 广告系列目标 KPI 的正数。对于广告系列目标 KPI“可见率 (%)”和“点击率”，请以百分比形式输入此字段的值，例如 80% 应输入为“80”。对于 KPI“其他”，此字段是对目标的简短说明。 |
| 广告素材类型 | 是 | 字符串、列表 | 是 | 您希望使用的广告素材类型列表。
|
| 广告系列预算 | 否 | float | 是 | 广告系列的正预算金额。由于预算始终是货币预算，因此始终是 float。货币将以广告客户的币种显示，单位为标准单位（而不是货币单位的 1/1,000,000） |
| 广告系列开始日期 | 是 | 字符串 | 是 | 广告系列的开始日期，格式为 MM/DD/YYYY HH:mm |
| 广告系列结束日期 | 否 | 字符串 | 是 | 广告系列的结束日期，格式为 MM/DD/YYYY HH:mm |
| 已启用频次上限 | 是 | 字符串 | 是 | 启用/停用基于展示次数的广告系列频次上限。
|
| 频次上限曝光次数 | 当“已启用频次上限”为“TRUE”时，必须指定这项设置 | 整数 | 是 | 给定频次上限金额的展示次数的正整数金额，即“在 y 时间段内展示 x 次”中的 x。 |
| 频次上限时间段 | 当“已启用频次上限”为“TRUE”时，必须指定这项设置 | 字符串 | 是 | 指定频次上限的时间段单位。
|
| 频次上限金额 | 当“已启用频次上限”为“TRUE”时，必须指定这项设置 | 整数 | 是 | 频次上限时间段类型的时长对应的正整数金额，即“在 y 时间段内展示 x 次”中的 y。 |
| 受众特征定位 - 性别 | 否 | 字符串、列表 | 是 | 要定位到的性别列表。选择一个或多个可接受的值：
|
| 受众特征定位 - 年龄 | 否 | 字符串、列表 | 是 | 定位到用户年龄段。通过选择单个“起始”年龄和单个“结束”年龄，并指定是否纳入未知年龄（true/false），来指定“起始”/“结束”范围。请参阅可接受的“起始”/“结束”年龄列表。 示例 1：若要定位到 18-55 岁，并纳入未知年龄，请指定格式 {起始; 结束; 纳入未知年龄 True/False} = 18;55;true; 示例 2：若要仅定位到 >35 岁的用户，并排除未知年龄，请指定以下内容 = 35;+;false;。 “起始”的可接受值：
“结束”的可接受值：
|
| 受众特征定位 - 家庭收入 | 否 | 字符串、列表 | 是 | 定位到家庭收入范围。通过选择单个“范围上限”收入范围和单个“范围下限”收入范围，并指定是否纳入收入未知的家庭（true/false），来指定“起始”/“结束”范围。请参阅可接受的“范围上限”/“范围下限”范围列表。 示例 1：若要定位到收入最高的前 10% 到 50% 的家庭，并纳入收入未知的家庭，请指定格式 {范围上限; 范围下限; 纳入未知 True/False} = Top 10%;41-50%;true; 示例 2：若要仅定位到收入较低的后 50% 的家庭，并排除收入未知的家庭，请指定格式 {范围上限; 范围下限; 纳入未知 True/False} = Lower 50%;Lower 50%;true; “范围上限”/“范围下限”的可接受值：
|
| 受众特征定位 - 育儿状况 | 是 | 字符串、列表 | 是 | 要定位到的育儿状况列表。 选择一个或多个可接受的值。
|
| 地理位置定位 - 纳入 | 否 | 字符串、列表 | 是 | 要纳入定位范围的地理位置列表。列表格式 = (GeoLocation.id; GeoLocation.id;etc.)。 |
| 地理位置定位 - 排除 | 否 | 字符串、列表 | 是 | 要从定位范围中排除的地理位置列表。列表格式 = (GeoLocation.id;GeoLocation.id; etc.)。 |
| 语言定位 - 纳入 | 否 | 字符串、列表 | 是 | 要纳入定位范围的语言列表。列表格式 = (Language.id;Language.id;etc.)。 |
| 语言定位 - 排除 | 否 | 字符串、列表 | 是 | 要从定位范围中排除的语言列表。列表格式 = (Language.id;Language.id;etc.)。 |
| 品牌保障标签 | 否 | 字符串、列表 | 是 | 要定位到的数字内容标签列表。列表格式 = (G;PG; etc.)。
|
| 品牌保障敏感度设置 | 否 | 字符串 | 是 | 选择敏感度设置，以根据广告资源周围内容的主题来屏蔽广告资源。
|
| 品牌保障自定义设置 | 当“品牌保障自定义设置”为“使用自定义”时，必须指定这项设置 | 字符串、列表 | 是 | 如果“品牌保障敏感度设置”为“使用自定义”，请指定标准内容分类器的列表。例如，(Adult;Alcohol;Tobacco;etc.)。
|
| 第三方验证服务 | 否 | 字符串 | 是 | 第三方验证服务提供商。
|
| 第三方验证标签 | 否 | 字符串、列表 | 是 | 如果“第三方验证服务”不是“无”，请指定所选提供商支持的标签列表。 |
| 可见度定位 - Active View | 否 | 字符串 | 是 | 定位到预计的可见度百分比。百分比以 float 表示。{0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9} 之一 |
| 可见度定位 - 广告位置 - 纳入 | 否 | 字符串 | 是 | 定位到广告位置。选择一个或多个可接受的值，也可以不选择任何值：
|
| 可见度定位 - 广告位置 - 排除 | 否 | 字符串 | 是 | 在定位范围中排除广告位置。选择一个或多个可接受的值，也可以不选择任何值：
|
| 广告资源来源定位 - 仅限授权卖方 | 当“类型”为“显示”“视频”或“音频”时，必须指定这项设置 | 字符串 | 是 | 设置定位到仅限授权卖方、授权卖方和转销商，或授权卖方 + 未知。“授权直销商”表示仅定位到授权卖方。TRUE 表示定位到授权卖方和转销商。FALSE 表示定位到授权卖方、转销商和未知卖方。
|
| 广告资源来源定位 - 纳入 | 否 | 字符串、列表 | 是 | 要纳入定位范围的广告资源列表。列表格式 = (InventorySource.id; InventorySource.id;)。 |
| 广告资源来源定位 - 排除 | 否 | 字符串、列表 | 是 | 要从定位范围中排除的广告资源列表。列表格式 = (InventorySource.id; InventorySource.id;)。 |
| 广告资源来源定位 - 定位新的广告交易平台 | 否 | 字符串 | 是 | 设置定位到新的广告交易平台。
|
| 环境定位 | 当“类型”为“显示”“视频”或“音频”时，必须指定这项设置 | 字符串、列表 | 是 | 要定位到的环境列表。列表格式 = (Desktop Web; Mobile App; etc.)。 对于显示环境：
|