ProductCondition 數據物件 - 營銷活動管理

定義條件，判斷是否從客戶的 Microsoft 商家中心目錄檔案中選取產品。

您可以使用營銷活動層級生產條件搭配購物活動、摘要型對象營銷活動，以及具有多媒體廣告的搜尋活動，也就是利用 Microsoft 商家中心 商店標識碼的營銷活動。 (注意：並非每個人都有具有多媒體廣告的搜尋活動。如果您沒有這麼做，別擔心，很快就會推出！) 廣告群組層級產品條件只能與購物活動搭配使用。 資產群組層級產品條件只能與效能上限活動搭配使用。 產品範圍可讓您選擇要包含在營銷活動中的目錄專案，例如依品牌或條件進行篩選。

語法

<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 商家中心目錄檔案中指定的值。 可用 的 Attribute 和 Operand 值會根據營銷活動類型而有所不同。 For supported attribute and operand values, see Remarks below. 新增或套用： 必填 更新： 選	string
操作	條件的操作數。 操作數隱含包含等號運算符。 例如，將 Brand 讀取為 Brand=。 新增或套用： 必填 更新： 選	string
運算子	規則項目運算元。 添加： 必填 更新： 必填	string

註解

如需每個行銷活動類型的支持產品條件 (操作數) 和產品值 (屬性) ，請參閱下表。

Feed-Based 對象行銷活動的產品條件

您可以為每個摘要型物件行銷活動指定多個產品條件。 如果產品的屬性值等於操作數的屬性值，就會符合每個條件。 例如，如果操作數設定為 Brand，且 屬性設定為 Contoso，則如果產品目錄的 Brand 屬性值等於 Contoso，就會符合條件。

產品條件 (操作數)	產品值 (屬性) 描述	商務規則
品牌	產品的製造商、品牌或發行者。 最多 1,000 個字元。	每個營銷活動產品範圍篩選只能指定品牌操作數一次。
條件	產品的條件。 如果操作數設定為 Condition，您可以指定的支持屬性值為 New、 Used 和 已修改。	條件操作數只能針對每個營銷活動產品範圍篩選指定一次。
ProductType1-5 有五個產品類型操作數值可供使用，例如 ProductType1、ProductType2、ProductType3、ProductType4 和 ProductType5。	由商家定義的產品類型或類別。 ProductType1 是最高層級的產品類型，而 ProductType5 是最低層級或最細微的產品類型。 最多100個字元。	每個產品類型操作數可以在每個營銷活動產品範圍篩選中使用一次。 如果您將操作數設定為從 1 到 5 的產品類型，則必須以遞增順序指定。 例如，如果較高層級的產品磁碟分區具有具有屬性 「ProductType1」 的操作數 「ProductType1」，則操作數可以設定為 「ProductType2」，且屬性為 “Pet & Supplies”，則為 “Pet Supplies”。
CustomLabel0-4 有五個自定義標籤操作數值可供使用，例如 CustomLabel0、CustomLabel1、CustomLabel2、CustomLabel3 和 CustomLabel4。	由商家定義的自定義標籤。 自定義標籤，例如 CustomLabel0 和 CustomLabel4，不會根據任何階層進行驗證。 最多100個字元。	每個營銷活動產品範圍篩選器都可以使用每個 CustomLabel 操作數一次。

購物活動的產品條件

您可以為每個 Microsoft 購物活動和廣告群組指定多個產品條件。 如果產品的屬性值等於操作數的屬性值，就會符合每個條件。 例如，如果操作數設定為 Brand，且 屬性設定為 Contoso，則如果產品目錄的 Brand 屬性值等於 Contoso，就會符合條件。

在購物活動中，可以在營銷活動和廣告群組層級設定產品條件。 下表描述產品條件 (操作數) 和產品值 (屬性) 營銷活動 ProductScope 和廣告群組 ProductPartition 對象的商務規則。

