Campaign Limitation

Learn how you can enforce campaign limitations to set a campaign budget or prevent fraud.

Campaign limitations are an essential tool to control reward distribution, prevent abuse, and maintain the integrity of your loyalty program. These limits allow you to define boundaries for how many times a campaign can be triggered and how many units can be distributed—globally or per member—within a specific time frame.

---

🔒 Types of Limits

You can configure three main types of campaign limitations:

Limit Category	Limit Type	Description
Limit	Per member limit (triggers)	The number of times a campaign can be completed by an individual member.
Budget	Global limit (units)	The total number of units that can be issued across the entire campaign.
Budget	Per member limit (units)	The maximum number of units that an individual member can receive within the campaign.

---

📦 Example

Let’s say you set:

• A global limit of 10,000 units,

• A per-member limit of 100 units.

This ensures that at least 100 different members can benefit from the campaign. Once a member reaches their individual cap (100 units), they won’t receive any additional rewards, even if the campaign is still active, and the event that triggers the campaign meets all the condition. If the campaign reaches 10,000 units in total, it stops rewarding entirely, regardless of individual member activity.

If a unit transferissued by the campaign is canceled, those units are automatically returned to the available pool.

---

⏲️ Time-Based Enforcement

Limits can be configured for specific time intervals.

You can apply each limit using one of the following periods:

Time Period	Behavior
No limit	The limit is not time-bound; it's enforced across the campaign lifetime.
Daily	Enforces the limit over every X calendar days.
Weekly	Enforces the limit every X calendar weeks.
Monthly	Enforces the limit every X calendar months.
Yearly	Enforces the limit every X calendar years.
In total	One-time limit for the entire campaign duration.

🔍 Examples

Daily Limit

• Time window: Every 1 calendar day

• Units issued per member: 230 Each member can earn up to 230 units every 1 calendar day.

Weekly Limit

• Time window: Every 1 calendar week

• Max units: 150 Each member can earn up to 150 units every 1 calendar week.

Monthly Limit

• Time window: Every 1 calendar month

• Max units: 15 Each member can earn up to 15 units every 1 calendar month.

Yearly Limit

• Time window: Every 1 calendar year

• Max units: 1,500 Each member can earn up to 1,500 units throughout the calendar year.

In Total Limit

• Time window: Lifetime (as long as the campaign is active)

• Max units: 1,000 Each member can earn up to 1,000 units throughout the activity of the campaign.

---

🔄 Limit Enforcement Logic

Time-based limits are always enforced using the business date of the event, such as the purchase or custom event date.

📌 Example:

If a campaign allows up to 1,000 points per day, and an admin sends:

• One transaction dated today, and

• One transaction dated two days ago, The member can receive up to 2,000 points total—1,000 for each day—because the system evaluates limits based on the business date value aligned with the event’s business date.

---

🧠 Best Practices

• Use global limits to prevent over-distribution of units in case of system misuse.

• Apply per-member limits to ensure fair reward allocation.

• Combine limits with time windows for campaigns that run over long periods.

• Pair limits with conditions and expressions for added flexibility (e.g., issue rewards only for certain transactions or custom events).

• Always test limit behavior in a staging environment before deploying campaigns at scale.