--- schema_version: "1" id: 5ef7d94243c476442e6750b670fbb14cfd0eece4c3e849f6b9102c7875ebf56c title: Create Games and Add Rewards collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/loyalty_games_definition_reward.md canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.loyalty_games_definition_reward.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: 9613f8a0dd0a56c7c25176fd67d7bf99080455cadafe3b06351b8031e7a992d2 description: Program managers can create games such as spin the wheel and scratchcard, and decide the rewards that customers receive after they play the games. products: - Loyalty Management release: "264" --- # Create Games and Add Rewards Program managers can create games such as spin the wheel and scratchcard, and decide the rewards that customers receive after they play the games. ### Required Editions

Available in: Lightning Experience

Available in: Enterprise, Performance, Unlimited, and Developer Editions with Loyalty Management

User Permissions Needed
To create games:	Loyalty Management AND Edit access on Game Definition
To create game rewards:	Loyalty Management AND Edit access on Game Reward

User Permissions Needed

To create games:

Loyalty Management

AND

Edit access on Game Definition

To create game rewards:

Loyalty Management

AND

Edit access on Game Reward

A loyalty program can offer these types of games to its customers and loyalty program members: | Game Type | Customer Experience | How the Game Is Designed In Salesforce | | --- | --- | --- | | Spin The Wheel | Customers can spin a virtual wheel and the wheel segment where the pointer stops shows the reward that the player receives. | A game definition record represents the game. Game reward records represent the rewards offered by each segment of the wheel. You can add only one reward for each wheel segment. | | Scratchcard | Customers can scratch a virtual card and the card reveals the reward that the player receives. | A game definition record represents the game. Each reward that the scratchcard offers is represented as game reward records. | ![Tip](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-loyalty_management-264-0-0-production-enus/0590ce3e-5a09-45ab-8e5e-68f359c35886/images/icon_tip.png) Tip Select the reward type in the game reward record as No Reward for instances where a wheel segment or a scratchcard outcome doesn’t offer a reward to participants. ## Create a Game Here's how you can map your business requirements to key game definition fields when you create a game definition record:

Business Requirement	Game Definition Configuration	Purpose	Example
Ensure that only select customers can play the game and the game isn’t available to all customers.	In the game definition record, select Game Assignment Required.	The Game Assignment Required checkbox ensures that only the customers who are assigned the game are eligible to play the game. Use this option if you want to offer the game to customers after they complete a specific eligible activity.	A game that’s assigned to customers when they become a loyalty program member. A game that’s assigned to loyalty program members when they reach the Gold tier. A game that’s assigned to loyalty program members when they shop for US$50 or above.
Ensure that all customers can play the game.	In the game definition record, don’t select Game Assignment Required.	Use this option to offer the game to all customers without placing an eligible criteria for the game.	A game that’s available for all customers in the Game Zone on the mobile app.
Ensure that customers are assigned the game during a specific period.	In the game definition record, select the start date and the end date.	The start and end dates decide the period during which a game can be assigned to customers. To design an evergreen game that can be assigned to customers at any time, select a start date but not an end date.	A game that’s assigned to customers between Black Friday and Cyber Monday.
Ensure that customers complete the game within a specific amount of time after they start the game.	In the game definition record, in the Timeout Duration field, enter the number of seconds within which customers must complete the game.	The timeout duration decides the number of seconds after a customer starts the game after which their game session times out.	A game that customers must complete within 120 seconds of starting the game.
Ensure that customers are eligible to play the game for a fixed duration after they’re assigned the game.	In the game definition record, use the Expiration Period Unit and Expiration Period fields to define the period for which customers are eligible to play a game after the game is assigned to them.	The expiration period ensures that the games that customers don’t play before the end of the expiration period automatically expire. After a game expires, customers can't play it.	A game that customers must play within three weeks after it’s assigned. A game that expires four months after it’s assigned to customers.
Ensure that the game can be assigned and played by customers.	In the game definition record, select the status as Active and ensure that the game start date is set to the date from which customers can play the game.	The Status and the Start Date fields ensure that games aren’t available for customers to play before the brand is ready to offer the game to customers.	A game that only goes live for customers to play on March 15.

1. From the App Launcher, find and select **Game Definitions**. 2. Click **New**. 3. Define the game and save your changes. After you create a game, add its rewards. You can add a game’s rewards on the Game Rewards tab in a game definition record. ## Add Game Rewards Here's how you can map your business requirements to key game reward fields when you create a game reward record:

