Scratch Card
Configure a Scratch Card game with a scratchable cover, reveal images, and probability-based or scheduled outcomes.
Placeholders in this article
This article contains placeholder screenshots. Search for placehold.co in this file and replace them before publishing.
Use Scratch Card when you want players to actively remove a cover image and reveal a branded win or loss visual underneath.
Before you begin
- Open an existing campaign in Studio. If you still need the campaign shell, start with Your first campaign.
- Prepare the shared touchpoint assets: a
Background Imageat1536 x 2048 pxand an optionalThumbnailat800 x 800 px. - Prepare the card visuals: one scratchable cover image, an optional branding-side image, and one landscape reveal image for each winning or losing result.
- Decide whether the game should resolve through
Random ChanceorScheduled Rewards. The current Scratch Card UI does not exposeLottery.
Configure the game
1. Create the touchpoint
In Build -> Touchpoints, add a new game touchpoint and choose Scratch Card.
Use an internal name that clearly identifies the campaign and locale. That makes the validation messages easier to understand later.
2. Set the page appearance
Open the Appearance tab and fill in the page frame:
- Upload the
Background Image. - Add the
TitleandSubtitle. - Use the description field if you want to explain the prize mechanic before play starts.
- Add a
Thumbnailif the touchpoint will appear in a list of games.
This screen controls the page around the card. The scratchable card itself is built separately.
3. Build the scratch card
Open Scratch Card Design and configure the card asset:
- Upload the
Front Image (Scratchable Cover)that players will rub away. - Add the
Back Image (Branding Side)if you want the card to keep a branded reverse face in preview and reveal flows. - Save the builder so OmniLab generates the scratch-card asset used on Pages.
The current builder uses a landscape card model for the revealed outcome. Prepare each winning or losing image in a format that stays readable in that wide reveal area.
4. Configure the outcomes
Open Outcomes to decide how the revealed result is selected.
Random Chanceuses probability weights. The combined total across winning and losing options must equal100.Scheduled Rewardsuses date-based availability. ChooseSimplefor one continuous date range orAdvancedto configure attribution slots after you link each winning reward.- Every winning option needs a result image, a
Winning Option Message, and a linked reward. - The losing outcome should also include its own image and
Losing Message.
If you need a delayed draw instead of an immediate reveal, move to a game type that exposes Lottery, such as Simple / Instant Win or 3D Selection game.
For the reward mechanics behind scheduled and immediate wins, keep the game article focused and use the platform references for Instant Win, Attribution slots, and reward linking.
5. Review the shared tabs and test
After Appearance and Outcomes, review the shared luck-based tabs as needed: Terms & Conditions, Restrictions, Dates, Gamification, and Advanced.
Use the Dates tab for overall play availability. In Scheduled Rewards, the date settings in Outcomes only define when the winning moments are distributed.
Save the touchpoint, open a preview or published page, and test both a winning reveal and a losing reveal before launch.
What players see
Players land on a branded page with the touchpoint title, subtitle, and optional instructions. Once they start, Pages shows the prompt Scratch the card to reveal your reward.
As the cover image is scratched away, the selected winning or losing image appears underneath. OmniLab then displays the message linked to that option.
Common validation issues
| Validation message | Meaning | Fix |
|---|---|---|
Scratch game '{{online_game_name}}' is missing scratch card configuration | The touchpoint was created, but the scratch-card builder was not saved with a full configuration. | Go to Build > Touchpoints > {{online_game_name}} > Game Configuration and configure the scratch card settings |
Scratch game '{{online_game_name}}' is missing a covered image | The scratchable front layer has not been uploaded yet. | Go to Build > Touchpoints > {{online_game_name}} > Game Configuration and upload a covered image |
Scratch game '{{online_game_name}}' is missing an asset | Pages has no generated scratch-card asset to render. | Go to Build > Touchpoints > {{online_game_name}} > Game Configuration and select an asset |
Scratch game '{{touchpoint_name}}' {{option_type}} option '{{display_name}}' is missing an image | One of the reveal results has no artwork attached. | Go to Build > Touchpoints > {{touchpoint_name}} > Game Configuration and upload an image for the {{option_type}} option '{{display_name}}' |
Probability-based game '{{touchpoint_name}}' has invalid total probability weights: {{total_weight}} (must equal 100) | The weight distribution does not add up to a valid total. | Go to Build > Touchpoints > {{touchpoint_name}} > Game Configuration and adjust probability weights so they sum to exactly 100 |
What to try next
About rewards and winning methods
Choose the right reward type before you finalize each scratch outcome.
Instant Win rewards
Use the canonical guide for rewards that resolve immediately after the scratch action.
Attribution slots
Plan advanced scheduled availability for each winning result.
Link rewards to touchpoints
Review the shared reward-linking flow used across OmniLab touchpoints.