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