结构化数据 - v7.1 - 订单项

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

字段必需类型可写入说明
订单项 ID仅在修改现有订单项时才需要integer不支持此订单项的数字 ID 值。如果留空，系统会创建一个新订单项并为其分配唯一 ID。（可选）在创建新的订单项时，您可以使用自定义标识符将 TrueView 广告组分配给新的订单项。自定义标识符的格式为“ext[自定义标识符]”，例如 ext123。在文件上传并处理后，所有自定义标识符都将被替换为 DBM 分配的 ID，并且系统会根据自定义标识符关联对象（例如，广告组与订单项）。
Io ID是integer不支持广告订单的数字 ID 值。您可为要与该订单项同时创建的广告订单指定自定义标识符（例如，“ext[自定义广告订单标识符]”）。
Io 名称不支持string不支持广告订单名称
类型是string是条目类型。只能在创建时写入，无法修改。
  • 显示
  • 视频
  • TrueView
  • 音频
子类型是string是为区分不同格式的订单项需要填写的字段
  • 简约
  • 不可跳过
  • 操作
  • 覆盖面
  • 查看
  • 音频
  • OTT 服务
  • 移动应用安装
  • 移动应用购买
  • 简单至上
  • 不可跳过的页首横幅广告
  • 覆盖页首
  • 目标频次
名称是string是条目的名称。
时间戳修改现有条目时必填integer不支持条目的时间戳，系统使用它来验证该条目在下载和上传期间是否未发生更改。
状态是string是条目的状态设置。
  • 有效
  • 已暂停
  • 草稿
  • 已归档
开始日期是string是条目的排期开始日期的时间戳，格式为 MM/DD/YYYY 或“与广告订单相同”，以便使用与父级广告订单相同的开始日期。
结束日期是string是条目的排期结束日期的时间戳，格式为 MM/DD/YYYY 或“与广告订单相同”，以便使用与父级广告订单相同的结束日期。
预算类型是string是指定预算是基于货币还是基于展示次数。如果此条目的广告订单已启用自动分配预算功能，您可以将此设置设为“自动”，以允许 DBM 自动为此条目设置预算。
  • 金额
  • 展示次数
  • 无限制
  • 自动
  • TrueView 预算
预算金额如果“类型”为“展示”“视频”或“音频”，则必须提供float是相应预算类型的预算金额（正数）。展示次数可以是简单的整数值，也可以是表示货币金额的浮点值。货币将以标准单位（而不是货币单位的 1/1,000,000）以广告客户的货币显示。如果您在相应条目中设置了“自动”预算分配，则可以指定最低支出金额（例如“至少支出”此金额）。
进度是string是根据投放安排金额进行支出的时间段。
  • 每天
  • 每月
  • 机票
TrueView 订单项只能是“每日”或“排期”
投放速率是string是此条目的投放速率。
  • 尽快
  • 均匀
  • 提前
TrueView 订单项只能是“尽快”或“均匀”
投放量如果“类型”为“展示”“视频”或“音频”，则必须提供此值。当“类型”为“TrueView”且“投放安排”为“每日”时为必填项。float是根据投放安排类型设置的时间段的支出金额。
频次已启用是string是对订单项启用/停用基于展示的频次上限。
  • TRUE
  • FALSE
频率曝光当“启用频次”为“TRUE”时必填integer是指定频次金额中展示次数的正整数量，即“在 y 周期内显示 x 次展示”中的 x。
频率时段当“启用频次”为“TRUE”时必填string是指定频次上限的时间段单位。对于 TrueView 订单项，支持的时间段包括天、周、月。
  • 分钟
  • 小时
  • 星期几
  • 周
  • 月
  • 生命周期
频次金额当“启用频次”为“TRUE”时必填integer是表示频次时段类型时长的正整数，即“显示 y 周期内的 x 次展示”中的 y。TrueView 订单项不支持此金额。
已启用 TrueView 观看频次当“类型”为“TrueView”时，必填string是对 TrueView 订单项启用/停用基于观看次数的频次上限
  • TRUE
  • FALSE
TrueView 观看频次曝光次数当“已启用 TrueView 观看频次”为“TRUE”时必填integer是表示 TrueView 观看次数的正整数，即“在相应时间段内显示 x 次观看”中的 x
TrueView 观看频次时段当“已启用 TrueView 观看频次”为“TRUE”时必填string是指定基于 TrueView 观看次数的频次上限的时间段单位
  • 星期几
  • 周
  • 月
合作伙伴收入模式不支持string是合作伙伴收入模式是yon控制 Bid Manager 中收入计算方式的机制。使用合作伙伴收入模式可跟踪服务费的加价。如果加入“合作伙伴收入模式”列，则应指定列“合作伙伴收入金额”。
  • TMCM - 总媒体费用加价
  • MCM - 媒体费用加价
  • CPM - 每千次展示费用
合作伙伴收入金额仅当指定了“合作伙伴收入模式”列时才需要填写。float是与合作伙伴收入模式对应的正浮点值。仅在已指定“合作伙伴收入模式”列时适用。
转化计数类型当“类型”为“展示”“视频”“音频”或“TrueView”时，为必填项string是选择系统统计的转化类型。
  • 全部统计
  • 统计点击后活动
  • 数量百分比
