キャンペーン製品のスコープ レコード - 一括

キャンペーンに含めるカタログの項目を特定するのに役立つ条件の一覧を含むキャンペーン レベルの製品の範囲を定義します (たとえば、ブランドや条件でフィルター処理)。

キャンペーン製品の範囲は、ショッピング キャンペーンとフィードベースのオーディエンス キャンペーンの両方、つまり、Microsoft Merchant Center ストア ID を利用するキャンペーンの両方で使用できます。 製品スコープを使用すると、キャンペーンに含めるカタログのアイテム (ブランドや条件でフィルター処理など) を選択できます。

アカウント内のすべてのキャンペーン製品スコープ レコードをダウンロードするには、DownloadCampaignsByAccountIds または DownloadCampaignsByCampaignIds サービス要求に CampaignProductScopes の DownloadEntity 値を含めます。 さらに、ダウンロード要求には EntityData スコープを含める必要があります。 ベスト プラクティスを含む一括サービスの詳細については、「 一括ダウンロードとアップロード」を参照してください。

次の一括 CSV の例では、有効な 親 ID 値が指定されている場合に、新しいキャンペーン製品のスコープを追加します。

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();

キャンペーン製品のスコープ レコードの場合、一括ファイル スキーマでは、次の属性フィールドを使用できます。

• Campaign
• クライアント ID
• Id
• 変更時刻
• Parent Id
• 製品条件 1
• 製品条件 2
• 製品条件 3
• 製品条件 4
• 製品条件 5
• 製品条件 6
• 製品条件 7
• 製品オペレーター 1
• 製品オペレーター 2
• 製品オペレーター 3
• 製品オペレーター 4
• 製品オペレーター 5
• 製品オペレーター 6
• 製品オペレーター 7
• 製品価値 1
• 製品価値 2
• 製品価値 3
• 製品価値 4
• 製品価値 5
• 製品価値 6
• 製品価値 7
• 状態

キャンペーン

製品スコープを含むキャンペーンの名前。

足す： 読み取り専用と必須
更新： 読み取り専用と必須
削除： 読み取り専用と必須

クライアント ID

一括アップロード ファイル内のレコードを結果ファイル内のレコードに関連付けるために使用されます。 このフィールドの値は、サーバーによって使用または格納されません。アップロードされたレコードから対応する結果レコードにコピーされます。 最大 100 の長さの任意の有効な文字列を指定できます。

足す： 随意
更新： 随意
削除： 読み取り専用

Id

製品スコープのシステム生成識別子。

足す： 読み取り専用
更新： 読み取り専用と必須
削除： 読み取り専用と必須

変更時刻

エンティティが最後に更新された日付と時刻。 値は、世界協定時刻 (UTC) です。

足す： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

Parent Id

製品スコープを含むキャンペーンのシステム生成識別子。

この一括フィールドは、キャンペーン レコードの Id フィールドにマップされます。

足す： 読み取り専用と必須。 既存のキャンペーン識別子を指定するか、親キャンペーン レコードの Id フィールドと等しい負の識別子を指定する必要があります。 これは、同じ Bulk ファイル内の新しいキャンペーンに新しい製品スコープを追加する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新： 読み取り専用
削除： 読み取り専用

製品条件 1

条件のオペランド。 オペランドには、equal 演算子が暗黙的に含まれます。 たとえば、「 Brand as Brand=」と読むことができます。

各製品条件を、対応する製品値のオペランドとして使用します。

各条件は、製品の属性値がオペランドの属性値と等しい場合に満たされます。 たとえば、オペランドが Brand に設定され、属性が Contoso に設定されている場合、製品カタログの Brand 属性の値が Contoso と等しい場合、条件が満たされます。

足す： 随意
更新： 読み取り専用。 条件フィールドまたは値フィールドを更新することはできません。 条件を更新するには、製品スコープを削除し、新しいスコープを追加する必要があります。
削除： 読み取り専用

キャンペーンの種類ごとにサポートされている製品条件 (オペランド) と製品値 (属性) については、次の表を参照してください。

Feed-Based オーディエンス キャンペーンの製品条件

フィードベースのオーディエンス キャンペーンごとに、複数の製品条件を指定できます。 各条件は、製品の属性値がオペランドの属性値と等しい場合に満たされます。 たとえば、オペランドが Brand に設定され、属性が Contoso に設定されている場合、製品カタログの Brand 属性の値が Contoso と等しい場合、条件が満たされます。

ショッピング キャンペーンの商品条件

Microsoft ショッピング キャンペーンと広告グループごとに、複数の製品条件を指定できます。 各条件は、製品の属性値がオペランドの属性値と等しい場合に満たされます。 たとえば、オペランドが Brand に設定され、属性が Contoso に設定されている場合、製品カタログの Brand 属性の値が Contoso と等しい場合、条件が満たされます。

ショッピング キャンペーンでは、製品の条件をキャンペーンレベルと広告グループレベルで設定できます。 次の表では、 キャンペーン製品スコープ レコードと 広告グループ製品パーティション レコードの製品条件 (オペランド) と製品値 (属性) ビジネス ルールについて説明します。

製品条件 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 Merchant Center カタログ ファイルで指定された値と完全に一致している必要があります。

ビジネス ルールについては、「 製品条件 1」を参照してください。

足す： 必須
更新： 読み取り専用。 条件フィールドまたは値フィールドを更新することはできません。 条件を更新するには、キャンペーン製品のスコープを削除し、新しい製品を追加する必要があります。
削除： 読み取り専用

製品価値 2

製品値 1 と同じ値とルールをサポートします。

製品価値 3

製品値 1 と同じ値とルールをサポートします。

製品価値 4

製品値 1 と同じ値とルールをサポートします。

製品価値 5

製品値 1 と同じ値とルールをサポートします。

製品価値 6

製品値 1 と同じ値とルールをサポートします。

製品価値 7

製品値 1 と同じ値とルールをサポートします。

状態

製品スコープの状態。

使用可能な値は [アクティブ] または [削除済み] です。

足す： 随意。 使用可能な状態は [アクティブ] のみです。 状態を [削除済み] に設定すると無視され、返されたレコードの状態が [アクティブ] に設定されます。
更新： 随意
削除： 必須。 [状態] を [削除済み] に設定する必要があります。