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

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

字段必填类型可写入说明
Io ID仅在修改现有广告订单时才必须指定这项设置integer否广告订单的数字 ID 值。如果留空，系统会创建一个新的广告订单 ID 并为其分配唯一 ID。（可选）创建新广告订单时，您可以使用自定义标识符为新广告订单分配订单项。自定义标识符的格式为“ext[自定义标识符]”，例如 ext123。待文件被上传并处理后，系统会将所有自定义标识符替换为由 DBM 分配的 ID，并会根据所用的自定义标识符将相关对象（例如订单项与广告订单）关联起来。
广告系列 ID否integer否广告系列的数字 ID 值。您可为要与此广告订单同时创建的广告系列指定自定义标识符（例如“ext[custom campaign identifier]”）。
名称是字符串是条目的名称。
时间戳修改现有条目时必须填写integer否相应条目的时间戳。系统会使用此时间戳来验证相应条目在下载和上传期间是否未发生更改。
状态是字符串是条目的状态设置。
  • 有效
  • 已暂停
  • 草稿
  • 已归档
Io 类型是字符串是广告订单的类型。只能在创建时设置。
  • standard
Io 子类型是字符串是广告订单中必需的字段，用于区分不同的格式。If the field is left empty 'default' value will be used'
  • 默认
  • 常规 OTT
可结算的结果是字符串是可结算的结果。

“按结果付费购买”模式已被弃用。“展示”是唯一的有效值。

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

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

费用类别费用类型账单选项
每千次展示费用/媒体默认不允许（请留空）
CPM/媒体第三方广告服务器不允许（请留空）
CPM/媒体DoubleVerify允许（True/False）
CPM/媒体Adsafe不允许（请留空）
CPM/媒体AdXpose 费用不允许（请留空）
CPM/媒体Vizu不允许（请留空）
CPM/媒体Aggregate Knowledge不允许（请留空）
CPM/媒体Teracent不允许（请留空）
每千次展示费用/媒体Evidon不允许（请留空）
CPM/媒体代理机构交易公司费用不允许（留空）
CPM/媒体Adloox允许（True/False）
每千次展示费用ShopLocal必填 (True)
每千次展示费用TrustMetrics不允许（请留空）
每千次展示费用Integral Ad Science视频允许（True/False）
每千次展示费用MOAT视频不允许（请留空）
媒体Display & Video 360 费用必填 (True)
媒体媒体费用数据不允许（请留空）
媒体Scibids 费用必填（True）
集成代码否字符串是一个可选代码，用于跟踪目的。
详细信息否字符串是字符串格式的条目详细信息。
节奏是字符串是根据投放安排金额进行支出的时间段。
  • 每天
  • 每月
  • 机票
节奏速率是字符串是此条目的节奏速率。
  • 尽快
  • 均匀
  • 提前

“ASAP”（尽快）与“Flight”（投放）节奏不兼容。
投放量是float是按节奏类型设置的时间段内要支出的金额。
频次已启用是字符串是对广告订单启用/停用基于展示的频次上限。
  • TRUE
  • FALSE
频次曝光如果“频次启用”为“TRUE”，则为必填项integer是指定频次金额中的展示次数对应的正整数金额，即“在 y 时间段内展示 x 次”中的 x。
频次时段如果“频次启用”为“TRUE”，则为必填项字符串是指定频次上限的时间段单位。
  • 分钟
  • 小时
  • 数天
  • 数周
  • 月份
  • 生命周期
频次金额当“启用频次”为“TRUE”时必填integer是频次周期类型的时长，即“在 y 个周期内展示 x 次”中的 y。该值应为正整数。
效果目标类型是字符串是广告订单的目标单位
  • 每千次展示费用
  • 每次转化费用
  • 每次点击费用
  • 每次观看费用
  • CPIAVC
  • 点击率
  • 可见度百分比
  • CPE
  • 点击转化率
  • 展示转化率
  • VCPM
  • 观看率 (VTR)
  • 音频完整播放率
  • 视频完整播放率
  • CPCL
  • CPCV
  • TOS10
  • 以尽可能大的支出力度花费预算
  • 自行指定的展示价值/费用
  • 无
  • 其他