转化计数百分比当“类型”为“展示”“视频”“音频”或“TrueView”时，为必填项float是为“计数百分比”转化计数类型指定百分比。将 % 的格式设置为浮点数 (3.123% = 3.123)，精确率限制为千位（小数点后 3 位）。
转化 Floodlight 活动 ID不支持字符串，列表列表是

用于转化和相关设置的 Floodlight 活动。

此列使用浏览后时间范围和点击后时间范围的 Display & Video 360 API FloodlightActivity 资源 ID 和衡量单位（以分钟为单位）。

列表格式 = ((FloodlightActivity.floodlightActivityId; view_window_minutes; click_window_minutes;);(FloodlightActivity.floodlightActivityId; view_window_minutes; click_window_minutes;);)。

主要归因模型 ID不支持integer是用于关联订单项的归因模型 ID。
费用不支持字符串，列表列表是此参评申请的所有费用。列表格式 = (费用类别; 费用金额; 费用类型; 已开具帐单;)。
  • 费用类别
    • 每千次展示费用
    • 媒体
  • 费用金额
    • 浮点数
    • Pct（以浮点数表示）
  • 费用类型
    • （字符串，请参阅费用表格）
  • 已开具帐单
    • True
    • False
    • 空白

示例“(CPM; 2; Display & Video 360 费用; False) ; (Media; 13; Default; True);”
下表提供了可接受的值：

费用类别费用类型帐单结算选项
每千次展示费用/媒体默认不允许（留空）
每千次展示费用/媒体第三方广告服务器不允许（留空）
每千次展示费用/媒体DoubleVerify允许 (True/False)
每千次展示费用/媒体Adsafe不允许（留空）
每千次展示费用/媒体AdXpose 费用不允许（留空）
每千次展示费用/媒体Vizu 费用不允许（留空）
每千次展示费用/媒体Aggregate Knowledge不允许（留空）
每千次展示费用/媒体Teracent不允许（留空）
每千次展示费用/媒体Evidon 费用不允许（留空）
每千次展示费用/媒体代理机构交易公司费用不允许（留空）
每千次展示费用/媒体Adloox允许 (True/False)
每千次展示费用ShopLocal必填 (True)
每千次展示费用TrustMetrics不允许（留空）
每千次展示费用Integral Ad Science视频允许 (True/False)
每千次展示费用MOAT视频不允许（留空）
媒体Display & Video 360 费用必填 (True)
媒体媒体费用数据不允许（留空）
媒体Scibids 费用必填 (True)
集成代码不支持string是用于跟踪目的的可选代码。
具体说明不支持string是字符串格式的条目详细信息。
出价策略类型如果“类型”为“展示”“视频”或“音频”，则必须提供string是 选择其中一个适用的出价策略：
  • 最大限度地降低：在用尽预算的同时，最大限度地降低每次转化费用/每次点击费用
  • 尽可能提高：在用尽预算的同时，最大限度地提高展示价值或优质展示
  • 超越：达到或超越每次转化费用/每次点击费用 X 的目标
  • 优化每千次可见展示费用：针对每千次可见展示费用出价 (X) 进行优化
  • 固定：指定固定出价 X
出价策略值必填，除非“出价策略类型”为“最小化”“最大化”或“类型”为“TrueView”float是对于“超越”“优化每千次可见展示费用”或“固定”策略类型，请为目标出价选择一个值。
请注意，对于“最大限度地降低”或“尽可能提高”出价策略类型，不需要指定出价策略价值
出价策略单元当“出价策略类型”为“节拍”、“最小化”或“最大化”时，为必填项string是对于“节拍”、“最小化”或“最大化”策略类型，请选择相应的单位：
  • 每次转化费用
  • 每次点击费用
  • 自定义展示次数值/费用
  • 完整播放且可见可听
  • IVO_TEN
  • AV_VIEWED
出价策略不得超过如果“类型”为“展示”“视频”或“音频”，则必须提供float是设置一个“不要超过”每千次展示费用值。如果为 0，则不启用“不超过”。仅当出价策略为“最小化”、“最大化”或“Beat”时，此字段才可用。
对交易应用底价如果“出价策略类型”为“最小化”或“最大化”，则必须提供string是是否优先处理交易而非公开竞价广告资源
  • TRUE
  • FALSE
算法 ID如果为“出价策略单元”自定义展示次数值/费用，则为必填项。integer是当出价策略单位设置为自定义展示次数值/费用时，必须使用相应的算法 ID。
广告素材分配不支持字符串、列表是

要分配给条目的广告素材 ID 的列表。

此列使用 Display & Video 360 API Creative 资源 ID。

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

上传时，用户还可以添加 Campaign Manager 360 展示位置 ID。展示位置 ID 应以字母“CM”开头，例如“CM789”。

例如(123;CM789;)。

按地理位置定位 - 包含不支持字符串、列表是

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

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

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

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

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

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

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

