Skip to content

Player Metrics Scheduled Triggers

Player Metrics triggers are the most powerful automation tool in the Rewards System. They allow you to reward players based on their actual gameplay activity, such as their total stake, number of bets, or net profit.

Overview

At each scheduled interval, the system:

  1. Aggregates player activity over an Evaluation Period.
  2. Filters activity based on Bet Qualification rules.
  3. Checks if the results meet your Qualification Conditions.
  4. Assigns rewards using your chosen Reward Configuration.

Decision Tree: "What do you want to achieve?"

Follow these five steps to configure your trigger:

1. "Over what time period should activity be measured?"

This defines the Evaluation Period.

  • Previous Interval: Measures activity since the trigger last ran.
  • Previous Day: Midnight-to-midnight (Fixed 24h window).
  • Last 24 Hours: A rolling 24h window relative to the execution time.
  • Previous 7 Days / Last 7 Days: Weekly snapshots.
  • Custom: Define a specific number of hours or days.

2. "Which currency should metrics be calculated in?"

  • Wallet Currency: Metrics are calculated in the player's native wallet currency. Use this if your players all use the same currency (e.g., all EUR).
  • Base Currency: The system converts all activity into a single base currency (usually USD) using current exchange rates. This allows you to compare high-rollers across different regions.

3. "Which bets should count?"

Set Bet Qualification filters to ignore activity that doesn't count toward the promotion. * Allowed Products: Limit to specific games (e.g., only "Crash"). * Min/Max Stake: Ignore bets that are too small or too large. * Min/Max Win: Ignore bets based on the outcome.

4. "Which players qualify for a reward?"

Define your Qualification Conditions. You can combine multiple rules using AND logic.

Metric Description Operators
Total Stake Amount Total money wagered. >, >=
Total Win Amount Total money won. >, >=
Bet Count Total number of bets placed. =, >, >=
Player Net Profit (Total Wins - Total Stakes). <, <=, >, >=
Net Profit Margin The ratio of profit to stakes. <, <=, >, >=

Example: Total Stake Amount >= 500 AND Bet Count >= 20

5. "How should rewards be assigned?"

Choose one of two ways to distribute rewards:

Option A: Tiered Rewards

Assign different rewards based on a metric value.

Example:

Total Stake (Metric) Reward
100 – 500 Bronze Package
500 – 1000 Silver Package
1000+ Gold Package

Option B: Dynamic Free Bet

Compute the reward value automatically from player metrics. This requires a Ranged Free Bet reward.

  • Bet Value: (Metric x Multiplier) clamped to Min/Max.
  • Bet Count: (Metric x Multiplier) clamped to Min/Max or a fixed number.
  • Example: Give 5% of a player's Total Stake back as a single free bet (Multiplier: 0.05).

Example Scenarios

Scenario 1: Weekly Original Games Cashback

Players who wager on original games throughout the week and end up with a net loss receive a consolation free bet based on their total stakes.

  1. Evaluation: Previous 7 Days.
  2. Currency: Wallet Currency (e.g., NGN).
  3. Bet Qualification: Only Original game products, Minimum Stake 100.
  4. Qualification: Total Stake Amount >= 5,000 AND Player Net Profit < 0 (only players who had a losing week qualify).
  5. Reward Config: Dynamic Free Bet. BetValue = (Player Net Profit x -0.10), Min 100, Max 1,000. BetCount = 1.

This trigger runs every Monday morning, looks back at the previous 7 days, finds players who staked at least 5,000 on original games but ended the week in the red, and gives them a single free bet worth 10% of their net losses (capped at 1,000).

Scenario 2: Weekly Tiered Loyalty

  1. Evaluation: Previous 7 Days.
  2. Currency: Base Currency (USD).
  3. Bet Qualification: Only Crash and Plinko games.
  4. Qualification: Bet Count >= 50 AND Total Stake Amount >= 500.
  5. Reward Config: Tiered. 500-1000 → Bronze, 1000-5000 → Silver, 5000+ → Gold.

This trigger runs every Monday morning, looks back at the previous 7 days, find players who staked at least 500 USD on Crash and Plinko across 50 bets, and gives them a bronze reward if they staked less than or equal to 1000, a silver reward if they staked less than or equal to 5000, or gold if they staked more.

Scenario 3: Daily High-Roller Welcome Pack

