结构化数据 - v6 - 广告订单

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

字段必填类型可写入说明
IoID仅当修改现有广告订单时才需填写integer否广告订单的数字 ID 值。如果留空，系统会创建一个新广告订单 ID，并为其分配唯一 ID。（可选）在创建新的广告订单时，您可以使用自定义标识符将订单项分配给新的广告订单。自定义标识符的格式为“ext[自定义标识符]”，例如 ext123。文件上传并处理后，所有自定义标识符都将替换为 DBM 分配的 ID，对象会根据自定义标识符关联（例如，订单项与广告订单）。
广告系列 ID否integer否广告系列的数字 ID 值。您可为要与此广告订单同时创建的广告系列指定一个自定义标识符（例如，“ext[自定义广告系列标识符]”）。
名称是string是条目的名称。
时间戳修改现有条目时必填integer否相应条目的时间戳，系统会使用此时间戳来验证相应条目在下载和上传期间是否未发生更改。
状态是string是条目的状态设置。
  • 在线
  • 已暂停
  • 草稿
  • 已归档
iOS 类型是string是广告订单的类型。只能在创建时设置。
  • standard
Io 子类型是string是广告订单中用于区分不同格式的必填字段。如果将此字段留空，则会使用“默认”值
  • 默认
  • 平时看上去很一般
可结算的结果是string是计费结果。

按结果付费购买交易已被弃用。“Impression”是唯一的有效值。

  • 展示
费用否字符串，列表列表是此条目的所有费用。列表格式 =（费用类别；费用金额；费用类型；已开具帐单；）
  • 费用类别
    • CPM
    • 媒体
  • 费用金额
    • 浮点值
    • 以浮点数形式表示 Pct
  • 费用类型
    • （字符串，请参阅费用表）
  • 已开具帐单
    • True
    • 错误
    • 空白

示例（每千次展示费用；2；Display & Video 360 费用；错误）；（媒体；13；默认；是）；”
下表提供了可接受的值：

费用类别费用类型已开具帐单的选项
每千次展示费用/媒体默认不允许（留空）
每千次展示费用/媒体第三方广告服务器不允许（留空）
每千次展示费用/媒体DoubleVerify允许 (True/False)
每千次展示费用/媒体Adsafe不允许（留空）
每千次展示费用/媒体AdXpose 费用不允许（留空）
每千次展示费用/媒体Vizu 费用不允许（留空）
每千次展示费用/媒体Aggregate Knowledge不允许（留空）
每千次展示费用/媒体Teracent不允许（留空）
每千次展示费用/媒体Evidon 费用不允许（留空）
每千次展示费用/媒体代理机构交易公司费用不允许（留空）
每千次展示费用/媒体Adloox允许 (True/False)
CPMShopLocal必填 (True)
CPMTrustMetrics不允许（留空）
CPMIntegral Ad Science视频允许 (True/False)
CPMMOAT视频不允许（留空）
媒体Display & Video 360 费用必填 (True)
媒体媒体费用数据不允许（留空）
集成代码否string是用于跟踪目的的可选代码。
具体说明否string是条目详情（字符串格式）。
进度是string是用于花费预算花费进度的时间段。
  • 每天
  • 每月
  • 广告投放期
投放节奏是string是此条目的投放节奏。
  • 尽快
  • 均匀
  • 提前
投放节奏是float是按投放节奏类型设置的每个时间段内的支出金额。
频次已启用是string是为广告订单启用/停用基于展示次数的频次上限。
  • TRUE
  • FALSE
频次暴露如果“已启用频次”为“TRUE”，则必须提供integer是指定频次范围内的展示次数的正整数值，即“展示 y 次期间的 x 次展示”。
频率周期如果“已启用频次”为“TRUE”，则必须提供string是指定频次上限对应的时间段单位。
  • 分钟
  • 小时
  • 星期几
  • 周
  • 月
  • 生命周期
