结构化数据 - v4 - 订单项

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

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

示例：“(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)
媒体媒体费用数据不允许（留空）
每千次展示费用高级功能费用不允许（留空）
集成代码否字符串是用于跟踪目的的可选代码。
详细信息否字符串是字符串格式的条目详细信息。
出价策略类型在“类型”时必填为“展示广告”或“视频”或“音频”字符串是 选择其中一个适用的出价策略：
  • 最大限度地降低：在用尽预算的同时，最大限度地降低每次转化费用/每次点击费用
  • 尽可能提高：在用尽预算的同时，最大限度地提高展示价值或优质展示
  • 超越：达到或超越每次转化费用/每次点击费用 X 的目标
  • 优化每千次可见展示费用：针对每千次可见展示费用出价 (X) 进行优化
  • 固定：指定固定出价 X
出价策略值必填，除非是“出价策略类型”是“最小化”、“最大化”或“类型”为“TrueView”float是对于“超越”“优化每千次可见展示费用”或“固定”策略类型，请为目标出价选择一个值。
请注意，对于“最大限度地降低”出价策略类型，不需要提供出价策略价值或“最大化”
出价策略单元在选择“出价策略类型”时必填是“Beat”,“最小化”或“最大化”字符串是对于“节拍”、“最小化”或“最大化”策略类型，请选择相应的单位：
  • 每次转化费用
  • 每次点击费用
  • 自定义展示次数值/费用
  • CIVA
  • IVO_TEN
  • AV_VIEWED
  • INCREMENTAL_CONVERSIONS
出价策略不得超过在“类型”时必填为“展示广告”或“视频”或“音频”float是设置一个“不超出”每千次展示费用值。如果为 0，则不要超过未启用。仅当出价策略为“最小化”或“最大化”时，此字段才可用或“Beat”。
广告素材分配否字符串、列表是要分配给该条目的广告素材 ID 列表。列表格式 = (Creative.common_data.id;Creative.common_data_id;etc.).
按地理位置定位 - 包含否字符串、列表是要在定位条件中包含的地理位置列表。列表格式 = (GeoLocation.id; GeoLocation.id;etc.)。
按地理位置定位 - 排除否字符串、列表是要在定位条件中排除的地理位置列表。列表格式 = (GeoLocation.id;GeoLocation.id; 等)。
语言定位 - 包含否字符串、列表是要包含在定位条件中的语言列表。列表格式 = (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
  • 使用自定义
品牌保障自定义设置如果选择“品牌保障自定义设置”，则必须启用为“使用自定义”字符串、列表是如果“品牌保障敏感度设置”设为“使用自定义”，请指定标准敏感内容类别列表。例如，（成人；酒精饮料；烟草等）
    。
  • 成人
  • 诋毁性内容
  • 下载内容和分享
  • 武器
  • 赌博
  • 暴力内容
  • 挑逗性内容
  • 脏话
  • 酒精饮料
  • 药品
  • 烟草
  • 政治
  • 宗教
  • 悲剧
  • 交通事故
  • 敏感的社会问题
  • 骇人听闻
第三方验证服务否字符串是第三方验证服务提供商。
  • 无
  • Integral Ad Science
  • DoubleVerify
  • Adloox
第三方验证标签否字符串、列表是如果“第三方验证服务”不是“无”，请指定所选提供商支持的标签列表。
渠道定位 - 包含否字符串、列表是要包含在定位条件中的渠道列表。列表格式 = (UniversalChannel.id;UniversalChannel.id; 等)。
渠道定位 - 排除否字符串、列表是要包含在定位条件中的渠道列表。列表格式 = (UniversalChannel.id;UniversalChannel.id; 等)。
网站定位 - 包含否字符串、列表是要在定位条件中包含的网站列表。如果未在“通用网站”表格中找到，该列表可包含一组网站 ID 或网址字符串。列表格式 = (UniversalSite.Id;'http://someurl.com';etc.)。
网站定位 - 排除否字符串、列表是要在定位条件中排除的网站列表。如果未在“通用网站”表格中找到，该列表可包含一组网站 ID 或网址字符串。列表格式 = (UniversalSite.Id;'http://someurl.com';etc.)。
应用定位 - 包含否字符串、列表是要包含在定位条件中的应用的列表。如果未在“通用网站”表格中找到，该列表可包含一组 UniversalSite ID 或应用软件包的字符串。列表格式 = (UniversalSite.Id; 'some.app.package';etc.).
应用定位 - 排除否字符串、列表是要在定位条件中排除的应用的列表。如果未在“通用网站”表格中找到，该列表可包含一组 UniversalSite 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.).
关键字定位 - 包含否字符串、列表是要包含在定位条件中的关键字字符串列表。
关键字定位 - 排除否字符串、列表是要在定位条件中排除的关键字字符串列表。
关键字列表定位 - 排除否字符串、列表是要在定位条件中排除的否定关键字列表列表。List format= 否定关键字列表 ID;否定关键字列表 ID；
受众群体定位 - 类似受众群体在“类型”时必填为“展示广告”或“视频”或“音频”字符串是 为正向定位的第一方列表启用类似受众群体。
  • TRUE
  • FALSE
