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:
- Holiday/Event Promotions: Grouping all rewards accociated with a holiday or event.
- Product Launches: Tracking all rewards associated with the launch of a new game category.
- 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.