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

如需查看格式说明,请参阅概览

字段必填类型可写入说明
Io ID仅在修改现有广告订单时才需要integer广告订单的数字 ID 值。如果留空,系统会创建一个新的广告订单 ID,并会分配一个唯一 ID。(可选)在创建新的广告订单时,您可以使用自定义标识符将订单项分配给新的广告订单。自定义标识符的格式为“ext[自定义标识符]”,例如 ext123。当文件上传并处理后,所有自定义标识符都将被替换为由 DBM 分配的 ID,并根据自定义标识符关联对象(例如,从订单项关联到广告订单)。
广告系列 IDinteger广告系列的数字 ID 值。您可为要与相应广告订单同时创建的广告系列指定一个自定义标识符(例如,“ext[custom campaign identifier]”)。
名称string条目的名称。
时间戳修改现有条目时必填integer条目的时间戳,系统使用它来验证条目在下载和上传期间是否未发生变化。
状态string条目的状态设置。
  • 在线
  • 已暂停
  • 草稿
  • 已归档
  • 已删除
Io 类型string广告订单的类型。只能在创建时设置。
  • standard
费用字符串, 列表列表, string, list of lists此条目的所有费用。列表格式 =(费用类别;费用金额;费用类型;已开具帐单;)。
  • 费用类别
    • CPM
    • 媒体
  • 费用金额
    • 浮点值
    • Pct 以浮点数表示
  • 费用类型
    • (字符串,请参阅费用表)
  • 账单
    • True
    • 错误
    • 空白

示例:“(CPM; 2; Bid Manager cost; False) ; (Media; 13; Default; True);”
可接受的值如下表中提供:

注意:附加费用 CPM 费用由系统保留且不可更改。通过根据需要插入默认 CPM 费用,可在变更间保留 Premium 费用的基数。

费用类别费用类型账单选项
每千次展示费用/媒体默认不允许(留空)
每千次展示费用/媒体第三方广告服务器不允许(留空)
每千次展示费用/媒体DoubleVerify允许 (True/False)
每千次展示费用/媒体Adsafe不允许(留空)
每千次展示费用/媒体AdXpose 费用不允许(留空)
每千次展示费用/媒体Vizu 费用不允许(留空)
每千次展示费用/媒体Aggregate Knowledge不允许(留空)
每千次展示费用/媒体Teracent不允许(留空)
每千次展示费用/媒体Evidon 费用不允许(留空)
每千次展示费用/媒体代理机构交易公司费用不允许(留空)
每千次展示费用/媒体Adloox允许 (True/False)
CPMShopLocal必需 (True)
CPMTrustMetrics不允许(留空)
CPMIntegral Ad Science视频允许 (True/False)
CPMMOAT视频不允许(留空)
媒体Bid Manager 费用必需 (True)
媒体媒体费用数据不允许(留空)
CPMPremium 费用不允许(留空)
集成代码string用于跟踪用途的可选代码。
具体说明string字符串格式的条目详细信息。
进度string根据投放安排金额支出的时间段。
  • 每天
  • 每月
  • 广告投放期
投放节奏string此条目的投放速率。
  • 尽快
  • 均匀
  • 提前
投放节奏float按投放节奏类型设置的每时间段的支出金额。
已启用频次string为广告订单启用/停用基于展示次数的频次上限。
  • TRUE
  • FALSE
广告展示频次当“已启用频次”为“TRUE”时为必填项integer给定频次金额中展示次数的正整数,即“显示 y 时间段内的 x 次展示”中的 x。
频次时段当“已启用频次”为“TRUE”时为必填项string指定频次上限的时间段单位。
  • 分钟
  • 小时
  • 星期几
  • 生命周期
频次金额当“已启用频次”为“TRUE”时为必填项integer表示频次周期类型时间长度的正整数,即“显示 y 时间段内的 x 次展示”中的 y。
效果目标类型string广告订单的目标单位
  • CPM
  • 每次转化费用
  • 每次点击费用
  • 每次观看费用
  • CPIAVC
  • CTR
  • 可见度 (%)
  • 其他
效果目标价值string以币种(每千次展示费用、每次转化费用、每次点击费用、每次观看费用、CPIAVC)、百分比(可见度、点击率)或字符串(其他)表示的目标价值。
衡量 DARstring使用 Nielsen Digital Ad Ratings 启用/停用受众群体衡量
  • TRUE
  • FALSE
测量 DAR 频道当“测量 DAR”为“TRUE”时,必须填写此字段integer要通过 Nielsen Digital Ad Ratings 衡量的渠道。格式 = UniversalChannel.id
预算类型string以要支出的“收入”金额(金额)或要购买的展示次数(展示次数)的形式指定预算类型。
  • 金额
  • 展示次数
预算期字符串, 列表列表, string, list of lists指定具体的预算期。列表格式 =(预算、开始日期、结束日期)。预算采用货币浮动格式。日期格式为 MM/DD/YYYY。示例:“(100.50;01/01/2016;03/31/2016;);(200.00;04/01/2016;06/30/2016;);"
自动分配预算string启用/停用自动分配预算
  • TRUE
  • FALSE
