结构化数据 - v9.2 - 广告组

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

字段必需类型可写入说明
广告组 ID仅当修改现有广告组时才必须指定这项设置整数否广告组的数字 ID 值。如果留空，系统会创建一个新的广告组 ID 并为其分配唯一 ID。（可选）创建新的广告组时，您可以使用自定义标识符将 TrueView 广告分配给新的广告组。自定义标识符的格式为“ext[自定义标识符]”，例如 ext123。待文件被上传并处理后，系统会将所有自定义标识符替换为由 DBM 分配的 ID，并会根据所用的自定义标识符将相关对象（例如广告与广告组）关联起来。
订单项 ID是整数否父订单项的数字 ID 值。您可以为要与此广告组同时创建的订单项指定自定义标识符（例如，“ext[custom line item ID]”）。
订单项名称否字符串否订单项名称
名称是字符串是条目的名称。
状态是字符串是相应条目的状态设置。
  • 有效
  • 已暂停
  • 已删除
视频广告格式是字符串是广告组的广告格式。

选择以下某个值：
  • 插播广告
  • 信息流视频广告
  • 导视广告
  • 不可跳过
  • 自适应
  • 经济实惠地扩大覆盖面
  • YouTube 音频
  • 需求开发
出价费用是float是表示广告组的最高目标出价费用，具体取决于“TrueView 出价策略类型”列中设置的出价类型。例如，如果“TrueView 出价策略类型”为“人工每次观看费用”，则此列为最高每次观看费用。

注意：如果“TrueView 出价策略类型”列为“尽可能提高转化次数”“尽可能提高转化价值”或“尽可能提高点击次数”，则上传时此列必须为 0。
关键字定位 - 包含否字符串、列表是

要纳入定位范围的关键字字符串列表。

此列表按升序字母顺序生成。

不适用于“依序播放视频广告”订单项的广告组。

关键字定位 - 排除否字符串、列表是

要在定位中排除的关键字字符串列表。

此列表按升序字母顺序生成。

不适用于“依序播放视频广告”订单项的广告组。

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

要纳入定位条件的类别列表。此列使用 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.)。此列表按升序数字顺序生成。

不适用于“依序播放视频广告”订单项的广告组。

展示位置定位 - YouTube 频道 - 包含否字符串、列表是

要纳入的 YouTube 频道列表。

列表格式 = (YouTube 频道 ID；YouTube 频道 ID；等等)。

不适用于“依序播放视频广告”订单项的广告组。

展示位置定位 - YouTube 频道 - 排除否字符串、列表是

要排除的 YouTube 频道列表。

列表格式 = (YouTube 频道 ID；YouTube 频道 ID；等等)。

不适用于“依序播放视频广告”订单项的广告组。

展示位置定位 - YouTube 视频 - 包含否字符串、列表是

要包含的 YouTube 视频的列表。

列表格式 = (YouTube 视频 ID; YouTube 视频 ID; 等等)。

不适用于“依序播放视频广告”订单项的广告组。

展示位置定位 - YouTube 视频 - 排除否字符串、列表是

要排除的 YouTube 视频的列表。

列表格式 = (YouTube 视频 ID; YouTube 视频 ID; 等等)。

不适用于“依序播放视频广告”订单项的广告组。

展示位置定位 - 热门内容 - 纳入否字符串、列表是

要纳入的 YouTube 和 Google 视频合作伙伴上的热门内容列表。各个内容分组应具有结构化的“video_content::内容分组 ID”。

列表格式 = (video_content::内容分组 ID; video_content::内容分组 ID; 等等)。

不适用于“依序播放视频广告”订单项的广告组。

展示位置定位 - 热门内容 - 排除否字符串、列表是

要排除的 YouTube 和 Google 视频合作伙伴上的热门内容列表。各个内容分组应具有结构化的“video_content::内容分组 ID”。

列表格式 = (video_content::内容分组 ID; video_content::内容分组 ID; 等等)。

不适用于“依序播放视频广告”订单项的广告组。

展示位置定位 - 网址 - 包含否字符串、列表是

要纳入定位条件的网址列表。该列表包含网址字符串。

列表格式 = (someurl.com; someurltwo.com; etc.)。

不适用于“依序播放视频广告”订单项的广告组。

展示位置定位 - 网址 - 排除否字符串、列表是

要在定位中排除的网址列表。该列表包含网址字符串。

列表格式 = (someurl.com; someurltwo.com; etc.)。

不适用于“依序播放视频广告”订单项的广告组。

展示位置定位 - 应用 - 包含否字符串、列表是

要在定位中排除的移动应用列表。该列表包含应用平台 ID。

