Bonuses & Loyalty Program in IZI CRM
Bonuses & Loyalty Program in IZI CRM
Section titled “Bonuses & Loyalty Program in IZI CRM”IZI CRM includes a built-in loyalty engine that lets you automatically credit bonuses when clients top up their balance, lets clients spend those bonuses on gaming time or orders, and gives managers clear analytics on whether the promotion is actually moving average check and ARPU. IZI stores the bonus balance separately from the gaming balance — every credit and debit is logged in the transaction journal with the executor name and the originating event. Bonus rules are configured through automation without any code: you pick a trigger event, set a condition on the top-up amount, and define a calculation formula — IZI does the rest without staff involvement. Every client card shows the current bonus balance and a real-time operation history.
How the Bonus Balance Works
Section titled “How the Bonus Balance Works”Each registered client has two independent accounts: a gaming balance (for paying sessions at the tariff rate) and a bonus balance. In IZI, bonuses are denominated in monetary units and can be spent on gaming time or orders through the mobile app or at the cashier.
Bonus operation types (visible in the Bonus Operations report):
| Operation type | Label in report | Executor |
|---|---|---|
| Automatic credit (rule fired) | Bonus Credit | System |
| Manual admin credit | Bonus Credit | Administrator |
| Client payment via app or cashier | Bonus Payment | System / Administrator |
| Manual admin write-off | Bonus Write-Off | Administrator |
| Bonus refund | Bonus Refund | System |
Top-Up Bonus: Setup
Section titled “Top-Up Bonus: Setup”The top-up bonus is the most common retention mechanic in IZI: a client tops up above a threshold and automatically receives bonus credits. It is configured through Automation.
How to Create a Rule
Section titled “How to Create a Rule”- Open Automation in the organization menu.
- Click Create Rule.
- Select the trigger event Balance Topped Up (
BALANCE_TOPPED_UP). - Add a condition: variable
topupAmountMajor— the threshold amount you need. - Add the action Credit Bonuses and specify the calculation formula. The formula can use event variables (
topupAmountMajor) and client context (bonusBalanceMajor,totalSpentMajor, and others). - Name the rule; optionally restrict it to specific clubs in your network.
- Save and enable the rule.
After saving, every qualifying top-up triggers the credit automatically. You can create multiple rules with different thresholds — each runs independently.
Payment Sources
Section titled “Payment Sources”The rule fires across all top-up sources:
- App — online payment via acquiring (
ACQUIRING) - Card Payment — POS terminal at the cashier (
POS_TERMINAL) - Cash — cash register (
CASH)
To filter by source inside the rule, use the condition variable topUpSource.
Manual Bonus Operations
Section titled “Manual Bonus Operations”An admin can credit or write off bonuses directly from a client card in IZI CRM.
Crediting: Transactions section → Credit Bonus Balance button → enter amount and optional comment. The operation is recorded in the report with executor Administrator.
Write-off: same section → Bonus Write-Off → enter amount. Appears as Bonus Write-Off in the log. Useful for correcting erroneous credits or fulfilling promotion terms.
Analytics: Bonus Reports
Section titled “Analytics: Bonus Reports”Bonus Operations Report
Section titled “Bonus Operations Report”Analytics → Bonuses (the Metrics tab) displays summary KPIs for the selected period:
| Metric | What it counts |
|---|---|
| Credited | Total bonuses credited, including rule-based and manual operations |
| Spent | Bonuses used by clients for payment |
| Written Off | Volume of manual admin write-offs |
| Average per client | Average credit among clients with at least one credit |
| Max per client | Highest single-client credit |
| Clients credited | Unique clients who received bonuses in the period |
The Operations tab gives a paginated log of every transaction with filters by amount, type, and date.
The Bonus Operations by Tags section shows a breakdown by rule labels: number of operations, total and average amount, and share of all credits (%).
Top-Up Bonus Report
Section titled “Top-Up Bonus Report”A dedicated IZI report for evaluating the top-up bonus promotion. It supports side-by-side comparison of two periods — current and baseline — so you can see how the cohort’s behavior has changed.
Report KPIs:
| Metric | What it counts |
|---|---|
| Operations | Number of rule triggers in the period |
| Top-Up Amount | Top-ups that triggered at least one bonus rule |
| Bonuses Issued | Total bonuses credited by top-up rules |
| Unique Clients | Clients who received a bonus at least once |
| Repeat Clients | Clients who qualified for the rule more than once |
| Club Average Check | Average check across all club top-ups (no promotion filter) |
| Promotion Average Check | Average check of top-ups among promotion participants |
| Difference | How much the promotion average check exceeds the club average |
Comparative metrics (require a baseline period selection):
- Average Check — baseline / current and Average Check Growth (%) — the cohort in the baseline vs the current period.
- ARPU — baseline / current and ARPU Growth (%) — revenue per client (top-ups minus refunds) divided by cohort size. This is the honest signal: is the promotion lifting per-client revenue, not just top-up volume?
Breakdowns:
- By Rule — which rule produced how many clients, operations, and top-up volume.
- By Source — app / card payment / cash.
- Daily Activity — trend of operation count and top-up amount by day.
The report exports to CSV.
Additional Automation Actions
Section titled “Additional Automation Actions”Beyond crediting bonuses, an IZI automation rule triggered on top-up can simultaneously:
- Assign a client group — for example, move the client into a VIP segment.
- Remove a client from a group.
- Send a push notification to the mobile app (title up to 40 characters, body up to 120 characters).
All four actions (ADD_BONUS, ASSIGN_GROUP, UNASSIGN_GROUP, SEND_PUSH) can be combined in a single rule.
Frequently asked questions
What is a bonus balance in IZI CRM?
Bonus balance is a separate account from the gaming balance. It accumulates automatically via automation rules (for example, a top-up bonus) or through manual admin credits. Clients spend bonuses to pay for gaming sessions and orders.
How do I set up a top-up bonus?
Go to Automation in the organization menu, create a rule with the Balance Topped Up event (BALANCE_TOPPED_UP), add a condition on the top-up amount using topupAmountMajor, and add the Credit Bonuses action with a calculation formula. The rule fires automatically on every qualifying top-up.
Can I credit bonuses to a client manually?
Yes. Open the client card, go to the Transactions section, and select Credit Bonus Balance. Enter the amount and an optional comment. The operation is recorded in the report with the executor label Administrator.
How can clients spend their bonuses?
Clients pay for sessions and orders with bonuses through the mobile app or at the cashier. Every spend is recorded as a Bonus Payment transaction in the transaction log.
What does the Top-Up Bonus report show?
It shows promotion effectiveness: number of operations, total top-up and bonus amounts, unique and repeat clients, average check of the promotion vs the club average, average check growth (%), and ARPU growth (%) compared to a selected baseline period.
What is ARPU in the bonus report context?
ARPU (revenue per client) is calculated as total top-ups minus refunds for the cohort (clients who received a bonus), divided by cohort size. ARPU growth is the honest signal of whether the promotion actually increases per-client revenue, not just top-up volume.
Which payment sources does the report track?
Three sources: App (online payment via acquiring), Card Payment (POS terminal), and Cash. A breakdown by source is available on the By Source tab in the Top-Up Bonus report.
Can I write off a client's bonuses manually?
Yes. An admin can manually write off bonuses from a client's balance from the Transactions section. The operation appears in the report as Bonus Write-Off with the executor's name.
What are tags on bonus operations?
Tags are labels that the system or automation rules attach to bonus operations. The Bonus Operations by Tags report shows a breakdown by label: number of operations, total and average amount, and share of all credits.
How do I create different bonus rules for different top-up amounts?
Create multiple automation rules, each with the BALANCE_TOPPED_UP event and different amount conditions (for example, from 500 and from 1000 in local units). Each rule defines its own bonus percentage or formula and fires independently.
How do I restrict a bonus rule to a specific club in a network?
When creating an automation rule, specify the target clubs in the clubIds field. If the list is empty, the rule applies to the entire organization.
Can I temporarily disable a bonus rule?
Yes. In the automation rules list, toggle the Enabled switch next to the rule. The rule is preserved with all its settings but stops firing. Re-enabling it restores operation without any configuration loss.