结构化数据 - v7 - 媒体产品

如需查看格式说明，请参阅概览。

字段必需类型可写入说明
产品 ID否integer否媒体产品的数字 ID 值。
方案 ID否integer否媒体提案的数字 ID 值。
广告系列 ID否integer否
名称是string是条目的名称。
类型否string否媒体产品的类型。
  • 公开竞价展示广告
  • 公开竞价音频广告
  • 公开竞价视频广告
  • 视频观看广告系列
  • YouTube TrueView 插播广告
  • YouTube TrueView 发现广告
  • YouTube TrueView 导视广告
  • YouTube TrueView 覆盖面
  • YouTube 音频
  • 设定目标频次的导视广告（可跳过）
  • 目标频次（不可跳过）
  • 目标频次（可跳过）
  • 导视广告的目标频次
  • Google 优选导视广告
  • Google 优选短视频
  • Google 优选长整型
  • 标准预订型短视频
  • 标准预订型长整型
  • 不可跳过的插播广告
  • 私有（发布商）
  • 不公开（广告资源来源）
  • 不公开（协商）
开始日期否string否媒体产品的开始日期，格式为 MM/DD/YYYY HH:mm
结束日期否string否媒体产品的结束日期，格式为 MM/DD/YYYY HH:mm
预算否float否媒体产品的正预算金额。它始终是货币金额的浮点数，因为它始终是货币预算。币种将以标准单位（而不是货币单位的 1/100 万）为单位显示广告客户的币种
已启用频次是string是
广告展示频次当“已启用频次”为“TRUE”时为必填项integer是给定频次金额中展示次数的正整数，即“显示 y 时间段内的 x 次展示”中的 x。
频次时段当“已启用频次”为“TRUE”时为必填项string是
  • 上场时间（分钟）
  • 小时
  • 星期几
  • 周
  • 月
  • 生命周期
频次金额当“已启用频次”为“TRUE”时为必填项integer是
地理位置定位 - 包含否字符串、列表是

要纳入定位条件中的地理位置列表。

此列将 Display & Video 360 API TargetingOption 资源 ID 用于定位类型“TARGETING_TYPE_GEO_REGION”。

列表格式 =（定位选项.targetingOptionId; TargetingOption.targetingOptionId; 等）。此列表按数字顺序升序生成。

语言定位 - 包含否字符串、列表是

要包含在定位条件中的语言的列表。

此列将 Display & Video 360 API TargetingOption 资源 ID 用于定位类型“TARGETING_TYPE_LANGUAGE”。

列表格式 =（定位选项.targetingOptionId; TargetingOption.targetingOptionId; 等）。此列表按数字顺序升序生成。

语言定位 - 排除否字符串、列表是

要在定位条件中排除的语言列表。

此列将 Display & Video 360 API TargetingOption 资源 ID 用于定位类型“TARGETING_TYPE_LANGUAGE”。

列表格式 =（定位选项.targetingOptionId; TargetingOption.targetingOptionId; 等）。此列表按数字顺序升序生成。

渠道定位 - 包含否字符串、列表是

要包含在定位条件中的渠道列表。

此列使用 Display & Video 360 API Channel 资源 ID。

列表格式 =（Channel.channelId；Channel.channelId；等等）。

渠道定位 - 排除否字符串、列表是

要在定位条件中排除的渠道列表。

此列使用 Display & Video 360 API Channel 资源 ID。

列表格式 =（Channel.channelId；Channel.channelId；等等）。

类别定位 - 包含否字符串、列表是

要包含在定位条件中的类别列表。此列将 Display & Video 360 API TargetingOption 资源 ID 用于定位类型“TARGETING_TYPE_CATEGORY”。

列表格式 =（定位选项.targetingOptionId; TargetingOption.targetingOptionId; 等）。此列表按数字顺序升序生成。

类别定位 - 排除否字符串、列表是要在定位条件中排除的类别的列表。此列将 Display & Video 360 API TargetingOption 资源 ID 用于定位类型“TARGETING_TYPE_CATEGORY”。

列表格式 =（定位选项.targetingOptionId; TargetingOption.targetingOptionId; 等）。此列表按数字顺序升序生成。

受众群体定位 - 包含否字符串、键值对列表是

要包含在定位条件中的受众群体名单的列表。

此列使用 Display & Video 360 API FirstAndThirdPartyAudience 资源 ID。

对于第一方受众群体名单，每个受众群体都会列为一对 FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId 和新近度设置。一对是 (1;1d;)，其中 1d 是表示新近度的样本新近度，表示新近度为 1 天。新近度不适用于第三方受众群体，因此列表格式为 (3;);(4;);。若要使用“AND”和“OR”组合受众群体，请效仿以下示例：若要组合有新近度和不具有新近度的成对组合，可使用：'((1;1d;);(2;365d; transform((3;);(4;5m;);(5;all;variant')。这指的是（列表 1 的新近度为 1 天，或者列表 2 的新近度为 365 天）AND（列表 3 没有指定新近度，或者列表 4 的新近度为 5 分钟，或者列表 5 包含所有用户）。

有效的新近度值为：

  • 全部
  • 100 万
  • 5 分钟
  • 10m
  • 15m
  • 30m
  • 1 小时
  • 2 小时
  • 3 小时
  • 6 小时
  • 12 小时
  • 1 天
  • 2 天
  • 3 天
  • 5 天
  • 7 天
  • 10 天
  • 14 天
  • 15 天
  • 21 天
  • 28天
  • 30 天
  • 45 天
  • 60 天
  • 90 天
  • 120 天
  • 180 天
  • 270 天
  • 365 天
受众群体定位 - 排除否字符串、键值对列表是

要在定位条件中排除的受众群体名单的列表。

此列使用 Display & Video 360 API FirstAndThirdPartyAudience 资源 ID。

如果受众群体名单是第一方受众群体名单，每个受众群体都会被列为一对 FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId 和新近度设置。一对是 (1;1d;)，其中 1d 是表示新近度的样本新近度，表示新近度为 1 天。不过，对于第三方受众群体，系统不提供新近度数据，因此列表格式为 (3;);(4;);。

列表格式 = ((FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; recency optional;); (FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; recency optional;););)
示例："(1;1d;);(2;);"。

有效的新近度值为：

  • 全部
  • 100 万
  • 5 分钟
  • 10m
  • 15m
  • 30m
  • 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 岁并包含未知年龄，请指定以下格式 {From; To ;Include known True/False} = 18;55;true;
示例 2：如果要仅定位 35 岁以上的用户并排除未知年龄，请指定以下 = 35;+;false;。
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

“收件人”的可接受值：
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
受众特征定位的育儿状况是字符串、列表是要定位的育儿状况列表。选择一个或多个可接受的值。
  • 育有子女
  • 无子女
  • 未知
设备定位 - 包含否字符串、列表是

要纳入定位条件的设备的列表。

此列将 Display & Video 360 API TargetingOption 资源 ID 用于以下定位类型：

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

列表格式 =（定位选项.targetingOptionId; TargetingOption.targetingOptionId; 等）。此列表按数字顺序升序生成。

视频播放器尺寸定位否字符串、列表是要定位的视频广告播放器尺寸的列表。选择一个或多个可接受的值：
  • 未知
  • small
  • 大
  • 高清
不公开 - 卖方名称否string否交易中的发布商名称。此字段仅适用于私有媒体产品。
不公开 - 订单 ID否string否有保证的交易的订单 ID。此字段仅适用于私有媒体产品。
不公开 - 广告资源来源 ID否string否广告资源来源的 DBM ID。此字段仅适用于私有媒体产品。