效果目标价值是字符串是目标值（以货币为单位 [CPM、CPA、CPC、CPV、CPIAVC、CPE、VCPM]、百分比 [可见度百分比、点击率、点击转化率、展示转化率、视频观看时长百分比、音频观看时长百分比、视频观看时长百分比、CPCL、CPCA、TOS10]、无单位 [自定义展示价值 / 费用] 或字符串 [其他]）。如果提供的目标类型为“投放节奏最大化”或“无”，则此列会被忽略。
效果目标算法 ID当“效果目标类型”为“自行指定的展示价值 / 费用”时，此属性为必需属性integer是与目标相关联的自定义出价算法 ID（如果目标类型为 CUSTOM_BIDDING_VALUE_COST）。否则，系统会忽略此列。
衡量 DAR是字符串是启用/停用使用 Nielsen Digital Ad Ratings 衡量受众群体
  • TRUE
  • FALSE
衡量 DAR 渠道如果“衡量 DAR”为“TRUE”，则为必填项integer是要通过 Nielsen Digital Ad Ratings 进行衡量的渠道。格式 = UniversalChannel.id
预算类型是字符串是指定预算类型，具体形式为要支出的“收入”金额（金额）或要购买的展示次数（展示次数）。
  • 金额
  • 展示次数
预算期是字符串，列表列表是指定具体的预算期。列表格式 =（预算、开始日期、结束日期、广告系列预算 ID、说明）。预算采用浮点货币格式。日期采用 MM/DD/YYYY 格式。如果未指定，广告系列预算 ID 为空。任何预算期的说明都不能为空。如果现有预算期的说明为空，则需要为要上传的行提供说明。示例：“(100.50;01/01/2016;03/31/2016;12345;budget segment 1;);(200.00;04/01/2016;06/30/2016;;updated budget segment 1;);"
自动分配预算是字符串是启用/停用自动分配预算
  • TRUE
  • FALSE
地理位置定位 - 包含否字符串、列表是要在定位条件中包含的地理位置列表。列表格式 = (GeoLocation.id; GeoLocation.id;etc.)。
地理位置定位 - 排除否字符串、列表是要从定位条件中排除的地理位置列表。列表格式 = (GeoLocation.id; GeoLocation.id; 等)。
邻近区域定位否字符串、列表的列表是相邻目标的列表，每个目标的格式为“(Latitude; Longitude; Radius; Unit; FullAddress;)”。纬度在 -90 度到 90 度之间（含边界值）；经度在 -180 度到 180 度之间（含边界值）；半径以 1 度到 500 度（含）之间的距离为单位；单位可以是“mi”或“km”；FullAddress 可选。例如：“(38.907192; -77.03687; 1.0; mi; Washington D.C., DC, USA;); (40.712775; -74.005972; 20.5; km; 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;);”。
语言定位 - 包含否字符串、列表是要包含在定位条件中的语言列表。列表格式 = (Language.id;Language.id;etc.)。
语言定位 - 排除否字符串、列表是要从定位条件中排除的语言列表。列表格式 = (Language.id;Language.id;etc.)。
设备定位 - 包含否字符串、列表是要纳入定位条件的设备列表。列表格式 = (DeviceCriteria.id; DeviceCriteria.id; 等)。
设备定位 - 排除否字符串、列表是要从定位条件中排除的设备列表。列表格式 = (DeviceCriteria.id; DeviceCriteria.id; 等)。
浏览器定位 - 包含否字符串、列表是要包含在定位条件中的浏览器列表。列表格式 = (Browser.id; Browser.id; 等)。
浏览器定位 - 排除否字符串、列表是要在定位条件中排除的浏览器列表。列表格式 = (Browser.id; Browser.id; 等)。
数字内容标签 - 排除否字符串、列表是要排除的数字内容标签的列表。列表格式 = (G;PG; etc.)。
  • G
  • PG
  • T
  • MA
  • ?
