Reward Campaign Triggers¶

Triggers allow you to automate player enrollment. Instead of manually uploading lists, you define rules that the system evaluates on a schedule.

What is a Trigger?¶

A trigger is a set of instructions that tells the system: "Every X hours/days, look at this data source, find players who qualify, and give them this reward."

Trigger Anatomy¶

• Campaign Link: Every trigger belongs to one campaign.
• Schedule: Defines the Start Date, End Date, and Frequency (e.g., Every 24 hours).
• Data Source: The "brain" of the trigger. It can be a Leaderboard or a collection of Player Metrics.
• Reward Mapping: Which reward is given to which qualifying player.

Trigger Lifecycle¶

Automation Flow¶

When a scheduled trigger fires, it follows this sequence:

sequenceDiagram
    participant S as Schedule
    participant T as Trigger Engine
    participant D as Data Source
    participant B as Budget Manager
    participant E as Enrollment Job

    S->>T: Execution Interval Reached
    T->>D: Fetch Qualifying Players
    D-->>T: Player List & Values
    T->>B: Check Available Budgets
    B-->>T: Approved Players
    T->>E: Create Bulk Enrollment Job
    E-->>T: Jobs Created
    T->>S: Wait for next interval

Schedule Preview¶

Before activating a trigger, you can view a Schedule Preview. This shows the exact date and time for every future execution of that trigger, allowing you to ensure it aligns with your marketing calendar.