受众群体定位 - 包含否字符串，键值对列表是要包含在定位条件中的受众群体名单名单。对于第一方受众群体名单，每个受众群体都会列为用户名单 ID 和新近度设置对。一对为 (1;1d;)，其中 1d 是表示 1 天新近度的样本新近度。新近度不适用于第三方受众群体，因此名单格式为 (3;);(4;);。插入“AND”和“OR”受众群体组，请效仿以下示例：要将包含新近度和不具有新近度的对组合使用，请执行以下操作：'((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'。这意味着 (list 1 with 1 day recency OR list 1 hd 4 1 天新近度, 1 4 , 1 4

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


兴趣相似的受众群体和有购买意向的受众群体定位 - 包含否字符串、列表是要包含的兴趣相似和/或有购买意向的受众群体名单的列表。List format= UserList ID;用户名单 ID；
兴趣相似的受众群体和有购买意向的受众群体定位 - 排除否字符串、列表是要排除的兴趣相似的受众群体和/或有购买意向的受众群体名单。List format= UserList ID;用户名单 ID；
“自定义的兴趣相似受众群体”定位否字符串、列表是要定位的自定义列表的列表。List format= UserList ID;用户名单 ID；
广告资源来源定位 - 包含在“类型”时必填为“展示广告”或“视频”或“音频”字符串、列表是要在定位条件中包含的广告资源列表。列表格式 = (InventorySource.id; InventorySource.id;)。
广告资源来源定位 - 排除否字符串、列表是要在定位条件中排除的广告资源列表。列表格式 = (InventorySource.id; InventorySource.id;)。
广告资源来源定位 - 定位新的广告交易平台否字符串是设置为定位新的广告交易平台。
  • 正确
  • 错误
时段定位否字符串、列表是ID 列表，其中每个时段 ID 的构建格式为：
daypart_id = base_dayparting_id 1 5 1 5 1 0







一个 0 到 95 之间的整数，表示 15 分钟空档
start <end
对于新实体，时间将按照用户的时区设置（即“本地”）。对于现有实体，时区不会更改。
按时段定位时区如果使用“时段定位”，则为必需。字符串是用于时段定位的时区。
  • 局部
  • 广告客户
TrueView 订单项只能是“广告客户”。
环境定位在“类型”时必填为“展示广告”或“视频”或“音频”字符串、列表是要定位的环境列表。列表格式 =（桌面版网站、移动应用等）。
对于展示环境：
  • 桌面版网站
  • 移动网站
  • mobile-app
  • 移动应用插页式广告
  • 移动设备上显示的桌面版网站
对于视频广告：
  • 桌面版网页视频
  • 桌面版网页游戏
  • 桌面版网页上的文章内嵌广告资源
  • 桌面版网页上的信息流广告
  • 移动网站视频
  • 移动应用视频广告
  • 移动应用视频插页式广告
对于音频：
  • 桌面版网站音频
  • 移动网站音频
  • 移动应用音频
Active View 可见度定位否字符串是定位到预计可见度百分比。百分比以浮点数表示。{0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9} 之一
使用可见度定位的广告排名 - 包含否字符串是目标广告排名。请选择一个或所有可接受的值：
  • 全部
  • ATF
  • BTF
  • 未知
使用可见度定位的广告排名 - 排除否字符串是在定位条件中排除广告位置。请选择一个或所有可接受的值：
  • ATF
  • BTF
  • 未知
视频广告位置定位否字符串、列表是要定位的视频广告位置的列表。请选择一个或多个可接受的值：
  • 未知
  • 前贴片广告
  • 中贴片广告
  • 后贴片广告
视频播放器尺寸定位否字符串、列表是要定位的视频广告播放器尺寸列表。请选择一个或多个可接受的值：
  • 未知
  • 小
  • 大
  • 高清
根据受众特征定位的性别否字符串、列表是要定位的性别列表。请选择一个或多个可接受的值：
  • 女性
  • 男性
  • 未知
根据受众特征定位的年龄否字符串、列表是定位到用户年龄段。通过选择单个“起始年龄”和单个“到”年龄来指定“开始”/“结束”范围，以及是否包含未知的年龄（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;包含未知 True/False} = Top 10%;41-50%;true;
示例 2：要仅定位收入较低的家庭所占的 50%，并排除收入未知的家庭，请指定格式{Top_of_Range;Bottom_of_Range;包含未知的 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;}
出价调节系数否字符串，列表列表是此条目的所有出价调节系数。列表格式 = (行类型;条件 ID;出价调节系数值);(row type;criteria ID;出价调节系数 value);。出价调节系数值可介于 0.1 到 10.0 之间。下表列出了可接受的行类型及其对应的条件 ID：
行类型维度条件 ID
应用应用/网站应用条件 ID（即通用网站 ID）。如果在“通用网站”表格中找不到条件 ID，请将其替换为应用软件包字符串。例如(app;UniversalSite.id;1.0);(app;'some.app.package';2.5);
网站应用/网站网站条件 ID（= 通用网站 ID）。如果在“通用网站”表格中找不到条件 ID，请将其替换为网站网址字符串。例如(site;UniversalSite.id;1.0);(site;'http://someurl.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);
TrueView 视频广告格式对于 TrueView 订单项，是字符串是订单项的视频广告格式。
您可以为两种按 CPV 出售的 TrueView 视频广告选择插播广告 / 视频发现广告，或为按 CPM 出售的时长为 6 秒的视频广告选择导视广告。
  • 插播广告 / 视频发现广告
  • 导视广告
TrueView 移动设备出价调整选项否字符串是“提高”或“降低”
  • 增加
  • 减少
TrueView 移动设备出价调整百分比否integer是用于增加在移动设备上展示广告的机会的出价调整。可接受的调整包括出价调整选项“提高”：[0;900%];对于“降低”：[0;90%] 或 100%
TrueView 桌面设备出价调整选项否字符串是“提高”或“降低”
  • 增加
  • 减少
TrueView 桌面设备出价调整百分比否integer是用于增加在桌面设备上展示广告的几率的出价调整。可接受的调整包括出价调整选项“提高”：[0;900%];对于“降低”：[0;90%] 或 100%
TrueView 平板电脑出价调整选项否字符串是“提高”或“降低”
  • 增加
  • 减少
TrueView 平板电脑出价调整百分比否integer是用于增加在平板电脑上展示广告的机会的出价调整。可接受的调整包括出价调整选项“提高”：[0;900%];对于“降低”：[0;90%] 或 100%
TrueView 类别排除定位否字符串、列表是要排除的类别列表。列表格式 = Games；悲剧性事件和冲突；等等
  • 嵌入式视频
  • 直播
  • 游戏
  • 悲剧性事件与冲突
  • 敏感的社会问题
  • 家庭
  • 所有受众群体
  • 年龄较小的青少年
  • 青少年
  • 成人
  • 尚未分级
  • 性暗示内容
  • 耸人听闻的内容
  • 粗言秽语
TrueView 内容过滤器否字符串是TrueView 内容过滤器。
  • 受限
  • 标准
  • 无
TrueView 广告资源来源定位否字符串、列表是要包含的 TrueView 广告资源来源列表
  • YouTube 搜索
  • YouTube 视频
  • 视频合作伙伴