通过

ProductCondition 数据对象 - 市场活动管理

  • 项目

定义一个条件，该条件确定是否从客户的Microsoft商家中心目录文件选择产品。

可以将市场活动级别的生产条件与购物市场活动、基于源的受众市场活动以及具有多媒体广告的搜索市场活动结合使用，即利用Microsoft商家中心 商店 ID 的营销活动。 (注意：目前并非所有人都有包含多媒体广告的搜索市场活动。如果你没有，别担心 - 它即将推出！) 广告组级别的产品条件只能用于购物市场活动。 资产组级别的产品条件只能与性能最高市场活动一起使用。 产品范围允许你选择目录中的哪些项要包含在市场活动中，例如，按品牌或条件进行筛选。

语法

<xs:complexType name="ProductCondition" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Attribute" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Operand" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Operator" nillable="true" type="xs:string">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

元素

ProductCondition 对象具有以下元素：Attribute、Operand、Operator。

元素 说明 数据类型
属性 条件的属性值。

属性的值必须与客户的 Microsoft 商家中心目录文件中指定的值完全匹配。

可用 属性 和 操作数 值因市场活动类型而异。 有关支持的属性和操作数值，请参阅下面的 说明 。

添加或应用： 必填
更新： 自选		 string
操作数 条件的操作数。 操作数隐式包含相等运算符。 例如，请阅读 Brand as Brand=。

添加或应用： 必填
更新： 自选		 string
运算符 规则项运算符。

加： 必填
更新： 必填		 string

备注

有关每个市场活动类型支持的产品条件 (操作数) 和产品价值 (属性) ，请参阅下表。

Feed-Based 受众市场活动的产品条件

可以为每个基于源的受众市场活动指定多个产品条件。 如果产品的属性值等于操作数的属性值，则满足每个条件。 例如，如果操作数设置为 Brand，并将 属性设置为 Contoso，则如果产品目录的 Brand 属性的值等于 Contoso，则满足条件。

产品条件 (操作数) 产品价值 (属性) 说明 业务规则
品牌 产品的制造商、品牌或发布者。

最多 1,000 个字符。		 每个市场活动产品范围筛选器只能指定 一次品牌 操作数。
条件 产品的条件。

如果操作数设置为 Condition，则可以指定的支持属性值为 New、 Used 和 Refurbished。		 每个市场活动产品范围筛选器只能指定 一次条件 操作数。
ProductType1-5

提供五个产品类型操作数值，即 ProductType1、ProductType2、ProductType3、ProductType4 和 ProductType5。		 商家定义的产品类型或类别。

ProductType1 是最高级别的产品类型，ProductType5 是最低级别或最精细的产品类型。

最多 100 个字符。		 每个产品类型操作数可以按市场活动产品范围筛选器使用一次。

如果将操作数设置为从 1 到 5 的产品类型，则必须按升序指定它们。 例如，如果较高级别的产品分区的操作数为“ProductType1”且属性为“Animals & Pet Supplies”，则可以将操作数设置为“ProductType2”。
CustomLabel0-4

提供五个自定义标签操作数值，即 CustomLabel0、CustomLabel1、CustomLabel2、CustomLabel3 和 CustomLabel4。		 由商家定义的自定义标签。

自定义标签（例如 CustomLabel0 和 CustomLabel4）不会基于任何层次结构进行验证。

最多 100 个字符。		 每个 CustomLabel 操作数可以为每个市场活动产品范围筛选器使用一次。

购物活动的产品条件

可以为每个Microsoft购物市场活动和广告组指定多个产品条件。 如果产品的属性值等于操作数的属性值，则满足每个条件。 例如，如果操作数设置为 Brand，属性设置为 Contoso，则如果产品目录的 Brand 属性的值等于 Contoso，则满足条件。

在购物市场活动中，可以在市场活动级别和广告组级别设置产品条件。 下表描述了市场活动 ProductScope 和广告组 ProductPartition 对象的 product Condition (操作数) 和 Product Value (属性) 业务规则。

产品条件 (操作数) 产品价值 (属性) 说明 市场活动产品范围规则 广告组产品分区规则
全部 必须为 null。 不适用。 对于广告组的产品分区，根节点的操作数必须设置为“All”，并将属性设置为 null 或空。
品牌 产品的制造商、品牌或发布者。

最多 1,000 个字符。		 每个市场活动产品范围筛选器只能指定 一次品牌 操作数。 Brand 操作数可以在多个分支中使用，但每个分支只能指定一次。
CategoryL1-5