A flat free bet sent every morning to anyone who wagered seriously the day before. Uses the simplest possible Dynamic Free Bet (Combination #1: Absolute / Absolute), so a fixed Free Bet reward is sufficient.

  1. Evaluation: Previous Day (calendar-aligned, timezone-aware).
  2. Currency: Base Currency (USD).
  3. Bet Qualification: All products, Minimum Stake 10.
  4. Qualification: Total Stake Amount >= 1,000.
  5. Reward Config: Dynamic Free Bet. BetValue = 25.00 (Absolute). BetCount = 1 (Absolute).

Useful as a "thank-you for yesterday" nudge that lands in the player's wallet first thing in the morning. Because both fields are Absolute, this can target a fixed Free Bet reward.

Scenario 4: Volume Reward — Free Bets Scaled by Activity

Players who place a lot of small bets get more free bets, each at a fixed value (Combination #3: Absolute Value, Relative Count).

  1. Evaluation: Previous 7 Days.
  2. Currency: Wallet Currency.
  3. Bet Qualification: Mines only, Minimum Stake 1.
  4. Qualification: Bet Count >= 2000.
  5. Reward Config: Dynamic Free Bet (Ranged). BetValue = 1.00 (Absolute). BetCount = Bet Count × 0.0005, Min 1, Max 20 (Relative).

A player who placed 2,000 bets gets 1 free bet; another player who placed 5,000 bets gets 3 free bets; one who placed 40,000 spins gets the maximum of 20. Bet value stays constant so the cost-per-player remains predictable.

Scenario 5: Fully Dynamic VIP Cashback

Both the value and the number of free bets scale with the player's losses (Combination #4: Relative / Relative). For your most engaged segment.

  1. Evaluation: Previous Week (Monday–Sunday).
  2. Currency: Base Currency (USD).
  3. Bet Qualification: All products, Minimum Stake 50.
  4. Qualification: Total Stake Amount >= 10,000 AND Player Net Profit < -500.
  5. Reward Config: Dynamic Free Bet (Ranged). BetValue = Player Net Profit × -0.05, Min 10, Max 200. BetCount = Bet Count × 0.02, Min 1, Max 10.

Splits the cashback across multiple free bets proportional to how active the player was, with each bet sized to a slice of their losses. Encourages the player to come back across multiple sessions rather than blow it all on one bet.

Scenario 6: Hourly Live-Casino Drip

Frequent small rewards during a promotional weekend to keep players engaged in live tables. Uses Previous Interval so each run cleanly covers the hour since the last execution.

  1. Evaluation: Previous Interval (1 hour).
  2. Currency: Wallet Currency.
  3. Bet Qualification: Live Casino products only, Minimum Stake 5.
  4. Qualification: Total Stake Amount >= 100 AND Bet Count >= 10.
  5. Reward Config: Dynamic Free Bet. BetValue = Total Stake × 0.02, Min 1, Max 20 (Relative). BetCount = 1 (Absolute).

Runs every hour during the campaign window. Players who keep playing keep earning. Combination #2 (Relative Value, Absolute Count) — the most common cashback shape.

Scenario 7: Monthly Tiered Turnover Bonus

Long-evaluation, multi-tier loyalty reward driven by aggregate turnover.

  1. Evaluation: Custom — 30 days.
  2. Currency: Base Currency (USD).
  3. Bet Qualification: All products, Minimum Stake 1.
  4. Qualification: Total Stake Amount >= 5,000.
  5. Reward Config: Tiered by Total Stake Amount. 5,000–20,000 → Bronze pack, 20,000–50,000 → Silver pack, 50,000–100,000 → Gold pack, 100,000+ → Platinum pack.

Pairs well with a monthly newsletter or VIP touchpoint. Because tiers are wide, players have a clear next-tier target to chase.

Scenario 8: Re-Engagement for Yesterday's Big Losers

Catch players who had a rough day yesterday and offer a same-day-next-day cashback so they return.

  1. Evaluation: Previous Day.
  2. Currency: Wallet Currency.
  3. Bet Qualification: All products, Minimum Stake 20.

  4. Qualification: Total Stake Amount >= 500 AND Player Net Profit <= -200 AND Net Profit Margin <= -0.4.

    The margin filter ensures we target genuine bad-luck sessions, not players who just wagered a lot and broke even.

  5. Reward Config: Dynamic Free Bet (Ranged). BetValue = Player Net Profit × -0.15, Min 10, Max 150. BetCount = 1.

Scenario 9: Crash-Game Tournament Top Stakers

Reward the highest-staking players on a specific game over a fixed promotional weekend. Uses tiered rewards keyed off stake volume so the leaderboard is implicitly defined by tier thresholds.

  1. Evaluation: Custom — 72 hours (Friday 00:00 → Sunday 23:59 weekend window).
  2. Currency: Base Currency (USD).
  3. Bet Qualification: Crash only, Minimum Stake 10, Maximum Stake 1,000 (excludes max-stake outliers).
  4. Qualification: Total Stake Amount >= 1,000 AND Bet Count >= 100.
  5. Reward Config: Tiered by Total Stake Amount. 1,000–5,000 → Bronze trophy pack, 5,000–20,000 → Silver trophy pack, 20,000+ → Gold trophy pack.

The Maximum Stake filter is doing real work here — it prevents a single whale from sweeping the top tier with a handful of huge bets, and rewards sustained play instead.

Net Profit Margin

Net Profit Margin is a ratio, not a monetary value. It is useful for identifying players who are winning or losing significantly relative to their turnover, regardless of their stake size.

Schedule Previews

Always check the Schedule Preview in the backoffice. It shows you exactly which "Previous Day" or "Last 7 Days" window each execution will look at, preventing overlaps or gaps in your data.

Base Currency Conversions

When using Base Currency mode for a Dynamic Free Bet, you must specify which currency the final reward should be issued in. The system will handle the conversion back from the base metric to the reward currency automatically.

For a complete matrix of all valid metric/operator combinations, reward config permutations, and evaluation period details, see the Player Metrics Configuration Reference.