通过

数据排除记录 - 批量

  • 项目

定义可在批量文件中上传和下载的数据排除字段。

可以通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 DownloadEntity值 SeasonalityAdjustments 来下载帐户中的所有数据排除记录。 此外，下载请求必须包括 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();

对于 数据排除 记录，批量 文件架构中提供了以下属性字段。

市场活动关联

对这些市场活动进行数据排除。

加： 自选
更新： 自选
删除： 自选。 只能指定“市场活动关联”和“市场活动类型”中的一个。 如果设置“市场活动类型”，则此值将为 null。

市场活动类型

对这些市场活动类型进行数据排除。

加： 自选
更新： 自选
删除： 自选。 只能指定“市场活动关联”和“市场活动类型”中的一个。 如果设置“市场活动关联”，则此值将为 null。

说明

数据排除的说明。

加： 必填
更新： 自选
删除： 只读

设备类型

对这些设备类型进行数据排除。

加： 必填
更新： 自选
删除： 只读

End Date

结束日期。

重要说明：该值必须位于帐户时区。 这与在 Microsoft Advertising Web 应用程序中上传脱机转换时的时区选项不同。 有关日期和时间格式的信息，请参阅 基元 XML 数据类型中的 dateTime 条目。

加： 必填
更新： 自选
删除： 只读

Id

数据排除的系统生成的标识符。

加： 没有
更新： 必填
删除： 只读

数据排除

数据排除的名称。

加： 必填
更新： 自选
删除： 只读

开始日期

开始日期。

重要说明：该值必须位于帐户时区。 这与在 Microsoft Advertising Web 应用程序中上传脱机转换时的时区选项不同。 有关日期和时间格式的信息，请参阅 基元 XML 数据类型中的 dateTime 条目。

加： 必填
更新： 自选
删除： 只读