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

如需了解格式，请参阅概览。

字段必需类型可写入说明
Io Id仅当修改现有广告订单时才必须指定这项设置整数否相应广告订单的数字 ID 值。如果留空，系统会创建一个新的广告订单 ID 并为其分配唯一 ID。（可选）创建新广告订单时，您可以使用自定义标识符将订单项分配给新广告订单。自定义标识符的格式为“ext[自定义标识符]”，例如 ext123。待文件被上传并处理后，系统会将所有自定义标识符替换为由 DBM 分配的 ID，并会根据所用的自定义标识符将相关对象（例如订单项与插播订单）关联起来。
广告系列 ID否整数否相应广告系列的数字 ID 值。您可以为要与此插单同时创建的广告系列指定一个自定义标识符（例如，“ext[自定义广告系列标识符]”）。
名称是字符串是条目的名称。
时间戳修改现有条目时必须指定整数否相应条目的时间戳，系统会使用此时间戳来验证相应条目在下载和上传期间是否未发生更改。
状态是字符串是相应条目的状态设置。
  • 有效
  • 已暂停
  • 草稿
  • 已归档
  • 已删除
I/O 类型是字符串是广告订单的类型。只能在创建时设置。
  • standard
费用否字符串，列表的列表是相应条目的所有费用。列表格式 =（费用类别；费用金额；费用类型；已开具账单）。
  • 费用类别
    • 每千次展示费用
    • 媒体
  • 费用金额
    • 浮点数
    • 以浮点数表示的百分比
  • 费用类型
    • （字符串，请参阅费用表）
  • 已开具账单
    • 正确
    • 错误
    • 空白

示例：'(CPM; 2; Bid Manager Fee; False) ; (Media; 13; Default; True);'
下表提供了可接受的值：

注意：高级功能费用 CPM 费用由系统预留，且不可变。通过在需要时插入默认 CPM 费用，在各种变动中保留了高级功能费用的基数。

费用类别费用类型账单结算选项
每千次展示费用/媒体默认不允许（留空）
每千次展示费用/媒体第三方广告服务器不允许（留空）
每千次展示费用/媒体DoubleVerify是否允许 (True/False)
每千次展示费用/媒体Adsafe不允许（留空）
每千次展示费用/媒体AdXpose 费用不允许（留空）
每千次展示费用/媒体Vizu不允许（留空）
每千次展示费用/媒体Aggregate Knowledge不允许（留空）
每千次展示费用/媒体Teracent不允许（留空）
每千次展示费用/媒体Evidon不允许（留空）
每千次展示费用/媒体代理机构交易公司费用不允许（留空）
每千次展示费用/媒体Adloox是否允许 (True/False)
每千次展示费用ShopLocal必需 (True)
每千次展示费用TrustMetrics不允许（留空）
每千次展示费用Integral Ad Science视频是否允许 (True/False)
每千次展示费用MOAT视频不允许（留空）
媒体Bid Manager 费用必需 (True)
媒体媒体费用数据不允许（留空）
每千次展示费用Premium 费用不允许（留空）
集成代码否字符串是用于跟踪的可选代码。
详细信息否字符串是字符串格式的条目详细信息。
节奏是字符串是用于达到投放节奏金额的时间段。
  • 每天
  • 每月
  • 机票
支出速率是字符串是相应条目的投放速率。
  • 尽快
  • 均匀
  • 提前
投放量是float是根据支出节奏类型设置的时间段内要支出的金额。
频次已启用是字符串是启用/停用广告订单的基于展示次数的频次上限。
  • TRUE
  • FALSE
频次曝光当“Frequency Enabled”（频次启用）为“TRUE”时，此字段为必填项整数是一个正整数值，表示指定频次金额的展示次数，即“在 y 时间段内展示 x 次”中的 x。
频次周期当“Frequency Enabled”（频次启用）为“TRUE”时，此字段为必填项字符串是指定频次上限的时间段单位。
  • 分钟
  • 小时
  • 数天
  • 数周
  • 月份
  • 累计
频次金额当“Frequency Enabled”（频次启用）为“TRUE”时，此字段为必填项整数是频次周期的时长（以正整数表示），即“在 y 周期内展示 x 次”中的 y。
效果目标类型是字符串是广告订单的目标单位
  • 每千次展示费用
  • 每次转化费用
  • 每次点击费用
  • 每次观看费用
  • CPIAVC
  • 点击率
  • 可见度百分比
  • 无
  • 其他