地理区域位置列表定位 - 包含不支持字符串、列表是要包含的地理区域区域地理位置列表 ID 列表。列表格式 = (11; 22; 33;)。
地理区域位置列表定位 - 排除不支持字符串、列表是要排除的地理区域位置列表 ID 列表。列表格式 = (11; 22; 33;)。
邻近区域定位不支持字符串，列表列表是每个邻近区域定位目标的列表，格式为“(Latitude; Longitude; Radius; Unit; FullAddress;);”。纬度在 -90 度到 90 度之间（含 -90 度和 90 度）；经度在 -180 度和 180 度之间（含此度）；半径以 1 度到 500 度（含）之间的距离为单位；单位可以是“mi”或“km”；FullAddress 选填。例如：“(38.907192; -77.03687; 1.0; mi; Washington D.C., 美国华盛顿；）；(40.712775; -74.005972; 20.5; 公里; 40.712775, -74.005972;); (20.000234; -56.675423; 5.0; mi; ;)。
邻近地理位置列表定位不支持字符串，列表列表是广告订单或非 TrueView 订单项的邻近区域列表定位条件列表，每个列表均采用“(ProximityListId; Radius; Unit; );”格式。ProximityListId 是广告客户资源下的地理位置列表 ID。半径是指介于 1 到 500（含）之间的距离，单位可以是“英里”或“公里”；除了地理位置区域位置列表，每个实体只能定位两个地理位置列表。例如：“(10041691678; 20.0; mi;); (10038858567; 20.5; km;);”。
语言定位 - 包含不支持字符串、列表是

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

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

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

语言定位 - 排除不支持字符串、列表是

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

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

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

设备定位 - 包含不支持字符串、列表是

要纳入定位条件的设备列表。

此列将 Display & Video 360 API TargetingOption 资源 ID 用于以下定位类型：

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

设备定位 - 排除不支持字符串、列表是

要在定位条件中排除的设备列表。

此列将 Display & Video 360 API TargetingOption 资源 ID 用于以下定位类型：

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

浏览器定位 - 包含不支持字符串、列表是

要在定位条件中包含的浏览器的列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID 作为定位类型 TARGETING_TYPE_BROWSER。

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

浏览器定位 - 排除不支持字符串、列表是

要在定位条件中排除的浏览器的列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID 作为定位类型 TARGETING_TYPE_BROWSER。

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

数字内容标签 - 排除不支持字符串、列表是要排除的数字内容标签列表。列表格式 = (G;PG; etc.)。
  • G
  • PG
  • T
  • MA
  • ?
品牌保障敏感度设置不支持string是选择敏感度设置来根据广告资源周围内容的主题屏蔽广告资源。
  • 不屏蔽
  • 使用 Campaign Manager 360 Verification
  • 使用自定义
品牌保障自定义设置当“品牌保障自定义设置”为“使用自定义设置”时，为必填项字符串、列表是如果“品牌保障敏感度设置”设为“使用自定义”，请指定标准敏感内容类别列表。例如，（“色情”“酒精饮料”“烟草”等）。
  • 色情内容
  • 诋毁性内容
  • 下载内容与分享
  • 武器
  • 赌博
  • 暴力
  • 挑逗性内容
  • 脏话
  • 酒精饮料
  • 毒品
  • 烟草
  • 政治
  • 宗教
  • 悲剧
  • 交通事故
  • 敏感的社会问题
  • 骇人听闻
第三方验证服务不支持string是第三方验证服务提供商。
  • 无
  • Integral Ad Science
  • DoubleVerify
  • Adloox
第三方验证标签不支持字符串、列表是如果“第三方验证服务”不是“无”，请指定所选提供商支持的标签列表。
渠道定位 - 包含不支持字符串、列表是

要包含在定位条件中的渠道列表。

此列使用 Display & Video 360 API Channel 资源 ID。

列表格式 = (Channel.channelId; Channel.channelId; etc.)。

渠道定位 - 排除不支持字符串、列表是

要在定位条件中排除的渠道的列表。

此列使用 Display & Video 360 API Channel 资源 ID。

列表格式 = (Channel.channelId; Channel.channelId; etc.)。

网站定位 - 包含不支持字符串、列表是

要包含在定位条件中的网站的列表。该列表是网址字符串。

列表格式 = (someurl.com; someurltwo.com; etc.)。此列表按字母顺序升序生成。

网站定位 - 排除不支持字符串、列表是

要在定位条件中排除的网站的列表。该列表是网址字符串。

列表格式 = (someurl.com; someurltwo.com; etc.)。此列表按字母顺序升序生成。

应用定位 - 包含不支持字符串、列表是

要包含在定位条件中的应用的列表。该列表是应用平台和应用平台 ID 的串联字符串。

以下值用于定义应用平台：

  • APP（包括 Android Play 商店平台和 Apple App Store 平台）
  • ROKU_APP
  • AMAZON_FIRETV_APP
  • XBOX_APP
  • PLAYSTATION_APP
  • APPLE_TV_APP
  • SAMSUNG_TV_APP
  • ANDROID_TV_APP
  • GENERIC_CTV_APP
  • LG_TV_APP
  • VIZIO_TV_APP
此 ID 由相关平台提供，例如 Android Play 商店中的软件包 ID（例如：com.google.android.gm）或 Apple App Store 中的应用 ID（例如：422689480）。

应用平台和 ID 的串联字符串之间用英文冒号分隔，例如：APP:com.google.android.gm。

列表格式 = (APP:com.google.android.gm; APP:422689480; 等)。此列表按字母顺序升序生成。

应用定位 - 排除不支持字符串、列表是

要在定位条件中排除的应用的列表。该列表是应用平台和应用平台 ID 的串联字符串。

以下值用于定义应用平台：

  • APP（包括 Android Play 商店平台和 Apple App Store 平台）
  • ROKU_APP
  • AMAZON_FIRETV_APP
  • XBOX_APP
  • PLAYSTATION_APP
  • APPLE_TV_APP
  • SAMSUNG_TV_APP
  • ANDROID_TV_APP
  • GENERIC_CTV_APP
  • LG_TV_APP
  • VIZIO_TV_APP
此 ID 由相关平台提供，例如 Android Play 商店中的软件包 ID（例如：com.google.android.gm）或 Apple App Store 中的应用 ID（例如：422689480）。

应用平台和 ID 的串联字符串之间用英文冒号分隔，例如：APP:com.google.android.gm。

列表格式 = (APP:com.google.android.gm; APP:422689480; 等)。此列表按字母顺序升序生成。

应用合集定位 - 包含不支持字符串、列表是

要包含在定位条件中的应用集合列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID 作为定位类型 TARGETING_TYPE_APP_CATEGORY。

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

应用合集定位 - 排除不支持字符串、列表是

要在定位条件中排除的应用集合列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID 作为定位类型 TARGETING_TYPE_APP_CATEGORY。

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

类别定位 - 包含不支持字符串、列表是

要包含在定位条件中的类别列表。此列使用 Display & Video 360 API TargetingOption 资源 ID 作为定位类型 TARGETING_TYPE_CATEGORY。

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

类别定位 - 排除不支持字符串、列表是要在定位条件中排除的类别列表。此列使用 Display & Video 360 API TargetingOption 资源 ID 作为定位类型 TARGETING_TYPE_CATEGORY。

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

内容类型定位 - 包含不支持字符串、列表是

要在定位条件中包含的内容类型列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID 作为定位类型“TARGETING_TYPE_CONTENT_GENRE”

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

内容类型定位 - 排除不支持字符串、列表是

要在定位条件中排除的内容类型的列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID 作为定位类型“TARGETING_TYPE_CONTENT_GENRE”

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

关键字定位 - 包含不支持字符串、列表是

要包含在定位条件中的关键字字符串列表。

此列表按字母顺序升序生成。

关键字定位 - 排除不支持字符串、列表是

要在定位条件中排除的关键字字符串列表。

此列表按字母顺序升序生成。

关键字列表定位 - 排除不支持字符串、列表是

要在定位条件中排除的否定关键字列表的列表。

此列使用 Display & Video 360 API NegativeKeywordList 资源 ID。

列表格式 = (否定关键字列表.否定关键字列表 ID; 否定关键字列表.否定关键字列表 ID 等)。此列表是按数字升序生成的。

优化型定位不支持string是启用优化型定位。
  • TRUE
  • FALSE
受众群体定位 - 包含不支持字符串，键值对列表是

要纳入到定位条件中的受众群体名单。

此列使用 Display & Video 360 API FirstAndThirdPartyAudience 资源 ID。

对于第一方受众群体名单，每个受众群体都会列为 FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId 和新近度设置对。一对为 (1;1d;)，其中 1d 是表示 1 天新近度的样本新近度。新近度不适用于第三方受众群体，因此名单格式为 (3;);(4;);。要对受众群体组执行“AND”和“OR”操作，请效仿以下示例：要组合有新近度和不新近度的键值对：'((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'。这表示（列表 1 具有 1 天新近度，或列表 2 具有 365 天新近度）AND（列表 3 没有指定新近度，或列表 4 具有 5 分钟新近度，或列表 5 包含所有用户）。

有效的新近度值为：

  • 全部
  • 1 分钟
  • 5 分钟
  • 10 分钟
  • 15m
  • 30m
  • 1 小时
  • 2 小时
  • 3 小时
  • 6 小时
  • 12 小时
  • 1 天
  • 2 天
  • 3 天
  • 5 天
  • 7 天
  • 10 天
  • 14 天
  • 15 天
  • 21 天
  • 28天
  • 30 天
  • 45 天
  • 60 天
  • 90 天
  • 120 天
  • 180 天
  • 270 天
  • 365 天
受众群体定位 - 排除不支持字符串，键值对列表是

要在定位条件中排除的受众群体名单。

此列使用 Display & Video 360 API FirstAndThirdPartyAudience 资源 ID。

如果受众群体名单是第一方受众群体名单，则每个受众群体都会列为 FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId 和新近度设置对。一对为 (1;1d;)，其中 1d 是表示 1 天新近度的样本新近度。不过，对于第三方受众群体，系统无法提供新近度，因此名单格式为 (3;);(4;);。

列表格式 = ((FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; recency optional;); (FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; recency optional;);)
示例："(1;1d;);(2;);"。

有效的新近度值为：

  • 全部
  • 1 分钟
  • 5 分钟
  • 10 分钟
  • 15m
  • 30m
  • 1 小时
  • 2 小时
  • 3 小时
  • 6 小时
  • 12 小时
  • 1 天
  • 2 天
  • 3 天
  • 5 天
  • 7 天
  • 10 天
  • 14 天
  • 15 天
  • 21 天
  • 28天
  • 30 天
  • 45 天
  • 60 天
  • 90 天
  • 120 天
  • 180 天
  • 270 天
  • 365 天
兴趣相似和有购买意向的定位 - 包含不支持字符串、列表是

要包含的兴趣相似受众群体名单和/或有购买意向的受众群体名单。

可以从 Display & Video 360 界面检索受众群体名单 ID。

列表格式 =（受众群体 ID；受众群体 ID；等等）。此列表是按数字升序生成的。

兴趣相似和有购买意向的定位 - 排除不支持字符串、列表是

要排除的兴趣相似的受众群体和/或有购买意向的受众群体名单。

可以从 Display & Video 360 界面检索受众群体名单 ID。

列表格式 =（受众群体 ID；受众群体 ID；等等）。此列表是按数字升序生成的。

组合的受众群体定位条件不支持字符串、列表是

要定位的组合受众群体名单。

此列使用 Display & Video 360 API CombinedAudience 资源 ID。

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

自定义名单定位不支持字符串、列表是

要定位的自定义列表的列表。

此列使用 Display & Video 360 API CustomList 资源 ID。

List format = (CustomList.customListId; CustomList.customListId; etc.). 此列表是按数字升序生成的。

广告资源来源定位 - 授权卖方选项如果“类型”为“展示”“视频”或“音频”，则必须提供string是设为定位到授权直销商、授权直销商和转销商，或者授权卖方 + 未知。“授权直接交易”是指仅定位到授权卖方。“授权直销商和转销商”指定位到授权卖方和转销商。“授权及未参与此计划的发布商”意味着将定位授权卖方、转销商和未知卖方。
  • 授权直销商
  • 授权直销商和转销商
  • 授权发布商及未参与此计划的发布商
广告资源来源定位 - 包含如果“类型”为“展示”“视频”或“音频”，则必须提供字符串、列表是

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

此列使用 Display & Video 360 API InventorySource 资源 ID、已发布的广告交易平台 ID 和定位类型为 TARGETING_TYPE_SUB_EXCHANGE 的 Display & 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.)

