Budget Data Object - Campaign Management

Represents a budget that can be shared by any campaigns in an account.

Important

The accelerated budget type is deprecated. Please see Deprecating Accelerated Budget Delivery for more information.

You can set a single daily budget that can be used by any campaign within the same account. This will enable you to efficiently distribute a single daily budget across all campaigns or across a defined group of campaigns within your Microsoft Advertising account.

Say you have a budget of $20 to be used uniformly between two campaigns every day. On a given day Campaign A spends only $8 (of its $10 budget) because it got a smaller amount of impressions and clicks than usual. Using a Shared Budget, if Campaign B is performing well then Microsoft Advertising will automatically take the remaining $2 and allocate it to Campaign B. This will increase the chances that the remaining budget will be used to send you more traffic.

Syntax

<xs:complexType name="Budget" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Amount" nillable="true" type="xs:decimal" />
    <xs:element minOccurs="0" name="AssociationCount" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="BudgetType" nillable="true" type="tns:BudgetLimitType" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

Elements

Element Description Data Type
Amount The amount to spend daily across all campaigns that share the budget.

Add: Required
Update: Optional
decimal
AssociationCount The number of Campaign objects that currently share this budget.

Add: Read-only
Update: Read-only
int
BudgetType The budget type determines the pace at which the budget is spent throughout the day.

The only valid budget type that you can set is DailyBudgetStandard.

IMPORTANT: The accelerated budget type has been sunset for shared budgets. As of January 2020 the only valid budget type that you can set is DailyBudgetStandard, and any other budget type value that you attempt to set will be ignored without returning an error. If you had set the budget type to accelerated prior to January 2020, the data has been migrated and the API will only return "DailyBudgetStandard". Please see Deprecating Accelerated Budget Delivery for more information.

Add: Required
Update: Optional
BudgetLimitType
Id The unique Microsoft Advertising identifier of the budget.

Add: Read-only
Update: Required
long
Name The name of the budget. The name must be unique among all budgets within the account. The name can contain a maximum of 255 characters.

The service performs a case-insensitive comparison when it compares the name to existing budget names.

Add: Required
Update: Optional
string

Requirements

Service: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Used By

AddBudgets
GetBudgetsByIds
UpdateBudgets