此 ID 由相关平台提供，例如 Android Play 商店中的软件包 ID（示例：com.google.android.gm）或 Apple App Store 中的应用 ID（示例：422689480）。

列表格式 = (com.google.android.gm; 422689480; 等)。

不适用于“依序播放视频广告”订单项的广告组。

展示位置定位 - 应用 - 排除否字符串、列表是

要在定位中排除的移动应用列表。该列表包含应用平台 ID。

此 ID 由相关平台提供，例如 Android Play 商店中的软件包 ID（示例：com.google.android.gm）或 Apple App Store 中的应用 ID（示例：422689480）。

列表格式 = (com.google.android.gm; 422689480; 等)。

不适用于“依序播放视频广告”订单项的广告组。

展示位置定位 - 应用集合 - 包含否字符串、列表是

要纳入定位范围的应用集合的列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID（适用于定位类型 TARGETING_TYPE_APP_CATEGORY）。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。

不适用于“依序播放视频广告”订单项的广告组。

展示位置定位 - 应用合集 - 排除否字符串、列表是

要纳入定位范围的应用集合的列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID（适用于定位类型 TARGETING_TYPE_APP_CATEGORY）。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。

不适用于“依序播放视频广告”订单项的广告组。

受众特征定位：性别是字符串、列表是要定位到的性别列表。选择一个或多个可接受的值：
  • 女
  • 男性
  • 未知

不适用于“依序播放视频广告”订单项的广告组。

受众特征定位 - 年龄是字符串、列表是

要定位的年龄列表。选择一个或多个可接受的值。

不适用于“依序播放视频广告”订单项的广告组。

受众特征定位：家庭收入是字符串、列表是

要定位的家庭收入列表。选择一个或多个可接受的值。

不适用于“依序播放视频广告”订单项的广告组。

受众特征定位：育儿状况是字符串、列表是

要定位的育儿状况列表。选择一个或多个可接受的值。

不适用于“依序播放视频广告”订单项的广告组。

优化型定位否字符串是启用优化型定位。
  • TRUE
  • FALSE

优化型定位不适用于所有出价策略。如果出现以下情况，此列必须为“FALSE”：
  • “出价策略类型”为“固定”
  • “出价策略类型”为“优化后的每千次展示费用”
  • “出价策略类型”为“最高”，且“出价策略单位”为“CIVA”“IVO_TEN”或“AV_VIEWED”
受众群体扩展级别否整数是

受众群体扩展级别。

只能针对值为 0、1、2、3 的广告组进行设置。

不适用于“视频序列”订单项的广告组

已排除受众群体扩展种子名单否字符串是

已排除受众群体扩展种子名单。

  • TRUE
  • FALSE

不适用于“视频序列”订单项的广告组

受众群体定位 - 纳入否字符串、列表是

要纳入的受众群体名单的列表。

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

列表格式 = (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; 等等)。此列表按升序数字顺序生成。

不适用于“依序播放视频广告”订单项的广告组。

受众群体定位 - 排除否字符串、列表是

要排除的受众群体名单的列表。

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

列表格式 = (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; 等等)。此列表按升序数字顺序生成。

不适用于“依序播放视频广告”订单项的广告组。

相似受众群体定位 - 包含否字符串、列表是

要纳入定位条件的相似受众群体名单。

列表格式：相似受众群体 ID；相似受众群体 ID；

仅适用于需求开发广告组。

相似受众群体定位 - 排除否字符串、列表是

要在定位中排除的相似受众群体列表。

列表格式：相似受众群体 ID；相似受众群体 ID；

仅适用于需求开发广告组。

兴趣相似和有购买意向的受众群体定位 - 包含否字符串、列表是

要排除的兴趣相似和/或有购买意向的受众群体名单的列表。

受众群体名单 ID 可从 Display & Video 360 界面中检索。

列表格式 =（受众群体 ID；受众群体 ID；等等）。此列表按升序数字顺序生成。

不适用于“依序播放视频广告”订单项的广告组。

兴趣相似的受众群体和有购买意向的受众群体定位 - 排除否字符串、列表是

要排除的兴趣相似和/或有购买意向的受众群体名单的列表。

受众群体名单 ID 可从 Display & Video 360 界面中检索。

列表格式 =（受众群体 ID；受众群体 ID；等等）。此列表按升序数字顺序生成。

不适用于“依序播放视频广告”订单项的广告组。

人生大事定位 - 包含否字符串、列表是

要包含的“人生大事”受众群体名单的列表。

受众群体名单 ID 可从 Display & Video 360 界面中检索。