广告资源来源定位 - 定位新的广告交易平台不支持string是设置为定位新的广告交易平台。
  • True
  • False
私下交易组定位包含不支持字符串、列表是

要在定位条件中包含的已分组交易 ID 的列表。在订单项、广告订单和广告系列中，您可在“我的广告资源”下的“已分组的交易”部分以及“广告资源来源设置”的“组”部分中找到已分组的交易 ID。

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

时段定位不支持字符串、列表是

ID 列表，其中每个时段 ID 都按以下格式构建：
daypart_id = base_dayparting_id
15 - 1 - 0 -








“本地”）。对于现有实体，时区不会更改。

此列表是按数字升序生成的。

按时段定位时区如果添加了“时段定位”，则为必填项。string是用于时段定位的时区。
  • 局部
  • 广告客户
TrueView 订单项只能是“广告客户”。
环境定位不支持字符串、列表是要定位的环境列表。请选择一个或多个可接受的值。请注意，如果不选择“网站”，则无法选择“未优化网站”。
  • 网站
  • 网站未优化
  • 应用
已启用可见度 OMID 定位不支持string是仅定位到可通过 Open Measurement 标准衡量的展示。
  • TRUE
  • FALSE
Active View 可见度定位不支持string是定位到预计可见度百分比。百分比以浮点数表示。{0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9} 之一
位置定位 - 在屏幕上不支持字符串、列表是屏幕上的广告位置定位。请选择一个或多个可接受的值：
  • 首屏
  • 非首屏
  • 未知