品牌保障敏感度设置否字符串是选择敏感度设置，以根据广告资源周围内容的主题来屏蔽某些广告资源。
  • 不屏蔽
  • 使用 Campaign Manager 360 Verification
  • 使用自定义
品牌保障自定义设置如果“品牌保障自定义设置”为“使用自定义设置”，则必填字符串、列表是如果品牌保障敏感性设置为“使用自定义设置”，请指定标准内容分类器列表。例如，（色情；酒精；烟草；等）。
  • 色情内容
  • 诋毁内容
  • 下载和分享
  • 武器
  • 赌博
  • 暴力内容
  • 挑逗性内容
  • 脏话
  • 酒精饮料
  • 药品
  • 烟草
  • 政治
  • 宗教
  • 悲剧
  • 交通事故
  • 敏感的社会问题
  • 骇人听闻
第三方验证服务否字符串是第三方验证服务提供商。
  • 无
  • 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;etc.)。
类别定位 - 排除否字符串、列表是要在定位中排除的类别列表（根据 AdX 行业 ID）。列表格式 = (Verticals.Id;Verticals.Id;etc.)。
内容类型定位 - 包含否字符串、列表是要包含在定位条件中的内容类型列表（通过 API 或元数据下载）。列表格式 = (ContentGenre.Id;ContentGenre.Id;etc.)。
内容类型定位 - 排除否字符串、列表是要从 API 或元数据下载中排除的内容类型列表。列表格式 = (ContentGenre.Id;ContentGenre.Id;etc.)。
关键字定位 - 包含否字符串、列表是要包含在定位条件中的关键字字符串列表。
关键字定位 - 排除否字符串、列表是要在定位条件中排除的关键字字符串列表。
关键字列表定位 - 排除否字符串、列表是要在定位中排除的否定关键字列表列表。列表格式 = (否定关键字列表 ID; 否定关键字列表 ID;)
受众群体定位 - 包含否字符串、对列表的列表是要包含在定位条件中的受众群体名单列表。对于第一方受众群体名单，每个受众群体都列为一对 UserList ID 和新近度设置。一对为 (1;1d;)，其中 1d 是表示 1 天新近度的样本新近度。新近度不适用于第三方受众群体，因此列表格式为 (3;);(4;);。如需对受众群体组进行“AND”和“OR”运算，请按以下示例操作：如需组合包含和不包含新近度信息的对：'((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'。这意味着“（名单 1，最近一次互动时间为 1 天）或（名单 2，最近一次互动时间为 365 天）”和“（名单 3，未指定最近一次互动时间）或（名单 4，最近一次互动时间为 5 分钟）或（名单 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
受众群体定位 - 排除否字符串、对列表的列表是定位时要排除的受众群体名单列表。如果受众群体名单是第一方受众群体名单，则每个受众群体都列为一对 UserList ID 和新近度设置。一对为 (1;1d;)，其中 1d 是表示 1 天新近度的样本新近度。不过，对于第三方受众群体，系统无法提供新近度，因此名单格式为 (3;);(4;);。列表格式 = ((UserList.id; recency optional;); (UserList.id; recency optional;);)
示例："(1;1d;);(2;);"。
有效的近似值为：
全部、1 分钟、5 分钟、10 分钟、15 分钟、30 分钟、1 小时、2 小时、3 小时、6 小时、12 小时、1 天、2 天、3 天、5 天、7 天、10 天、14 天、15 天、21 天、28 天、30 天、45 天、60 天、90 天、120 天、180 天、270 天、365 天
兴趣相似和有购买意向的受众群体定位 - 包含否字符串、列表是要包含的兴趣相似受众群体名单和/或有购买意向的受众群体名单。列表格式= 用户名单 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
对于新实体，时间将设置为用户所在的时区（即“Local”）。对于现有实体，时区不会更改。
时段定位时区包含“时段定位”时，此字段为必填字段。字符串是用于时段定位的时区。
  • 局部
  • 广告客户
