For the complete documentation index, see llms.txt. This page is also available as Markdown.

Boost Engine

Reward Your Best Users More

The Boost Engine applies multipliers to campaign rewards based on each user's tier. A base-tier user earning 100 pSP gets 100 pSP. A top-tier user earning 100 pSP gets 250 pSP (or whatever multiplier the brand configured). Same campaign, same base reward, different outcomes based on loyalty commitment.

The entire boost system operates on each brand's own token and tier configuration. A brand issuing FLY Points with its own tier structure gets its own set of multipliers. Two brands on Spree can run entirely different boost configurations without affecting each other.

Example Multipliers

These are example values. Brands configure their own multiplier per tier.

Tier
Example Multiplier
100 pSP base reward becomes

Tier 0

1.0x

100 pSP

Tier 1

1.25x

125 pSP

Tier 2

1.5x

150 pSP

Tier 3

2.0x

200 pSP

Tier 4

2.5x

250 pSP

A DeFi protocol might use aggressive multipliers (1x to 5x). A ticketing company might use gentle ones (1x to 1.5x). Multipliers must increase with each tier level.

Campaign-Specific Boosts

Each campaign can layer additional boosts on top of tier multipliers:

  • Early-bird bonus. The first N users who claim get an extra multiplier. First 500 claimants earn +50% on top of their tier multiplier.

  • Loyalty bonus. Extra boost for users with high activity or holding streaks.

  • Referral bonus. Boost for users who brought referrals into the campaign.

The combined multiplier caps at 10x to prevent runaway payouts.

Guardrails

  • Per-user caps. Limit how many times a single user can receive boosted rewards in a campaign.

  • Cooldowns. Set minimum time between boost applications for the same user.

These controls protect campaign budgets from concentrated extraction.

How It Connects

The Boost Engine reads from the brand's own Status & Tiers configuration. Campaigns distribute boosted Pending SP rewards at mint time. The multiplier applies and the boosted amount mints in a single transaction. The bonus comes from the campaign budget.

For technical integration details, see SDK Reference (BoostEngine wrapper).

Last updated