如需查看格式说明,请参阅概览。
字段 | 必需 | 类型 | 可写入 | 说明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Io ID | 仅在修改现有广告订单时才需要 | integer | 不支持 | 广告订单的数字 ID 值。如果留空,系统会创建新的广告订单 ID 并为其分配唯一 ID。(可选)在创建新的广告订单时,您可以使用自定义标识符将订单项分配给新的广告订单。自定义标识符的格式为“ext[自定义标识符]”,例如 ext123。待文件被上传并处理后,系统会将所有自定义标识符替换为由 DBM 分配的 ID,并根据自定义标识符关联相应对象(例如,从订单项关联到广告订单)。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
广告系列 ID | 不支持 | integer | 不支持 | 广告系列的数字 ID 值。您可为要与此广告订单同时创建的广告系列指定自定义标识符(例如“ext[自定义广告系列标识符]”)。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
名称 | 是 | string | 是 | 条目的名称。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
时间戳 | 修改现有条目时必填 | integer | 不支持 | 条目的时间戳,系统使用它来验证条目在下载和上传之间是否发生更改。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
状态 | 是 | string | 是 | 条目的状态设置。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
Io 类型 | 是 | string | 是 | 广告订单的类型。只能在创建时设置。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
可结算的结果 | 是 | string | 是 | 可结算结果。 按结果付费购买模式已被弃用。“Impression”是唯一的有效值。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
费用 | 不支持 | 字符串, 列表列表 | 是 | 此参评申请的所有费用。列表格式 =(费用类别;费用金额;费用类型;已开具帐单;)。
示例 '(CPM; 2; Display & Video 360 费用; False) ; (Media; 13; Default; True);'
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
集成代码 | 不支持 | string | 是 | 用于跟踪的可选代码。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
具体说明 | 不支持 | string | 是 | 字符串格式的条目详情。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
进度 | 是 | string | 是 | 根据投放安排金额支出的时间段。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
投放节奏 | 是 | string | 是 | 此条目的投放节奏。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
投放节奏 | 是 | float | 是 | 由投放节奏类型设置的每个时间段内的支出金额。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
已启用频次 | 是 | string | 是 | 为广告订单启用/停用基于展示的频次上限。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
频次曝光次数 | 当“已启用频次”为“TRUE”时,必须填写此字段 | integer | 是 | 表示指定频次金额内展示次数的正整数金额,即“显示 y 期的 x 次展示”中的 x。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
频次时段 | 当“已启用频次”为“TRUE”时,必须填写此字段 | string | 是 | 指定频次上限的时间段单位。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
频次金额 | 当“已启用频次”为“TRUE”时,必须填写此字段 | integer | 是 | 展示频次时段类型时间长度的正整数,即“在 y 期间显示 x 次展示”中的 y。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
效果目标类型 | 是 | string | 是 | 广告订单的目标单位
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
效果目标价值 | 是 | string | 是 | 以货币(每千次展示费用、每次转化费用、每次点击费用、每次观看费用、CPIAVC、每次互动费用、VCPM)、百分比(可见度、点击率、点击转化率、展示转化率、完整观看率、音频完整观看率、视频 CR、CPCL、CPCA、TOS10)、无单位(自行指定的展示次数 / 费用)或字符串形式的目标价值(其他)。如果提供的目标类型是“尽可能提高投放速度”或“无”,系统会忽略此列。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
衡量 DAR | 是 | string | 是 | 使用 Nielsen Digital Ad Ratings 启用/停用受众群体衡量
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
测量 DAR 通道 | 如果“测量 DAR”为“TRUE”,则必须提供 | integer | 是 | 要使用 Nielsen Digital Ad Ratings 衡量的渠道。格式 = UniversalChannel.id | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
预算类型 | 是 | string | 是 | 根据要支出的“收入”金额(金额)或要购买的展示次数(展示次数)指定预算类型。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
预算细分 | 是 | 字符串, 列表列表 | 是 | 指定具体的预算期。列表格式 =(预算、开始日期、结束日期)。预算采用货币浮动格式。日期格式为 MM/DD/YYYY。例如:"(100.50;01/01/2016;03/31/2016;);(200.00;04/01/2016;06/30/2016;);" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
自动分配预算 | 是 | string | 是 | 启用/停用自动分配预算
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
地理位置定位 - 包含 | 不支持 | 字符串、列表 | 是 | 要包含在定位条件中的地理位置的列表。列表格式 =(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;etc.)。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
浏览器定位 - 排除 | 不支持 | 字符串、列表 | 是 | 要在定位条件中排除的浏览器的列表。列表格式 = (Browser.id;Browser.id;etc.)。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
数字内容标签 - 排除 | 不支持 | 字符串、列表 | 是 | 要排除的数字内容标签的列表。列表格式 =(G;PG;等等)。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
品牌保障敏感度设置 | 不支持 | string | 是 | 选择敏感度设置可根据广告资源周围内容的主题来屏蔽广告资源。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
品牌保障自定义设置 | 当“品牌保障自定义设置”为“使用自定义设置”时,必须提供 | 字符串、列表 | 是 | 如果“品牌保障敏感度设置”为“使用自定义内容”,请指定一系列标准敏感内容类别。例如:(成人;酒精饮料;烟草等)。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
第三方验证服务 | 不支持 | string | 是 | 第三方验证服务提供商。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
第三方验证标签 | 不支持 | 字符串、列表 | 是 | 如果第三方验证服务不是“无”,请指定所选提供商支持的标签列表。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
渠道定位 - 包含 | 不支持 | 字符串、列表 | 是 | 要纳入定位条件中的渠道的列表。列表格式 = (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 | 是 | 为正向定位的第一方名单启用类似受众群体。 此字段已弃用。此列始终为 FALSE。如果您在上传时将此列设为 TRUE,该值将重置为 FALSE。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
受众群体定位 - 包含 | 不支持 | 字符串,键值对列表 | 是 | 要添加到定位条件中的受众群体名单的列表。对于第一方受众群体名单,每个受众群体都会列为一对用户名单 ID 和新近度设置。一对是 (1;1d;),其中 1d 是表示 1 天新近度的样本新近度。新近度不适用于第三方受众群体,因此列表格式为 (3;);(4;);。若要使用“AND”和“OR”两组受众群体,请效仿以下示例:要将有新近度的成对组合和不具有新近度的成对组合使用:' ((1;1d;);(2;365d;的主要原因:(3;);(4;5m;);(5;all; AdSense')。也就是说(列表 1 的新近度值为 1 天、5 时、8 和 5、3 和 365 天、1 天、6 天、1 天、6 天、1 天、6 天、1 天、3 天、1 天、1 天、3 天、1 天、1 天、3 天、1 天、1 天、3 天、1 天、3 天、1 天、1 天、3 天、1 天、1 天、3 天、3d、10、3d、15、3d、1d、3d、1d、6d、1d、6d、1d、6d、1d、6d、1d、1d、6d、1d、6d、1d、1d、6d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
受众群体定位 - 排除 | 不支持 | 字符串,键值对列表 | 是 | 要在定位条件中排除的受众群体名单的列表。如果受众群体名单是第一方受众群体名单,则每个受众群体都会列为一组用户名单 ID 和新近度设置。一对是 (1;1d;),其中 1d 是表示 1 天新近度的样本新近度。但是,对于第三方受众群体,无法提供新近度,因此列表格式为 (3;);(4;);。List format= (UserList.id; recency optional;); (UserList.id; recency optional;); 例如:"(1;1d;);(2;);" 有效的新近值为: all、1m、5m、10m、15m、30m、1h、2d、6d、7d、6d、7d、6d、1d、6d、1d、6d、1d、6d、1d、6d、1d、1d、6d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d、1d | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
兴趣相似和有购买意向的定位 - 包含 | 不支持 | 字符串、列表 | 是 | 要包含的兴趣相似和/或有购买意向的受众群体名单名单。List format= UserList ID; UserList ID; | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
兴趣相似和有购买意向的定位 - 排除 | 不支持 | 字符串、列表 | 是 | 要排除的兴趣相似的受众群体和/或有购买意向的受众群体名单的列表。List format= UserList ID; UserList ID; | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
自定义列表定位 | 不支持 | 字符串、列表 | 是 | 要定位的自定义列表的列表。List format= UserList ID; UserList ID; | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
广告资源来源定位 - 授权卖方选项 | 如果“类型”为“展示”“视频”或“音频”,则必须提供 | string | 是 | 设为定位到授权直销商、授权直销商和转销商或授权卖方 + 未知。“授权直接交易”是指仅定位到授权卖方。“授权直销商和转销商”是指定位到授权卖方和转销商。“授权发布商及未参与此计划的发布商”是指其将定位到授权卖方、转销商和未知卖方。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
广告资源来源定位 - 包含 | 不支持 | 字符串、列表 | 是 | 要包含在定位条件中的广告资源的列表。列表格式 = (InventorySource.id; InventorySource.id;)。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
广告资源来源定位 - 排除 | 不支持 | 字符串、列表 | 是 | 要在定位条件中排除的广告资源的列表。列表格式 = (InventorySource.id; InventorySource.id;)。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
广告资源来源定位 - 定位新的广告交易平台 | 不支持 | string | 是 | 用于定位新的广告交易平台的设置。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
时段定位 | 不支持 | 字符串、列表 | 是 | ID 列表,其中每个时段 ID 都按以下格式构建: daypart_id = base_dayparting_id + days_since_monday * 10000 + start * 100 + end days_since_monday: 0=Monday, 1=Tuesday, 0 = Monday. “本地”)。对于现有实体,时区不会更改。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
时段定位时区 | 如果包含“时段定位”,则必须提供此值。 | string | 是 | 用于时段定位的时区。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
环境定位 | 不支持 | 字符串、列表 | 是 | 要定位的环境的列表。选择一个或多个可接受的值。请注意,必须选择“网络”,才能选择“网络未优化”。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
可见度定位 Active View | 不支持 | string | 是 | 达到预计可见度百分比的目标。百分比用浮点数表示。{0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9} 中的一个 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
位置定位 - 在屏幕上展示 | 不支持 | 字符串、列表 | 是 | 屏幕上的展示广告位置定位。选择一个或多个可接受的值:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
位置定位 - 屏幕上的视频 | 不支持 | 字符串、列表 | 是 | 屏幕视频广告位置定位。选择一个或多个可接受的值:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
位置定位 - 内容中的展示广告位置 | 不支持 | 字符串、列表 | 是 | 要定位的展示广告内容位置。选择一个或多个可接受的值:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
位置定位 - 内容中的视频位置 | 不支持 | 字符串、列表 | 是 | 要定位的视频广告内容位置。选择一个或多个可接受的值:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
位置定位 - 内容中的音频位置 | 不支持 | 字符串、列表 | 是 | 要定位的音频广告内容位置。选择一个或多个可接受的值:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
视频播放器尺寸定位 | 不支持 | 字符串、列表 | 是 | 要定位的视频视频播放器的尺寸列表。选择一个或多个可接受的值:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
受众特征定位:性别 | 不支持 | 字符串、列表 | 是 | 要定位的性别的列表。选择一个或多个可接受的值:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
受众特征定位 - 年龄 | 不支持 | 字符串、列表 | 是 | 定位到用户年龄段。通过选择单个“开始”年龄和“到”年龄以及是否包含未知年龄的 true/false 可指定开始/结束范围。请查看可接受的开始/结束年龄列表。 示例 1:要定位 18-55 岁且包含未知年龄,请指定以下格式 {From; To ; Include known True/False} = 18;55;true; 示例 2:如果要仅定位 35 岁以上的用户并排除未知年龄,请指定以下 = 35;+;false;。 可接受以下值:
“收件人”的可接受值:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
受众特征定位家庭收入 | 不支持 | 字符串、列表 | 是 | 定位家庭收入范围。通过选择一个“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 以仅定位家庭/值下限;true 表示家庭/值下限; 示例 2:仅定位家庭%
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
受众特征定位 生育情况 | 是 | 字符串、列表 | 是 | 要定位的育儿状况列表。选择一个或多个可接受的值。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
连接速度定位 | 不支持 | string | 是 | 定位特定的连接速度。请选择以下某个可接受的值:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
运营商定位 - 包含 | 不支持 | 字符串、列表 | 是 | 要定位的 ISP 或运营商列表。列表格式 = {ISP.id; ISP.id;} | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
运营商定位 - 排除 | 不支持 | 字符串、列表 | 是 | 要排除的 ISP 或运营商列表。列表格式 = {ISP.id; ISP.id;} | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
广告订单优化 | 是 | string | 是 | 启用/停用广告订单优化
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
出价策略单元 | 当“广告订单优化”为“True”时,必须提供 | string | 是 | 选择要优化出价的出价策略单元:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
出价策略不得超过 | 当“广告订单优化”为“True”时,必须提供 | float | 是 | 设置“不超过”每千次展示费用值。如果为 0,则未启用“请勿超过”。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
为交易应用底价 | 当“广告订单优化”为“True”时,必须提供 | string | 是 | 是否优先处理交易而非公开竞价广告资源
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
算法 ID | 在“出价策略单元”自定义展示次数值/费用时必填。 | integer | 是 | 如果出价策略单元设置为自定义展示次数值/费用,则必须使用此对应的算法 ID。 |