📚 In this article...
Eligibility Setting & Game Activation
Member Experience & Multi-Game Arena
Run multiple games
Overview
Games is a feature that enables merchants to engage loyalty members through branded, play-to-win mini-games. Hosted on the Customer Portal (accessible via desktop/mobile web or mobile app webviews), eligible members play for a chance to win a configured gift, which is automatically credited to their account for online or in-store redemption.
Key Capabilities
3 Ready-to-Use Games: Loop Snake, Treat Catch, and Menu Match.
Custom Branding: Define game titles, color palettes, emojis, and winning target scores.
Reward Capping: Set a campaign-wide limit for the total number of gifts available across all players.
Rule-Based Eligibility: Link games to Campaign Center rules using game-specific eligibility tags.
Multi-Game Arena: Automatically presents a game selection screen if a member is eligible for more than one active game.
Performance Tracking: Monitor total plays, unique players, and gifts awarded directly from the Hub.
Key Concept: Game setup and campaign distribution are managed separately:
Games Page: Defines the game design, win condition, and reward.
Campaign Center: Defines who becomes eligible, when they become eligible, and sends the game link.
Before You Begin
Ensure the 'Games' feature flag is enabled in Hub.
Prepare at least one active gift in the Campaign Center to serve as the game reward.
Determine your eligibility criteria (e.g., birthday, spend threshold, new registration) and outreach channels (Email, SMS, Push, Customer Portal menu, or Mobile App Webview).
Game Configuration
Step 1: Open the Games Catalog
Go to Campaign Center.
Select Games from the left navigation menu.
Choose a game (Loop Snake, Treat Catch, or Menu Match).
Step 2: Customize Design & Rules
Enter a Game Name.
Set the Score Required to Win.
Choose your Primary and Secondary colors (or click Use My Colors to auto-apply your Customer Portal theme).
Select positive/food emojis and obstacle emojis (where applicable).
Select the Gift Awarded to winning members.
Set the Total Gifts Available (the maximum number of rewards that can be won across the entire campaign).
Note: Each member can win a specific game only once. Setting Total Gifts Available to 200 means up to 200 unique members can win a gift before the campaign closes.
Step 3: Save & Preview
-
Click Save Configuration to update the preview player.
-
Use the on-page desktop preview to test the gameplay and design.
- Click Play on Your Phone and scan the QR code to test the experience on a mobile device.
Eligibility Setting & Game Activation
Step 1: Get the Game Eligibility Tag
Click Turn On Game.
A modal will display a unique Eligibility Tag (e.g.,
game_loop_snake_123).Copy this tag exactly as shown. Do not rename or modify it.
Step 2: Create the Campaign Center Rule
Open Campaign Center > Rules in a new tab.
Create or edit a rule defining your target audience and triggers.
Add the action: Tag Member → paste the exact Eligibility Tag.
Save and activate the rule.
Step 3: Turn On the Game
Return to the game setup modal, confirm the rule has been activated, and turn the game ON.
Behind the Scenes: When a member wins, the system automatically awards the selected gift and removes the eligibility tag. This ensures members can win a reward only once per game campaign.
Game Distribution
To distribute the game, copy the Game URL from the game's View Setup section and share it via your preferred channel:
Email / Push: Add the game URL to a button or text link in your Campaign Center message action.
SMS: Paste the game URL into your SMS template and use the built-in URL-shortener tool to save characters.
Customer Portal: Eligible members can access active games directly via the Customer Portal navigation menu.
Mobile App Webview: Open the Customer Portal game URL inside a mobile app webview using temporary token authentication and mobile source parameters.
Member Experience & Multi-Game Arena
Access Check: When a member opens the link, the system verifies that they have the active eligibility tag and that total gift limits have not been reached.
Winning: Upon reaching the target score, a victory modal appears, and the gift is added to their profile under Rewards.
Play for Fun: After winning, members can replay the game for fun, but no additional gifts will be issued.
Multi-Game Arena: If a member is eligible for more than one active game at the same time, opening the Games link brings them to an Arena screen where they can choose which game to play.
Game Management & Analytics
View Setup: Re-open the setup drawer at any time to copy the distribution URL or review the eligibility tag.
Pause Game: Pausing a game instantly makes it unavailable to members on the Customer Portal. It does not retroactively remove tags or edit active rules.
Game Stats: Click Stats on any game card to track total plays, unique players, and total gifts awarded.
Frequently Asked Questions
Q: Can a member win the same game twice?
A: No. Once a member wins, the system automatically removes their eligibility tag.They can continue to play the game for fun, but cannot win additional gifts from that campaign.
Q: What happens if the gift limit is reached or the gift expires?
A: The game will automatically become unavailable for reward-enabled play.
Q: Is "Total Gifts Available" a per-member cap?
A: No, it is the total reward cap across all players for that campaign.