​

Reward Types

​

Basic

A Basic Reward is the simplest form of reward that can be offered to users. Typically it should be used to “reward” a user with an access, feature, or content.

Examples

There are many ways how the basic reward type can be utilized. Below are a few of then:

• Alternative Plan: Offer an alternative plan to a user.
• Feature Access: Grant access to a special feature.
• Exclusive Content: Unlock content that otherwise is restricted.

​

Credit

A Credit Reward is a type of reward that provides users with credits that can be used within the app.

Examples

• Trial Days: Grant a user with a number of trial days. One day equals one credit.
• AI Requests: Grant additional requests as a reward. One request equals one credit.
• Game Levels: Unlock a number of levels in a game. One level equals one credit.

​

Offer Code

An Offer Code reward provides users with an App Store Offer Code that grants them a discounted or free subscription for a specified duration.

Examples

• Discounted Start: Give a user discounted first three months of a monthly subscription.
• Cheaper First Year: Attract a user with a lower price for the first year of a yearly subscription.
• Free Month: Reward with a free month of their active subscription for each invited user.
• Trial Period: Enable a trial period on a subscription that otherwise is not available.

Learn more about Offer Codes.

​

Entitlement

A reward that provides users with a RevenueCat Entitlement.

Examples

• Feature Access: Grant access to a feature as a reward for engaging with referrals.
• Premium Access: Grant access to premium features for a limited time.

Learn more about RevenueCat Entitlements.

​

Offering

A reward that provides users with a RevenueCat Offering.

Examples

• Special Offering: Set a special offering for newcomers from a referral invite.

Learn more about RevenueCat Offerings.

​

Setting Up

​

Type

The type of the reward.

​

General

​

Name and Description

Name and optional description. Will be shown to the users with Preview Link enabled.

​

Key

The key is a stable and machine-readable string value meant to be used for granting users access to their rewards. Once the reward is saved, its key cannot be changed.

​

Credits

Credits defines the amount of usable credits for the reward. Once the reward is saved, its credits cannot be changed.

Only applicable to the Credit reward type.

​

Offer Code

The attached Offer Code from the App Store Connect. Once the reward is saved, its Offer Code value cannot be changed.

Only applicable to the Offer Code reward type.

​

Configs

​

Metadata

This allows you to provide extra configuration and metadata making it flexible to meet your specific needs. Must be a valid JSON object.

​

Example Rewards

​

Basic

Let’s create a simple reward that rewards users with an extra app icon.

Step-by-step guide

​

1. Type

Selected type is by default “Basic”.

​

2. Name and description

Enter name and description.

​

3. Key

The key value is auto-filled based on the entered name and if is precise enough can be kept as is.

​

4. Save

The reward is ready!

​

Credit

Let’s create a reward that rewards users with 20 extra AI requests.

Step-by-step guide

​

1. Type

Select type “Credit"".

​

2. Name and description

Enter name and description.

​

3. Key

The key value is auto-filled based on the entered name and if is precise enough can be kept as is.

​

4. Credits

Enter the number of credits attached to the reward.

​

5. Save

The reward is ready!

​

Offer Code

Let’s create a reward that rewards users with a free month of a subscription.

Step-by-step guide

​

1. Type

Select type “Offer Code"".

​

2. Name and description

Enter name and description.

​

3. Key

The key value is auto-filled based on the entered name and if is precise enough can be kept as is.

​

4. Offer Code

Select the Offer Code that is loaded from the App Store Connect.

Learn more about Offer Codes.

​

5. Save

The reward is ready!