位置定位 - 在内容中显示位置不支持字符串、列表是显示要定位的广告内容位置。请选择一个或多个可接受的值：
  • 文章内嵌
  • 信息流广告
  • 横幅内嵌广告
  • 插页式广告
  • 未知
位置定位 - 内容中的视频位置不支持字符串、列表是要定位的视频广告内容位置。请选择一个或多个可接受的值：
  • 文章内嵌
  • 信息流广告
  • 横幅内嵌广告
  • 插页式广告
  • 未知外播广告
  • 前贴片广告
  • 中贴片广告
  • 后贴片广告
  • 未知 In-Stream 广告
位置定位 - 内容中的音频位置不支持字符串、列表是要定位的音频广告内容位置。请选择一个或多个可接受的值：
  • 前贴片广告
  • 中贴片广告
  • 后贴片广告
  • 未知
视频播放器尺寸定位不支持字符串、列表是要定位的视频广告播放器尺寸列表。请选择一个或多个可接受的值：
  • 未知
  • small
  • 大
  • 高清
内容持续时间定位不支持字符串、列表是要定位的内容时长列表。单位值为分钟。请选择一个或多个可接受的值：
  • 0-1
  • 1-5
  • 5-15
  • 15-30
  • 30-60
  • 60+
  • 未知
