Incentives #

The Incentives system in Hiro is a powerful tool that enables you to create a variety of incentives to drive and increase play engagement, retention, and revenue. Incentives can be used to reward players for completing specific tasks, such as logging in daily or completing advanced tutorials, and also to encourage players to spend money in your game.

Customization parameters #

The following JSON represents the customization parameters you can use to configure the default user experience for a particular incentive.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

{
    "incentives": {
        "<incentiveId>": {
            "type": "daily_login",
            "name": "",
            "description": "",
            "max_claims": 1,
            "max_global_claims": 1,
            "max_recipient_age_sec": 86400,
            "recipient_reward": "<rewardId>",
            "sender_reward": "<rewardId>",
            "max_concurrent": 1,
            "expiry_duration_sec": 86400,
        }
    }
        
}

Each Incentive is keyed by id and may define the following:

PropertySubpropertyDescription
typeThe type of incentive.
nameThe name of the incentive.
descriptionA description of the incentive.
max_claimsThe maximum number of times this incentive can be claimed.
max_global_claimsThe maximum number of times an individual user can claim this incentive ID.
max_recipient_age_secThe maximum account age that is eligible for this incentive. Useful for restricting invites to new users only.
recipient_rewardThe reward for the incentive recipient.
sender_rewardThe reward for the incentive sender.
max_concurrentThe maximum number of times this incentive can be created by an individual user.
expiry_duration_secThe duration, in seconds, before the incentive expires.