キャンペーンの負のストア条件レコード - 一括

[アーティクル]
11/13/2024

一括ファイルでアップロードおよびダウンロードできるキャンペーンの否定的なストア条件を定義します。

各 キャンペーンの負のストア条件 では、ブランドのショッピングキャンペーンから 1 つの Microsoft Merchant Center ストアが除外されます。各キャンペーンの除外店舗数は最大 10 個です。

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

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

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Store Id,Name
Format Version,,,,,,,,,6.0
Campaign Negative Store Criterion,Active,,-114,,,ClientIdGoesHere,,StoreIdGoesHere,

.NET、Java、または Python 用の Bing Ads SDK を使用している場合は、 BulkServiceManager を使用して BulkCampaignNegativeStoreCriterion オブジェクトをアップロードしてダウンロードする時間を節約できます。サービス操作を直接呼び出し、カスタムコードを記述して一括ファイル内の各フィールドを解析する代わりにします。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignNegativeStoreCriterion
var bulkCampaignNegativeStoreCriterion = new BulkCampaignNegativeStoreCriterion
{
    // Map properties in the Bulk file to the 
    // NegativeCampaignCriterion object of the Campaign Management service.
    NegativeCampaignCriterion = new NegativeCampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        Criterion = new StoreCriterion
        {
            // 'Store Id' column header in the Bulk file
            StoreId = StoreIdGoesHere,
        },
        // 'Id' column header in the Bulk file
        Id = null,
    },
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkCampaignNegativeStoreCriterion);

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

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

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

キャンペーン
クライアント ID
Id
変更時刻
Parent Id
状態
ストア ID

キャンペーン

ストア条件を含むキャンペーンの名前。

追加： 読み取り専用と必須
更新： 適用されません。負のストアは追加および削除できますが、更新することはできません。
削除： 読み取り専用と必須

注:

追加、更新、削除を行うには、[ 親 ID ] フィールドまたは [ キャンペーン ] フィールドを指定する必要があります。

クライアント ID

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

追加： オプション
更新： 適用されません。負のストアは追加および削除できますが、更新することはできません。
削除： 読み取り専用

Id

ストア条件のシステム生成識別子。

追加： 読み取り専用
更新： 適用されません。負のストアは追加および削除できますが、更新することはできません。
削除： 読み取り専用と必須

変更時刻

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

注:

日付と時刻の値は、クライアントではなく、サーバーでの日付と時刻を反映します。日付と時刻の形式については、「プリミティブ XML データ型」の dateTime エントリを参照してください。

追加： 読み取り専用
更新： 適用されません。負のストアは追加および削除できますが、更新することはできません。
削除： 読み取り専用

Parent Id

ストア条件を含むキャンペーンのシステム生成識別子。

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

追加： 読み取り専用と必須。既存のキャンペーン識別子を指定するか、親キャンペーンレコードの Id フィールドと等しい負の識別子を指定する必要があります。これは、同じ Bulk ファイル内の新しいキャンペーンに新しい動的広告ターゲットを追加する場合に推奨されます。詳細については、「一括ファイルスキーマ参照キー」を参照してください。
更新： 適用されません。負のストアは追加および削除できますが、更新することはできません。
削除： 読み取り専用

注:

追加、更新、削除を行うには、[ 親 ID ] フィールドまたは [ キャンペーン ] フィールドを指定する必要があります。

状態

ストア条件の状態。

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

追加： オプション。既定値は [アクティブ] です。
更新： 適用されません。負のストアは追加および削除できますが、更新することはできません。
削除： 必須。 [状態] を [削除済み] に設定する必要があります。

ストア ID

除外する Microsoft Merchant Center ストアのシステム生成識別子。

追加： 必須
更新： 適用されません。負のストアは追加および削除できますが、更新することはできません。
削除： 読み取り専用

次の方法で共有