共用方式為

營銷活動產品範圍記錄 - 大量

  • 發行項

使用條件清單定義行銷活動層級產品範圍，以協助判斷要包含在營銷活動中的目錄專案，例如依品牌或條件進行篩選。

您可以將行銷活動產品範圍與購物活動和摘要型對象營銷活動搭配使用，也就是利用商家中心 商店標識碼Microsoft營銷活動。 產品範圍可讓您選擇要包含在營銷活動中的目錄專案，例如依品牌或條件進行篩選。

提示

如需Microsoft購物活動的概觀和詳細資訊，請參閱 產品廣告 技術指南。

注意事項

智慧型購物活動不支援營銷活動層級產品範圍條件，也就是營銷活動類型設定為 [購物] 且 [子類型] 設定為 [ShoppingSmartAds] 的活動。

您可以在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服務要求中包含 CampaignProductScopes 的 DownloadEntity 值，以下載帳戶中的所有行銷活動產品範圍記錄。 此外，下載要求必須包含 EntityData 範圍。 如需大量服務的詳細資訊，包括最佳做法，請參閱 大量下載和上傳。

如果提供有效的 父標識 碼值，下列大量 CSV 範例會新增行銷活動產品範圍。

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Bid,Name,Product Condition 1,Product Value 1,Product Condition 2,Product Value 2,Product Condition 3,Product Value 3,Product Condition 4,Product Value 4,Product Condition 5,Product Value 5,Product Condition 6,Product Value 6,Product Condition 7,Product Value 7,Is Excluded,Parent Criterion Id,Tracking Template,Custom Parameter
Format Version,,,,,,,,,,6.0,,,,,,,,,,,,,,,,,,
Campaign Product Scope,Active,,-113,,,,ClientIdGoesHere,,,,Condition,New,CustomLabel0,MerchantDefinedCustomLabel,,,,,,,,,,,,,,

如果您使用適用於 .NET、Java 或 Python 的 Bing Ads SDK ，則可以使用 BulkServiceManager 來節省時間來上傳和下載 BulkCampaignProductScope 物件，而不是直接呼叫服務作業，並撰寫自定義程式代碼來剖析大量檔案中的每個字段。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignProductScope
var bulkCampaignProductScope = new BulkCampaignProductScope
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // SharedEntityAssociation object of the Campaign Management service.
    CampaignCriterion = new CampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        Criterion = new ProductScope
        {
            // Conditions are mapped to Product Value 1..7 and Product Condition 1..7 columns
            Conditions = new []
            {
                new ProductCondition
                {
                    // 'Product Value 1' column header in the Bulk file
                    Attribute = "New",
                    // 'Product Condition 1' column header in the Bulk file
                    Operand = "Condition",
                    // 'Product Operator 1' column header in the Bulk file
                    Operator = "Operator",
                },
                new ProductCondition
                {
                    // 'Product Value 2' column header in the Bulk file
                    Attribute = "MerchantDefinedCustomLabel",
                    // 'Product Condition 2' column header in the Bulk file
                    Operand = "CustomLabel0",
                    // 'Product Operator 2' column header in the Bulk file
                    Operator = "Operator",
                },
            },
        },
        // 'Id' column header in the Bulk file
        Id = null,
    },

    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkCampaignProductScope);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

針對 營銷活動產品範圍 記錄， 大量檔案架構中提供下列屬性欄位。

行銷活動

包含產品範圍的活動名稱。

加： 唯讀和必要
更新： 唯讀和必要
刪除： 唯讀和必要

注意事項

若要新增、更新和刪除，您必須指定 [父標識符 ] 或 [ 營銷活動 ] 字段。

用戶端識別碼

用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。 伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。 它可以是長度上限為100的任何有效字串。

加： 自選
更新： 自選
刪除： 唯讀

識別碼

系統產生的產品範圍標識碼。

加： 唯讀
更新： 唯讀和必要
刪除： 唯讀和必要

修改時間

上次更新實體的日期和時間。 值為國際標準時間 (UTC)。

注意事項

日期和時間值會反映伺服器上的日期和時間，而不是用戶端。 如需日期和時間格式的相關信息，請參閱 基本 XML 數據類型中的 dateTime 專案。

加： 唯讀
更新： 唯讀
刪除： 唯讀

父項識別碼

包含產品範圍之營銷活動的系統產生標識碼。

此大量欄位會對應至營銷活動記錄的 [標識符] 欄位。

加： 唯讀和必要。 您必須指定現有的行銷活動標識碼，或指定等於父活動記錄之 [標識符] 字段的負標識符。 如果您要將新產品範圍新增至相同大量檔案中的新行銷活動，建議您這麼做。 如需詳細資訊，請 參閱大量檔案架構參考密鑰。
更新： 唯讀
刪除： 唯讀

