Skip to main content

Retrieving User Promotion Limits

The /api/v2/marketing-actions/balance/ method returns a user's limits relative to limited promotions.

Link to the method: /api/v2/marketing-actions/balance/

Why Balance (Limits) is Needed​

Limits in promotion settings allow you to set restrictions on how many times and in what volume a promotion can trigger.

Examples when this is needed:

  • a marketing campaign has a limited budget;
  • you need to add a restriction for a client, e.g.: promotion is available 1 time per day.

What Restrictions Exist​

Restrictions can be set:

  • by total number of triggers (e.g., a promotion stops being active after the first N applications);
  • by number of triggers for a specific client considering a time window (e.g., 1 time per day, 2 times per month, etc.).

Minimum Product Price​

A promotion can take into account the minimum product price and not allow reducing the cost below it. This is useful for controlling margin and protecting against too strong a discount when several promotions intersect.

In What Units are Limits Measured​

Restrictions can be set in different measurements, for example:

  • in the number of sold positions;
  • in the amount of provided discount.