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

有关格式说明，请参阅概览。

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