地理位置定位 - 包含字符串、列表要纳入到定位条件中的地理位置列表。列表格式 =(GeoLocation.id;GeoLocation.id;等等)。
按地理位置定位 - 排除字符串、列表要在定位范围中排除的地理位置列表。列表格式 = (GeoLocation.id;GeoLocation.id; 等)。
语言定位 - 包含字符串、列表要包含在定位条件中的语言列表。列表格式 = (Language.id;Language.id; 等)。
语言定位 - 排除字符串、列表要在定位条件中排除的语言的列表。列表格式 = (Language.id;Language.id; 等)。
设备定位 - 包含字符串、列表要纳入定位条件的设备列表。列表格式 =(DeviceCriteria.id;DeviceCriteria.id; 等)。
设备定位 - 排除字符串、列表要在定位中排除的设备的列表。列表格式 =(DeviceCriteria.id;DeviceCriteria.id; 等)。
浏览器定位 - 包含字符串、列表要包含在定位条件中的浏览器列表。列表格式 =(Browser.id;Browser.id; 等)。
浏览器定位 - 排除字符串、列表要在定位条件中排除的浏览器的列表。列表格式 =(Browser.id;Browser.id; 等)。
品牌保障标签字符串、列表要定位的数字内容标签的列表。列表格式 =(G;PG;等等)。
  • G
  • PG
  • T
  • MA
  • ?
品牌保障敏感度设置string选择敏感度设置,即可根据广告资源周围内容的主题来屏蔽广告资源。
  • 不屏蔽
  • 使用 DoubleClick Verification
  • 使用自定义
品牌保障自定义设置当“品牌保障自定义设置”为“使用自定义”时,必须提供字符串、列表如果“品牌保障敏感度设置”为“使用自定义内容”,请指定标准内容分类列表。例如:成人、酒精饮料、烟草等。
  • Adult
  • 诋毁性内容
  • 下载内容与分享
  • 武器
  • 赌博
  • 暴力内容
  • 挑逗性内容
  • 脏话
  • 酒精饮料
  • 用药
  • 烟草
  • 政治
  • 宗教
  • 悲剧
  • 交通事故
  • 敏感的社会问题
  • 骇人听闻
第三方验证服务string第三方验证服务提供商。
  • Integral Ad Science
  • DoubleVerify
  • Adloox
