结构化数据 - v9.2 - 媒体商品

如需了解格式说明，请参阅概览。

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

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

此列使用 Display & Video 360 API TargetingOption 资源 ID，用于定位类型 TARGETING_TYPE_GEO_REGION。

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

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

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

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

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

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

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

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

列表格式 = (TargetingOption.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。

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

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

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

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

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

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

对于第一方受众群体名单，每个受众群体都列为一对 FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId 和新近度设置。一对是 (1;1d;)，其中 1d 是一个示例新近度，表示 1 天的新近度。第三方受众群体没有新近度，因此列表格式为 (3;);(4;);。如需对受众群体进行“与”和“或”分组，请按照以下示例操作：如需将包含新近度和不包含新近度的对组合在一起，请使用以下格式：'((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'。这意味着（新近度为 1 天的名单 1 或新近度为 365 天的名单 2）与（未指定新近度的名单 3 或新近度为 5 分钟的名单 4 或包含所有用户的名单 5）。

有效的新近度值包括：

  • 全部
  • 1 分钟
  • 5 分钟
  • 10 分钟
  • 15 分钟
  • 30 分钟
  • 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 FirstPartyAndPartnerAudience 资源 ID。

如果受众群体名单是第一方受众群体名单，则每个受众群体都列为一对 FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId 和新近度设置。一对是 (1;1d;)，其中 1d 是一个示例新近度，表示 1 天的新近度。不过，对于第三方受众群体，没有新近度，因此列表格式为 (3;);(4;);。

列表格式 = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; 新近度（可选）;); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; 新近度（可选）;);)
示例："(1;1d;);(2;);"。

有效的新近度值包括：

  • 全部
  • 1 分钟
  • 5 分钟
  • 10 分钟
  • 15 分钟
  • 30 分钟
  • 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 岁的用户并包含未知年龄，请指定格式 {起始; 结束; 包含未知年龄 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; 等等)。此列表按数字升序生成。

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