# Incentives

**URL:** https://heroiclabs.com/docs/hiro/concepts/incentives/
**Keywords:** incentives, hiro
**Categories:** hiro, incentives, concepts

---


# Incentives

The Incentives system in Hiro is a powerful tool that enables you to create a variety of incentives to drive and increase player 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.

```json
{
    "incentives": {
        "<incentiveId>": {
            "type": 1,
            "name": "Free Coins Invite",
            "description": "Send 100 free coins to a new player!",
            "max_claims": 1,
            "max_global_claims": 1,
            "max_recipient_age_sec": 86400,
            "recipient_reward": {
              "guaranteed": {
                "currencies": {
                  "coins": {
                    "min": 100
                  }
                }
              }
            },
            "sender_reward": {
              "guaranteed": {
                "currencies": {
                  "gems": {
                    "min": 10
                  }
                }
              }
            },
            "max_concurrent": 1,
            "expiry_duration_sec": 86400
        }
    }
}
```

The JSON schema defines an `incentives` object which _must contain an individual object for each incentive_ you wish to define in the system. You can configure as few or as many incentives as needed for your desired gameplay.

{{< table name="gdk.concepts.incentives.incentives-system" >}}

Each individual incentive is keyed by id and may define the following:

### Incentive

{{< table name="gdk.concepts.incentives.incentive" >}}