季節性調整記錄 - 大量

發行項
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。

描述

季節性調整的描述。

加：必填
更新： 自選
刪除： 唯讀

裝置類型

對這些裝置類型進行季節性調整。

加：必填
更新： 自選
刪除： 唯讀

結束日期

結束日期。

重要：此值必須位於您的帳戶時區中。這與您在 Microsoft Advertising Web 應用程式中上傳脫機轉換時的時區選項不同。如需日期和時間格式的相關信息，請參閱基本 XML 數據類型中的 dateTime 專案。

加：必填
更新： 自選
刪除： 唯讀

識別碼

系統產生的季節性調整標識碼。

加：沒有
更新： 必填
刪除： 唯讀