有关格式说明,请参阅概览。
字段 | 必填 | 类型 | 可写入 | 说明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Io ID | 仅在修改现有广告订单时才需要 | integer | 否 | 广告订单的数字 ID 值。如果留空,系统会创建一个新的广告订单 ID 并分配一个唯一 ID。(可选)在创建新的广告订单时,您可以使用自定义标识符为这个新广告订单分配订单项。自定义标识符的格式为“ext[自定义标识符]”,例如 ext123。在文件上传和处理后,所有自定义标识符都将被替换为 DBM 分配的 ID,并且系统会根据自定义标识符关联对象(例如,订单项与广告订单)。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
广告系列 ID | 否 | integer | 否 | 广告系列的数字 ID 值。您可为要与这个广告订单同时创建的广告系列指定自定义标识符(例如,“ext[自定义广告系列标识符]”)。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
名称 | 是 | 字符串 | 是 | 条目的名称。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
时间戳 | 修改现有条目时必填 | integer | 否 | 条目的时间戳,系统使用它来验证该条目在下载和上传期间是否未发生更改。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
状态 | 是 | 字符串 | 是 | 条目的状态设置。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
Io 类型 | 是 | 字符串 | 是 | 广告订单的类型。只能在创建时设置。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
Io 子类型 | 是 | 字符串 | 是 | 广告订单的必填字段,用于区分不同的格式。如果此字段留空,则设为“default”将使用<ph type="x-smartling-placeholder">
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
可结算的结果 | 是 | 字符串 | 是 | 可结算结果。 “按结果付费购买”模式已被弃用。“展示次数”是唯一的有效值。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
费用 | 否 | 字符串,列表列表 | 是 | 此参评申请的所有费用。列表格式 = (费用类别; 费用金额; 费用类型; 已开具账单;)。
示例“(CPM; 2; Display & Video 360 费用; False) ;(Media; 13; Default; True);'
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
集成代码 | 否 | 字符串 | 是 | 用于跟踪目的的可选代码。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
详细信息 | 否 | 字符串 | 是 | 字符串格式的条目详细信息。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
节奏 | 是 | 字符串 | 是 | 根据投放安排金额进行支出的时间段。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
投放速率 | 是 | 字符串 | 是 | 此条目的投放速率。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
投放量 | 是 | float | 是 | 根据投放安排类型设置的时间段的支出金额。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
频次已启用 | 是 | 字符串 | 是 | 对广告订单启用/停用基于展示的频次上限。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
频率曝光 | 如果为“启用频率”时必填为“TRUE” | integer | 是 | 指定频次金额中展示次数的正整数量,即“在 y 周期内显示 x 次展示”中的 x。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
频率时段 | 如果为“启用频率”时必填为“TRUE” | 字符串 | 是 | 指定频次上限的时间段单位。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
频次金额 | 如果为“启用频率”时必填为“TRUE” | integer | 是 | 表示频次时段类型时长的正整数,即“显示 y 段 x 次展示”中的 y。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
效果目标类型 | 是 | 字符串 | 是 | 广告订单的目标单元
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
效果目标价值 | 是 | 字符串 | 是 | 以货币(CPM、CPA、CPC、CPV、CPIAVC、CPE、VCPM)、百分比(可见度百分比、CTR、点击转化率、展示转化率、完整观看率、音频 CR、视频广告 CR、CPCL、CPCA、TOS10)、无单位(自定义展示价值 / 费用)或字符串 (Other) 形式的目标价值。如果提供的目标类型为“尽可能提高投放节奏”或“无”则系统会忽略此列。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
效果目标算法 ID | 如果为“效果目标类型”为必填项为“自行指定的展示价值 / 费用” | integer | 是 | 与目标相关联的自定义出价算法 ID(如果目标类型为 CUSTOM_BIDDING_VALUE_COST)。否则,系统会忽略此列。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
衡量 DAR | 是 | 字符串 | 是 | 使用 Nielsen Digital Ad Ratings 启用/停用受众群体衡量
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
衡量 DAR 渠道 | “衡量 DAR”时必需为“TRUE” | integer | 是 | 要通过 Nielsen Digital Ad Ratings 进行衡量的渠道。格式 = UniversalChannel.id | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
预算类型 | 是 | 字符串 | 是 | 以“收入”金额的形式指定预算类型要支出的费用(金额)或展示次数(展示次数)。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
预算期 | 是 | 字符串,列表列表 | 是 | 指定具体的预算期。列表格式 = (预算, 开始日期, 结束日期, 广告系列预算 ID, 说明)。预算采用货币浮动格式。日期采用 MM/DD/YYYY 格式。如果未指定,广告系列预算 ID 则为空。任何预算期的说明不能为空。如果现有预算期的说明为空,则需要为要上传的行提供说明。示例:“(100.50;01/01/2016;03/31/2016;12345;预算期 1;);(200.00;04/01/2016;06/30/2016;;已更新预算期 1;);" | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
自动分配预算 | 是 | 字符串 | 是 | 启用/停用自动分配预算功能
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
按地理位置定位 - 包含 | 否 | 字符串、列表 | 是 | 要在定位条件中包含的地理位置列表。列表格式 = (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.)。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
品牌保障敏感度设置 | 否 | 字符串 | 是 | 选择敏感度设置来根据广告资源周围内容的主题屏蔽广告资源。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
品牌保障自定义设置 | 如果选择“品牌保障自定义设置”,则必须启用为“使用自定义” | 字符串、列表 | 是 | 如果“品牌保障敏感度设置”设为“使用自定义”,请指定标准敏感内容类别列表。例如,(“色情”“酒精饮料”“烟草”等)。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
第三方验证服务 | 否 | 字符串 | 是 | 第三方验证服务提供商。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
第三方验证标签 | 否 | 字符串、列表 | 是 | 如果“第三方验证服务”不是“无”,请指定所选提供商支持的标签列表。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
渠道定位 - 包含 | 否 | 字符串、列表 | 是 | 要包含在定位条件中的渠道列表。列表格式 = (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; | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
受众群体定位 - 类似受众群体 | 在“类型”时必填为“展示广告”或“视频”或“音频” | 字符串 | 是 | 为正向定位的第一方名单启用类似受众群体。 此字段已弃用。此列始终为 FALSE。如果您在上传时将此列设置为 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; | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
广告资源来源定位 - 授权卖方选项 | 在“类型”时必填为“展示广告”或“视频”或“音频” | 字符串 | 是 | 设为定位到授权直销商、授权直销商和转销商,或者授权卖方 + 未知。“Authorized Direct”意味着系统只会定位到授权卖方。“授权直销商和转销商”是指针对授权卖方和转销商。“授权发布商及未参与此计划的发布商”表示将定位授权卖方、转销商和未知卖方。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
广告资源来源定位 - 包含 | 否 | 字符串、列表 | 是 | 要在定位条件中包含的广告资源列表。列表格式 = (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 对于新实体,时间将按照用户的时区设置(即“本地”)。对于现有实体,时区不会更改。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
按时段定位时区 | 如果使用“时段定位”,则为必需。 | 字符串 | 是 | 用于时段定位的时区。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
环境定位 | 否 | 字符串、列表 | 是 | 要定位的环境列表。请选择一个或多个可接受的值。请注意,“网站未优化”。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
已启用可见度 OMID 定位 | 否 | 字符串 | 是 | 仅定位可通过 Open Measurement 标准衡量的展示。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
Active View 可见度定位 | 否 | 字符串 | 是 | 定位到预计可见度百分比。百分比以浮点数表示。{0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9} 之一 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
位置定位 - 在屏幕上展示 | 否 | 字符串、列表 | 是 | 屏幕上的展示广告位置定位。请选择一个或多个可接受的值:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
位置定位 - 屏幕上的视频 | 否 | 字符串、列表 | 是 | 屏幕上的视频广告位置定位。请选择一个或多个可接受的值:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
位置定位 - 在内容中显示位置 | 否 | 字符串、列表 | 是 | 显示要定位的广告内容位置。请选择一个或多个可接受的值:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
位置定位 - 内容中的视频位置 | 否 | 字符串、列表 | 是 | 要定位的视频广告内容位置。请选择一个或多个可接受的值:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
位置定位 - 内容中的音频位置 | 否 | 字符串、列表 | 是 | 要定位的音频广告内容位置。请选择一个或多个可接受的值:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
视频播放器尺寸定位 | 否 | 字符串、列表 | 是 | 要定位的视频广告播放器尺寸列表。请选择一个或多个可接受的值:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
内容持续时间定位 | 否 | 字符串、列表 | 是 | 要定位的内容时长列表。单位值为分钟。请选择一个或多个可接受的值:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
内容流类型定位 | 否 | 字符串、列表 | 是 | 要定位的内容流类型列表。请选择一个或多个可接受的值:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
根据受众特征定位的性别 | 否 | 字符串、列表 | 是 | 要定位的性别列表。请选择一个或多个可接受的值:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
根据受众特征定位的年龄 | 否 | 字符串、列表 | 是 | 定位到用户年龄段。通过选择单个“起始年龄”和单个“到”年龄来指定“开始”/“结束”范围,以及是否包含未知的年龄(true/false)。查看可接受的“开始”/“结束”年龄列表。 示例 1:要定位 18-55 岁并包含未知年龄,请指定格式{From;收件人:包含未知 True/False} = 18;55;true; 示例 2:要仅定位 35 岁以上的用户并排除年龄未知的用户,请指定以下 = 35;+;false;。 “发件人”的可接受值:
“To”可接受以下值:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
根据受众特征定位家庭收入 | 否 | 字符串、列表 | 是 | 定位到家庭收入范围。通过选择单个 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 的可接受值:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
根据受众特征定位(生育情况) | 是 | 字符串、列表 | 是 | 要定位的生育情况列表。请选择一个或多个可接受的值。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
网速定位 | 否 | 字符串 | 是 | 以特定的连接速度为目标。请选择某个可接受的值:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
运营商定位 - 包含 | 否 | 字符串、列表 | 是 | 要定位的 ISP 或运营商列表。列表格式 = {ISP.id;ISP.id;} | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
运营商定位 - 排除 | 否 | 字符串、列表 | 是 | 要排除的 ISP 或运营商列表。列表格式 = {ISP.id;ISP.id;} | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
广告订单优化 | 是 | 字符串 | 是 | 启用/停用广告订单优化
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
出价策略单元 | 在选择“广告订单优化”时必填为“True” | 字符串 | 是 | 选择出价策略单元以优化出价:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
出价策略不得超过 | 在选择“广告订单优化”时必填为“True” | float | 是 | 设置一个“不超出”每千次展示费用值。如果为 0,则不要超过未启用。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
为交易应用底价 | 在选择“广告订单优化”时必填为“True” | 字符串 | 是 | 是否优先处理交易而非公开竞价广告资源
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
算法 ID | 如果为“出价策略单元”,则必须填写自定义展示次数价值/费用 。 | integer | 是 | 当出价策略单元设为“自定义展示次数”时,必须使用此对应的算法 ID价值/费用。 |