结构化数据 - v7 - 广告系列

如需查看格式说明，请参阅概览。

字段	必需	类型	可写入	说明
广告系列 ID	仅在修改现有广告系列时才需要	integer	否	广告系列的数字 ID 值。如果留空，系统会创建一个新的广告系列 ID，并为其分配唯一 ID。（可选）在创建新的广告系列时，您可使用自定义标识符将广告订单分配给这个新广告系列。自定义标识符的格式为“ext[自定义标识符]”，例如 ext123。当文件上传并处理后，所有自定义标识符都将被替换为由 DBM 分配的 ID，并根据自定义标识符关联相应对象（例如，从广告订单到广告系列）。
广告客户 ID	是	integer	否	广告客户的数字 ID 值。必须是有效的现有广告客户 ID
名称	是	string	是	条目的名称。
时间戳	修改现有条目时必填	integer	否	条目的时间戳，系统使用它来验证条目在下载和上传期间是否未发生变化。
状态	是	string	是	条目的状态设置。 在线 已暂停 已归档
广告系列目标	是	string	是	选择其中一个适用的广告系列目标： 提高用户对我品牌或产品的认知度 提升在线操作量或访问量 推动线下或实体店销售 吸引用户安装应用或与之互动
广告系列目标 KPI	是	string	是	请选择适用的广告系列目标 KPI： 每千次展示费用 可见率 (%) CPIAVC 每次转化费用 CPC CTR 其他
广告系列目标 KPI 值	是	float	是	广告系列目标 KPI 的正数。对于广告系列目标 KPI“可见率 (%)”和“点击率”，请输入此字段的值（以百分比表示），例如，80% 将输入为“80”。对于“其他”KPI，此字段是对目标的简短说明。
广告素材类型	是	字符串、列表	是	您希望使用的广告素材类型的列表。 显示 视频 音频
广告系列预算	否	float	是	广告系列的预算金额为正数。它始终是货币金额的浮点数，因为它始终是货币预算。币种将以标准单位（而不是货币单位的 1/100 万）为单位显示广告客户的币种
广告系列开始日期	是	string	是	广告系列的开始日期，格式为 MM/DD/YYYY HH:mm
广告系列结束日期	否	string	是	广告系列的结束日期，格式为 MM/DD/YYYY HH:mm
已启用频次	是	string	是	为广告系列启用/停用基于展示次数的频次上限。 TRUE FALSE
广告展示频次	当“已启用频次”为“TRUE”时为必填项	integer	是	给定频次金额中展示次数的正整数，即“显示 y 时间段内的 x 次展示”中的 x。
频次时段	当“已启用频次”为“TRUE”时为必填项	string	是	指定频次上限的时间段单位。 上场时间（分钟） 小时 星期几 周 月 生命周期
频次金额	当“已启用频次”为“TRUE”时为必填项	integer	是	表示频次周期类型时间长度的正整数，即“显示 y 时间段内的 x 次展示”中的 y。
广告系列预算细分	否	字符串, 列表列表, string, list of lists	是	广告系列的预算期集。列表格式 =（ID；名称；类型；金额；开始日期；结束日期；外部预算来源；外部预算 ID；账单分组 ID；Prisma 客户代码；Prisma 产品代码；Prisma 估算代码；Prisma 类型；供应商；）。 示例“(; My Budget; IMPRESSIONS; 234; 01/01/2020 00:00; ; MEDIA_OCEAN; ExternalId; InvoiceId; Client; Product; Estimate; DISPLAY; MySupplier;)”，其中未提供 ID 和 End Date。 下表提供了可接受的值： 列名称 必需 说明 ID 否 广告系列预算细分的唯一 ID。修改预算期时必须提供此信息。如果留空，该预算期将被写为新的。 名称 是 广告系列预算细分的显示名称。 类型 是 预算金额的类型。可接受的值为： 金额 展示次数 金额 是 预算类型的正预算金额。这可以是简单的整数展示价值，也可以是表示货币金额的浮点数。币种将以标准单位（而不是货币单位的 1/100 万）为单位显示广告客户的币种。 开始日期 否 预算期排期的开始日期的时间戳，格式为 MM/DD/YYYY HH:mm。未设置的开始日期由空白字段值表示。 结束日期 否 预算期排期结束日期的时间戳，格式为 MM/DD/YYYY HH:mm。未设置的结束日期由空白字段值表示。 外部预算来源 是 预算细分的来源。可接受的值为： 无 Mediaocean 外部预算 ID 仅适用于 Mediaocean 预算期 设置后，如果客户选择采用预算细分级结算，那么根据此预算细分投放的所有展示次数将在账单上包含此 ID。 账单分组 ID 否 设置后，如果客户已选择采用预算细分级结算，则具有相同外部预算 ID 和账单分组 ID 的所有预算细分将汇总到单个账单中。 Prisma 客户端代码 仅适用于 Mediaocean 预算期 只能为 Mediaocean 预算期设置。Google 付款中心支持在此字段上搜索和过滤。 Prisma 产品代码 仅适用于 Mediaocean 预算期 只能为 Mediaocean 预算期设置。Google 付款中心支持在此字段上搜索和过滤。 Prisma 估算代码 仅适用于 Mediaocean 预算期 只能为 Mediaocean 预算期设置。Google 付款中心支持在此字段上搜索和过滤。 棱镜类型 仅适用于 Mediaocean 预算期 只能为 Mediaocean 预算期设置。线段的棱镜类型。可接受的值为： 显示 搜索 视频 音频 社交媒体 收费 Prisma 供应商 仅适用于 Mediaocean 预算期 只能为 Mediaocean 预算期设置。分配给该预算的实体（DSP、网站等）
受众特征定位性别	否	字符串、列表	是	要定位的性别列表。选择一个或多个可接受的值： 女性 男 未知
受众特征定位 - 年龄	否	字符串、列表	是	定位到用户年龄段。通过选择一个“开始”年龄和单个“结束”年龄以及是否包含未知年龄（true/false），可指定“开始”/“结束”范围。请查看可接受的“开始”/“结束”年龄列表。 示例 1：如果要定位 18-55 岁并包含未知年龄，请指定以下格式 {From; To ;Include known True/False} = 18;55;true; 示例 2：如果要仅定位 35 岁以上的用户并排除未知年龄，请指定以下 = 35;+;false;。 18 25 35 45 55 65 “收件人”的可接受值： 25 35 45 55 65 +
受众特征定位家庭收入	否	字符串、列表	是	定位家庭收入范围。通过选择单个 Top_of_Range 收入范围和一个 Bottom_of_Range 收入范围，以及是否包括收入未知的家庭（true/false），可以指定“from/to”范围。请查看可接受的 Top_of_Range/Bottom_of_Range 范围列表。 示例 1：要定位收入最高的前 10% 到 50% 的家庭，并包含收入未知的家庭，请指定以下格式 {Top_of_Range; Bottom_of_Range;包含未知 True/False} = Top 10%;41-50% Bottom_Range; true; 示例 2：仅包含家庭收入下限 收入最高的前 10% 11-20% 21-30% 31-40% 41-50% 收入较低的后 50%
受众特征定位的育儿状况	是	字符串、列表	是	要定位的育儿状况列表。选择一个或多个可接受的值。 育有子女 无子女 未知
地理位置定位 - 包含	否	字符串、列表	是	要纳入定位条件中的地理位置列表。 此列将 Display & Video 360 API TargetingOption 资源 ID 用于定位类型“TARGETING_TYPE_GEO_REGION”。 列表格式 =（定位选项.targetingOptionId; TargetingOption.targetingOptionId; 等）。此列表按数字顺序升序生成。
按地理位置定位 - 排除	否	字符串、列表	是	要在定位时排除的地理位置的列表。 此列将 Display & Video 360 API TargetingOption 资源 ID 用于定位类型“TARGETING_TYPE_GEO_REGION”。 列表格式 =（定位选项.targetingOptionId; TargetingOption.targetingOptionId; 等）。此列表按数字顺序升序生成。
语言定位 - 包含	否	字符串、列表	是	要包含在定位条件中的语言的列表。 此列将 Display & Video 360 API TargetingOption 资源 ID 用于定位类型“TARGETING_TYPE_LANGUAGE”。 列表格式 =（定位选项.targetingOptionId; TargetingOption.targetingOptionId; 等）。此列表按数字顺序升序生成。
语言定位 - 排除	否	字符串、列表	是	要在定位条件中排除的语言列表。 此列将 Display & Video 360 API TargetingOption 资源 ID 用于定位类型“TARGETING_TYPE_LANGUAGE”。 列表格式 =（定位选项.targetingOptionId; TargetingOption.targetingOptionId; 等）。此列表按数字顺序升序生成。
数字内容标签 - 排除	否	字符串、列表	是	要排除的数字内容标签的列表。列表格式 =（G;PG；等等）。 G PG T MA ?
品牌保障敏感度设置	否	string	是	选择敏感度设置，即可根据广告资源周围内容的主题来屏蔽广告资源。 不屏蔽 使用 Campaign Manager 360 Verification 使用自定义
品牌保障自定义设置	当“品牌保障自定义设置”为“使用自定义”时，必须提供	字符串、列表	是	如果“品牌保障敏感度设置”为“使用自定义内容”，请指定标准内容分类列表。例如：（色情、酒精饮料、烟草等）。 色情内容 诋毁性内容 下载内容与分享 武器 赌博 暴力内容 挑逗性内容 脏话 酒精饮料 毒品 烟草 政治 宗教 悲剧 交通事故 敏感的社会问题 骇人听闻
第三方验证服务	否	string	是	第三方验证服务提供商。 无 Integral Ad Science DoubleVerify Adloox
第三方验证标签	否	字符串、列表	是	如果第三方验证服务并非“无”，请指定所选提供商支持的标签列表。
可见度定位 Active View	否	string	是	目标预计可见度百分比。百分比以浮点数表示。{0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9} 中的一个
位置定位 - 在屏幕上展示	否	字符串、列表	是	屏幕上的展示广告位置定位。选择一个或多个可接受的值： 首屏 非首屏 未知
位置定位 - 视频在屏幕上	否	字符串、列表	是	屏幕上的视频广告位置定位。选择一个或多个可接受的值： 首屏 非首屏 未知
位置定位 - 在内容中显示位置	否	字符串、列表	是	要定位的展示广告内容位置。选择一个或多个可接受的值： 文章内嵌 信息流广告 横幅内嵌广告 插页式广告 未知
位置定位 - 内容中的视频位置	否	字符串、列表	是	要定位的视频广告内容位置。选择一个或多个可接受的值： 文章内嵌 信息流广告 横幅内嵌广告 插页式广告 未知的外播广告 前贴片广告 中贴片广告 后贴片广告 未知插播广告
广告资源来源定位 - 授权卖方选项	当“类型”为“展示”“视频”或“音频”时必填	string	是	用于定位授权直销商、授权直销商和转销商或授权卖方 + 未知的设置。“授权直销商”是指仅定位到授权卖方。“授权直销商和转销商”是指定位到授权卖方和转销商。“授权发布商及未参与此计划的发布商”是指它将定位到授权卖方、转销商和未知卖方。 授权直销商 授权直销商和转销商 授权发布商及未参与此计划的发布商
广告资源来源定位 - 包含	否	字符串、列表	是	要添加到定位条件的广告资源来源、广告交易平台和子广告交易平台的列表。 此列使用的是 Display & Video 360 API InventorySource 资源 ID、已发布的广告交易平台 ID 以及定位类型 TARGETING_TYPE_SUB_EXCHANGE 的 Display & Video 360 API TargetingOption 资源 ID。 列表格式 = (InventorySource.inventorySourceId; ExchangeId; TargetingOption.targetingOptionId; 等)
广告资源来源定位 - 排除	否	字符串、列表	是	要在定位范围中排除的广告资源来源、广告交易平台和子广告交易平台的列表。 此列使用的是 Display & Video 360 API InventorySource 资源 ID、已发布的广告交易平台 ID 以及定位类型 TARGETING_TYPE_SUB_EXCHANGE 的 Display & Video 360 API TargetingOption 资源 ID。 列表格式 = (InventorySource.inventorySourceId; ExchangeId; TargetingOption.targetingOptionId; 等)
广告资源来源定位 - 定位新的广告交易平台	否	string	是	用于定位新的广告交易平台的设置。 True False
环境定位	否	字符串、列表	是	要定位的环境的列表。选择一个或多个可接受的值。请注意，如果未选择“网络”，则无法选择“网络未优化”。 Web 未优化网站 应用