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