Games Integration

Integrating Lobyco games.

The Lobyco Games is a significant engagement driver that is quick to implement, easy to manage and provides great results.

Games Admin Portal provides full access to configure game designs and behavior

Allow to set up and manage app games with products or services in stores as prizes in a few steps.

• Select game template: quick start from preloaded game designs.
• Customize gameplay: brand the game via an easy-to-use WYSIWYG editor.
• Game campaign: plan games by setting up periods, win chances, logistics, and others.
• Monitor games and adapt prizes and behavior as needed.

Lobyco Admin Portal - games are fully managed from a simple-to-use interface

Integration within an existing loyalty landscape

1. The retailer sets up the promotion

   The retailer sets up the promotion for game rewards coupons in the Client Promotion System.

2. Promotion is imported

   Promotion is imported into the Lobyco Promotion Service.

3. Promotion is linked as a game reward

   Promotion is linked as a game reward to the Lobyco Game Service.

4. Mobile app loads the game

   The Mobile App (existing or implemented by Lobyco) calls the Lobyco Game Service to provide the game URL and load the actual game in a web view.

5. Game Service notifies Promotion Service

   When a user plays and wins a game, the Lobyco Game Service notifies the Lobyco Promotion Service that the customer has earned a reward.

6. Promotion Service allocates a coupon

   The Lobyco Promotion Service allocates a coupon for the user in the Client Coupon System.

7. User redeems the reward

   When the user redeems the reward at the POS, the POS calls the Client Coupon System to get and redeem the coupon.

8. Coupon System notifies Promotion Service

   The Client Coupon System notifies the Lobyco Promotion Service that the coupon is redeemed.

Games mobile app integration

Action	Request	Response	Mobile App
Get games	GET /v1/games — memberId is parsed from the token	The games available to the customer, ordered	Display the game if the customer has one available
Start game	POST /v1/games/{gameId}/start — memberId is parsed from the token	gameUrl for the started game	Open gameUrl in a webview
Game finished — customer wins	REDIRECT lobyco://game-finished?isWin=true&rewardId=abc1234	—	Close the webview when the game finished redirect is received, then show a native reward screen
Game finished — customer loses	REDIRECT lobyco://game-finished?isWin=false; on error: REDIRECT lobyco://game-finished?isWin=false&error=error_message	—	Close the webview when the game finished redirect is received; if there is an error, show an error

Promotion integration - import campaign data

When a games promotion reward is created in the Client’s Promotion System it should also be imported into the Lobyco system to become available for other components: game service, mobile app (if needed), etc.

The import process is, by default, implemented via events like campaign Created/Updated/Deleted in the Lobyco Promotion Service.

If some of the required fields can’t be supplied by the client service, the Lobyco Promotion Admin tool is used to enrich the data model. Usually used for promotional images, Terms & Conditions texts, or description fields.