环境定位否字符串、列表是要定位到的环境列表。选择一个或多个可接受的值。请注意，如果不选择“网站”，就无法选择“未优化网站”。
  • Web
  • 网站未优化
  • 应用
启用了可见度 OMID 定位否字符串是仅定位可通过 Open Measurement 标准衡量的展示。
  • TRUE
  • FALSE
可见度定位条件 - Active View否字符串是指定预测的可见度百分比作为目标。百分比以浮点数表示。{0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9} 中的任一值
位置定位 - 展示在屏幕上否字符串、列表是屏幕上展示广告位置定位。选择一个或多个可接受的值：
  • 首屏
  • 非首屏
  • 未知
位置定位 - 视频在屏幕上的位置否字符串、列表是屏幕上的视频广告位置定位。选择一个或多个可接受的值：
  • 首屏
  • 非首屏
  • 未知
位置定位 - 展示位置（内容中）否字符串、列表是要定位到的展示广告内容位置。选择一个或多个可接受的值：
  • 文章内
  • 信息流广告
  • 横幅内嵌广告
  • 插页式广告
  • 未知
位置定位 - 内容中的视频位置否字符串、列表是要定位的视频广告内容位置。选择一个或多个可接受的值：
  • 文章内
  • 信息流广告
  • 横幅内嵌广告
  • 插页式广告
  • 未知外播广告
  • 前贴片广告
  • 中贴片广告
  • 后贴片广告
  • 未知的插播广告
位置定位 - 音频内容中的位置否字符串、列表是要定位的音频广告内容位置。选择一个或多个可接受的值：
  • 前贴片广告
  • 中贴片广告
  • 后贴片广告
  • 未知
视频播放器尺寸定位否字符串、列表是要定位到的视频广告播放器尺寸列表。选择一个或多个可接受的值：
  • 未知
  • 小
  • 大
  • 高清
内容时长定位否字符串、列表是要定位的内容时长列表。单位值为分钟。选择一个或多个可接受的值：
  • 0-1
  • 1-5
  • 5-15
  • 15-30
  • 30-60
  • 60+
  • 未知
内容流类型定位否字符串、列表是要定位的内容流类型的列表。选择一个或多个可接受的值：
  • 直播
  • 按需
音频内容类型定位否字符串、列表是要定位的音频内容类型列表。选择一个或多个可接受的值：
  • 未知
  • 在线电台
  • 在线音乐
  • 播客
受众特征定位 - 性别否字符串、列表是要定位到的性别的列表。选择一个或多个可接受的值：
  • 女性
  • 男性
  • 未知
受众特征定位 - 年龄否字符串、列表是定位到特定年龄段的用户。通过选择单个“从”年龄和单个“到”年龄，以及是否要包含“未知”年龄（true/false），指定“从/到”范围。请参阅可接受的年龄范围（从/到）。
示例 1：若要定位到 18-55 周岁的用户并包含未知年龄的用户，请使用以下格式：{从; 到; 包含未知年龄（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; 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;}
广告订单优化是字符串是启用/停用广告订单优化
  • TRUE
  • FALSE
出价策略单位如果“广告订单优化”设置为“true”，则为必填项字符串是选择要优化出价的出价策略单位：
  • 每次转化费用
  • 每次点击费用
  • 单位费用带来的自定义展示价值
  • CIVA
  • IVO_TEN
  • AV_VIEWED
出价策略 - 不超出如果“广告订单优化”设置为“true”，则为必填项float是设置“请勿超出”每千次展示定价值。如果为 0，则表示未启用“不超过”。
为交易应用底价如果“广告订单优化”设置为“true”，则为必填项字符串是是否优先处理交易而非公开竞价广告资源
  • TRUE
  • FALSE
算法 ID如果为“出价策略单元”自定义展示次数值/费用，则为必填项。integer是将出价策略单位设置为自定义展示价值/费用时，必须使用此对应的算法 ID。