LogoStacked
Concepts

Completion Conditions

Defining how users complete offers and earn rewards

What are Completion Conditions?

Completion conditions define what actions a user must take to complete an offer and claim rewards. While surfacing conditions determine WHO sees an offer, completion conditions determine HOW they finish it.

Multiple conditions can be combined - all must be met for the offer to become claimable.

Available Conditions

Completion conditions define specific actions users must take to claim rewards:

Buy Item

Users must purchase a specific item.

ParameterDescription
Item IDThe specific item to purchase
Item NameDisplay name for the item
Amount (optional)Number of items required (default: 1)

Spend Currency

Users must spend a certain amount of any currency.

ParameterDescription
Currency IDThe currency type (e.g., gold, gems)
Currency NameDisplay name for the currency
AmountTotal amount to spend

Deposit Currency

Users must add currency to their account (typically via purchase).

ParameterDescription
Currency IDThe currency type to deposit
Currency NameDisplay name for the currency
AmountTotal amount to deposit

Login

Users must log in (simple boolean check).

ParameterDescription
LoginMust log in (true/false)

Shared Conditions

These conditions work for both surfacing and completion:

ConditionDescription
Login StreakConsecutive login days required
LevelsReach a specific level or skill
CurrenciesHave certain currency balance or spend/deposit amounts
AchievementsComplete an achievement
QuestsFinish a quest
MembershipsObtain a membership
Staked TokensStake cryptocurrency tokens
Trust ScoreReach reputation threshold
Days in GameMinimum days the user has logged in

See Surfacing Conditions for parameter details.

Note

Tags and Dynamic Fields are only available for surfacing conditions, not completion conditions.

How Conditions Combine

Multiple completion conditions use AND logic - all must be met for the offer to become claimable.

Example: An offer requiring "Buy 3 health potions" + "Reach level 10" + "Login 3 days straight" needs all three actions completed.

How Progress Works

Stacked automatically tracks progress in real-time:

  1. Offer Surfaces → User meets surfacing conditions
  2. Tracking Begins → Stacked monitors relevant actions
  3. Progress Updates → Each action updates completion trackers
  4. Threshold Met → Offer becomes "claimable"
  5. User Claims → Rewards distributed

Tip

Show progress clearly with visual indicators. Users complete offers more often when they can see how close they are to the goal.

Examples

Here are practical examples of combining completion conditions:

Starter Bundle Quest

New player engagement

  • Buy Item: "health_potion", Amount = 3
  • Spend Currency: "gold", Amount = 100
  • Login Streak: 2 days

New players must buy health potions, spend gold, and log in twice to complete.

Level Up Challenge

Progression milestone

  • Level (player_level): Min = 10
  • Achievement ("tutorial_complete"): Min Count = 1
  • Login: true

Users must reach level 10, complete tutorial achievement, and log in to claim.

First Purchase Bonus

Monetization conversion

  • Deposit Currency: "gems", Amount = 100
  • Min Days in Game: 3

Users who've been playing for 3+ days and deposit 100 gems get bonus rewards.

Daily Spending Goal

Economy circulation

  • Spend Currency: "gold", Amount = 500
  • Login Streak: 1

Daily challenge requiring 500 gold spent and logging in.

Best Practices

  • Match effort to reward - Higher requirements need better rewards
  • Show progress clearly - Visual indicators improve completion rates
  • Test with real users - Monitor completion rates and adjust
  • Allow reasonable time - Consider user schedules and play patterns