預算記錄 - 大量
定義可在大量檔案中上傳和下載的預算。
您可以設定單一每日預算,供相同帳戶內的任何行銷活動使用。 這可讓您有效率地將單一每日預算分散到所有行銷活動,或跨 Microsoft Advertising 帳戶內定義的行銷活動群組。
假設您的預算為 $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
在所有共用預算的活動之間每日花費的金額。
添加: 必填
更新: 選。 如果未設定更新的值,則此設定不會變更。
刪除: 唯讀
預算名稱
預算的名稱。 此名稱在帳戶內的所有預算中必須是唯一的。 名稱最多可以包含 255 個字元。
當服務比較名稱與現有的預算名稱時,會執行不區分大小寫的比較。
添加: 必填
更新: 選。 如果未設定更新的值,則此設定不會變更。
刪除: 唯讀
預算類型
預算類型會決定一天花費預算的步調。
您可以設定的唯一有效預算類型是 DailyBudgetStandard。
添加: 必填
更新: 選。 如果未設定更新的值,則此設定不會變更。
刪除: 唯讀
用戶端識別碼
用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。 伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。 它可以是長度上限為 100 的任何有效字串。
添加: 選
更新: 選
刪除: 唯讀
識別碼
系統產生的預算識別碼。
添加: 選。 您必須將此欄位保留空白,或指定負識別碼。 然後,您可以在活動等相依記錄類型的 [預算標識符] 欄位中參考預算的負識別碼集。 如果您要在相同的大量檔案中新增新的預算和新的相依記錄,建議使用此選項。 如需詳細資訊,請 參閱大量檔案架構參考金鑰。
更新: 唯讀和必要
刪除: 唯讀和必要
修改時間
上次更新實體的日期和時間。 值為國際標準時間 (UTC)。
注意事項
日期和時間值會反映伺服器上的日期和時間,而不是用戶端。 如需日期和時間格式的相關資訊,請參閱 基本 XML 資料類型中的 dateTime 專案。
添加: 唯讀
更新: 唯讀
刪除: 唯讀
父項識別碼
系統產生的帳戶識別碼,其中包含預算。
此大量欄位會對應至客戶紀錄的 [ 標識 符 ] 字 段。
添加: 唯讀
更新: 唯讀
刪除: 唯讀
狀態
預算的狀態。
可能的值為 [作用中 ] 或 [已刪除]。
添加: 選。 預設值為 Active。
更新: 選。 如果未設定更新的值,則此設定不會變更。
刪除: 必填。 [狀態] 必須設定為 [ 已刪除]。