Onboarding · Dashboard Guide
Offers & Theme
Deliver personalised purchase offers inside your game and control exactly how they look — without touching your game code.
What is an offer?
An offer is a purchase pop-up shown to a player at the right moment — when they finish a level, run out of currency, or open the app after a few days away. gamemantra decides who sees an offer, what it contains, and when it appears. Your team controls the look, the price limits, and when the AI is allowed to act.
A curated pack of items + currency at one price. Best for new players.
Example: Starter Pack: 500 gems + shield + 2× XP for $2.99
How an offer reaches a player
From the moment a player opens the game to seeing the pop-up.
Player opens the game
SDK calls gm_login_player() → registers a session
A trigger fires
e.g. level_complete, session_start, currency_low
AI pipeline runs (11 steps, <200ms)
Checks kill switch, holdout, spend score, fatigue, M04 model
Offer pop-up appears on screen
Themed to match your game's colours and corner style
Player buys or dismisses
gamemantra records the outcome → improves future recommendations
🔒 Your game stays in control
Manual offer creation walkthrough
gamemantra is AI-first — the platform generates offers automatically. The dashboard lets you audit, approve, and tune them. Here is the exact step-by-step flow.
Open the Offers tab and check your trust mode
In the left sidebar, click Offers. The badge next to the tab shows pending AI proposals waiting for your review.
Check Games → [your game] to see your current trust mode:
- Shadow — the AI computes silently and nothing it picks reaches a player; your own approved bundles and store items keep serving. You audit what it would have shown.
- Assisted — AI proposes offers; you approve before players see them.
- Autonomous — AI serves offers directly. You can pause anytime.
Audit shadow offers (Shadow mode only)
In Shadow mode, go to Offers → Shadow Log (or the Offers tab will show an AI Audit section). Each row shows:
- Which player triggered the event
- What trigger event fired (e.g.
session_start) - What offer the AI would have shown (type, price, template)
- The M04 model score (show probability, 0–1)
This audit log is your 7–30 day validation window. If the offers look reasonable, you are ready to move to Assisted mode.
Review AI-generated proposals (Assisted mode)
In Assisted mode, the AI automatically submits proposals to the Offers tab when a trigger fires. Click any proposal card to see:
- Offer details — type, price, template name, M04 score
- Trigger event — which event caused this proposal
- Simulate button — runs Monte Carlo FSR projection before you commit
Approve or reject
Click Approve to serve this offer to players (cached for 60 seconds, then re-proposed on next trigger). Click Reject with a note to discard it. Approved offers are served until rejected or expired (24h TTL).
Requires offer_approval permission — owner or admin by default.
Submit a manual change for review
To manually change an offer outside the AI flow, use the Approvals panel:
- Click New Approval and select the change type:
price_change — adjust offer price, bundle_add — add a new bundle, trust_mode_change — upgrade trust mode - Fill in the payload fields and click Submit for Review
- An owner or admin approves it — same flow as AI proposals
Move to Assisted mode when ready
After 7–30 days of shadow auditing, submit a trust_mode_change approval to move to Assisted. Offers now appear live to players — each one still requires your approval first. To skip approval for specific triggers, enable them inSettings → Offer Triggers.
Go to Games → [your game] → Trust Mode to see current status and upgrade path.
💡 AI prompt you can use
Ask your AI assistant to help you evaluate any approval — paste the payload JSON and simulation result.
How to change the offer theme
The theme controls colours, corner style, and background of the pop-up. Changes go live in the game within 60 seconds — no app store update needed.
Open Settings → Theme tab
Go to Settings in the sidebar, then click the Theme tab. You will see a live preview of the current offer pop-up on the right.
Edit the design tokens
Each token controls one visual property. The most impactful ones:
accent_color
CTA button + highlights
badge_color
SPECIAL OFFER badge
background_style
dark / glassmorphism / light
corner_style
rounded / cut / sharp
Click "Publish to Ring 4"
Ring 4 = 100% of players. The platform stores the new config and the game SDK picks it up on the next status poll (within 60 seconds). Your theme is now live.
🎨 Six preset themes
What to expect on the device
📲
Pop-up appears
Offer card slides up with your themed colours, badge, and CTA button.
✅
Buy → IAP flow
Tapping Buy opens the native store payment sheet. gamemantra records the purchase.
❌
Dismiss → fatigue
Tapping × dismisses. After 5 consecutive dismissals, offers pause for 14 days (fatigue protection).