季节性调整记录 - 批量

项目
11/13/2024

定义可在批量文件中上传和下载的季节性调整字段。

可以通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 SeasonalityAdjustments 的 DownloadEntity 值来下载帐户中的所有季节性调整记录。此外，下载请求必须包括 EntityData 范围。有关批量服务的更多详细信息（包括最佳做法），请参阅批量下载和上传。

以下批量 CSV 示例将添加新的季节性调整。

Type,AccountId,Id,Campaign Type,Start Date,End Date,Name,Description,Adjustment Value,Seasonality Adjustment,Device Type,Campaign Associations
Format Version,,,,,,6.0,,,,,
Seasonality Adjustment,,,Search,3/15/2024 3:00,3/16/2024 3:00,,Description,100,TestSA,Tablets,

如果使用用于 .NET、Java 或 Python 的 Bing Ads SDK ，则可以使用 BulkServiceManager 来节省时间来上传和下载 BulkAdGroupSeasonalityAdjustment 对象，而无需直接调用服务操作并编写自定义代码来分析批量文件中的每个字段。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkSeasonalityAdjustment
var bulkSeasonalityAdjustment = new BulkSeasonalityAdjustment
{
    // Map properties in the Bulk file to the 
    // SeasonalityAdjustment object of the Campaign Management service.
    SeasonalityAdjustment = new SeasonalityAdjustment
    {
        // 'Adjustment Value' column header in the Bulk file
        AdjustmentPercentage = 100,
        // '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),
        // 'Seasonality Adjustment' column header in the Bulk file
        Name = "Seasonality Adjustment",
    },
};

uploadEntities.Add(bulkSeasonalityAdjustment);

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

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

对于 季节性调整 记录，批量文件架构中提供了以下属性字段。

调整值
市场活动关联
市场活动类型
说明
设备类型
"结束日期"
Id
季节性调整
"开始日期"

调整值

转换速率调整的百分比。

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

市场活动关联

对这些市场活动进行季节性调整。

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

市场活动类型

对这些市场活动类型进行季节性调整。

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

说明

季节性调整的说明。

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

设备类型

对这些设备类型进行季节性调整。

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

End Date

结束日期。

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

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

Id

季节性调整的系统生成的标识符。

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