Skip to content

Offers & Items


An Item Document represents one entity within your game. It can be a sword, shield, wood, stone - anything from your game.

Name Description
Name The name of the Item
MaxStack The maximum amount of Item, which can be put in one Slot

We want to keep this structure as universal as possible. Thus we only added a few parameters. However, your game needs much more parameters than we offer. Just create a new Template inherited from Item and add as many parameters as you need.

Store Items

StoreItems section holds everything you can sell directly through the in-game Shop or via Game Offers.


Name Description
Sprite The image associated with this Store Item. Read more about Sprites
Name The name of the Store Item
Price Price can be in Hard Currency, Soft Currency, or watching Ads
Reward Detailed information about the items player gets

Game Offers

Game offers (aka Personalised Offers) can make your company the most money and bring your customers the most significant value. Besides making money, they can also serve other purposes, like pushing players to make their first purchase or retaining a player who is about to churn.

  • New player completes the first level -> offer them a Starter Pack.
  • Player is playing for 3 days and doesn’t make a single purchase-> Offer them a time-limited pack with a considerable discount to convert them to paying users.
  • Player lost 3 matches in a row -> Offer them a Power Booster.
  • Player pays a lot -> hide all cheap offers and show more expensive ones.

Such a list is limited only by your imagination. You shall be testing a lot of such offers during LiveOps. Personalised offers are tough to implement and require much knowledge from the team, but this is the gaming industry's future.

Thanks to Balancy, you already have all the tools you need to start your experiments.


Name Description
Sprite The image associated with this Offer. Read more about Sprites
Name The name of the Offer
Duration How long will the offer be available to a user after the initial offering? (In seconds)
Store Item Defines what you are selling in this offer. Read more about Store Item
Description Detailed information about the offer
Reward Detailed information about the items player gets. You can edit them here or on a separate page Store Item
Limit Maximum amount of items the player can get

Offer Groups

There are several types of Offer Groups, and the most popular is the Chain Deal - a series of offers presented to a user in a sequence. A player must purchase or accept one offer in the chain as a gift before moving on to the next one. Offers in a chain deal can be versatile: from currencies and in-game items to bundles and loot boxes.

Type Description
Unlimited Purchases Players can purchase any Store Item in such group without limits while the Offer Group is active.
Chain Deals A player has to purchase or accept one offer in the chain as a gift before moving on to the next one.
Only One Purchase A player can purchase only one Store Item from the available list. After purchase, the Offer Group disappears.
Purchase Each Offer Once A player can purchase all the Store Items in a random order, but only once.


If your game requires additional parameters, you should inherit a new Template from 🎁 Game Offer and add as many parameters as needed. Screenshot

When you create a new Offer, make sure to select the new Template you just created, and then you'll get something like this: Screenshot

You can use the same trick for any structure in Balancy: GameOffer, GameOfferGroup, StoreItem, or Item*.

Section for programmers

You can request all active offers. Call this method only after OnSmartObjectsInitialized is invoked.

var activeOffers = Balancy.LiveOps.GameOffers.GetActiveOffers();
var activeOfferGroups = Balancy.LiveOps.GameOffers.GetActiveOfferGroups();

Visit the Payments section to learn how to purchase Offers and Store Items.

Visit the Programmers Section and learn how to subscribe for important events.