| Name | Modifier & Defaults | Type | Description |
|---|---|---|---|
| spending_limit_model | Required | String Note: Use the Dictionary to fetch the latest, up-to-date enum values. Possible Values: MONTHLY Monthly recurring budget ENTIRE Non-recurring budget | The Spending Limit model defines whether the campaign will have a monthly recurring budget (which replenishes automatically each month), or an overall budget. For a detailed overview, see below. |
Overview
When defining the spending limit for a given campaign, the following 2 fields work together:
spending_limitspending_limit_model
In general, campaigns have 2 possible spending models:
- Entire Budget
spending_limit= entire amount that the campaign can consume.- Once the budget is depleted, the campaign stops running, and
status= DEPLETED.
- Monthly Budget
spending_limit= monthly amount the campaign can consume.- Once the budget is depleted, the campaign stops running for this month, and
status= MONTHLY_DEPLETED. - When a new month begins, the campaign's budget is replenished and the campaign starts running again (
status= RUNNING).
To set the spending model to Entire Budget, set
spending_limit_model= ENTIRE.
To set the spending model to Monthly Budget, setspending_limit_model= MONTHLY.