有五个类别操作数值可用，即 CategoryL1、CategoryL2、CategoryL3、CategoryL4 和 CategoryL5。		 由Microsoft商家中心商店定义的产品类别。 有关有效的类别值和分类，请参阅 必应 类别分类。

CategoryL0 是最高级别的类别，CategoryL4 是最低级别或最精细的类别。

最多 100 个字符。		 每个 CategoryL 操作数可按市场活动产品范围筛选器使用一次。

如果指定将操作数设置为 1 到 5 的产品类别的产品条件，
它们必须按升序进行指定。 例如，如果前面的产品条件的操作数为“CategoryL1”且属性为“Animals & 宠物用品”，则可以将操作数设置为“CategoryL2”。		 每个 CategoryL 操作数都可以在多个分支中使用，但每个分支只能指定一次。 例如，一个分支可能包含 CategoryL1 和 CategoryL2，但不能包含具有 CategoryL2 操作数的另一个节点。

如果将操作数设置为从 1 到 5 的产品类别，则必须按升序指定它们。 例如，如果高级产品分区的操作数为“CategoryL1”且属性为“Animals & 宠物用品”，则可以将操作数设置为“CategoryL2”。

无需在直接父分区中指定以前的级别产品类别操作数。 例如，如果父分区的父级指定 CategoryL1 条件，则可为其分区指定 CategoryL2 条件。
频道 本地库存广告 (LIA) 频道。

可能的值包括“本地存储”和“Online”。

如果市场活动尚未选择加入 本地库存广告，则默认情况下所有产品/服务仅联机 (Channel=Online) 和单通道 (ChannelExclusivity=单通道) 。 有关详细信息，请参阅 本地库存广告 帮助页。		 每个市场活动产品范围筛选器只能指定 一次通道 操作数。 通道操作数可以在多个分支中使用，但每个分支只能指定一次。
ChannelExclusivity 本地库存广告 (LIA) 频道排他性。

可能的值包括“单通道”和“多通道”。

如果市场活动尚未选择加入 本地库存广告，则默认情况下所有产品/服务仅联机 (Channel=Online) 和单通道 (ChannelExclusivity=单通道) 。 有关详细信息，请参阅 本地库存广告 帮助页。		 每个市场活动产品范围筛选器只能指定 一次 ChannelExclusivity 操作数。 ChannelExclusivity 操作数可以在多个分支中使用，但每个分支只能指定一次。
条件 产品的条件。

如果操作数设置为 Condition，则可以指定的支持属性值为 New、 Used 和 Refurbished。		 每个市场活动产品范围筛选器只能指定 一次条件 操作数。 Condition 操作数可以在多个分支中使用，但每个分支只能指定一次。
CustomLabel0-4

提供五个自定义标签操作数值，即 CustomLabel0、CustomLabel1、CustomLabel2、CustomLabel3 和 CustomLabel4。		 由商家定义的自定义标签。

自定义标签（例如 CustomLabel0 和 CustomLabel4）不会基于任何层次结构进行验证。

最多 100 个字符。

此操作数不适用于 赞助产品。		 每个 CustomLabel 操作数可以为每个市场活动产品范围筛选器使用一次。 每个 CustomLabel 操作数都可以在多个分支中使用，但每个分支只能指定一次。 例如，一个分支可能包含 CustomLabel0 和 CustomLabel1，但不能包含具有 CustomLabel1 操作数的另一个节点。
GTIN 商家定义的全球贸易项编号。

GTIN 字段限制为 50 个字符，每个 GTIN 值最多包含 14 位数字。

此操作数仅适用于 赞助产品。		 每个市场活动产品范围筛选器只能指定 一次 GTIN 操作数。 GTIN 操作数可以在多个分支中使用，但每个分支只能指定一次。
Id 商家定义的产品标识符。

最多 1,000 个字符。		 每个市场活动产品范围筛选器只能指定 ID 操作数一次。 ID 操作数可以在多个分支中使用，但每个分支只能指定一次。
MPN 商家定义的全球贸易项编号。

最多 70 个字符。

此操作数仅适用于 赞助产品。		 每个市场活动产品范围筛选器只能指定 MPN 操作数一次。 MPN 操作数可以在多个分支中使用，但每个分支只能指定一次。
ProductType1-5

提供五个产品类型操作数值，即 ProductType1、ProductType2、ProductType3、ProductType4 和 ProductType5。		 商家定义的产品类型或类别。

ProductType1 是最高级别的产品类型，ProductType5 是最低级别或最精细的产品类型。

最多 100 个字符。