内容流类型定位不支持字符串、列表是要定位的内容流类型列表。请选择一个或多个可接受的值：
  • 直播
  • 自助式培训
音频内容类型定位不支持字符串、列表是要定位的音频内容类型列表。请选择一个或多个可接受的值：
  • 未知
  • 在线电台
  • 在线音乐
  • 播客
根据受众特征定位的性别不支持字符串、列表是要定位的性别列表。请选择一个或多个可接受的值：
  • 女性
  • 男性
  • 未知
根据受众特征定位的年龄不支持字符串、列表是定位到用户年龄段。通过选择单个“起始年龄”和单个“到”年龄来指定“开始”/“结束”范围，以及是否包含未知的年龄（true/false）。查看可接受的“开始”/“结束”年龄列表。
示例 1：要定位 18-55 岁并包含未知年龄，请指定以下格式：{From; To ; Include known 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;Includeunknown True/False} = Top 10%;41-50%;true;
False 仅指定 Bottom_of_Ranges 的 Bottom_of_Range；
  • 收入最高的前 10%
  • 11-20%
  • 21-30%
  • 31-40%
  • 41-50%
  • 收入较低的后 50%

根据受众特征定位（生育情况）是字符串、列表是要定位的生育情况列表。请选择一个或多个可接受的值。
  • 父级
  • 无子女
  • 未知
网速定位不支持string是以特定的连接速度为目标。请选择某个可接受的值：
  • All
  • 2G
  • 3G
  • DSL
  • 4G
运营商定位 - 包含不支持字符串、列表是

要定位的 ISP 或运营商的列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID 作为定位类型 TARGETING_TYPE_CARRIER_AND_ISP。

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

运营商定位 - 排除不支持字符串、列表是

要排除的 ISP 或运营商的列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID 作为定位类型 TARGETING_TYPE_CARRIER_AND_ISP。

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

出价调节系数不支持字符串，列表列表是此条目的所有出价调节系数。列表格式 = (行类型;条件 ID;出价调节系数值); (行类型;条件 ID;出价调节系数值);。出价调节系数值可介于 0.1 到 10.0 之间。下表列出了可接受的行类型及其对应的条件 ID：
行类型维度条件 ID
app应用应用平台和应用平台 ID 的串联字符串。应用平台和 ID 的串联字符串之间用英文冒号分隔，例如：APP:com.google.android.gm。以下值用于定义应用平台：
  • APP（包括 Android Play 商店平台和 Apple App Store 平台）
  • ROKU_APP
  • AMAZON_FIRETV_APP
  • XBOX_APP
  • PLAYSTATION_APP
  • APPLE_TV_APP
  • SAMSUNG_TV_APP
  • ANDROID_TV_APP
  • GENERIC_CTV_APP
  • LG_TV_APP
  • VIZIO_TV_APP
应用平台和 ID 的串联字符串之间用英文冒号分隔。例如(app;APP:com.google.android.gm;1.0);(app;APP:422689480;2.5);
网站网址网站网址的字符串。例如(site;'someurl.com';1.0);(site;'someurltwo.com';2.5);
user_list受众群体名单用户列表 ID，例如(user_list;UserList.id;1.0);(user_list;UserList.id;2.5);
user_interest受众群体名单用户兴趣 ID，例如(user_interest;UserList.id;1.0);(user_interest;UserList.id;2.5);
custom_affinity受众群体名单自定义的兴趣相似受众群体 ID。例如(custom_affinity;CustomAffinity.id;1.0);(custom_affinity;CustomAffinity.id;2.5);
day_part广告时段时段 ID 在“时段定位”列中进行定义。例如，314159 表示“星期二，上午 10:15 - 下午 2:45”。例如：(day_part;314159;1.0);(day_part;302312;2.5);
age_range受众特征年龄段，以“从-到”的形式表示。可接受的值为：
  • 18-24
  • 25-34
  • 35-44
  • 45-54
  • 55-64 岁
  • 65 岁以上
  • 未知
（例如(age_range;55-64;1.0);(age_range;65+;2.5);
gender受众特征性别。可接受的值包括：
  • 男性
  • 女性
  • 未知
（例如(gender;Male;1.0);(gender;Female;2.5);
parental_status受众特征生育情况。可接受的值包括：
  • 父级
  • 无子女
  • 未知
（例如(parental_status;Not a parent;1.0);
household_income受众特征家庭收入百分位范围。可接受的值为：
  • 收入最高的前 10%
  • 11-20%
  • 21-30%
  • 31-40%
  • 41-50%
  • 收入较低的后 50%
  • 未知
（例如(household_income;Top 10%;1.0);(household_income;Unknown;2.5);
device_type设备类型设备类型。可接受的值为：
  • 计算机
  • 智能手机游戏
  • 平板电脑
  • 联网电视
  • 联网设备
