季節性調整レコード - 一括
一括ファイルでアップロードおよびダウンロードできる季節性調整フィールドを定義します。
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();
季節性調整レコードの場合は、一括ファイル スキーマで次の属性フィールドを使用できます。
調整値
換算レート調整の割合。
足す： 必須
更新： 随意
削除： 読み取り専用
キャンペーンの関連付け
これらのキャンペーンに季節性を調整します。
足す： 随意
更新： 随意
削除： 随意。 [キャンペーンの関連付け] と [キャンペーンの種類] の 1 つのみを指定できます。 [キャンペーンの種類] を設定した場合、 これは null になります。
キャンペーンの種類
これらのキャンペーンタイプに季節性を調整します。
足す： 随意
更新： 随意
削除： 随意。 [キャンペーンの関連付け] と [キャンペーンの種類] の 1 つのみを指定できます。 "キャンペーンの関連付け" を設定した場合、これは null になります。
説明
季節性調整の説明。
足す： 必須
更新： 随意
削除： 読み取り専用
デバイスの種類
これらのデバイスの種類に合わせた季節性の調整を行います。
足す： 必須
更新： 随意
削除： 読み取り専用
終了日
終了日。
重要: 値はアカウントのタイム ゾーンに存在する必要があります。 これは、Microsoft Advertising Web アプリケーションでオフライン コンバージョンをアップロードするときのタイム ゾーン オプションとは異なります。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。
足す： 必須
更新： 随意
削除： 読み取り専用
Id
季節性調整のシステム生成識別子。
足す： 何一つ
更新： 必須
削除： 読み取り専用
季節性の調整
季節性調整の名前。
足す： 必須
更新： 随意
削除： 読み取り専用
開始日
開始日。
重要: 値はアカウントのタイム ゾーンに存在する必要があります。 これは、Microsoft Advertising Web アプリケーションでオフライン コンバージョンをアップロードするときのタイム ゾーン オプションとは異なります。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。
足す： 必須
更新： 随意
削除： 読み取り専用