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

如需了解格式,请参阅概览

字段必需类型可写入说明
产品 ID整数媒体商品的数字 ID 值。
方案 ID整数媒体建议的数字 ID 值。
广告系列 ID整数
名称字符串条目的名称。
类型字符串媒体商品的类型。
  • 公开竞价的展示广告
  • 公开竞价音频广告
  • 公开竞价视频广告
  • 视频观看广告系列
  • 经济实惠地扩大覆盖面
  • YouTube TrueView 插播广告
  • YouTube TrueView 发现广告
  • YouTube TrueView 导视广告
  • YouTube TrueView 覆盖面广告系列
  • YouTube 音频广告
  • 设有目标频次的贴片可跳过广告
  • 目标频次(不可跳过)
  • 目标频次可跳过广告系列
  • 设有目标频次的贴片广告
  • Google 优选导视广告
  • Google 优选短视频广告
  • Google 优选广告(长)
  • Google 优选 30 秒不可跳过的插播广告
  • Google Preferred YouTube Shorts
  • 标准预订型短广告
  • 标准预订型长广告
  • 不可跳过的插播广告
  • 不公开(发布商)
  • 私下交易(广告资源来源)
  • 私享(协商)
  • 需求开发
开始日期字符串媒体产品的开始日期,格式为 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 资源 ID(适用于定位类型 TARGETING_TYPE_GEO_REGION)。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。

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

要纳入定位的语言列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID(适用于定位类型 TARGETING_TYPE_LANGUAGE)。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。

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

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

此列使用 Display & Video 360 API TargetingOption 资源 ID(适用于定位类型 TARGETING_TYPE_LANGUAGE)。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。

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

要纳入定位的频道列表。

此列使用 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)。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。

类别定位 - 排除字符串、列表定位条件中要排除的类别列表。此列使用 Display & Video 360 API TargetingOption 资源 ID(适用于定位类型 TARGETING_TYPE_CATEGORY)。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。

受众群体定位 - 纳入字符串,配对列表的列表

要纳入定位范围的受众群体名单的列表。

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

对于第一方受众群体名单,每个受众群体都以 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)。

有效近因值包括:

  • 全部
  • 1 分钟
  • 5 分钟
  • 10 分钟
  • 15 分钟
  • 30 分钟
  • 1 小时
  • 2 小时
  • 3h
  • 6 小时
  • 12 小时
  • 1 天
  • 2 天
  • 3 天
  • 5 天
  • 7 天
  • 10 天
  • 14 天
  • 15 天
  • 21 天
  • 28天
  • 30 天
  • 45 天
  • 60 天
  • 90 天
  • 120 天
  • 180 天
  • 270 天
  • 365 天
受众群体定位 - 排除字符串,配对列表的列表

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

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

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

列表格式 = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;);)
示例:"(1;1d;);(2;);"。

有效近因值包括:

  • 全部
  • 1 分钟
  • 5 分钟
  • 10 分钟
  • 15 分钟
  • 30 分钟
  • 1 小时
  • 2 小时
  • 3h
  • 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 unknown 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

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。

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