（例如(device_type;Computer;1.0);(device_type;Tablet;2.5);
geo地理位置地理位置 ID，例如(geo;2840;1.0);
private_deal私下交易私下交易定位 ID。例如(private_deal;1016301;1.0);
private_deal私下交易私下交易定位 ID。例如(private_deal;1016301;1.0);
public_exchange公开广告交易平台公开广告交易平台 ID，例如(public_exchange;17;1.0);
unclassified_exchange未分类的广告交易平台未分类的广告交易平台目标 ID（= 5000 + Exchange_id）。例如(unclass_exchange;5017;1.0);
sub_exchange子广告交易平台格式为 [Exchange_id]-[sub_exchange_targeting_id]，例如。(sub_Exchange;38-4515403;1.0);
TrueView 视频广告格式对于 TrueView 订单项，是string是订单项的视频广告格式。

插播广告 / 信息流视频广告是按每次观看费用 (CPV) 出售的 TrueView 视频广告类型。插播广告 / 导视广告是按每千次展示费用 (CPM) 出售的 TrueView 视频广告类型。导视广告是按每千次展示费用 (CPM) 出售的视频广告，时长不超过 6 秒。不可跳过的视频广告是按每千次展示费用 (CPM) 出售且时长介于 6-15 秒之间的插播广告。对于按每千次展示费用 (CPM) 出售的“目标频次”订单项，插播广告 / 导视广告 / 不可跳过的视频广告是可接受的 TrueView 视频广告类型。自适应视频广告是以多种格式投放的广告类型。
  • 插播广告
  • 插播视频广告 / 信息流视频广告
  • 插播广告 / 导视广告
  • 导视广告
  • 不可跳过
  • 插播广告 / 导视广告 / 不可跳过的广告
  • 自适应广告
TrueView 出价策略类型对于 TrueView 订单项，是string是选择适用的 TrueView 出价策略之一：
  • 每次观看费用人工出价：基于观看次数的人工出价，即按观看次数付费。
  • 每千次展示费用人工出价：基于展示的人工出价，即按每千次展示付费。新的 TrueView 订单项不支持此值。
  • 目标每千次展示费用：一种自动出价策略，可根据您愿意为广告获得的每千次展示支付的金额来优化出价，帮助您获得尽可能多的展示次数。
  • “尽可能提高转化次数”出价策略：这是一种自动出价策略，可优化出价以帮助您争取尽可能多的转化。
  • 目标每次转化费用：一种自动出价策略，它会根据您愿意为每次转化支付的目标金额来优化出价，帮助您争取尽可能多的转化。
  • 尽可能提高转化价值：基于价值的自动出价策略，以促成更高价值的转化为目标进行优化。
  • “目标广告支出回报率”出价策略：一种基于价值的出价策略，可针对更高的转化价值进行优化。
TrueView 出价策略价值对于 TrueView 订单项，是float是对于“目标每次转化费用”或“目标广告支出回报率”出价策略类型，请选择目标出价的值。对于其他“TrueView 出价策略类型”值或非 TrueView 订单项，在上传时此列应为 0。对于“目标广告支出回报率”出价策略，此列应以百分比表示。例如，如果您想要将目标广告支出回报率设置为 150%，请在此列中输入 1.5。
TrueView 移动设备出价调整选项不支持string是“提高”或“降低”
  • 增加
  • 减少
TrueView 移动设备出价调整百分比当 TrueView 出价策略类型为“目标每次转化费用”或“尽可能提高转化次数”时，是integer是用于增加在移动设备上展示广告的机会的出价调整。可接受的调整幅度包括：出价调整选项“提高”为 [0;900%]；“降低”为 [0;90%] 或 100%。
如果 TrueView 出价策略类型是“目标每次转化费用”或“尽可能提高转化次数”，那么可接受的调整选项包括：出价调整选项“提高”为 0；“降低”为 100%。
TrueView 桌面设备出价调整选项不支持string是“提高”或“降低”
  • 增加
  • 减少
TrueView 桌面设备出价调整百分比当 TrueView 出价策略类型为“目标每次转化费用”或“尽可能提高转化次数”时，是integer是用于增加在桌面设备上展示广告的几率的出价调整。可接受的调整幅度包括：出价调整选项“提高”为 [0;900%]；“降低”为 [0;90%] 或 100%。
如果 TrueView 出价策略类型是“目标每次转化费用”或“尽可能提高转化次数”，那么可接受的调整选项包括：出价调整选项“提高”为 0；“降低”为 100%。
TrueView 平板电脑出价调整选项不支持string是“提高”或“降低”
  • 增加
  • 减少
TrueView 平板电脑出价调整百分比当 TrueView 出价策略类型为“目标每次转化费用”或“尽可能提高转化次数”时，是integer是用于增加在平板电脑上展示广告的机会的出价调整。可接受的调整幅度包括：出价调整选项“提高”为 [0;900%]；“降低”为 [0;90%] 或 100%。
如果 TrueView 出价策略类型是“目标每次转化费用”或“尽可能提高转化次数”，那么可接受的调整选项包括：出价调整选项“提高”为 0；“降低”为 100%。
TrueView 联网电视出价调整选项不支持string是“提高”或“降低”
  • 增加
  • 减少