频次如果“已启用频次”为“TRUE”，则必须提供integer是“频次周期”类型的时间长度的正整数，即“显示 y 时间段的 x 次展示”。
效果目标类型是string是广告订单的目标单位
  • CPM
  • 每次转化费用
  • 每次点击费用
  • 每次观看费用
  • CPIAVC
  • CTR
  • 可见度 (%)
  • 每次互动费用
  • 点击转化率
  • 展示转化率
  • VCPM
  • VTR
  • 音频完整播放率
  • 视频完整播放率
  • CPCL
  • CPCV
  • TOS10
  • 以尽可能大的支出力度花费预算
  • 自行指定的展示价值/费用
  • 无
  • 其他
效果目标值是string是以货币（CPM、CPA、CPC、CPV、CPIAVC、CPE、VCPM）、百分比（可见度、点击率、点击转化率、展示转化率、完整观看率、音频预设回复、视频广告预设回复、每次点击费用、每次点击费用、TOS10）、目标单位（自定义展示价值 / 费用）或字符串（其他）为目标的值。如果提供的目标类型为“最大化投放节奏”或“无”，则忽略此列。
效果目标算法 ID如果“效果目标类型”为“自行指定的展示价值 / 费用”，则必须填写integer是如果目标类型为 CUSTOM_BIDDING_VALUE_COST，则与目标相关联的自定义出价算法 ID。否则，系统会忽略此列。
测量 DAR是string是使用 Nielsen Digital Ad Ratings 启用/停用受众群体衡量
  • TRUE
  • FALSE
测量 DAR 通道“测量 DAR”为“TRUE”时为必填项integer是使用 Nielsen Digital Ad Ratings 衡量效果的渠道。格式 = UniversalChannel.id
预算类型是string是以要支出的“金额”（金额）或要购买的展示次数（展示次数）为目标指定预算类型。
  • 金额
  • 展示次数
