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

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

字段必填类型可写入说明
广告系列 ID仅在修改现有广告系列时才需要integer否广告系列的数字 ID 值。如果留空，系统会创建新的广告系列 ID 并为其分配唯一 ID。（可选）在创建新的广告系列时，您可以使用自定义标识符将广告订单分配给新的广告系列。自定义标识符的格式为“ext[自定义标识符]”，例如 ext123。在文件上传和处理后，所有自定义标识符都将被替换为 DBM 分配的 ID，并且对象将根据自定义标识符关联（例如，从广告订单与广告系列）。
广告客户 ID是integer否广告客户的数字 ID 值。必须是有效的现有广告客户 ID
名称是字符串是条目的名称。
时间戳修改现有条目时必填integer否相应条目的时间戳。系统会使用此时间戳来验证相应条目在下载和上传期间是否未发生更改。
状态是字符串是条目的状态设置。
  • 有效
  • 已暂停
  • 已归档
广告系列目标是字符串是选择其中一个适用的广告系列目标：
  • 提高用户对我品牌或产品的认知度
  • 提升在线操作量或访问量
  • 推动线下或实体店销售
  • 吸引用户安装应用或与之互动
广告系列目标 KPI是字符串是请选择适用的广告系列目标 KPI 之一：
  • 每千次展示费用
  • 可见率 (%)
  • CPIAVC
  • 每次转化费用
  • 每次点击费用
  • 点击率
  • 其他
广告系列目标 KPI 值是float是广告系列目标 KPI 为正数。对于广告系列目标 KPI“可见率 (%)”和“点击率”输入此字段的值（以百分比表示），例如80% 将输入“80”。对于“其他”KPI，此字段是对目标的简短说明。
广告素材类型是字符串、列表是您希望使用的广告素材类型的列表。
  • 显示
  • 视频
  • 音频
广告系列预算否float是广告系列的正预算金额。货币金额始终是浮点数，因为它始终是货币预算。货币将以广告客户的币种以标准单位（而非货币单位的 1/1,000,000）显示
广告系列开始日期是字符串是广告系列的开始日期，格式为 MM/DD/YYYY HH:mm
广告系列结束日期否字符串是广告系列的结束日期，格式为 MM/DD/YYYY HH:mm
频次已启用是字符串是为广告系列启用/停用基于展示次数的频次上限。
  • TRUE
  • FALSE
频率曝光如果为“启用频率”时必填为“TRUE”integer是指定频次金额中展示次数的正整数量，即“在 y 周期内显示 x 次展示”中的 x。
频率时段如果为“启用频率”时必填为“TRUE”字符串是指定频次上限的时间段单位。
  • 分钟
  • 小时
  • 数天
  • 数周
  • 月份
  • 生命周期
频次如果“频次启用”为“TRUE”，则为必填项integer是频次周期类型的时长，即“在 y 个周期内展示 x 次”中的 y，是一个正整数。
广告系列预算期否字符串，列表列表是广告系列的预算期集。列表格式 =（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 和结束日期。
    以下表格提供了可接受的值：

    列名称必填说明
    ID否广告系列预算细分的唯一 ID。修改预算期时必须提供此字段。如果留空，系统会将预算期写入为新预算期。
    名称是广告系列预算期的显示名称。
    类型是预算金额的类型。可接受的值为：
    • 金额
    • 展示次数
    金额是相应预算类型的预算金额（正数）。展示次数可以是简单的整数值，也可以是表示货币金额的浮点值。货币将以标准单位（而不是货币单位的 1/1,000,000）以广告客户的货币显示。
    开始日期否预算细分的广告系列投放开始日期的时间戳，格式为 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 付款中心支持在此字段中执行搜索和过滤。
    Prisma 类型仅适用于 Mediaocean 预算期只能为 Mediaocean 预算期进行设置。细分的 Prisma 类型。可接受的值包括：
    • 显示
    • 搜索
    • 视频
    • 音频
    • 社交
    • 费用
    Prisma 供应商仅适用于 Mediaocean 预算期只能为 Mediaocean 预算期进行设置。分配到此预算的实体（需求方平台、网站等）
受众特征定位 - 性别否字符串、列表是要定位的性别列表。选择一个或多个可接受的值：
  • 女性
  • 男性
  • 未知
根据受众特征定位的年龄否字符串、列表是定位到用户年龄段。通过选择单个“起始年龄”和单个“到”年龄来指定“开始”/“结束”范围，以及是否包含未知的年龄（true/false）。查看可接受的“开始”/“结束”年龄列表。
示例 1：要定位 18-55 岁并包含未知年龄，请指定格式{From;收件人：包含未知 True/False} = 18;55;true;
示例 2：要仅定位 35 岁以上的用户并排除年龄未知的用户，请指定以下 = 35;+;false;。
“发件人”的可接受值：
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

“To”可接受以下值：
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
根据受众特征定位家庭收入否字符串、列表是定位到特定的家庭收入范围。通过选择单个 Top_of_Range 收入范围和 Bottom_of_Range 收入范围，可指定“开始/结束”范围，以及是否包含收入未知的家庭 (true/false)。请参阅可接受的 Top_of_Range/Bottom_of_Range 范围列表。
示例 1：若要定位收入排在前 10% 到 50% 的家庭，并包含收入未知的家庭，请指定格式为 {Top_of_Range; Bottom_of_Range; Include unknown True/False} = Top 10%;41-50%;true;
示例 2：若要仅定位收入排在后 50% 的家庭，并排除收入未知的家庭，请指定格式为 {Top_of_Range; Bottom_of_Range; Include unknown True/False} = Lower 50%;Lower 50%;true;
Top_of_Range/Bottom_of_Range 的可接受值：
  • 收入最高的前 10%
  • 11-20%
  • 21-30%
  • 31-40%
  • 41-50%
  • 收入较低的后 50%

