Specify Eligibility Criteria for Bonuses

Use triggers to determine the users receive your bonus

In single-stage campaigns, you can configure rules to determine which users receive the bonus associated with your campaign. There are two ways to configure the bonus eligibility criteria:

  • Set campaign and qualification triggers
  • Specify user actions for bonus eligibility

Set campaign and qualification triggers

With event-triggered campaigns, you can ensure that bonuses are only allocated to users who trigger the campaign. For example, if the campaign trigger is a 100 USD user deposit, the bonus is allocated only to users who make that deposit.

Additionally, you can use qualification triggers to set criteria that users must meet before they can trigger the campaign. You can also set a time limit for this qualification criteria.

Using the previous example, a qualification trigger could be that users must opt in to your campaign within a seven-day period. To qualify for the bonus, the users now need to opt-in to your campaign within seven days (qualification trigger) and then make a 100 USD deposit (campaign trigger).

🚧

One Qualification Trigger per Campaign

Only one qualification trigger can be used in a campaign. The qualification trigger can only be associated with one campaign trigger.

To create a bonus campaign using event and qualification triggers, follow these steps:

  1. Create a single-stage Event-triggered campaign.
  2. Specify the dynamic bonus amount in the Promotions section of the Setup tab.
    For more information on configuring the bonus, see Assign Bonuses using Messages.
  3. (Optional) In the Triggers tab, go to Qualification Trigger and specify the qualification trigger and the duration it is applicable for.

👍

If you specify a qualification trigger, the campaign recipient would first need to trigger the qualification trigger and then the campaign trigger to claim the bonus.

  1. Specify the campaign trigger under Trigger Event.

For an example use case, see 20% Cashback on User Deposit.

Specify user actions for bonus eligibility

With accumulation-triggered campaigns, you can determine bonus eligibility based on users who meet specific action-based criteria. You can define these criteria by:

  • Action Count: A user must perform an action a specific number of times. For example, if a user makes three deposits.
  • Accumulated Value: The value of a user's actions must accumulate to a specific target value. For example, if the user stakes a total of 1000 USD.
  • Combined Action Count and Accumulated Value: A user must perform a specific action a number of times, and the value of those actions must accumulate to a specific target. For example, a user makes three deposits that total 100 USD.

For more information on Accumulation triggers and how to configure them, see Accumulation Triggers.

👍

Enable Accumulation Triggers

To enable accumulation triggers, reach out to Xtremepush support. See Contact Us for details on contacting Xtremepush Support.

You can also use qualification triggers to set criteria users must meet before the accumulation rule becomes active. You can also set a time limit during this criteria must be met for the subsequent accumulation rule to be considered.

For example, your campaign bonus is assigned only to users if they opt in to a promotion within 7 days (qualification trigger) and then stake 1000 USD (accumulation trigger)

To create accumulation-triggered campaigns, create a single-stage campaign, select Accumulation-triggered, and follow these steps:

  1. Specify the dynamic bonus amount in the Promotions section of the Setup tab.
    For more information on setting the bonus amount, see Assign Bonuses using Messages.

📘

Transaction Window for User Metric

  • A fixed date range

For a User Metric, you can specify the date range for the bonus calculation. For example, if your user metric is average_deposit and your date range is three months, the bonus is calculated as a percentage of the user's average deposit during that period.

  • Between first and last transaction in the rule

In accumulation-triggered campaigns, the between first and last transaction in the rule option creates a dynamic calculation period that starts and stops based on specific user actions.

This option isolates the exact activity you want to reward. The calculation period works as follows:

  1. It Starts only when the user performs the qualification action (e.g., user opts into a promotion).
  2. It Ends as soon as they complete the accumulation rule (e.g., user stakes 100 USD).

Example: Bonus on Stakes (User Metric- stake_amount)

Consider a bonus on total stakes that requires users to opt-in (qualification trigger) and then stake at least 100 USD (accumulation rule). A user stakes 150 USD on Monday but has not opted in. On Tuesday, they opt in (starting the period) and then stake an additional 200 USD (ending the period).

If you select stake_amount as the user metric for this bonus, the calculation is based only on the 200 USD staked on Tuesday.. The 150 USD from Monday is ignored because it occurred before the user opted in and started the dynamic calculation period.

  1. (Optional) Configure the qualification trigger in the Triggers tab.
    Your user needs to trigger the qualification trigger within the specified time to be eligible for the bonus.
  2. Create the accumulation rule in the Triggers tab.
    The campaign is triggered and the bonus is assigned to the user when the meet the accumulation criteria.

🚧

Accumulation-triggered campaigns can only be triggered once

Accumulation-triggered campaigns are limited to a single trigger. For example, if the accumulation rule is that your user stakes 1000 USD, then the bonus is assigned to users after they stake 1000 USD.

The user can stake 1000 USD again, but the campaign won't be triggered again as the accumulation trigger is no longer valid.

For an example use case of a campaign with accumulation triggers, see Use Case 50% Cashback on Losses and Free Spins for Playing Promoted Games.