效果目标价值是字符串是目标值，以货币（每千次展示费用、每次转化费用、每次点击费用、每次观看费用、每次安装和首次应用打开费用）、百分比（可见度百分比、点击率）或字符串（其他）表示。
衡量 DAR是字符串是启用/停用使用 Nielsen Digital Ad Ratings 进行的受众群体衡量
  • TRUE
  • FALSE
衡量 DAR 渠道当“衡量 DAR”为“TRUE”时，此参数为必需参数整数是要使用 Nielsen Digital Ad Ratings 衡量的渠道。格式 = UniversalChannel.id
预算类型是字符串是指定预算类型，具体形式可以是要支出的“收入”金额（金额）或要购买的展示次数（展示次数）。
  • 金额
  • 展示次数
预算细分是字符串，列表的列表是指定具体的预算细分。列表格式 =（预算、开始日期、结束日期）。预算采用浮动货币格式。日期采用 MM/DD/YYYY 格式。示例："(100.50;01/01/2016;03/31/2016;);(200.00;04/01/2016;06/30/2016;);"
自动分配预算是字符串是启用/停用自动分配预算
  • TRUE
  • FALSE
地理位置定位 - 包含否字符串、列表是要纳入定位范围的地理位置列表。列表格式 = (GeoLocation.id; GeoLocation.id;etc.)。
地理位置定位 - 排除否字符串、列表是要在定位条件中排除的地理位置列表。列表格式 = (GeoLocation.id;GeoLocation.id; etc.)。
语言定位 - 包含否字符串、列表是要纳入定位条件的语言列表。列表格式 = (Language.id;Language.id;etc.)。
语言定位 - 排除否字符串、列表是要在定位中排除的语言列表。列表格式 = (Language.id;Language.id;etc.)。
设备定位 - 包含否字符串、列表是要纳入定位条件的设备列表。列表格式 = (DeviceCriteria.id;DeviceCriteria.id;etc.)。
设备定位 - 排除否字符串、列表是要在定位中排除的设备的列表。列表格式 = (DeviceCriteria.id;DeviceCriteria.id;etc.)。
浏览器定位 - 包含否字符串、列表是要纳入定位范围的浏览器列表。列表格式 = (Browser.id;Browser.id;etc.)。
浏览器定位 - 排除否字符串、列表是要在定位条件中排除的浏览器列表。列表格式 = (Browser.id;Browser.id;etc.)。
品牌保障标签否字符串、列表是要定位到的数字内容标签的列表。列表格式 = (G;PG; etc.)。
  • G
  • PG
  • T
  • MA
  • ?
品牌保障敏感度设置否字符串是选择敏感度设置，根据广告资源周围内容的主题屏蔽广告资源。
  • 不屏蔽
  • 使用 DoubleClick Verification
  • 使用自定义温度
品牌保障自定义设置当“品牌安全自定义设置”为“使用自定义”时，此字段为必需字段字符串、列表是如果“品牌保障敏感度设置”为“使用自定义”，请指定标准内容分类器的列表。例如，(Adult;Alcohol;Tobacco;etc.)。
  • 成人
  • 诋毁内容
  • 下载和分享
  • 武器
  • 赌博
  • 暴力内容
  • 挑逗性内容
  • 脏话
  • 酒精饮料
  • 毒品
  • 烟草
  • 政治
  • 宗教
  • 悲剧
  • 交通事故
  • 敏感的社会问题
  • 骇人听闻
第三方验证服务否字符串是第三方验证服务提供商。
  • 无
  • Integral Ad Science
  • DoubleVerify
  • Adloox
