spending_limit_model

NameModifier & DefaultsTypeDescription
spending_limit_modelRequiredString

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_limit
  • spending_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, set spending_limit_model = MONTHLY.