TrueView 联网电视出价调整百分比当 TrueView 出价策略类型为“目标每次转化费用”或“尽可能提高转化次数”时，是integer是用于增加在联网电视上展示广告几率的出价调整。可接受的调整幅度包括：出价调整选项“提高”为 [0;900%]；“降低”为 [0;90%] 或 100%。
如果 TrueView 出价策略类型是“目标每次转化费用”或“尽可能提高转化次数”，那么可接受的调整选项包括：出价调整选项“提高”为 0；“降低”为 100%。
TrueView 类别排除定位不支持字符串、列表是要排除的类别列表。列表格式 = 游戏；悲剧性事件和冲突；等等
  • 嵌入式视频
  • 直播
  • 游戏
  • 家庭
  • 所有受众群体
  • 年龄较小的青少年
  • 青少年
  • 成人
  • 尚未分级
TrueView 内容过滤器不支持string是TrueView 内容过滤器。
  • 受限
  • 标准
  • 已展开
TrueView 广告资源来源定位不支持字符串、列表是要包含的 TrueView 广告资源来源列表
  • YouTube
  • Google TV
  • 视频合作伙伴
TrueView 第三方可见度衡量服务供应商仅在修改现有 TrueView 订单项时才需要字符串，列表列表是衡量 TrueView 订单项可见度的第三方供应商。如果在创建 TrueView 订单项期间将此字段留空，并且已在广告客户级启用了默认可见度供应商，则系统会在创建订单项时启用广告客户级默认供应商。
  • 无
  • Moat
  • DoubleVerify
  • Integral Ad Science
TrueView 第三方可见度报告 ID当第三方可见度衡量服务供应商不是“无”时，会是。string是您的第三方可见度供应商用于识别特定报告中的事件的 ID。空字符串在此列中有效，这会将报告 ID 设置为空。
TrueView 第三方品牌保障服务供应商仅在修改现有 TrueView 订单项时才需要字符串，列表列表是衡量 TrueView 订单项的品牌保障能力的第三方供应商。如果您在创建 TrueView 订单项期间将此字段留空，并且已在广告客户级启用了默认的品牌保障供应商，则系统会在创建订单项时启用广告客户级默认供应商。
  • 无
  • DoubleVerify
  • Integral Ad Science
  • Zefr
TrueView 第三方品牌保障报告 ID当第三方品牌保障服务供应商不是“无”时，是的。string是您的第三方品牌保障服务供应商用于标识特定报告中的事件的 ID。空字符串在此列中有效，这会将报告 ID 设置为空。
TrueView 第三方覆盖面衡量服务供应商仅在更新现有 TrueView 订单项时才需要字符串，列表列表是衡量 TrueView 订单项覆盖面的第三方供应商。如果在创建 TrueView 订单项期间将此字段留空，并且已在广告客户级启用了默认覆盖率供应商，则系统会在创建订单项时启用广告客户级默认供应商。
  • 无
  • Nielsen
  • Comscore
  • Kantar
  • Gemius
  • Video Research
  • 媒体范围
  • AudienceProject
  • iSpot 电视
  • VideoAmp
TrueView 第三方覆盖面报告 ID当第三方覆盖面衡量服务供应商不是“无”时，会是。string是您的第三方覆盖面衡量服务供应商用于标识特定报告中的事件的 ID。空字符串在此列中有效，这会将报告 ID 设置为空。
TrueView 第三方品牌提升效果衡量服务供应商仅在更新现有 TrueView 订单项时才需要字符串，列表列表是衡量 TrueView 订单项的品牌提升效果的第三方供应商。如果在创建 TrueView 订单项期间将此字段留空，并且已在广告客户级启用了默认品牌提升供应商，则系统会在创建订单项时启用广告客户级默认供应商。
  • 无
  • Kantar
  • Dynata
  • Intage
  • Nielsen
  • Macromill
TrueView 第三方品牌提升报告 ID当第三方品牌提升效果衡量服务供应商不是“无”时，是的。string是您的第三方品牌提升效果衡量服务供应商用于标识特定报告中的事件的 ID。空字符串在此列中有效，这会将报告 ID 设置为空。
TrueView 目标频次计数当订单项子类型为“目标频次”时，是integer是为“目标频次”类型的 YouTube 订单项设置的目标频次计数。此字段只能设置为值 2、3 或 4。对于非“目标频次”类型的 YouTube 订单项，此字段应为空。
TrueView 目标频次时间范围当订单项子类型为“目标频次”时，是string是采用“目标频次”类型的 YouTube 订单项的目标频次时间范围。此字段目前只能设置为“每周”。对于不是“目标频次”类型的 YouTube 订单项，此字段应为空。
  • 每周
TrueView 视频广告资源控制当 TrueView 订单项子类型为“覆盖面”且使用信息流广告和 Shorts 广告时，会用到字符串、列表是此订单项的视频广告资源控件。请选择一个或多个可接受的广告格式值：
  • 插播广告
  • 信息流广告
  • Shorts