预算细分是字符串，列表列表是指定具体的预算期。列表格式 =（预算、开始日期、结束日期、广告系列预算 ID、说明）。预算采用货币浮动格式。日期采用 MM/DD/YYYY 格式。如果未指定，则广告系列预算 ID 为空。任何预算期的说明都必须为空。如果现有预算期的说明为空，则需要为要提供的行提供说明。例如：“(100.50;01/01/2016;03/31/2016;12345;预算细分 1;;(200.00;04/01/2016;06/30/2016;; 预算细分 1;)”
自动分配预算是string是启用/停用自动预算分配
  • TRUE
  • FALSE
地理位置定位 - 包括否字符串、列表是要纳入定位的地理位置列表。List list = (GeoLocation.id; GeoLocation.id; etc.)。
地理位置定位 - 排除否字符串、列表是要在定位条件中排除的地理位置列表。List list = (GeoLocation.id;GeoLocation.id; etc.)。
邻近区域定位否字符串，列表列表是邻近区域定位目标列表，格式为“（纬度；经度；半径；单位；完整地址；）；”。纬度在 -90 度（含）和 90 度（含）之间；经度在 -180 度（含）和 180 度（含）之间；半径为 1 度到 500 度（含）之间的距离；单位可以是“mi”或“km”；完整地址是可选的。例如：“(38.907192; -77.03687; 1.0; mi; 华盛顿特区,美国华盛顿特区；(40.712775；-74.005972；20.5；公里；40.712775、-74.005972;) (20.000234; -56.675423; 5.0; 英里; ;)。
邻近区域列表定位否字符串，列表列表是广告订单或非 TrueView 订单项的邻近区域名单定位条件，每个定位条件均采用“(ProximityListId; 半径; 单位; ;)”格式。ProximityListId 是广告客户资源下的地理位置列表 ID。半径是 1 至 500（含）间的单位距离；单位可以是“mi”或“km”；每个实体只能定位两个位置列表以及地理位置列表。例如：“(10041691678; 20.0; mi;); (10038858567; 20.5; 公里;)”。
语言定位 - 包括否字符串、列表是要纳入定位的语言列表。List list = (Language.id;Language.id; etc.)。
语言定位 - 排除否字符串、列表是要在定位条件中排除的语言列表。List list = (Language.id;Language.id; etc.)。
设备定位 - 包含否字符串、列表是要在定位条件中包含的设备列表。List list = (DeviceCriteria.id;DeviceCriteria.id;etc.)。
设备定位 - 排除否字符串、列表是要在定位条件中排除的设备列表。List list = (DeviceCriteria.id;DeviceCriteria.id;etc.)。
浏览器定位 - 包括否字符串、列表是要纳入定位的浏览器列表。List list = (Browser.id;Browser.id; etc.)。
浏览器定位 - 排除否字符串、列表是要在定位条件中排除的浏览器列表。List list = (Browser.id;Browser.id; etc.)。
数字内容标签 - 排除否字符串、列表是要排除的数字内容标签列表。List list =（G;PG 等）。
  • G
  • PG
  • T
  • MA
  • ?
品牌保障敏感度设置否string是选择灵敏度设置，以根据广告资源周围内容的主题屏蔽广告资源。
  • 不屏蔽
  • 使用 Campaign Manager 360 验证
  • 使用自定义
品牌保障自定义设置当“品牌保障自定义设置”为“使用自定义设置”时必填字符串、列表是如果“品牌保障敏感度”设置设为“使用自定义”，请指定标准敏感内容类别列表。例如（色情；酒精饮料；烟草等）。
  • 色情内容
  • 诋毁性内容
  • 下载和分享
  • 武器
  • 赌博
  • 暴力
  • 挑逗性内容
  • 脏话
  • 酒精饮料
  • 用药
  • 烟草
  • 政治
  • 宗教
  • 悲剧
  • 交通事故
  • 敏感的社会问题
  • 骇人听闻
第三方验证服务否string是第三方验证服务提供商。
  • 无
  • Integral Ad Science
  • DoubleVerify
  • Adloox
第三方验证标签否字符串、列表是如果第三方验证服务不是“无”，请指定所选提供商支持的标签列表。
渠道定位 - 包括否字符串、列表是要纳入定位的渠道列表。列表格式 = (UniversalChannel.id;UniversalChannel.id; 等)。
渠道定位 - 排除否字符串、列表是要纳入定位的渠道列表。列表格式 = (UniversalChannel.id;UniversalChannel.id; 等)。
网站定位 - 包括否字符串、列表是要在定位条件中包含的网站列表。在“通用网站”表格中找不到该列表，列表中可能包含一组网站 ID 或网址字符串。List list = (UniversalSite.Id;'http://someurl.com';etc.)。
网站定位 - 排除否字符串、列表是要在定位条件中排除的网站的列表。在“通用网站”表格中找不到该列表，列表中可能包含一组网站 ID 或网址字符串。List list = (UniversalSite.Id;'http://someurl.com';etc.)。
应用定位 - 包括否字符串、列表是要纳入定位范围的应用列表。在“通用网站”表格中，此列表可以包含一组 UniversalSite ID 或应用软件包字符串。列表格式 = (UniversalSite.Id; 'some.app.package'; 等)。
应用定位 - 排除否字符串、列表是要在定位条件中排除的应用的列表。在“通用网站”表格中，此列表可以包含一组 UniversalSite ID 或应用软件包字符串。列表格式 = (UniversalSite.Id; 'some.app.package'; 等)。
应用集合定位 - 包含否字符串、列表是要纳入定位的应用集合列表。List list= App Collection ID; App Collection ID;
应用集合定位 - 排除否字符串、列表是要在定位条件中排除的应用集合列表。List list= App Collection ID; App Collection ID;
类别定位 - 包括否字符串、列表是定位条件中包含的类别列表，来自 AdX 行业 ID。List list = (Verticals.Id;Verticals.Id; etc.)。
类别定位 - 排除否字符串、列表是定位条件中排除的类别列表（来自 AdX 行业 ID）。List list = (Verticals.Id;Verticals.Id; etc.)。
内容类型定位 - 包括否字符串、列表是待纳入 API 或元数据下载的内容类型列表。List list = (ContentGenre.Id;ContentGenre.Id;etc.)。
内容类型定位 - 排除否字符串、列表是从 API 或元数据下载中选择要排除的定位内容类型。List list = (ContentGenre.Id;ContentGenre.Id;etc.)。
关键字定位 - 包括否字符串、列表是要在定位条件中包含的关键字字符串的列表。
关键字定位 - 排除否字符串、列表是要在定位条件中排除的关键字列表。
关键字定位 - 排除否字符串、列表是要在定位条件中排除的否定关键字列表的列表。列表格式= 否定关键字列表 ID; 否定关键字列表 ID;
受众群体定位 - 包括否字符串，对列表列表是要纳入定位的受众群体名单。对于第一方受众群体名单，每个受众群体都会列为一对 UserList ID 和新近度设置。一对是 (1;1d;)，其中 1d 是一个新近度样本，代表 1 天新近度。第三方受众群体不适用于新近度，因此列表格式为 (3;);(4;);如需用 AND 和 OR 组合多个受众群体，请按以下示例操作：将新近与不包含新近度的组合成对这表示 (1) 新近度 1 (1/3) 和 2 (3) /3/3

受众群体定位 - 排除否字符串，对列表列表是要在定位条件中排除的受众群体名单列表。如果受众群体名单是第一方受众群体名单，则每个名单都会列为“用户名单 ID”和“新近度”设置。一对是 (1;1d;)，其中 1d 是一个新近度样本，代表 1 天新近度。不过，由于第三方受众群体没有新近受众群体，因此列表格式为 (3;);(4;;)。（


兴趣相似和有购买意向的受众群体定位 - 包括否字符串、列表是要包含的兴趣相似和/或有购买意向的受众群体名单。List format= UserList ID; UserList ID;
兴趣相似的受众群体和有购买意向的受众群体定位 - 排除否字符串、列表是要排除的兴趣相似的受众群体和/或有购买意向的受众群体名单。List format= UserList ID; UserList ID;
客户名单定位否字符串、列表是要定位的自定义列表的列表。List format= UserList ID; UserList ID;
广告资源来源定位 - 授权卖方选项当“Type”为“Display”“Video”或“Audio”时为必需参数string是定位授权直销商、授权直销商和转销商，或授权卖方 + 未知。“授权直销商”表示只定位授权卖方。“授权直销商和转销商”是指定位到授权卖方和转销商。“授权发布商及未参与此计划的发布商”表示其定位到授权卖方、转销商和未知卖方。
  • 授权直销商
  • 授权直销商和转销商
  • 授权发布商及未参与此计划的发布商
广告资源来源定位 - 包括否字符串、列表是要纳入定位的广告资源的列表。List list = (InventorySource.id; InventorySource.id;)。
广告资源来源定位 - 排除否字符串、列表是要在定位条件中排除的广告资源列表。List list = (InventorySource.id; InventorySource.id;)。
广告资源来源定位 - 定位新的广告交易平台否string是设置为定位新的广告交易平台。
  • True
  • 错误
时段定位否字符串、列表是。










“本地”）。对于现有实体，时区不会更改。
时段定位时区如果包含“时段定位”，则必须填写该字段。string是用于时段定位的时区。
  • 本地广告系列
  • 广告客户
环境定位否字符串、列表是要定位的环境列表。选择一个或多个可接受的值。请注意，如果未选择“网站”，则无法选择“网络未优化”。
  • Web
  • 未优化网页
  • 应用
可见度定位（已启用定位）否string是仅定位可通过开放式衡量标准进行衡量的展示次数。
  • TRUE
  • FALSE
可见度定位 Active View否string是目标预计可见度百分比。百分比以浮点数表示。{0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9} 之一
位置定位 - 屏幕上显示否字符串、列表是屏幕上的展示广告位置定位条件。选择一个或多个可接受的值：
  • 首屏
  • 非首屏
  • 未知
位置定位 - 屏幕上的视频否字符串、列表是屏幕上的视频广告位置定位条件。选择一个或多个可接受的值：
  • 首屏
  • 非首屏
  • 未知
位置定位 - 在内容中显示位置否字符串、列表是展示广告的要定位的内容位置。选择一个或多个可接受的值：
  • 文章内嵌
  • 信息流广告
  • 横幅内嵌广告
  • 插页式广告
  • 未知
位置定位 - 内容中的视频位置否字符串、列表是要定位的视频广告内容位置。选择一个或多个可接受的值：
  • 文章内嵌
  • 信息流广告
  • 横幅内嵌广告
  • 插页式广告
  • 未知外播
  • 前贴片广告
  • 中贴片广告
  • 后贴片广告
  • 未知插播广告
位置定位 - 内容中的音频位置否字符串、列表是要定位到的音频广告内容的位置。选择一个或多个可接受的值：
  • 前贴片广告
  • 中贴片广告
  • 后贴片广告
  • 未知
视频播放器尺寸定位否字符串、列表是待定位视频广告播放器尺寸的列表。选择一个或多个可接受的值：
  • 未知
  • small
  • 大
  • 高清
内容时长定位否字符串、列表是要定位的内容时长的列表。单位值为分钟。选择一个或多个可接受的值：
  • 0-1
  • 1-5
  • 5-15
  • 15-30
  • 30-60
  • 60+
  • 未知
内容流类型定位否字符串、列表是要定位的内容流类型列表。选择一个或多个可接受的值：
  • 直播
  • 按需
音频内容类型定位否字符串、列表是目标音频内容类型的列表。选择一个或多个可接受的值：
  • 未知
  • 在线电台
  • 流媒体音乐
  • 播客
受众特征定位性别否字符串、列表是要定位的性别列表。选择一个或多个可接受的值：
  • 女性
  • 男
  • 未知
受众特征定位年龄否字符串、列表是定位到某个用户年龄段。通过指定单个“发件人”年龄和“收件人”年龄，以及是否在包含未知年龄（true/false），指定发件人/收件人范围。


  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

“收件人”的可接受值：
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
受众特征定位家庭收入否字符串、列表是定位家庭收入范围。通过选择单个 Top_of_Range 收入范围和单个 Bottom_of_Range 收入范围，以及是否包含包含未知收入的 true/false 家庭，可以指定日期范围。查看可接受的顶级范围列表：
示例 1：示例

  • 收入最高的前 10%
  • 11-20%
  • 21-30%
  • 31-40%
  • 41-50%
  • 收入较低的后 50%

受众特征定位、育儿状况是字符串、列表是要定位的育儿状况列表。选择一个或多个可接受的值。
  • 有子女
  • 无子女
  • 未知
连接速度定位否string是目标为特定的连接速度。选择以下某个可接受的值：
  • 所有
  • 2G
  • 3G
  • DSL
  • 4G
运营商定位 - 包括否字符串、列表是要定位的 ISP 或运营商列表。列表格式 = {ISP.id; ISP.id;}
运营商定位 - 排除否字符串、列表是要排除的 ISP 或运营商列表。列表格式 = {ISP.id; ISP.id;}
广告订单优化是string是启用/停用广告订单优化
  • TRUE
  • FALSE
出价策略单元如果“广告订单优化”为“True”，则必须提供string是优化出价的出价策略单元：
  • 每次转化费用
  • 每次点击费用
  • 自定义展示次数值/费用
  • 无效流量
  • IVO_TEN
  • AV_VIEWED
  • 增加的转化次数
出价策略不超过如果“广告订单优化”为“True”，则必须提供float是设置“不超过”CPM 值。如果为 0，则不会启用“不超过”值。
对交易应用底价如果“广告订单优化”为“True”，则必须提供string是是否优先处理交易，而不是公开竞价广告资源
  • TRUE
  • FALSE
算法 ID如果“出价策略单元”使用自定义的展示次数值/费用，则必须填写该字段。integer是当出价策略单元设置为自定义展示价值/费用时，必须使用此算法 ID。