Business Requirement	Game Reward Configuration	Purpose	Example
Offer customers vouchers as game reward.	In the game reward record, select Voucher from the Reward Type field and select Voucher Definition from the Reward Definition field.	You can set up a process to issue the voucher to the player who wins the reward.	The reward offers customers the Free Cheesecake voucher.
Offer loyalty program members points as game reward.	In the game reward record, select Loyalty Points from the Reward Type field and select the loyalty program currency for which you want to credit points from the Reward Definition field.	You can set up a process to credit points to the player who wins the reward.	The reward offers loyalty program members 100 points.
Offer customers a reward that’s unique to your brand.	In the game reward record, select Custom Reward from the Reward Type field.	You can set up a process to provide the custom reward to the player who wins the reward.	The reward offers customers a gift card. To issue custom rewards like gift cards, set up an integration with the external system where you manage custom rewards.
Offer customers a fixed number of points.	In the Reward Value field of the game reward record, enter the number of points.	The reward can offer the player a fixed number of points.	The reward offers customers 150 points.
Add an image and color for each segment in the virtual wheel of a Spin The Wheel game.	In the game reward record, specify the image’s location in Image URL and the color code in Color.	The reward has your brand’s custom branding in the virtual wheel segment.	The Free Cheesecake segment in the wheel segment has an image of a cheesecake.
Add the probability of customers winning a reward when they play the game.	In the game reward record, enter the win probability percentage in Win Probability.	The win probability percentage determines the chance of customers winning the reward. You can enter the win probability as a percentage and the cumulative value of the all rewards in a game can be 100%.	The reward’s win probability is 25% because the reward is provided to players at every fourth attempt.
Ensure that each reward is only rewarded until the reward is available in the reward inventory.	In the game reward record, in Maximum Reward Count, enter the number of times the reward can be offered to players.	The reward is awarded to members a fixed number of times. After the reward reaches its limit, the reward is no longer offered to customers.	The reward can be provided to the first 500 winner.
Add one reward that doesn’t offer customers anything.	In the game reward record, from Reward Type, select No Reward.	The reward supports use cases where you don’t want to offer customers a reward for playing the game.	A segment in the wheel or a reward option in the scratchcard shows Better Luck Next Time.

1. Open the game definition for which you want to add rewards. 2. Click **Related**. 3. On the Game Rewards tab, click **New**. 4. From Game Definition, select the game that you want to offer the reward for. 5. Define the game reward and save your changes. ![Spin the Wheel](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-loyalty_management-264-0-0-production-enus/0590ce3e-5a09-45ab-8e5e-68f359c35886/images/icon_example.png) Spin the Wheel Cloud Kicks wants to enhance customer engagement in their promotion by incorporating the spin the wheel game. The spin the wheel game offers customers three rewards and the fourth segment of the wheel doesn’t offer customers any reward. Each reward can only be provided to customers a limited number of times. The company wants to run the game during the last two weeks of the year and it’s only available for customers to play after the game is assigned to them. After the game is assigned, customers have to play the game within five days. Here’s how the game is modeled:

Game Definition	Game Definition Configuration	Game Reward	Game Reward Configuration
Spin the wheel and get a shot at winning loyalty points or a voucher.	Game Type—Spin The Wheel Game Assignment Required—Selected Start Date—December 15 End Date—December 31 Expiration Period Unit—Days Expiration Period—5	Get 20 Points	Reward Type—Loyalty Points Reward Definition—Regular Points Reward Value—20 Win Probability—25 Maximum Reward Count—100 Color—#90d0fe (Blue)
		Get 50 Points	Reward Type—Loyalty Points Reward Definition—Regular Points Reward Value—50 Win Probability—25 Maximum Reward Count—50 Color—#ff784f (Orange)
		Get a $25 Voucher	Reward Type—Voucher Reward Definition—Get $25 Off on Your Next Purchase Win Probability—25 Maximum Reward Count—25 Color—#41b658 (Green)
		Better Luck Next Time!	Reward Type—No Reward Win Probability—25 Color—#c9c9c9 (Grey)

Cloud Kicks wants to offer a surprise scratchcard to new customers who sign up with the brand for the first time. A scratchcard game offers customers two rewards and another reward that doesn’t offer customers anything. The company want to give out rewards to 100 new customers. The game is always available for customers to play and doesn’t have to be assigned to them. Each of the game’s rewards can be offered to customers up to 5,000 times. Here’s how the game is modeled:

Game Definition	Game Definition Configuration	Game Reward	Game Reward Configuration
Scratch a card and get a shot at winning loyalty points or a voucher.	Game Type—Scratchcard Game Assignment Required—Deselected Start Date—January 1	Get 100 Points	Reward Type—Loyalty Points Reward Definition—Regular Points Reward Value—100 Win Probability—25 Maximum Reward Count—75
		Get a $5 Voucher	Reward Type—Voucher Reward Definition—Get $5 Off on Your Next Purchase Win Probability—50 Maximum Reward Count—25
		Better Luck Next Time!	Reward Type—No Reward Win Probability—25

Work with your admin to integrate the Eligible Games and Game Rewards business APIs with the sites or apps where you want your members to play the game.