如需了解格式,请参阅概览。
| 字段 | 必需 | 类型 | 可写入 | 说明 |
|---|---|---|---|---|
| 产品 ID | 否 | 整数 | 否 | 媒体商品的数字 ID 值。 |
| 方案 ID | 否 | 整数 | 否 | 媒体建议的数字 ID 值。 |
| 广告系列 ID | 否 | 整数 | 否 | |
| 名称 | 是 | 字符串 | 是 | 条目的名称。 |
| 类型 | 否 | 字符串 | 否 | 媒体商品的类型。
|
| 开始日期 | 否 | 字符串 | 否 | 媒体产品的开始日期,格式为 MM/DD/YYYY HH:mm |
| 结束日期 | 否 | 字符串 | 否 | 媒体产品的结束日期,格式为 MM/DD/YYYY HH:mm |
| 预算 | 否 | float | 否 | 媒体产品的正预算金额。它始终是货币金额的浮点数,因为始终是货币预算。货币将以广告客户的币种显示,单位为标准单位(而非货币单位的 1/1,000,000) |
| 频次已启用 | 是 | 字符串 | 是 | |
| 频次曝光 | 当“Frequency Enabled”(频次启用)为“TRUE”时,此字段为必填项 | 整数 | 是 | 一个正整数值,表示指定频次金额的展示次数,即“在 y 时间段内展示 x 次”中的 x。 |
| 频次周期 | 当“Frequency Enabled”(频次启用)为“TRUE”时,此字段为必填项 | 字符串 | 是 |
|
| 频次金额 | 当“Frequency Enabled”(频次启用)为“TRUE”时,此字段为必填项 | 整数 | 是 | |
| 地理位置定位 - 包含 | 否 | 字符串、列表 | 是 | 要纳入定位范围的地理位置列表。列表格式 = (GeoLocation.id; GeoLocation.id;etc.)。 |
| 语言定位 - 包含 | 否 | 字符串、列表 | 是 | 要纳入定位条件的语言列表。列表格式 = (Language.id;Language.id;etc.)。 |
| 语言定位 - 排除 | 否 | 字符串、列表 | 是 | 要在定位中排除的语言列表。列表格式 = (Language.id;Language.id;etc.)。 |
| 渠道定位 - 包含 | 否 | 字符串、列表 | 是 | 要纳入定位条件的渠道列表。列表格式 = (UniversalChannel.id; UniversalChannel.id; etc.)。 |
| 频道定位 - 排除 | 否 | 字符串、列表 | 是 | 要在定位中排除的渠道列表。列表格式 = (UniversalChannel.id; UniversalChannel.id; etc.)。 |
| 类别定位 - 包含 | 否 | 字符串、列表 | 是 | 要纳入定位范围的类别列表,来自 AdX 垂直行业 ID。列表格式 = (Verticals.Id;Verticals.Id;etc.)。 |
| 类别定位 - 排除 | 否 | 字符串、列表 | 是 | 要从定位中排除的类别列表,来自 AdX 垂直 ID。列表格式 = (Verticals.Id;Verticals.Id;etc.)。 |
| 受众群体定位 - 纳入 | 否 | 字符串,配对列表的列表 | 是 | 要纳入定位的受众群体名单的列表。对于第一方受众群体名单,每个受众群体都以用户名单 ID 和新近度设置的组合形式列出。一个对是 (1;1d;),其中 1d 是表示 1 天近期的样本近期性。“近况”不适用于第三方受众群体,因此名单格式为 (3;);(4;);。如需对受众群体组使用“AND”和“OR”运算符,请参考以下示例:如需组合包含和不包含新近度的配对,请使用以下语法:'((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'。这意味着(具有 1 天近期性的名单 1 或具有 365 天近期性的名单 2)和(未指定近期性的名单 3 或具有 5 分钟近期性的名单 4 或包含所有用户的名单 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 |
| 受众群体定位 - 排除 | 否 | 字符串,配对列表的列表 | 是 | 要在定位中排除的受众群体名单的列表。如果受众群体名单是第一方受众群体名单,则每个受众群体都以用户列表 ID 和新近度设置的对的形式列出。一个对是 (1;1d;),其中 1d 是表示 1 天近期的样本近期性。不过,对于第三方受众群体,新近度不可用,因此列表格式为 (3;);(4;);。列表格式 = ((UserList.id; recency optional;); (UserList.id; recency optional;);) 示例:“(1;1d;);(2;);”。 有效近况值包括: 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 |
| 兴趣相似和有购买意向的受众群体定位 - 包含 | 否 | 字符串、列表 | 是 | |
| 兴趣相似的受众群体和有购买意向的受众群体定位 - 排除 | 否 | 字符串、列表 | 是 | |
| 受众特征定位:性别 | 否 | 字符串、列表 | 是 | 要定位到的性别列表。选择一个或多个可接受的值:
|
| 受众特征定位 - 年龄 | 否 | 字符串、列表 | 是 | 定位到某个年龄段的用户。通过选择单个“起始”年龄和单个“结束”年龄,并指定是否纳入“未知”年龄(true/false),来指定“起始”/“结束”年龄段。请参阅可接受的“起始年龄”/“结束年龄”列表。 示例 1:如需定位 18-55 岁的用户并包含未知年龄,请指定格式 {From; To ; Include unknown True/False} = 18;55;true; 示例 2:如需仅定位 35 周岁以上的用户并排除未知年龄,请指定以下格式 = 35;+;false;。 “起始年龄”的可接受值:
“收件人”的可接受值:
|
| 受众特征定位 - 育儿状况 | 是 | 字符串、列表 | 是 | 要定位的育儿状况列表。选择一个或多个可接受的值。
|
| 设备定位 - 包含 | 否 | 字符串、列表 | 是 | 要纳入定位条件的设备列表。列表格式 = (DeviceCriteria.id; DeviceCriteria.id; etc.)。 |
| 视频播放器尺寸定位 | 否 | 字符串、列表 | 是 | 要定位的视频广告播放器尺寸列表。选择一个或多个可接受的值:
|
| 不公开 - 卖家名称 | 否 | 字符串 | 否 | 交易中的发布商名称。此字段仅适用于私有媒体产品。 |
| 私密 - 订单 ID | 否 | 字符串 | 否 | 有保证交易的订单 ID。此字段仅适用于私有媒体产品。 |
| 私下交易 - 广告资源来源 ID | 否 | 字符串 | 否 | 相应广告资源来源的 DBM ID。此字段仅适用于私有媒体产品。 |