予算レコード - 一括
一括ファイルでアップロードおよびダウンロードできる予算を定義します。
同じアカウント内の任意のキャンペーンで使用できる 1 日の予算を 1 つ設定できます。 これにより、1 日の予算をすべてのキャンペーンに、または Microsoft Advertising アカウント内の定義済みのキャンペーン グループ全体に効率的に配分できます。
たとえば、毎日 2 つのキャンペーン間で一様に使用される予算が 20 ドルであるとします。 キャンペーン A は、通常よりも少ないインプレッション数とクリック数を得たため、特定の日に 8 ドル (10 ドルの予算) のみを費やします。 共有予算を使用して、キャンペーン B のパフォーマンスが良好な場合、Microsoft Advertising は残りの $2 を自動的に受け取り、それをキャンペーン B に割り当てます。これにより、残りの予算を使用してトラフィックが増える可能性が高まります。
DownloadCampaignsByAccountIds または DownloadCampaignsByCampaignIds サービス要求に Budgets の DownloadEntity 値を含めることで、アカウント内のすべての予算レコードをダウンロードできます。 さらに、ダウンロード要求には EntityData スコープを含める必要があります。 ベスト プラクティスを含む一括サービスの詳細については、「 一括ダウンロードとアップロード」を参照してください。
次の一括 CSV の例では、新しい予算を追加します。
Type,Status,Id,Parent Id,Client Id,Modified Time,Budget Id,Budget Name,Budget,Budget Type,Name
Format Version,,,,,,,,,,6.0
Budget,Active,-20,0,ClientIdGoesHere,,,My Shared Budget,50,DailyBudgetStandard,
.NET、Java、または Python 用 の Bing Ads SDK を 使用している場合は、 BulkServiceManager を使用して、サービス操作を直接呼び出し、カスタム コードを記述してバルク ファイル内の各フィールドを解析する代わりに、 BulkBudget オブジェクトをアップロードしてダウンロードする時間を節約できます。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkBudget
var bulkBudget = new BulkBudget
{
// 'Parent Id' column header in the Bulk file
AccountId = 0,
// Map properties in the Bulk file to the
// Budget object of the Campaign Management service.
Budget = new Budget
{
// 'Budget' column header in the Bulk file
Amount = 50,
// 'Budget Type' column header in the Bulk file
BudgetType = BudgetLimitType.DailyBudgetStandard,
// 'Budget Name' column header in the Bulk file
Name = "My Shared Budget",
// 'Id' column header in the Bulk file
Id = budgetIdKey,
},
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Status' column header in the Bulk file
Status = Status.Active
};
uploadEntities.Add(bulkBudget);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
Budget レコードの場合、一括ファイル スキーマでは、次の属性フィールドを使用できます。
予算
予算を共有するすべてのキャンペーンで 1 日に費やす金額。
追加： 必須
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用
予算名
予算の名前。 名前は、アカウント内のすべての予算で一意である必要があります。 名前には、最大 255 文字を含めることができます。
サービスは、名前を既存の予算名と比較するときに、大文字と小文字を区別しない比較を実行します。
追加： 必須
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用
予算の種類
予算タイプは、予算が 1 日を通して費やされるペースを決定します。
設定できる有効な予算の種類は DailyBudgetStandard のみです。
追加： 必須
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用
クライアント ID
一括アップロード ファイル内のレコードを結果ファイル内のレコードに関連付けるために使用されます。 このフィールドの値は、サーバーによって使用または格納されません。アップロードされたレコードから対応する結果レコードにコピーされます。 最大 100 の長さの任意の有効な文字列を指定できます。
追加： オプション
更新： オプション
削除： 読み 取り 専用
Id
予算のシステム生成識別子。
追加： オプション。 このフィールドは空のままにするか、負の識別子を指定する必要があります。 その後、予算に対して設定された負の識別子は、キャンペーンなどの依存レコードタイプの [予算 ID] フィールドで参照できます。 これは、同じ Bulk ファイルに新しい予算レコードと新しい依存レコードを追加する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新： 読み取り専用と必須
削除： 読み取り専用と必須
変更時刻
エンティティが最後に更新された日付と時刻。 値は、世界協定時刻 (UTC) です。
注:
日付と時刻の値は、クライアントではなく、サーバーでの日付と時刻を反映します。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。
追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用
Parent Id
予算を含む勘定のシステム生成識別子。
この一括フィールドは、取引先企業レコードの Id フィールドにマップされます。
追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用
状態
予算の状態。
使用可能な値は [アクティブ] または [削除済み] です。
追加： オプション。 既定値は [アクティブ] です。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 必須。 [状態] を [削除済み] に設定する必要があります。