Skip to content

Reward Campaigns

A Campaign is the top-level promotional container. It is used to group related rewards and define the overall lifespan of a promotion.

Campaign Fields

When setting up a campaign, you will define the following:

  • Name: Internal name for the campaign.
  • Description: Purpose and details of the promotion.
  • Operator Reference: A custom ID to help you correlate this campaign with your external CRM or marketing systems.
  • Terms & Conditions URL: Link to the player-facing legal terms.
  • Start Time: When the campaign becomes eligible to distribute rewards.
  • End Time: When the campaign stops. If left empty, the campaign runs indefinitely until manually cancelled.

Campaign Lifecycle

Campaign status is automatically computed based on the current time relative to the Start and End times.

Status Description
Scheduled The current time is before the Start Time.
Active The current time is between the Start and End times.
Ended The current time is after the End Time.
Cancelled The campaign has been manually stopped.
stateDiagram-v2
    [*] --> Scheduled
    Scheduled --> Active: Start Time Reached
    Active --> Ended: End Time Reached
    Active --> Cancelled: Manual Action
    Scheduled --> Cancelled: Manual Action
    Ended --> [*]

When to Use Campaigns

Campaigns are most effective for:

  1. Holiday/Event Promotions: Grouping all rewards accociated with a holiday or event.
  2. Product Launches: Tracking all rewards associated with the launch of a new game category.
  3. Tiered Loyalty: Creating a campaign for "Monthly VIP Rewards" where individual rewards represent different VIP tiers.

Cancelling a Campaign

You can cancel a campaign at any time.

Important Note on Cancellation

Cancelling a campaign will also cancel all rewards and player enrollments within it. This is a destructive action — once cancelled, affected players will immediately lose access to any unused free bets.

Tip

Use the Operator Reference field consistently. This allows your data team to easily join rewards data with your primary player database for ROI analysis.