此操作数不适用于 赞助产品。		 每个产品类型操作数可以按市场活动产品范围筛选器使用一次。

如果指定将操作数设置为 1 到 5 的产品类型的产品条件，
它们必须按升序进行指定。 例如，如果前面的产品条件的操作数“ProductType1”具有属性“Animals & Pet Supplies”，则可以将操作数设置为“ProductType2”。		 每个 ProductType 操作数都可以在多个分支中使用，但每个分支只能指定一次。 例如，一个分支可能包含 ProductType1 和 ProductType2，但不能包含具有 ProductType2 操作数的另一个节点。

如果将操作数设置为从 1 到 5 的产品类型，则必须按升序指定它们。 例如，如果较高级别的产品分区的操作数为“ProductType1”且属性为“Animals & Pet Supplies”，则可以将操作数设置为“ProductType2”。

无需在直接父分区中指定以前的级别产品类型操作数。 例如，如果父级的父级指定了 ProductType1 条件，则可为其分区指定 ProductType2 条件。

注意

还不是每个人都有此功能。 如果你没有，别担心 - 它即将推出！

可以使用多媒体广告为每个Microsoft搜索市场活动指定多个产品条件。 如果产品的属性值等于操作数的属性值，则满足每个条件。 例如，如果操作数设置为 Brand，属性设置为 Contoso，则如果产品目录的 Brand 属性的值等于 Contoso，则满足条件。

在“搜索市场活动”中，可以在市场活动级别设置产品条件。 下表介绍了市场活动 ProductScope 对象的 product Condition (操作数) 和 Product Value (属性) 业务规则。

产品条件 (操作数) 产品价值 (属性) 说明 市场活动产品范围规则
品牌 产品的制造商、品牌或发布者。

最多 1,000 个字符。		 每个市场活动产品范围筛选器只能指定 一次品牌 操作数。
CategoryL1

一个类别操作数值可用，即 CategoryL1。		 由Microsoft商家中心商店定义的产品类别。 有关有效的类别值和分类，请参阅 必应 类别分类。

最多 100 个字符。		 每个 CategoryL 操作数可按市场活动产品范围筛选器使用一次。
频道 本地库存广告 (LIA) 频道。

可能的值包括“本地存储”和“Online”。

如果市场活动尚未选择加入 本地库存广告，则默认情况下所有产品/服务仅联机 (Channel=Online) 和单通道 (ChannelExclusivity=单通道) 。 有关详细信息，请参阅 本地库存广告 帮助页。		 每个市场活动产品范围筛选器只能指定 一次通道 操作数。
ChannelExclusivity 本地库存广告 (LIA) 频道排他性。

可能的值包括“单通道”和“多通道”。

如果市场活动尚未选择加入 本地库存广告，则默认情况下所有产品/服务仅联机 (Channel=Online) 和单通道 (ChannelExclusivity=单通道) 。 有关详细信息，请参阅 本地库存广告 帮助页。		 每个市场活动产品范围筛选器只能指定 一次 ChannelExclusivity 操作数。
条件 产品的条件。

如果操作数设置为 Condition，则可以指定的支持属性值为 New、 Used 和 Refurbished。		 每个市场活动产品范围筛选器只能指定 一次条件 操作数。
CustomLabel0-4

提供五个自定义标签操作数值，即 CustomLabel0、CustomLabel1、CustomLabel2、CustomLabel3 和 CustomLabel4。		 由商家定义的自定义标签。

自定义标签（例如 CustomLabel0 和 CustomLabel4）不会基于任何层次结构进行验证。

最多 100 个字符。

此操作数不适用于 赞助产品。		 每个 CustomLabel 操作数可以为每个市场活动产品范围筛选器使用一次。
Id 商家定义的产品标识符。

最多 1,000 个字符。		 每个市场活动产品范围筛选器只能指定 ID 操作数一次。
ProductType1

一个产品类型操作数值可用，即 ProductType1。		 商家定义的产品类型或类别。

ProductType1 是最高级别的产品类型。

最多 100 个字符。

此操作数不适用于 赞助产品。		 每个产品类型操作数可以按市场活动产品范围筛选器使用一次。

性能最大市场活动的产品条件

可以为每个Microsoft Performance Max 资产组指定多个产品条件。 如果产品的属性值等于操作数的属性值，则满足每个条件。 例如，如果操作数设置为 Brand，属性设置为 Contoso，则如果产品目录的 Brand 属性的值等于 Contoso，则满足条件。

在性能最高市场活动中，只能在资产组级别设置产品条件。 下表介绍了资产组 AssetGroupListingGroup 对象的 product Condition (操作数) 和 Product Value (属性) 业务规则。

