Budget Data Object - Campaign Management

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

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

The Budget object has the following elements: Amount, AssociationCount, BudgetType, Id, Name.

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. 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