第三方验证标签否字符串、列表是如果“第三方验证服务”不是“无”，请指定所选提供商支持的标签列表。
渠道定位 - 包含否字符串、列表是要纳入定位条件的渠道列表。列表格式 = (UniversalChannel.id;UniversalChannel.id; etc.)。
频道定位 - 排除否字符串、列表是要纳入定位条件的渠道列表。列表格式 = (UniversalChannel.id;UniversalChannel.id; etc.)。
网站定位 - 包含否字符串、列表是要纳入定位范围的网站列表。如果未在“通用网站”表中找到相应网站，该列表可以包含一组网站 ID 或网址字符串。列表格式 = (UniversalSite.Id;'http://someurl.com';etc.)。
网站定位 - 排除否字符串、列表是要在定位条件中排除的网站列表。如果未在“通用网站”表中找到相应网站，该列表可以包含一组网站 ID 或网址字符串。列表格式 = (UniversalSite.Id;'http://someurl.com';etc.)。
应用定位 - 包含否字符串、列表是要纳入定位条件的应用列表。如果未在通用网站表中找到，该列表可以包含一组通用网站 ID 或应用软件包字符串。列表格式 = (UniversalSite.Id; 'some.app.package';etc.)。
应用定位 - 排除否字符串、列表是要在定位中排除的应用的列表。如果未在通用网站表中找到，该列表可以包含一组通用网站 ID 或应用软件包字符串。列表格式 = (UniversalSite.Id; 'some.app.package';etc.)。
应用集合定位 - 包含否字符串、列表是要纳入定位范围的应用集合的列表。列表格式= 应用集合 ID；应用集合 ID；
应用合集定位 - 排除否字符串、列表是要在定位中排除的应用集合的列表。列表格式= 应用集合 ID；应用集合 ID；
类别定位 - 包含否字符串、列表是要纳入定位范围的类别列表，来自 AdX 垂直行业 ID。列表格式 = (Verticals.Id;Verticals.Id;etc.)。
类别定位 - 排除否字符串、列表是要从定位中排除的类别列表，来自 AdX 垂直 ID。列表格式 = (Verticals.Id;Verticals.Id;etc.)。
关键字定位 - 包含否字符串、列表是要纳入定位范围的关键字字符串列表。
关键字定位 - 排除否字符串、列表是要在定位中排除的关键字字符串列表。
关键字列表定位 - 排除否字符串、列表是要在定位中排除的否定关键字列表的列表。列表格式= 否定关键字列表 ID；否定关键字列表 ID；
受众群体定位 - 类似受众群体当“Type”为“Display”“Video”或“Audio”时，此列为必需列字符串是 为正向定位的第一方名单启用类似受众群体。
  • TRUE
  • FALSE
受众群体定位 - 纳入否字符串，配对列表的列表是要纳入定位的受众群体名单的列表。对于第一方受众群体名单，每个受众群体都以用户名单 ID 和新近度设置的组合形式列出。一个对是 (1;1d;)，其中 1d 是表示 1 天近期的样本近期性。“近况”不适用于第三方受众群体，因此名单格式为 (3;);(4;);。如需对受众群体组使用“AND”和“OR”运算符，请参考以下示例：如需组合包含和不包含新近度的配对，请使用以下语法：' ((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'。这意味着（具有 1 天近期性的名单 1 或具有 365 天近期性的名单 2）和（未指定近期性的名单 3 或具有 5 分钟近期性的名单 4 或包含所有用户的名单 5）。
有效的近期性值包括：
all、1m、5m、10m、15m、30m、1h、2h、3h、6h、12h、1d、2d、3d、5d、7d、10d、14d、15d、21d、28d、30d、45d、60d、90d、120d、180d、270d、365d
受众群体定位 - 排除否字符串，配对列表的列表是要在定位中排除的受众群体名单的列表。如果受众群体名单是第一方受众群体名单，则每个受众群体都以用户列表 ID 和新近度设置的对的形式列出。一个对是 (1;1d;)，其中 1d 是表示 1 天近期的样本近期性。不过，对于第三方受众群体，新近度不可用，因此列表格式为 (3;);(4;);。列表格式= (UserList.id; recency optional;); (UserList.id; recency optional;);
示例：“(1;1d;);(2;);”。
有效的近期度值包括：
all、1m、5m、10m、15m、30m、1h、2h、3h、6h、12h、1d、2d、3d、5d、7d、10d、14d、15d、21d、28d、30d、45d、60d、90d、120d、180d、270d、365d
兴趣相似和有购买意向的受众群体定位 - 包含否字符串、列表是要包含的兴趣相似和/或有购买意向的受众群体名单的列表。列表格式= 用户名单 ID；用户名单 ID；
兴趣相似的受众群体和有购买意向的受众群体定位 - 排除否字符串、列表是要排除的兴趣相似和/或有购买意向的受众群体名单的列表。列表格式= 用户名单 ID；用户名单 ID；
自定义的兴趣相似受众群体定位否字符串、列表是要定位的自定义列表的列表。列表格式= 用户名单 ID；用户名单 ID；
广告资源来源定位 - 包含否字符串、列表是要纳入定位范围的广告资源列表。列表格式 = (InventorySource.id; InventorySource.id;)。
广告资源来源定位 - 排除否字符串、列表是要在定位条件中排除的广告资源列表。列表格式 = (InventorySource.id; InventorySource.id;)。
广告资源来源定位 - 定位新的广告交易平台否字符串是设置以定位新的广告交易平台。
  • 正确
  • 错误