第三方验证标签字符串、列表如果第三方验证服务并非“无”,请指定所选提供商支持的标签列表。
渠道定位 - 包含字符串、列表要包含在定位条件中的渠道列表。列表格式 = (UniversalChannel.id;UniversalChannel.id; 等)。
渠道定位 - 排除字符串、列表要包含在定位条件中的渠道列表。列表格式 = (UniversalChannel.id;UniversalChannel.id; 等)。
网站定位 - 包含字符串、列表要纳入定位条件中的网站列表。如果未在“通用网站”表格中找到,该列表可包含一组网站 ID 或网址字符串。列表格式 =(UniversalSite.Id;“http://someurl.com”;等等)。
网站定位 - 排除字符串、列表要在定位中排除的网站列表。如果未在“通用网站”表格中找到,该列表可包含一组网站 ID 或网址字符串。列表格式 =(UniversalSite.Id;“http://someurl.com”;等等)。
应用定位 - 包含字符串、列表要纳入定位范围的应用的列表。如果未在“通用网站”表格中找到,此列表可包含一组 UniversalSite ID 或应用软件包字符串。列表格式 =(UniversalSite.Id;“some.app.package”;等等)。
应用定位 - 排除字符串、列表要在定位条件中排除的应用的列表。如果未在“通用网站”表格中找到,此列表可包含一组 UniversalSite ID 或应用软件包字符串。列表格式 =(UniversalSite.Id;“some.app.package”;等等)。
应用集定位 - 包含字符串、列表要包含在定位条件中的应用集合的列表。列表格式= 应用集合 ID;应用集合 ID;
应用集合定位 - 排除字符串、列表要在定位范围中排除的应用集合的列表。列表格式= 应用集合 ID;应用集合 ID;
类别定位 - 包含字符串、列表要包含在定位条件中的类别列表,来自 AdX 行业 ID。列表格式 =(Verticals.Id;Verticals.Id; 等)。
类别定位 - 排除字符串、列表要在定位条件中排除的类别列表,来自 AdX 行业 ID。列表格式 =(Verticals.Id;Verticals.Id; 等)。
关键字定位 - 包含字符串、列表要包含在定位条件中的关键字字符串列表。
关键字定位 - 排除字符串、列表要在定位中排除的关键字字符串列表。
关键字列表定位 - 排除字符串、列表要在定位中排除的否定关键字列表的列表。列表格式= 否定关键字列表 ID;否定关键字列表 ID;
受众群体定位 - 类似受众群体当“类型”为“展示”“视频”或“音频”时必填string 为正向定位的第一方列表启用类似受众群体。
  • TRUE
  • FALSE
受众群体定位 - 包含字符串、键值对列表要在定位条件中包含的受众群体名单的列表。对于第一方受众群体名单,每个受众群体都会列为一对用户名单 ID 和新近度设置。一对是 (1;1d;),其中 1d 是表示新近度的样本新近度,表示新近度为 1 天。新近度不适用于第三方受众群体,因此列表格式为 (3;);(4;);。若要使用“AND”和“OR”组合受众群体,请效仿以下示例:若要组合有新近度的键值对和不具有新近度的键值对,可使用:' ((1;1d;);(2;365d;variant((3;);(4;5m;);(5;all;variant')。也就是说(列表 1 的新近度为 1 天;列表 2 包含 1 天的新近度;5, 0, 7, d, 0, 7, d, 1d, 1d, 1d, 1d, 3d, 1d, 1d, 1d, 1d, 1d, 1d, 1d, 1d, 1d, 1

受众群体定位 - 排除字符串、键值对列表要在定位条件中排除的受众群体名单的列表。如果受众群体名单是第一方受众群体名单,则每个受众群体都会被列为一对用户名单 ID 和新近度设置。一对是 (1;1d;),其中 1d 是表示新近度的样本新近度,表示新近度为 1 天。不过,对于第三方受众群体,系统不提供新近度数据,因此列表格式为 (3;);(4;);。列表格式= (UserList.id; recency optional;); (UserList.id, d5, d, d, d, d, d, d, d, d, d, d, d, d, d 7, d0, d 7, d0, d 1 d 1


兴趣相似的受众群体和有购买意向的受众群体定位 - 包含字符串、列表要包含的兴趣相似和/或有购买意向的受众群体名单的列表。名单格式= 用户名单 ID; 用户名单 ID;
兴趣相似的受众群体和有购买意向的受众群体定位 - 排除字符串、列表要排除的兴趣相似和/或有购买意向的受众群体名单的列表。名单格式= 用户名单 ID; 用户名单 ID;
自定义兴趣相似定位字符串、列表要定位的自定义列表的列表。名单格式= 用户名单 ID; 用户名单 ID;
广告资源来源定位 - 包含字符串、列表要包含在定位条件中的广告资源列表。列表格式 = (InventorySource.id; InventorySource.id;)。
广告资源来源定位 - 排除字符串、列表要在定位条件中排除的广告资源列表。列表格式 = (InventorySource.id; InventorySource.id;)。
广告资源来源定位 - 定位新的广告交易平台string用于定位新的广告交易平台的设置。
  • True
  • 错误
时段定位字符串、列表ID 列表,其中每个时段 ID 都按以下格式构建:
0-5。









“本地”)。对于现有实体,时区不会更改。
时段定位时区如果包含“时段定位”,则必须提供此值。string要用于时段定位的时区。
  • 本地广告系列
  • 广告客户
环境定位当“类型”为“展示”“视频”或“音频”时必填字符串、列表要定位的环境的列表。列表格式 =(桌面版网站、移动应用等)。
对于展示环境:
  • 桌面版网站
  • 移动 Web 应用
  • mobile-app
  • 移动应用插页式广告
  • 移动设备上显示的桌面版网站
对于视频广告:
  • 桌面版网站视频
  • 桌面版网页游戏
  • 桌面版网页上的 In-Read
  • 桌面版网站信息流广告
  • 移动网站视频广告
  • 移动应用视频广告
  • 移动应用视频插页式广告
对于音频:
  • 桌面版网站音频
  • 移动网站音频
  • 移动应用音频
可见度定位 Active Viewstring目标预计可见度百分比。百分比以浮点数表示。{0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9} 中的一个
可见度定位广告位置 - 包含string目标广告排名。请选择一个或多个可接受的值:
  • 所有
  • ATF
  • 黑人大会
  • 未知
可见度定位广告位置 - 排除string在定位范围中排除广告位置。请选择一个或多个可接受的值:
  • ATF
  • 黑人大会
  • 未知
视频广告位置定位字符串、列表要定位的视频广告展示位置的列表。选择一个或多个可接受的值:
  • 未知
  • 前贴片广告
  • 中贴片广告
  • 播放后视频广告
视频播放器尺寸定位字符串、列表要定位的视频广告播放器尺寸的列表。选择一个或多个可接受的值:
  • 未知
  • small
  • 高清
受众特征定位性别字符串、列表要定位的性别列表。选择一个或多个可接受的值:
  • 女性
  • 未知
受众特征定位 - 年龄字符串、列表定位到用户年龄段。通过选择一个“开始”年龄和单个“结束”年龄以及是否包含未知年龄(true/false),可指定“开始”/“结束”范围。请查看可接受的“开始”/“结束”年龄列表。
示例 1:如果要定位 18-55 岁并包含未知年龄,请指定以下格式 {From; To ;Include known 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),可以指定“from/to”范围。请查看可接受的 Top_of_Range/Bottom_of_Range 范围列表。
示例 1:要定位收入最高的前 10% 到 50% 的家庭,并包含收入未知的家庭,请指定以下格式 {Top_of_Range; Bottom_of_Range;包含未知 True/False} = Top 10%;41-50% Bottom_Range;true: 仅定位家庭收入范围下限 - 家庭所占的百分比;
示例 2:仅定位家庭收入的 10% 到 50%
  • 收入最高的前 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;}