Onboarding · Dashboard Guide

Campaigns

Override your game's offer theme for a set time window — Black Friday, holidays, birthdays, special events. When the campaign ends, the theme automatically reverts. No code changes. No app update.

What is a campaign?

A campaign is a time-bounded theme override. You set a start date, an end date, and which design tokens to change (colours, background style, corner shape). During that window, every offer pop-up shown to players uses the campaign theme instead of the base theme. At the end date the platform automatically switches back — you don't need to remember to turn it off.

Base theme

Always-on default. Your game's standard look.

Campaign theme

Overlaid during the campaign window. Overrides only the tokens you specify.

Auto-revert

When end_at passes, the SDK switches back to the base theme within 60s.

How a campaign reaches the player

📅

You create a campaign

Set name, start date, end date, and which theme tokens to override. Optionally link it to a Live Ops event so they activate together.

☁️

Config published to the SDK

The campaign is included in the OTA config response (GET /v1/sdk/config). Both active and upcoming campaigns (within 48 hours) are returned.

⏰

SDK schedules the switch

The game SDK sets a timer for the campaign start. When it fires, the base theme is replaced by the campaign theme — no server call needed.

🎨

Players see the campaign theme

All offer pop-ups during the window show your campaign colours — Black Friday red, holiday blue, birthday gold, etc.

🔄

Auto-revert at end date

The SDK fires a second timer at end_at. The base theme is restored. Players see the normal design again.

How to create a campaign

Go to Operations → Campaigns in the sidebar.

Click "New Campaign"

A modal appears. Fill in:

Name — e.g. "Black Friday 2026"
Start date / End date — the exact window. End date is mandatory; the revert is automatic.
Priority — if two campaigns overlap, the higher number wins (default: 0).
Trigger type — schedule (date-based) or liveops_event (links to a Live Ops event).

Choose a preset theme or build your own

Five presets are available — click one to auto-fill all tokens:

🎂 Birthday

Gold tones, light background. Perfect for anniversary events.

light

🎃 Halloween

Orange on dark. High contrast, spooky feel.

dark

❄️ Winter

Ice blue, frosted glass look. Holiday season.

glassmorphism

🌸 Spring

Soft cherry blossom pink. Spring events.

light

☀️ Summer Neon

Neon green on dark. High energy summer vibes.

dark

Or open the Figma import panel (collapsible, inside the modal) to paste a Figma URL and import your designer's colours directly.

Preview the merged theme

The modal shows a mini live-preview of the merged tokens (campaign overrides on top of your base theme). Only the tokens you specify are overridden — everything else stays as the base theme.

Click "Create Campaign"

The campaign is saved. You will see it in the campaign list with a status badge:

Upcoming — before start date
Active — currently running
Ended — past end date

⚡ Changes go live within 60 seconds

The SDK polls for config every 60 seconds. For upcoming campaigns starting soon, the SDK pre-schedules a timer up to 48 hours in advance — the theme switches exactly at start_at, with no extra server call.

Real-world campaign examples

Campaign	Trigger	Window	Result
Black Friday Sale	`schedule`	Nov 28 – Dec 2	Urgency-driven bundle sales during peak shopping window
Game 1st Anniversary	`schedule`	Launch date anniversary	Celebratory offer — loyal player retention reward
New Boss Raid Event	`liveops_event`	Tied to Boss Raid live event	Contextual: theme matches the in-game event atmosphere
Summer Tournament	`schedule`	July 1 – Aug 31	Seasonal re-engagement — players who haven't opened app in 2 weeks

💡 AI prompt you can use

"I want to run a Black Friday campaign from November 28 to December 2. My game is a dark FPS. What accent colour, badge colour, and background style should I use? And should I tie it to a Live Ops sale event or just use a schedule trigger?"

Common questions

Q: What if two campaigns overlap?

The one with the higher priority number wins. If equal priority, the one with the later start_at date wins.

Q: Can I cancel a campaign early?

Yes — click the campaign card, then Delete. The SDK will revert to the base theme on the next config poll (within 60 seconds).

Q: Can I edit a running campaign?

Yes — click the pencil icon on an active campaign. Changes take effect within 60 seconds.

Q: Does a campaign affect A/B experiments?

No. Campaigns only change the visual theme. Offer content and pricing are controlled separately by the AI and approvals.