The BudgetingService provides operations for managing the daily spend limits of accounts and campaigns.
The account daily spend limit is the monetary budget amount you want to spend per day for all campaigns in an account. The campaign daily spend limit is the monetary budget amount you want to spend per day for a specific campaign.
If set, the campaign daily spend limit amount will override (but will not exceed) the account daily spend limit for the specified campaign. For example, suppose the account daily spend limit is $1000. If you set the campaign daily spend limit to $500, this limit is used. However, if you set the campaign daily spend limit to $1500, this limit is not used; the account daily spend limit of $1000 is used instead.
For new accounts, the daily spend limit is set when you create (add) the account.
For legacy accounts, the daily spend limit may or may not be set. To determine the status, use the getAccountDailySpendLimitStatus operation. To set the daily spend limit, use the updateAccountDailySpendLimit operation. Once the daily spend limit is set, it can be updated but it cannot be disabled.
When the account daily spend limit is reached, all ads in the account will stop serving for the rest of the day. To determine the daily spend limit amount, use the getAccountDailySpendLimit operation. To update the daily spend limit amount, use the updateAccountDailySpendLimit operation.
Unlike the account daily spend limit, you can turn the campaign daily spend limit on or off. To determine the status, use the getCampaignDailySpendLimitStatus operation. To enable or disable the daily spend limit, use the updateCampaignDailySpendStatus operation.
As noted, the campaign daily spend limit amount overrides (but will not exceed) the account daily spend limit. To determine the daily spend limit amount, use the getCampaignDailySpendLimit operation. To enable and/or update the daily spend limit amount, use the updateCampaignDailySpendLimit operation.
Campaign optimization allows you to optimize the spend of a campaign's monthly budget based on the guidelines that you provide (see the Campaign Optimization). Campaign optimization affects the account and campaign daily spend limits differently.
If you enable campaign optimization, you can continue to use the updateAccountDailySpendLimit operation to adjust the account daily spend limit, if necessary.
The account daily spend limit acts as a spending safe guard for all campaign activity. If optimization sets the campaign daily spend limit to be greater than the account daily spend limit, the account daily spend limit is used instead.
If you enable campaign optimization, the campaign daily spend limit is controlled and automatically adjusted for you. If you try to set the campaign daily spend limit using the updateCampaignDailySpendLimit operation, it will generate an error. If you try to enable or disable the daily spend limit using the updateCampaignDailySpendStatus operation, it will generate an error.
If you subsequently disable campaign optimization, the campaign daily spend limit remains set to the last value used during optimization. You can use the getCampaignDailySpendLimit operation to determine the actual spend limit amount and the updateCampaignDailySpendLimit operation to re-set this amount, if desired.