データ除外レコード - 一括

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

一括ファイルでアップロードおよびダウンロードできるデータ除外フィールドを定義します。

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

次の一括 CSV の例では、新しいデータ除外を追加します。

Type,AccountId,Id,Campaign Type,Start Date,End Date,Name,Description,Data Exclusion,Device Type,Campaign Associations
Format Version,,,,,,6.0,,,,
Data Exclusion,,,Search,3/15/2024 3:00,3/16/2024 3:00,,Description,TestDE,Tablets,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkDataExclusion
var bulkDataExclusion = new BulkDataExclusion
{
    // Map properties in the Bulk file to the
    // DataExclusion object of the Campaign Management service.
    DataExclusion = new DataExclusion
    {
        // 'Campaign Associations' column header in the Bulk file
        CampaignAssociations = new List<CampaignAssociation>(),
        // 'Campaign Type' column header in the Bulk file
        CampaignTypeFilter = CampaignType.Search,
        // 'Description' column header in the Bulk file
        Description = "Description",
        // 'Device Type' column header in the Bulk file
        DeviceTypeFilter = DeviceType.Computers,
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Start Date' column header in the Bulk file
        StartDate = DateTime.UtcNow,
        // 'End Date' column header in the Bulk file
        EndDate = DateTime.UtcNow.AddDays(7),
        // 'Data Exclusion' column header in the Bulk file
        Name = "Data Exclusion",
    },
};

uploadEntities.Add(bulkDataExclusion);

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

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

データ除外レコードの場合は、一括ファイルスキーマで次の属性フィールドを使用できます。

キャンペーンの関連付け
キャンペーンの種類
説明
デバイスの種類
終了日
Id
データの除外
開始日

キャンペーンの関連付け

これらのキャンペーンに対してデータを除外します。

足す： 随意
更新： 随意
削除： 随意。 [キャンペーンの関連付け] と [キャンペーンの種類] の 1 つのみを指定できます。 [キャンペーンの種類] を設定した場合、 これは null になります。

キャンペーンの種類

これらのキャンペーンの種類に対してデータを除外します。

足す： 随意
更新： 随意
削除： 随意。 [キャンペーンの関連付け] と [キャンペーンの種類] の 1 つのみを指定できます。 "キャンペーンの関連付け" を設定した場合、これは null になります。