列表格式 =（受众群体 ID；受众群体 ID；等等）。此列表按升序数字顺序生成。

仅当“广告资源类型”为“TrueView”或“需求开发广告”时有效。

不适用于“依序播放视频广告”订单项的广告组。

人生大事定位 - 排除否字符串、列表是

要排除的“人生大事”受众群体名单的列表。

受众群体名单 ID 可从 Display & Video 360 界面中检索。

列表格式 =（受众群体 ID；受众群体 ID；等等）。此列表按升序数字顺序生成。

仅当“广告资源类型”为“TrueView”或“需求开发广告”时有效。

不适用于“依序播放视频广告”订单项的广告组。

详细受众特征定位 - 包含否字符串、列表是

要纳入的详细受众特征受众群体名单的列表。

受众群体名单 ID 可从 Display & Video 360 界面中检索。

列表格式 =（受众群体 ID；受众群体 ID；等等）。此列表按升序数字顺序生成。

仅当“广告资源类型”为“TrueView”或“需求开发广告”时有效。

不适用于“依序播放视频广告”订单项的广告组。

详细受众特征定位 - 排除否字符串、列表是

要排除的详细受众特征受众群体名单的列表。

受众群体名单 ID 可从 Display & Video 360 界面中检索。

列表格式 =（受众群体 ID；受众群体 ID；等等）。此列表按升序数字顺序生成。

仅当“广告资源类型”为“TrueView”或“需求开发广告”时有效。

不适用于“依序播放视频广告”订单项的广告组。

组合受众群体定位否字符串、列表是

要定位的组合受众群体名单的列表。

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

列表格式 = (CombinedAudience.combinedAudienceId; CombinedAudience.combinedAudienceId; 等)。此列表按升序数字顺序生成。

不适用于“依序播放视频广告”订单项的广告组。

自定义列表定位否字符串、列表是

要定位的自定义名单的列表。

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

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

不适用于“依序播放视频广告”订单项的广告组。

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

要纳入定位范围的语言列表。

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

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

仅在满足以下条件时可用：

  • “视频广告格式”列设置为“需求开发广告”
  • 父订单项在界面中将地理位置和语言定位级别设置为广告组
地理位置定位 - 包含否字符串、列表是

要纳入定位范围的地理位置列表。

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

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

仅在满足以下条件时可用：

  • “视频广告格式”列设置为“需求开发广告”
  • 父订单项在界面中将地理位置和语言定位级别设置为广告组
地理位置定位 - 排除否字符串、列表是

定位条件中要排除的地理位置列表。

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

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

仅在满足以下条件时可用：
  • “视频广告格式”列设置为“需求开发广告”
  • 父订单项在界面中将地理位置和语言定位级别设置为广告组
需求开发广告系列的广告资源来源策略需求开发广告组为“是”字符串是需求开发广告系列的广告资源来源策略。
  • 所有 Google 广告资源
  • 所有 Google 和展示广告网络广告资源
  • 所选广告资源
已启用需求开发广告系列的广告资源来源否字符串、列表是已启用需求开发广告系列的广告资源来源。当广告资源来源策略未设置时，系统会使用此值。
  • YouTube 可跳过的广告
  • YouTube 信息流广告
  • YouTube Shorts 广告
  • Gmail
  • 发现
  • Google 展示广告网络
商品过滤条件类型如果为父订单项设置了“Merchant Center 账号 ID”，则必须提供此属性字符串是

“商品过滤条件”选项选择。

  • 所有产品
  • 特定商品
  • 自定义标签
  • 无任何产品
产品过滤设置当“商品过滤条件类型”为“特定商品”或“自定义标签”时，此属性为必需属性字符串、列表是

“商品过滤条件”设置。根据“商品过滤条件类型”的选择，它由 ID 列表或键值对组成。

如果“商品过滤条件类型”为“指定商品”，则该列表将包含可在 Google Merchant Center 中找到的数字商品 ID。示例：(1; 2; 3; 等)。

如果“商品过滤条件类型”为“自定义标签”，则该列表将包含一个键值对列表，其中键的格式为“自定义标签 [0-4]”，值为字符串。示例：（自定义标签 0：值；自定义标签 1：值；等等）

如果“商品过滤条件类型”为“所有商品”或“无商品”，则此列应为空。

视频序列步骤 ID当父订单项子类型为“视频序列”时，此字段为必需字段整数是

相应广告组所属的序列步骤的 ID。在创建此广告组之前，相应步骤必须已存在于父订单项的“视频序列步骤”中。

此字段一经设置便不可更改。

仅适用于“视频序列”订单项的广告组。