Rewards
A reward represent a level of access, feature, or content that a user is “rewarded” with.
If you’re familiar with RevenueCat, WinWinKit’s Rewards concept is similar to their Entitlements.
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.
Remember to withdraw credits when the user utilizes them.
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.
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!