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