Games Integration - Lobyco Help center

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 can be fully managed from a simple-to-use interface

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

Integration within an existing loyalty landscape

The retailer sets up the promotion

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

Promotion is imported

Promotion is imported into the Lobyco Promotion Service.

Promotion is linked as a game reward

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

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.

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.

Promotion Service allocates a coupon

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

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.

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.

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

​Integration within an existing loyalty landscape

​The retailer sets up the promotion

​Promotion is imported

​Promotion is linked as a game reward

​Mobile app loads the game

​Game Service notifies Promotion Service

​Promotion Service allocates a coupon

​User redeems the reward

​Coupon System notifies Promotion Service

​Games mobile app integration

​Promotion integration - import campaign data