Onboarding · Dashboard Guide

Live Ops

Schedule time-limited events — tournaments, sales, raids, seasonal specials — that re-engage players and drive revenue spikes at exactly the right moment.

What is a Live Ops event?

A Live Ops event is any time-limited activity you run inside your game — a 3-day sale, a weekend tournament, a Guild War, a seasonal battle pass. In gamemantra, you create these events in the dashboard. The AI then knows the context and can tailor offer timing, content, and theme to match the event.

📅

Scheduled

Set start + end dates. The platform activates automatically.

🎯

Offer-aware

The AI uses event context to choose the most relevant offer type.

🎨

Theme-linked

Link to a Campaign so the UI theme matches the event automatically.

🔔 Offer Trigger Events — No Code Required

gamemantra supports dynamic offer triggers — you configure which in-game events should trigger an offer directly in the dashboard, without writing any code. The SDK fires a standard OnGameEvent call; the platform decides whether to show an offer based on your trigger rules.

Event trigger	When it fires	Best offer type
`session_start`	Player opens the app	Daily login bundle — soft re-engagement
`level_complete`	Player finishes a level	Victory pack — emotional high, peak buy intent
`first_loss`	Player fails for the first time	Booster pack — solve the exact pain point
`currency_low`	Balance drops below threshold	Currency refill — catch player at the moment of need
`first_launch`	Player opens the app for the first time	Starter pack — first-purchase discount
`session_end`	Player closes the app	Come-back bundle — reduce churn at exit

→ Configure trigger rules in Settings → Offer Triggers. Custom triggers (your own event names) can be added from Live Ops → Event Types.

Event types — platform + genre

gamemantra comes with 5 universal event types that work for any game, plus5 genre-specific types matched to your game's genre. You can also create unlimited custom types.

All games (platform defaults)

sale

Time-limited price discount across items

tournament

Competitive leaderboard event

battle_pass

Tiered rewards over a season

limited_offer

Scarcity-driven bundle (e.g. only 500 available)

challenge

Player skill or streak challenge

RPG genre

guild_war

Faction vs faction event

boss_raid

Cooperative PvE raid

hero_summon

Gacha/pull event

season_pass

RPG season progression

dungeon_event

Limited dungeon access

Puzzle genre

brain_challenge

Timed puzzle marathon

daily_puzzle

Recurring daily challenge

speedrun

Fastest completion leaderboard

chain_event

Multi-day puzzle chain

bonus_level

Exclusive level unlock

➕ Adding your own custom event types

Go to Live Ops → Event Types and click Add Custom Type. Enter a name in snake_case(e.g. arena_season) and pick a colour. Platform defaults and genre defaults cannot be deleted, but custom types can be removed anytime. Custom event types are also available as offer trigger conditions.

How to create a Live Ops event

Go to Operations → Live Ops in the sidebar.

Click "New Event"

Fill in the event details:

Name — e.g. "Summer Tournament 2026"
Event type — choose from the platform/genre/custom dropdown. The genre section is labelled with your game's genre automatically.
Start date / End date — the live window for this event.
Description (optional) — internal notes for your team.

Link an offer trigger (optional)

Under Offer Triggers, select which in-game events during this Live Ops window should trigger offer delivery. For example: during a Tournament event, fire an offer onlevel_complete and first_loss— the two highest-intent moments in competitive play.

These are configured without any code changes in your game.

Link a campaign theme (optional but recommended)

Check Link Campaign and select an existing campaign, or create a new one inline. This ensures the offer pop-up theme matches your event's look — e.g. a Halloween event gets orange/dark theming automatically.

Click "Create Event"

The event appears in the Gantt Timeline view — a horizontal bar showing when each event is active relative to today. Status badges show Upcoming, Active, or Ended.

What the Gantt Timeline shows

Summer Tournament

Active

Guild War Season 3

Upcoming

Spring Sale

Ended

Each row is one event. The bar shows the active window relative to today. Click any row to expand details.

💡 AI prompt you can use

"I'm running a Guild War event from July 5 to July 12 for my RPG game. What offer type should I use, at what price, and which in-game trigger moments (events) give the highest purchase intent during a PvP event? Should I link it to a campaign theme?"

How items & currencies power Live Ops events

Live Ops events don't stand alone — they draw their offer content from your item catalogue and their pricing from your currency BCU rates. Before creating a live event, make sure both are configured.

📦 Items → Offer Content

When the AI generates an offer during a live event, it pulls from your item catalogue. Items with fallback_eligible=true are the safety net when the ML pipeline is still warming up. Event-themed items (e.g. "Raid Sword", "Boss Chest") should be added before the event starts.

consumableBooster packs during tournament events

equipmentGear bundles during battle / raid events

currencyCurrency refill when depleted mid-event

→ Set up item catalogue

💎 Currencies → Offer Timing

Live events drive sudden spikes in currency velocity. A Raid event means players burn Raid Tickets rapidly. gamemantra detects this acceleration and tightens the offer window — showing refill offers earlier because the scarcity is real.

energy depletedRefill offer fires immediately (lives_depleted)

ticket = 0Event-access offer with countdown timer

FSR spikesInflation risk flag → platform alerts you

→ Set up currencies

✅ Recommended setup order for a Live Ops event

1.Add event-specific items to your catalogue (e.g. "Raid Sword Bundle", "Boss Chest")
2.Verify currency BCU rates are set — especially tickets/energy if the event consumes them
3.Enable the relevant trigger rule in Settings → Offer Triggers (e.g. boss_raid)
4.Create the Live Ops event in Operations → Live Ops with the trigger set to boss_raid
5.Optionally link a Campaign theme so the UI matches the event's visual identity
6.Optionally create an A/B experiment on the same trigger to find the best price during the event

Common questions

Q: Can two events run at the same time?

Yes. Multiple events can overlap. Each has its own offer triggers and campaign theme. If campaigns overlap, the higher-priority one wins.

Q: Do I need to add code to the game for each new event?

No. The SDK fires standard game events (level_complete, session_start, etc.). The platform decides which events trigger offers during an active Live Ops window — all configured in the dashboard.

Q: What happens if I forget to end an event?

The event stays active until its end_at date. If you need to end it early, click Delete on the event card. The platform stops using it as an offer trigger context immediately.