Operator guideEN

Bonuses / List

Main working catalog for bonus definitions with search, archive mode, type filters, group filters, and row actions.

How to use this guide

Start with the main guide

Follow the explanation and examples first. Extra definitions and formulas are available below when you need them.

What this surface does

This is the main catalog for reusable bonus definitions.

Operators use it to find an existing bonus, understand whether it is active or archived, and then open the correct row action.

How to use it

  1. Use Search Bonus for the English promotion title, Promo Code for an exact Entry Code, or Bonus ID for one or more numeric IDs.
  2. Narrow the list with:
    • active/inactive status
    • bonus type
    • bonus group
    • archived mode
  3. Open the row action that matches the task:
    • View to inspect the current setup
    • Edit to change the bonus
    • Activate/Deactivate to change availability
    • Archive/Restore to move the record in or out of the active catalog
  4. Switch between table and grid view if you need compact scanning or card-style browsing. The data source and actions stay the same in both modes.

Filters and tabs that matter

  • Search Bonus matches the free-text catalog query.
  • Search Bonus actually checks the English promotion title, while the visible Name column shows bonusName. A visible name is therefore not guaranteed to match this search.
  • Promo Code trims the value and requires an exact match inside couponCodes, the array shown as Entry Codes.
  • Bonus ID accepts one numeric ID or comma-separated numeric IDs.
  • Status narrows the list to All, Active, or Inactive.
  • Bonus Type changes both the main type tab and the request payload.
  • Bonus Group narrows the list with the secondary tab row when group options exist.
  • Active Bonuses shows non-archived rows, including both Active and Inactive statuses.
  • Archived Bonuses switches the whole surface into restore-first mode.
  • Bonus Map forces the Bonus Map group and hides the group-tab row.

What operators should watch for

  • Archived is a separate working mode. If the row seems missing, first check whether archived mode is enabled.
  • The visible row status is an operator status, not proof that the bonus is currently assigned to any player.
  • Group tabs and type tabs are filtering tools. They do not change the bonus itself.
  • All Groups intentionally excludes Bonus Map-generated rows; use the dedicated Bonus Map tab for those definitions.
  • The page supports both table-style and card-style browsing, but the underlying row actions stay the same.
  • Entry Codes reads couponCodes; Exit Codes reads the separate nextCouponCodes array.
  • The Rows selector exposes 5000 and 10000, but the server accepts a maximum of 1000. Those two choices fall back to 15 returned rows on page one.
  • Most filter edits do not reset pagination. If a narrower filter appears empty, return to page one before assuming there are no matches.

Common questions

Why is a bonus missing from the default list?

Usually because one of these is true:

  • the row is archived
  • the type or group filter excludes it
  • the search string is still active
  • the normal All Groups view excludes Bonus Map-generated rows

When should I archive instead of deactivate?

Use Deactivate when the bonus should stay in the normal working catalog but should not currently be used.
Use Archive when the bonus should be removed from the active working set and treated as an old configuration.

Why does the Active tab still show unfinished work?

The list uses the active/inactive state from the bonus row, not a separate “published” concept. A bonus can appear in the active working set while still needing content or later lifecycle follow-up.

More details

Definitions and formulas

Open only the section you need. The relevant section opens automatically when you request help for a specific item on screen.

Columns11 topicsOpen details

ID

Stable internal identifier for the reusable bonus definition.

Data Type
integer

Name

Main operator-facing name displayed in both table and card layouts.

Data Type
string
Caveats
The bonus type chip is rendered directly below this value in the table., Search Bonus does not search this field; it searches the English promotion title.

Type

Bonus family shown as a chip below Name and used to determine reward mechanics and available settings.

Data Type
enum

Entry Codes

Coupon or entry codes that can trigger the bonus.

Data Type
array
Empty State
No entry codes

Tags

Saved segmentation tags attached to the bonus.

Data Type
array
Empty State
No tags

Groups

Saved group memberships used by the group tabs and dedicated Bonus Map catalog.

Data Type
array
Empty State
No groups

Exit Codes

Follow-up or exit codes displayed separately from Entry Codes.

Data Type
array
Empty State
No exit codes

Start Date

Beginning of the configured bonus validity window.

Data Type
datetime

End Date

End of the configured bonus validity window.

Data Type
datetime

Status

Displays Active or Inactive for the row.

Data Type
boolean
Caveats
The chip itself is read-only; Activate or Deactivate is a separate confirmed row action., Archive state is independent and controlled by the main catalog tab.

Actions

Provides View, Edit, Activate or Deactivate, and Archive for normal rows; archived rows provide Restore instead.

Data Type
action-set
Filters6 topicsOpen details

Search Bonus

Searches the English promotion title with a case-insensitive contains match.

Data Type
string
Caveats
The grid displays `bonusName`, but this filter searches `promotionTitle.EN`; typing the visible Name can therefore return no match., This field does not search Entry Codes; use Promo Code for that.

Promo Code

Trims the entered value and requires an exact element match inside the Entry Codes array.

Data Type
string

Bonus ID

Accepts one ID or a comma-separated list such as `1,2,3`.

Data Type
comma-separated-integers
Caveats
The service converts every comma-separated token to a number; use numeric IDs only.

Status

Narrows the current catalog mode by active or inactive row status.

Data Type
enum
Allowed Values
0: Label: All | Value: all | 1: Label: Active | Value: true | 2: Label: Inactive | Value: false

Bonus Type

The selector and the type-tab row share one value and send the selected type as a one-item request array.

Data Type
enum
Allowed Values
All, Free Spins, Deposit, No Deposit, Promotion, Instant Cashback

Filter by Group

Narrows rows to one group, to rows with no groups, or to the normal all-groups catalog.

Data Type
enum
Allowed Values
All Groups, No Groups, Dynamic saved group names
Caveats
All Groups does not include rows in the `Bonus Map` group; those rows are intentionally reserved for the Bonus Map catalog tab., Group tabs are hidden while the Bonus Map tab is active.
More help

Related pages

Bonuses

Operator documentation for bonus catalog management, bonus editing, and player-issued bonus follow-up.

Bonuses / Create And Edit

Create and edit workspace for reusable bonus definitions, including targeting, per-currency reward settings, and linked promotional content.

Bonuses / View

Read-only bonus detail screen used to inspect one reusable bonus definition before editing it.

Activity Tag Rules / List

Main inventory for activity-driven tag rules, with search, activity and status filters, grouped rows, clone, edit, and run actions.

Affiliate Deals / List

Searchable table of affiliate deal rows with PID filter, create action, dashboard shortcut, and edit/delete row actions.

Affiliate Payment Settings / List

Affiliate payment settings inventory page for reviewing configured rows and opening saved records.