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

有关格式说明，请参阅概览。

字段必填类型可写入说明
产品 ID否integer否媒体产品的数字 ID 值。
方案 ID否integer否媒体提案的数字 ID 值。
广告系列 ID否integer否
名称是字符串是条目的名称。
类型否字符串否媒体产品的类型。
  • 公开竞价的展示广告
  • 公开竞价的音频广告
  • 公开竞价视频广告
  • 视频观看广告系列
  • 经济实惠地扩大覆盖面
  • YouTube TrueView 插播广告
  • YouTube TrueView 发现广告
  • YouTube TrueView 导视广告
  • YouTube TrueView 覆盖面
  • YouTube 音频
  • 设置了目标频次的可跳过式导视广告
  • 设置了目标频次的不可跳过的广告
  • 可跳过的目标频次
  • 设置了目标频次的导视广告
  • Google 优选导视广告
  • Google 优选短视频
  • Google 优选长视频
  • 30 秒 Google 优选不可跳过的插播广告
  • 标准预订型短视频
  • 标准预订型长广告
  • 不可跳过的插播广告
  • 不公开（发布商）
  • 私下（广告资源来源）
  • 私下（协商）
开始日期否字符串否媒体产品的开始日期，格式为 MM/DD/YYYY HH:mm
结束日期否字符串否媒体产品的结束日期，格式为 MM/DD/YYYY HH:mm
预算否float否媒体产品的正预算金额。货币金额始终是浮点数，因为它始终是货币预算。货币将以标准单位（而非货币单位的 1/1,000,000）以广告客户的货币显示
频次已启用是字符串是
频率曝光如果为“启用频率”时必填为“TRUE”integer是指定频次金额中展示次数的正整数量，即“在 y 周期内显示 x 次展示”中的 x。
频率时段如果为“启用频率”时必填为“TRUE”字符串是
  • 分钟
  • 小时
  • 数天
  • 数周
  • 月份
  • 生命周期
频次金额如果为“启用频率”时必填为“TRUE”integer是
按地理位置定位 - 包含否字符串、列表是

要包含在定位条件中的地理位置列表。

此列使用展示广告和定位类型 TARGETING_TYPE_GEO_REGION 的 Video 360 API TargetingOption 资源 ID。

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

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

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

此列使用展示广告和定位类型 TARGETING_TYPE_LANGUAGE 的 Video 360 API TargetingOption 资源 ID。

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

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

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

此列使用展示广告和定位类型 TARGETING_TYPE_LANGUAGE 的 Video 360 API TargetingOption 资源 ID。

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

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

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

此列使用展示广告和Video 360 API Channel 资源 ID。

列表格式 = (Channel.channelId; Channel.channelId; etc.)。

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

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

此列使用展示广告和Video 360 API Channel 资源 ID。

列表格式 = (Channel.channelId; Channel.channelId; etc.)。

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

要包含在定位条件中的类别列表。此列使用展示广告和定位类型 TARGETING_TYPE_CATEGORY 的 Video 360 API TargetingOption 资源 ID。

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

类别定位 - 排除否字符串、列表是要在定位条件中排除的类别列表。此列使用展示广告和定位类型 TARGETING_TYPE_CATEGORY 的 Video 360 API TargetingOption 资源 ID。

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

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

要纳入到定位条件中的受众群体名单。

此列使用展示广告和Video 360 API FirstAndThirdPartyAudience 资源 ID。

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

有效的新近度值为：

  • 全部
  • 1 分钟
  • 5 分钟
  • 10 分钟
  • 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 天
受众群体定位 - 排除否字符串，键值对列表是

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

此列使用展示广告和Video 360 API FirstAndThirdPartyAudience 资源 ID。

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

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

有效的新近度值为：

  • 全部
  • 1 分钟
  • 5 分钟
  • 10 分钟
  • 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;收件人：包含未知 True/False} = 18;55;true;
示例 2：要仅定位 35 岁以上的用户并排除年龄未知的用户，请指定以下 = 35;+;false;。
“发件人”的可接受值：
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

“To”可接受以下值：
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
根据受众特征定位（生育情况）是字符串、列表是要定位的生育情况列表。请选择一个或多个可接受的值。
  • 育有子女
  • 无子女
  • 未知
设备定位 - 包含否字符串、列表是

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

此列使用展示广告和以下定位类型的 Video 360 API TargetingOption 资源 ID：

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

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