Rule Based Campaigns

Learn how Rule Based campaigns use reactors to automate loyalty logic in response to user actions. Covers how reactors work within campaigns, when to use Rule Based campaigns, and practical examples.

What are Rule Based campaigns?

Rule Based campaigns respond to events immediately. Every time a qualifying event is reported and conditions are met, the campaign's reactions fire. They don't track progress toward a completion target, but they do record how many times each user has earned — see Tracking participation below. The campaign runs continuously for as long as it is active.

Under the hood, Rule Based campaigns use reactors — the same event-driven rules engine that powers the Loyalty Engine. A Rule Based campaign is a reactor (or group of reactors) organised under a named campaign entity with a schedule and a clear purpose.

When to use Rule Based campaigns

Rule Based campaigns are the right choice when you want the system to react to events as they happen, without tracking cumulative progress. Common use cases:

• Baseline earning rules — earn 1 point per £1 spent on every purchase

• Promo code rewards — issue a voucher when a valid code is submitted

• Time-limited promotions — double points during a specific weekend or holiday

• Webhook notifications — call an external service when a specific event occurs

• Audience-targeted offers — bonus points for VIP members on purchases

How Rule Based campaigns work

A Rule Based campaign contains one or more reactors. Each reactor defines:

1. Event trigger — the event type that activates the reactor

2. Conditions (optional) — criteria the event or user must meet

3. Reactions — what happens when a trigger fires and conditions are met

4. Activation limits (optional) — how many times the reactor can trigger

When an event is reported to the Loyalty Engine:

1. The engine checks which active reactors are listening for that event type.

2. For each matching reactor, it evaluates conditions.

3. If conditions pass, the configured reactions fire.

This happens in real time — there is no delay or batching.

Multiple reactors in a campaign

A Rule Based campaign can contain more than one reactor. This is useful for grouping related rules under a single campaign. For example, a "Summer Sale" campaign might contain:

• A reactor awarding bonus points on purchases

• A reactor calling a webhook to send a promotional email

• A reactor issuing a voucher to users who spend over £100

All three are logically part of the same initiative and share the campaign's start and end dates.

Each reactor within a campaign operates independently. They share the campaign's schedule and name but evaluate their own triggers, conditions, and reactions separately.

See Reactors for a detailed reference on configuring reactors within a campaign.

---

Rule Based campaign examples

Campaign	Trigger	Conditions	Reaction
Core points earning	ORDER_PLACED	None	+1 point per £1 spent
Double points weekend	ORDER_PLACED	Date between Fri–Sun	+1 point per £1 spent (concurrent with base earning)
VIP bonus	ORDER_PLACED	User in audience: VIP	+2x points multiplier
Partner promo code	SUBMITTED_CODE	Code = FREE5; limit: first 100 users	£5 voucher + webhook for thank you email
Social mention reward	MENTIONED_YOU_SOCIAL	User in audience: Over 5,000 followers	+2,000 points + Influencer badge

---

Tracking participation

Rule Based campaigns don't track progress toward a completion target the way missions do — but you can still see how many times each user has earned from a campaign.

From the campaign or the campaign list, choose Track users to see the list of participating users, each with a count of how many times they've triggered the campaign's reactors. Reporting a qualifying event increments that user's count.

Tracking respects each reactor's conditions. In a campaign with more than one reactor, a user is only counted against the reactors they qualify for — so if one reactor is open to everyone and another is limited to an audience, a user outside that audience is counted on the first but not the second.

---

For existing reactor users

If you've been creating standalone reactors, Rule Based campaigns will feel familiar. The reactor configuration is unchanged — same triggers, conditions, reactions, and activation limits. The difference is organisational: reactors now live inside a campaign, giving you a named, scheduled, manageable container for related rules.

Existing standalone reactors will continue to function. You can migrate them into campaigns at your own pace.