Hide

Shared Budgets


What are Shared Budgets?

When you create new Budgets using the AdWords API, they can be shared among many campaigns by default. You can assign these Budgets to more than one campaign, hence they are called Shared Budgets.

You can choose not to share a Budget at creation by setting isExplicitlyShared to false. Once a Budget is explicitly shared, you cannot change its isExplicitlyShared value from true to false. Any attempt to do so will result in a BudgetError.CANNOT_UPDATE_BUDGET_TO_IMPLICITLY_SHARED. However, you can change a non-shared Budget to shared, provided there are no active experiments running on any of the campaigns using the Budget.

Using the API, how can I tell if a budget can be linked to more than one campaign?

You can check whether a Budget is shareable by looking at its isExplicitlyShared value. If it is set to true, the Budget can be shared with multiple campaigns.

When you use the AdWords user interface to manage/create/view Budgets, you need to be aware of the differences between Budgets that are shareable and those that are not. Unlike Shared Budgets, those that are not shareable do not appear in an Account’s Shared Library in the AdWords user interface. They still exist in the system—they appear within the individual campaign’s Settings in the user interface. The API will return these budgets from BudgetService with an isExplicitlyShared value of false.

Can a Campaign be associated with multiple Budgets?

No. This includes any combination of Budgets that are shareable or not.

How do I convert a Budget to a shared Budget?

A Budget becomes a Shared Budget when you set its isExplicitlyShared field to true.

How do I assign an Existing Shared Budget to a Campaign?

For a new Campaign, in the CampaignService.mutate ADD operation, set the Campaign's budget attribute to a Budget object with its budgetId set to the ID of the existing shared budget.

For an existing Campaign, use a CampaignService.mutate SET operation, set the Campaign’s ID and budget attribute to a Budget object with its budgetId set to the ID of the existing shared budget (along with any other Campaign fields that you might want to set). Note that this will replace the existing Budget assigned to the Campaign with the one specified by the budgetId.

Can a Budget be created at the same time the Campaign that uses it is created?

No. You need to create a budget with BudgetService first and use the resulting budget ID in a subsequent call to CampaignService

Note, in this scenario if the campaign operation fails, an orphaned budget (a budget associated with no campaign) will be created. It is recommended to either re-use or remove such budgets.

How do I find out which Campaigns are using a given Budget?

Make a CampaignService.get operation requesting at minimum the Id field along with a Predicate of the form

BudgetId EQUALS <budget id>

where <budget id> is the ID of the Budget that you want to get the Campaigns for.

How do I remove a Budget?

To remove a Budget, first ensure that no Campaigns are using the Budget. There are Campaigns still using the Budget if its ReferenceCount field (retrieved as the ReferenceCount field in a BudgetService.get operation and BudgetReferenceCount field in a CampaignService.get operation) is not equal to 0. Next send a BudgetService mutate REMOVE request with the Id of the Budget. This does not remove the Budget from AdWords—it just sets its status to REMOVED.

How do I remove Campaigns from a Shared Budget (say if I want to remove the Shared Budget)?

Move any Campaigns that are using the Shared Budget to other Shared Budgets in the Account. To identify Campaigns that are using the Shared Budget see the FAQ "How do I find out which Campaigns are using a given Budget?".

Note: Currently it's not enough to "remove" the Campaigns associated with a Shared Budget in order to be able to remove the Budget, mostly because REMOVED Campaigns only involve a status change, and it's possible to unremove them. We are currently looking at possible options for better managing the removal of Shared Budgets.

What happens to a Shared Budget when I remove the Campaign(s) that uses it?

Nothing changes. The removed Campaigns will still be associated with the Shared Budget and its ReferenceCount will remain the same (equal to the number of Campaigns associated with it regardless of their status).

How do I remove a Budget from a Campaign?

With the exception of Campaigns that use CPA Bids, a Campaign must always be associated with a Budget, you can remove a Budget from a Campaign by replacing it with another Budget (i.e. changing the ID of the Budget associated with the Campaign).

Are there any restrictions on when Budgets can be shared?

Yes, Campaigns that use the Budget Optimizer or that have Campaign Experiments enabled must exclusively have their own Budget.

When I try to create a Budget I see the error: EntityCountLimitExceeded.ACCOUNT_LIMIT. Why is this and what can I do to resolve it?

This error message indicates that you have reached the limit of maximum number of Budgets in an account. It is 11,000 and 20,000 per account for shared Budgets and non-shared Budgets respectively.

See the limit page for more detail.

When I try to share a Budget with multiple campaigns I see the error: CampaignError.BUDGET_CANNOT_BE_SHARED. Why is this and what can I do to resolve it?

This error message indicates that the Budget is associated with a Campaign that is using the Budget Optimizer for its BiddingStrategy. Campaigns that use the BudgetOptimizer must have their own Budget.

If you want the Campaign to use a Shared Budget then do not use the BudgetOptimizer. If you want to use the BudgetOptimizer, assign the campaign to its own Budget.

When I try to assign a Budget to a Campaign I see the error: CampaignError.CANNOT_SET_BUDGET. Why is this and what can I do to resolve it?

This error indicates that the Campaign is using CPA Bids as its bidding strategy and therefore cannot have a Budget.

When I try to assign a Budget to a Campaign I see the error: CampaignError.CAMPAIGN_CANNOT_USE_SHARED_BUDGET. Why is this and what can I do to resolve it?

This error indicates that the Campaign you are trying to add the Budget to is using either Campaign Experiments or is using the Budget Optimizer and that the Budget is already being use by another Campaign.

When I try to modify a Budget I see the error: BudgetError.CANNOT_EDIT_SHARED_BUDGET. Why is this and what can I do to resolve it?

This error indicates that you are trying to modify the Budget associated with a Campaign using the CampaignService; you can only modify Budgets via the BudgetService.

Use the BudgetService to modify the Budget.

Send feedback about...

AdWords API