如需了解格式,请参阅概览。
字段 | 必需 | 类型 | 可写入 | 说明 |
---|---|---|---|---|
产品 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”时,此字段为必填项 | 整数 | 是 | |
地理位置定位 - 包含 | 否 | 字符串、列表 | 是 | 要纳入定位范围的地理位置列表。 此列使用 Display & Video 360 API 列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。 |
语言定位 - 包含 | 否 | 字符串、列表 | 是 | 要纳入定位的语言列表。 此列使用 Display & Video 360 API 列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。 |
语言定位 - 排除 | 否 | 字符串、列表 | 是 | 要在定位中排除的语言列表。 此列使用 Display & Video 360 API 列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。 |
渠道定位 - 包含 | 否 | 字符串、列表 | 是 | 要纳入定位的频道列表。 此列使用 Display & Video 360 API 列表格式 = (Channel.channelId; Channel.channelId; 等)。 |
频道定位 - 排除 | 否 | 字符串、列表 | 是 | 要在定位中排除的渠道列表。 此列使用 Display & Video 360 API 列表格式 = (Channel.channelId; Channel.channelId; 等)。 |
类别定位 - 包含 | 否 | 字符串、列表 | 是 | 要纳入定位条件的类别列表。此列使用 Display & Video 360 API 列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。 |
类别定位 - 排除 | 否 | 字符串、列表 | 是 | 定位条件中要排除的类别列表。此列使用 Display & Video 360 API TargetingOption 资源 ID(适用于定位类型 TARGETING_TYPE_CATEGORY )。列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。 |
受众群体定位 - 纳入 | 否 | 字符串,配对列表的列表 | 是 | 要纳入定位范围的受众群体名单的列表。 此列使用 Display & Video 360 API 对于第一方受众群体名单,每个受众群体都以 FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId 和新近度设置的形式列出。一个对是 (1;1d;),其中 1d 是表示 1 天近期的样本近期度。新近度不适用于第三方受众群体,因此名单格式为 (3;);(4;);。如需对受众群体组使用“AND”和“OR”运算符,请参考以下示例:如需组合包含和不包含新近度的配对,请使用以下语法:'((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'。这意味着(具有 1 天近期度的名单 1 或具有 365 天近期度的名单 2)AND(未指定近期度的名单 3 或具有 5 分钟近期度的名单 4 或包含所有用户的名单 5)。 有效近因值包括:
|
受众群体定位 - 排除 | 否 | 字符串,配对列表的列表 | 是 | 要在定位中排除的受众群体名单列表。 此列使用 Display & Video 360 API 每个受众群体都列为 FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId 和新近度设置(如果受众群体名单是第一方受众群体名单)。一个对是 (1;1d;),其中 1d 是表示 1 天近期的样本近期度。不过,对于第三方受众群体,系统不会提供近况,因此名单格式为 (3;);(4;);。 列表格式 = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;);) 有效近因值包括:
|
兴趣相似的受众群体和有购买意向的受众群体定位 - 包含 | 否 | 字符串、列表 | 是 | |
兴趣相似的受众群体和有购买意向的受众群体定位 - 排除 | 否 | 字符串、列表 | 是 | |
受众特征定位:性别 | 否 | 字符串、列表 | 是 | 要定位到的性别列表。选择一个或多个可接受的值:
|
受众特征定位 - 年龄 | 否 | 字符串、列表 | 是 | 定位到某个年龄段的用户。通过选择单个“起始”年龄和单个“结束”年龄,并指定是否纳入“未知”年龄(true/false),来指定“起始”/“结束”范围。请参阅可接受的“起始年龄”/“结束年龄”列表。 示例 1:如需定位 18-55 岁的用户并包含未知年龄的用户,请指定格式 {From; To ; Include unknown True/False} = 18;55;true; 示例 2:如需仅定位 35 岁以上的用户并排除未知年龄的用户,请指定以下格式 = 35;+;false;。 “起始年龄”的可接受值:
“收件人”的可接受值:
|
受众特征定位 - 育儿状况 | 是 | 字符串、列表 | 是 | 要定位的育儿状况列表。选择一个或多个可接受的值。
|
设备定位 - 包含 | 否 | 字符串、列表 | 是 | 要纳入定位条件的设备列表。 此列使用 Display & Video 360 API
列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。 |
视频播放器尺寸定位 | 否 | 字符串、列表 | 是 | 要定位的视频广告播放器尺寸列表。选择一个或多个可接受的值:
|
不公开 - 卖家名称 | 否 | 字符串 | 否 | 交易中的发布商名称。此字段仅适用于私有媒体产品。 |
私密 - 订单 ID | 否 | 字符串 | 否 | 有保证交易的订单 ID。此字段仅适用于私有媒体产品。 |
私下交易 - 广告资源来源 ID | 否 | 字符串 | 否 | 相应广告资源来源的 DBM ID。此字段仅适用于私有媒体产品。 |