时段定位否字符串、列表是ID 列表，其中每个时段 ID 的格式如下：
daypart_id = base_dayparting_id
+ days_since_monday * 10000
+ start * 100
+ end

base_dayparting_id = 300000
days_since_monday：0=周一，1=周二，...，6=周日
start：0..95（00:00-23:45），一个介于 0 到 95 之间的整数，表示 15 分钟的时间段
end：1..96（00:15-24:00），一个介于 0 到 95 之间的整数，表示 15 分钟的时间段
start < end
对于新实体，时间将以用户的时区设置（即，“本地”）。对于现有实体，时区不会发生变化。
时段定位时区如果包含“时段定位”，则此字段为必填字段。字符串是用于时段定位的时区。
  • 局部
  • 广告客户
环境定位当“Type”为“Display”“Video”或“Audio”时，此列为必需列字符串、列表是要定位到的环境列表。列表格式 =（桌面版网站；移动应用；等等）。
对于展示环境：
  • 桌面 Web 应用
  • 移动网站
  • mobile-app
  • 移动应用插页式广告
  • 移动设备上显示的桌面版网站
对于视频：
  • 桌面版网页视频广告
  • 桌面版网页游戏
  • 桌面版 In-Read 广告
  • 桌面版网页上的信息流广告
  • 移动网站视频广告
  • 移动应用视频广告
  • 移动应用视频插页式广告
对于音频：
  • 桌面 Web 音频
  • 移动网站音频
  • 移动应用音频
可见度定位条件 - Active View否字符串是指定预计的可见度百分比作为目标。百分比以浮点数表示。{0.1、0.2、0.3、0.4、0.5、0.6、0.7、0.8、0.9} 之一
可见度定位广告位置 - 包含否字符串是定位广告位置。选择一个或多个可接受的值：
  • 全部
  • ATF
  • BTF
  • 未知
可见度定位广告位置 - 排除否字符串是在定位中排除广告位置。选择一个或多个可接受的值：
  • ATF
  • BTF
  • 未知
视频广告位置定位条件否字符串、列表是要定位的视频广告位置的列表。选择一个或多个可接受的值：
  • 未知
  • 前贴片广告
  • 中贴片广告
  • 后贴片广告
视频播放器尺寸定位否字符串、列表是要定位的视频广告播放器尺寸列表。选择一个或多个可接受的值：
  • 未知
  • 小
  • large
  • 高清
受众特征定位：性别否字符串、列表是要定位到的性别列表。选择一个或多个可接受的值：
  • 女
  • 男性
  • 未知
受众特征定位 - 年龄否字符串、列表是定位到某个年龄段的用户。通过选择单个“起始”年龄和单个“结束”年龄，并指定是否纳入“未知”年龄（true/false），来指定“起始”/“结束”年龄段。请参阅可接受的“起始年龄”/“结束年龄”列表。
示例 1：如需定位 18-55 岁的用户并包含未知年龄，请指定格式 {From; To ; Include unknown 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），来指定起始/结束范围。请参阅可接受的 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%

受众特征定位 - 育儿状况是字符串、列表是要定位的育儿状况列表。选择一个或多个可接受的值。
  • 有子女
  • 无子女
  • 未知
连接速度定位否字符串是定位到特定连接速度。选择一个可接受的值：
  • 全部
  • 2G
  • 3G
  • DSL
  • 4G
运营商定位 - 包含否字符串、列表是要定位的 ISP 或运营商的列表。列表格式 = {ISP.id; ISP.id;}
运营商定位 - 排除否字符串、列表是要排除的 ISP 或运营商的列表。列表格式 = {ISP.id; ISP.id;}