产品条件 (操作数) 产品价值 (属性) 说明 资产组产品分区规则
全部 必须为 null。 对于资产组的产品分区，根节点的操作数必须设置为 All ，属性必须设置为 null 或空。
品牌 产品的制造商、品牌或发布者。

最多 1,000 个字符。		 对于资产组的产品分区，根节点的操作数必须设置为 All ，属性必须设置为 null 或空。
CategoryL1-5

有五个类别操作数值可用，即 CategoryL1、CategoryL2、CategoryL3、CategoryL4 和 CategoryL5。		 由Microsoft商家中心商店定义的产品类别。 有关有效的类别值和分类，请参阅 必应 类别分类。

CategoryL0 是最高级别的类别，CategoryL4 是最低级别或最精细的类别。

最多 100 个字符。		 每个 CategoryL 操作数都可以在多个分支中使用。

每个 CategoryL 操作数都可以在多个分支中使用，但每个分支只能指定一次。 例如，一个分支可能包含 CategoryL1 和 CategoryL2，但不能包含具有 CategoryL2 操作数的另一个节点。

如果将操作数设置为从 1 到 5 的产品类别，则必须按升序指定它们。 例如，如果较高级别的产品分区的操作数 CategoryL1 具有属性 Animals & Pet Supplies，则可以将操作数设置为 CategoryL2。

无需在直接父分区中指定以前的级别产品类别操作数。 例如，如果父分区的父级指定 了 CategoryL1 条件，则可为其分区指定 CategoryL2 条件。
频道 本地库存广告 (LIA) 频道。

可能的值包括“本地存储”和“Online”。

如果市场活动尚未选择加入 本地库存广告，则默认情况下所有产品/服务仅联机 (Channel=Online) 和单通道 (ChannelExclusivity=单通道) 。 有关详细信息，请参阅 本地库存广告 帮助页。		 通道操作数可以在多个分支中使用，但每个分支只能指定一次。
ChannelExclusivity 本地库存广告 (LIA) 频道排他性。

可能的值包括“单通道”和“多通道”。

如果市场活动尚未选择加入 本地库存广告，则默认情况下所有产品/服务仅联机 (Channel=Online) 和单通道 (ChannelExclusivity=单通道) 。 有关详细信息，请参阅 本地库存广告 帮助页。		 ChannelExclusivity 操作数可以在多个分支中使用，但每个分支只能指定一次。
条件 产品的条件。

如果操作数设置为 Condition，则可以指定的支持属性值为 New、 Used 和 Refurbished。		 Condition 操作数可以在多个分支中使用，但每个分支只能指定一次。
CustomLabel0-4

提供五个自定义标签操作数值，即 CustomLabel0、CustomLabel1、CustomLabel2、CustomLabel3 和 CustomLabel4。		 由商家定义的自定义标签。

自定义标签（例如 CustomLabel0 和 CustomLabel4）不会基于任何层次结构进行验证。

最多 100 个字符。		 每个 CustomLabel 操作数都可以在多个分支中使用，但每个分支只能指定一次。 例如，一个分支可能包含 CustomLabel0 和 CustomLabel1，但不能包含具有 CustomLabel1 操作数的另一个节点。
Id 商家定义的产品标识符。

最多 1,000 个字符。		 ID 操作数可以在多个分支中使用，但每个分支只能指定一次。
ProductType1-5

提供五个产品类型操作数值，即 ProductType1、ProductType2、ProductType3、ProductType4 和 ProductType5。		 商家定义的产品类型或类别。

ProductType1 是最高级别的产品类型，ProductType5 是最低级别或最精细的产品类型。

最多 100 个字符。		 每个 ProductType 操作数都可以在多个分支中使用，但每个分支只能指定一次。 例如，一个分支可能包含 ProductType1 和 ProductType2，但不能包含具有 ProductType2 操作数的另一个节点。

如果将操作数设置为从 1 到 5 的产品类型，则必须按升序指定它们。 例如，如果较高级别的产品分区的操作数 ProductType1 具有属性 Animals &Pet Supplies，则可以将操作数设置为 ProductType2。

无需在直接父分区中指定以前的级别产品类型操作数。 例如，如果父分区的父级指定 了 ProductType1 条件，则可为其分区指定 ProductType2 条件。

要求

服务： CampaignManagementService.svc v13
Namespace： https://bingads.microsoft.com/CampaignManagement/v13

使用者

AssetGroupListingGroup
ProductPartition
ProductScope