Skip to main content
All CollectionsPortal Pages
Design | Marketplace | Redemption Codes
Design | Marketplace | Redemption Codes

Engage influencers & drive contest participation

Paul Winterhalder avatar
Written by Paul Winterhalder
Updated over a week ago

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:

Did this answer your question?