產品條件 (操作數)	產品值 (屬性) 描述	營銷活動產品範圍規則	廣告群組產品分割規則
全部	必須是 null。	不適用。	針對廣告群組的產品分割區，根節點必須將操作數設定為 「All」，並將屬性設定為 Null 或空白。
品牌	產品的製造商、品牌或發行者。 最多 1,000 個字元。	每個營銷活動產品範圍篩選只能指定品牌操作數一次。	Brand 操作數可用於多個分支，但每個分支只能指定一次。
CategoryL1-5 有五個類別操作數值可供使用，例如 CategoryL1、CategoryL2、CategoryL3、CategoryL4 和 CategoryL5。	Microsoft 商家中心商店所定義的產品類別。 如需有效的類別值和分類法，請參閱 Bing 類別分類法。 CategoryL0 是最高層級的類別，而 CategoryL4 是最低層級或最細微的類別。 最多100個字元。	每個營銷活動產品範圍篩選可以使用每個 CategoryL 操作數一次。 如果您指定將操作數設為 1 到 5 之產品類別的產品條件， 它們必須以遞增順序指定。 例如，如果前述產品條件的操作數 「CategoryL1」 屬性為 「Pet Supplies」，則您可以將操作數設定為 「CategoryL2」，其屬性為 「Pet & Supplies」。	每個 CategoryL 操作數都可以在多個分支中使用，但每個分支只能指定一次。 例如，一個分支可能包含 CategoryL1 和 CategoryL2，但不能包含具有 CategoryL2 操作數的另一個節點。 如果您將操作數設定為從 1 到 5 的產品類別，則必須以遞增順序指定。 例如，如果較高層級的產品分割區具有具有屬性 「CategoryL1」 且屬性為 「Pet & Supplies」 的操作數 「CategoryL1」，則操作數可以設定為 「CategoryL2」，而屬性為 “Pet Supplies”。 不需要在直接父數據分割中指定先前層級的產品類別操作數。 例如，如果其父系的父系指定 CategoryL1 條件，則可以為產品分割區指定 CategoryL2 條件。
通道	本機清查廣告 (LIA) 頻道。 可能的值包括「本地商店」和「在線」。 如果營銷活動尚未選擇加入 本機清查廣告，則所有供應項目預設只會 (Channel=Online) 和單一頻道 (ChannelExclusivity=Single-channel) 。 如需詳細資訊，請參閱 本機清查廣告 說明頁面。	通道操作數只能針對每個營銷活動產品範圍篩選指定一次。	通道操作數可用於多個分支，但每個分支只能指定一次。
ChannelExclusivity	本機清查廣告 (LIA) 頻道包容性。 可能的值包括 「Single-channel」 和 「Multi-channel」。。 如果營銷活動尚未選擇加入 本機清查廣告，則所有供應項目預設只會 (Channel=Online) 和單一頻道 (ChannelExclusivity=Single-channel) 。 如需詳細資訊，請參閱 本機清查廣告 說明頁面。	每個營銷活動產品範圍篩選只能指定 ChannelExclusivity 操作數一次。	ChannelExclusivity 操作數可用於多個分支，但每個分支只能指定一次。
條件	產品的條件。 如果操作數設定為 Condition，您可以指定的支持屬性值為 New、 Used 和 已修改。	條件操作數只能針對每個營銷活動產品範圍篩選指定一次。	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” 屬性為 “Pet Supplies”，則您可以將操作數設定為 “ProductType2”，且屬性為 “Pet Supplies &” 。	每個 ProductType 操作數都可以在多個分支中使用，但每個分支只能指定一次。 例如，一個分支可能包含 ProductType1 和 ProductType2，但不能包含另一個具有 ProductType2 操作數的節點。 如果您將操作數設定為從 1 到 5 的產品類型，則必須以遞增順序指定。 例如，如果較高層級的產品磁碟分區具有具有屬性 「ProductType1」 的操作數 「ProductType1」，則操作數可以設定為 「ProductType2」，且屬性為 “Pet & Supplies”，則為 “Pet Supplies”。 不需要在直接父數據分割中指定先前層級的產品類型操作數。 例如，如果 ProductType2 條件的父系指定 ProductType1 條件，則可以為產品分割區指定 ProductType2 條件。

搜尋活動的產品條件

注意事項

並非每個人都有這項功能。 如果沒有，別擔心， 即將推出！

您可以為每個具有多媒體廣告的 Microsoft Search 行銷活動指定多個產品條件。 如果產品的屬性值等於操作數的屬性值，就會符合每個條件。 例如，如果操作數設定為 Brand，且 屬性設定為 Contoso，則如果產品目錄的 Brand 屬性值等於 Contoso，就會符合條件。

在搜尋活動中，產品條件可以在營銷活動層級設定。 下表描述產品條件 (操作數) 和產品值 (屬性) 營銷活動 ProductScope 物件的商務規則。

產品條件 (操作數)	產品值 (屬性) 描述	營銷活動產品範圍規則
品牌	產品的製造商、品牌或發行者。 最多 1,000 個字元。	每個營銷活動產品範圍篩選只能指定品牌操作數一次。
CategoryL1 有一個類別操作數值可供使用，也就是 CategoryL1。	Microsoft 商家中心商店所定義的產品類別。 如需有效的類別值和分類法，請參閱 Bing 類別分類法。 最多100個字元。	每個營銷活動產品範圍篩選可以使用每個 CategoryL 操作數一次。
通道	本機清查廣告 (LIA) 頻道。 可能的值包括「本地商店」和「在線」。 如果營銷活動尚未選擇加入 本機清查廣告，則所有供應項目預設只會 (Channel=Online) 和單一頻道 (ChannelExclusivity=Single-channel) 。 如需詳細資訊，請參閱 本機清查廣告 說明頁面。	通道操作數只能針對每個營銷活動產品範圍篩選指定一次。
ChannelExclusivity	本機清查廣告 (LIA) 頻道包容性。 可能的值包括 「Single-channel」 和 「Multi-channel」。。 如果營銷活動尚未選擇加入 本機清查廣告，則所有供應項目預設只會 (Channel=Online) 和單一頻道 (ChannelExclusivity=Single-channel) 。 如需詳細資訊，請參閱 本機清查廣告 說明頁面。	每個營銷活動產品範圍篩選只能指定 ChannelExclusivity 操作數一次。
條件	產品的條件。 如果操作數設定為 Condition，您可以指定的支持屬性值為 New、 Used 和 已修改。	條件操作數只能針對每個營銷活動產品範圍篩選指定一次。
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 對象的產品條件 (操作數) 和產品值 (屬性) 商務規則。

產品條件 (操作數)	產品值 (屬性) 描述	資產群組產品分割規則
全部	必須是 null。	對於資產群組的產品分割區，根節點必須將操作數設定為 All ，並將屬性設定為Null或空白。
品牌	產品的製造商、品牌或發行者。 最多 1,000 個字元。	對於資產群組的產品分割區，根節點必須將操作數設定為 All ，並將屬性設定為Null或空白。
CategoryL1-5 有五個類別操作數值可供使用，例如 CategoryL1、CategoryL2、CategoryL3、CategoryL4 和 CategoryL5。	Microsoft 商家中心商店所定義的產品類別。 如需有效的類別值和分類法，請參閱 Bing 類別分類法。 CategoryL0 是最高層級的類別，而 CategoryL4 是最低層級或最細微的類別。 最多100個字元。	每個 CategoryL 操作數都可以在多個分支中使用。 每個 CategoryL 操作數都可以在多個分支中使用，但每個分支只能指定一次。 例如，一個分支可能包含 CategoryL1 和 CategoryL2，但不能包含具有 CategoryL2 操作數的另一個節點。 如果您將操作數設定為從 1 到 5 的產品類別，則必須以遞增順序指定。 例如，如果較高層級的產品分割區具有具有類別目錄的操作數 CategoryL1，則操作數可以設定為 CategoryL2，且屬性為 Pet Supplies &。 不需要在直接父數據分割中指定先前層級的產品類別操作數。 例如，如果其父系的父系指定 CategoryL1 條件，則可以為產品分割區指定 CategoryL2 條件。
通道	本機清查廣告 (LIA) 頻道。 可能的值包括「本地商店」和「在線」。 如果營銷活動尚未選擇加入 本機清查廣告，則所有供應項目預設只會 (Channel=Online) 和單一頻道 (ChannelExclusivity=Single-channel) 。 如需詳細資訊，請參閱 本機清查廣告 說明頁面。	通道操作數可用於多個分支，但每個分支只能指定一次。
ChannelExclusivity	本機清查廣告 (LIA) 頻道包容性。 可能的值包括 「Single-channel」 和 「Multi-channel」。。 如果營銷活動尚未選擇加入 本機清查廣告，則所有供應項目預設只會 (Channel=Online) 和單一頻道 (ChannelExclusivity=Single-channel) 。 如需詳細資訊，請參閱 本機清查廣告 說明頁面。	ChannelExclusivity 操作數可用於多個分支，但每個分支只能指定一次。
條件	產品的條件。 如果操作數設定為 Condition，您可以指定的支持屬性值為 New、 Used 和 已修改。	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，操作數可以設定為 ProductType2 與屬性 Pet Supplies。 不需要在直接父數據分割中指定先前層級的產品類型操作數。 例如，如果 ProductType2 條件的父系指定 ProductType1 條件，則可以為產品分割區指定 ProductType2 條件。

需求

服務： CampaignManagementService.svc v13
命名空間： https://bingads.microsoft.com/CampaignManagement/v13

消費者

AssetGroupListingGroup
ProductPartition
ProductScope