受众特征定位 - 育儿状况是字符串、列表是要定位的生育情况列表。选择一个或多个可接受的值。
  • 育有子女
  • 无子女
  • 未知
按地理位置定位 - 包含否字符串、列表是

要包含在定位条件中的地理位置列表。

此列使用展示广告和定位类型 TARGETING_TYPE_GEO_REGION 的 Video 360 API TargetingOption 资源 ID。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表是按数字升序生成的。

按地理位置定位 - 排除否字符串、列表是

定位中要排除的地理位置列表。

此列针对定位类型 TARGETING_TYPE_GEO_REGION 使用 Display & Video 360 API TargetingOption 资源 ID。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.).此列表是按数字升序生成的。

语言定位 - 包含否字符串、列表是

要在定位条件中包含的语言列表。

此列针对定位类型 TARGETING_TYPE_LANGUAGE 使用 Display & Video 360 API TargetingOption 资源 ID。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.).此列表是按数字升序生成的。

语言定位 - 排除否字符串、列表是

要在定位条件中排除的语言列表。

此列使用展示广告和定位类型 TARGETING_TYPE_LANGUAGE 的 Video 360 API TargetingOption 资源 ID。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.).此列表是按数字升序生成的。

数字内容标签 - 排除否字符串、列表是要排除的数字内容标签列表。列表格式 = (G;PG; etc.)。
  • G
  • PG
  • T
  • MA
  • ?
品牌保障敏感度设置否字符串是选择敏感度设置来根据广告资源周围内容的主题屏蔽广告资源。
  • 不屏蔽
  • 使用 Campaign Manager 360 Verification
  • 使用自定义
品牌保障自定义设置如果选择“品牌保障自定义设置”，则必须启用为“使用自定义”字符串、列表是如果“品牌保障敏感度设置”设为“使用自定义”，请指定标准敏感内容类别列表。例如，（色情；酒精；烟草；等）。
  • 色情内容
  • 诋毁性内容
  • 下载内容和分享
  • 武器
  • 赌博
  • 暴力内容
  • 挑逗性内容
  • 脏话
  • 酒精饮料
  • 药品
  • 烟草
  • 政治
  • 宗教
  • 悲剧
  • 交通事故
  • 敏感的社会问题
  • 骇人听闻
第三方验证服务否字符串是第三方验证服务提供商。
  • 无
  • Integral Ad Science
  • DoubleVerify
  • Adloox
第三方验证标签否字符串、列表是如果“第三方验证服务”不是“无”，请指定所选提供商支持的标签列表。
Active View 可见度定位否字符串是指定预测的可见度百分比作为目标。百分比以浮点数表示。{0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9} 之一
位置定位 - 在屏幕上展示否字符串、列表是屏幕上的展示广告位置定位。请选择一个或多个可接受的值：
  • 首屏
  • 非首屏
  • 未知
位置定位 - 屏幕上的视频否字符串、列表是屏幕上的视频广告位置定位。请选择一个或多个可接受的值：
  • 首屏
  • 非首屏
  • 未知
位置定位 - 在内容中显示位置否字符串、列表是显示要定位的广告内容位置。选择一个或多个可接受的值：
  • 文章内嵌
  • 信息流广告
  • 横幅内嵌广告
  • 插页式广告
  • 未知
位置定位 - 内容中的视频位置否字符串、列表是要定位的视频广告内容位置。选择一个或多个可接受的值：
  • 文章内嵌
  • 信息流广告
  • 横幅内嵌广告
  • 插页式广告
  • 未知外播广告
  • 前贴片广告
  • 中贴片广告
  • 后贴片广告
  • 未知视频插播广告
广告资源来源定位 - 授权卖方选项在“类型”时必填为“展示广告”或“视频”或“音频”字符串是设为定位到授权直销商、授权直销商和转销商，或者授权卖方 + 未知。“授权直销商”表示仅定位到授权卖方。“授权直销商和转销商”是指针对授权卖方和转销商。“授权发布商及未参与此计划的发布商”表示将定位授权卖方、转销商和未知卖方。
  • 授权直销商
  • 授权直销商和转销商
  • 授权发布商及未参与此计划的发布商
广告资源来源定位 - 包含否字符串、列表是

要在定位条件中包含的广告资源来源、广告交易平台和子广告交易平台的列表。

此列使用展示广告和Video 360 API InventorySource 资源 ID、已发布的广告交易平台 ID 以及 Display &定位类型为 TARGETING_TYPE_SUB_EXCHANGE 的 Video 360 API TargetingOption 资源 ID。

列表格式 = (InventorySource.inventorySourceId; switchId; TargetingOption.targetingOptionId; etc.)

广告资源来源定位 - 排除否字符串、列表是

要排除在定位条件中的广告资源来源、广告交易平台和子广告交易平台的列表。

此列使用 Display & Video 360 API InventorySource 资源 ID、已发布的广告交易平台 ID 以及定位类型为 TARGETING_TYPE_SUB_EXCHANGE 的 Display & Video 360 API TargetingOption 资源 ID。

列表格式 = (InventorySource.inventorySourceId; switchId; TargetingOption.targetingOptionId; etc.)

广告资源来源定位 - 定位新的广告交易平台否字符串是设置为定位新的广告交易平台。
  • 正确
  • 错误
环境定位否字符串、列表是要定位的环境列表。请选择一个或多个可接受的值。请注意，“网站未优化”。
  • Web
  • 网站未优化
  • 应用