注意事項

若要新增、更新和刪除，您必須指定 [父標識符 ] 或 [ 營銷活動 ] 字段。

產品條件 1

條件的操作數。 操作數隱含包含等號運算符。 例如，您可以將 Brand 讀取為 Brand=。

使用每個產品條件做為對應產品值的操作數。

產品條件 (操作數) 產品值 (屬性) Product Operator (Operator)
產品條件 1 產品值 1 產品操作員 1
產品條件 2 產品值 2 產品操作員 2
產品條件 3 產品值 3 產品操作員 3
產品條件 4 產品值 4 產品操作員 4
產品條件 5 產品值 5 產品操作員 5
產品條件 6 產品值 6 產品操作員 6
產品條件 7 產品值 7 產品操作員 7

如果產品的屬性值等於操作數的屬性值，就會符合每個條件。 例如，如果操作數設定為 Brand，且 屬性設定為 Contoso，則如果產品目錄的 Brand 屬性值等於 Contoso，就會符合條件。

注意事項

若要新增和更新，至少需要一個產品條件和值組，且索引編號沒有相關性。 例如，您可以指定 產品條件 2 和 產品值 2 的有效值 ，並將其餘條件和值欄位保留空白。

加： 自選
更新： 唯讀。 您無法更新條件或值欄位。 若要更新條件，您必須刪除產品範圍並新增一個新範圍。
刪除： 唯讀

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

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，就會符合條件。

在購物活動中，可以在營銷活動和廣告群組層級設定產品條件。 下表說明產品條件 (操作數) 和產品值 (屬性) 行銷活動產品範圍 和 廣告群組產品數據分割 記錄的商務規則。

產品條件 (操作數) 產品值 (屬性) 描述 營銷活動產品範圍規則 廣告群組產品分割規則
全部 必須是 null。 不適用。 針對廣告群組的產品分割區，根節點必須將操作數設定為 「All」，並將屬性設定為 Null 或空白。
品牌 產品的製造商、品牌或發行者。

最多 1,000 個字元。		 每個營銷活動產品範圍篩選只能指定品牌操作數一次。 Brand 操作數可用於多個分支，但每個分支只能指定一次。
CategoryL1-5

有五個類別操作數值可供使用，例如 CategoryL1、CategoryL2、CategoryL3、CategoryL4 和 CategoryL5。		 Microsoft商家中心商店所定義的產品類別。

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 操作數可用於多個分支，但每個分支只能指定一次。
識別碼 商家所定義的產品標識碼。

最多 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 條件。

產品條件 2

支援與 產品條件 1 相同的值和規則。

產品條件 3

支援與 產品條件 1 相同的值和規則。

產品條件 4

支援與 產品條件 1 相同的值和規則。

產品條件 5

支援與 產品條件 1 相同的值和規則。

產品條件 6

支援與 產品條件 1 相同的值和規則。

產品條件 7

支援與 產品條件 1 相同的值和規則。

產品操作員 1

條件的運算子值。 運算子值 等於 或 notequal。

加： 自選
更新： 唯讀。 您無法更新條件或值欄位。 若要更新條件，您必須刪除行銷活動產品範圍並新增一個。
刪除： 唯讀

產品操作員 2

支援與 Product Operator 1 相同的值和規則。

產品操作員 3

支援與 Product Operator 1 相同的值和規則。

產品操作員 4

支援與 Product Operator 1 相同的值和規則。

產品操作員 5

支援與 Product Operator 1 相同的值和規則。

產品操作員 6

支援與 Product Operator 1 相同的值和規則。

產品操作員 7

支援與 Product Operator 1 相同的值和規則。

產品值 1

條件的屬性值。 屬性的值必須完全符合客戶Microsoft商家中心目錄檔案中指定的值。

如需商務規則，請 參閱產品條件 1。

加： 必填
更新： 唯讀。 您無法更新條件或值欄位。 若要更新條件，您必須刪除行銷活動產品範圍並新增一個。
刪除： 唯讀

產品值 2

支援與 產品值 1 相同的值和規則。

產品值 3

支援與 產品值 1 相同的值和規則。

產品值 4

支援與 產品值 1 相同的值和規則。

產品值 5

支援與 產品值 1 相同的值和規則。

產品值 6

支援與 產品值 1 相同的值和規則。

產品值 7

支援與 產品值 1 相同的值和規則。

狀態

產品範圍的狀態。

可能的值為 [作用中 ] 或 [已刪除]。

加： 自選。 唯一可能的狀態是 [作用中]。 如果您將狀態設定為 [已刪除] ，則會忽略該狀態，且傳回的記錄的狀態會設定為 [作用中]。
更新： 自選
刪除： 必填。 [狀態] 必須設定為 [ 已刪除]。