Redemption Codes
brainCloud’s redemption system allows apps to support an inventory of codes that can be redeemed by users to unlock rewards and/or content in the app. Each code can be used by a single user, only once.
Design
Redemption Codes are highly effective at developing a relationship between the developer and Social Media Influencers. Twitch and YouTube broadcasters will be grateful to have codes with which to do giveaways.
The most effective products to giveaway with Redemption Codes are non-resellable cosmetics OR bundles of hard currency. Doing a giveaway for a non-resellable cosmetic is recommended because:
it will not spoil demand for hard currency by new players,
it will build the perception of the account's value in the eyes of the account holder
there is no additional value to redeeming multiple copies of the same cosmetic, ensuring codes are not hoarded by a single player
Hard currency giveaways do not have to be large amounts to be effective. For example, it is better to give away 10 x $5 codes rather than 1 x $50 code.
Implementation
Creating Code Type:
To create Redemption Code type, go to the dashboard screen:
Click the [Add Item] button with the plus icon.
Enter the ‘Code Type Name’ – This should be unique
[Save] the Code Type
Using the S2S Explorer:
To add and active the code, go to the S2S Explorer screen:
Adding a code:
Go to Design | Cloud Code | S2S Explorer
Select [Service]: RedemptionCode and [Operation]: AddCode
In the Parameters:Enter [scanCode] as your desired code nameEnter [codeType] as the code Type created under Design | Marketplace |Redemption CodesEnter [codeState] as ‘Available’
Run it
Viewing the Redemption Code:
OPTION 1:
Go to Monitoring | Global Monitoring | Redemption Code
Enter the [scanCode] in the search text box
Click the [Search] button
OPTION 2:
Go to Monitoring | Global Monitoring | Redemption Code
Select the [Get Test Code] button.
Select the created ‘Code Type’ and ‘Code State’
Click the [Get Test Code] button
Using the API Explorer:
1. Redeem a Code:
Go to Design | Cloud Code | API Explorer
Authenticate it
Select [Service]: RedemptionCode and [Operation] – RedeemCode
In the Parameters:Enter the [scanCode] as the code name createdEnter the [codeType] as the code Type created under Design | Marketplace | Redemption Codes
Run it
2. Viewing the Redeemed Code:
OPTION 1:
Go to Design | Cloud Code | API Explorer
Authenticate it
Select [Service]: ‘RedemptionCode’ and [Operation]: ‘GetRedeemedCodes’
In the Parameters, enter [codeType] as the code Type created under Design | Marketplace | Redemption Codes
Run it.
The Result: You can view the Redeemed Codes:
OPTION 2:
Go to Monitoring | User Monitoring | Redemption Codes
Select the User
The Result: View the list of codes that have been redeemed by the User:
