Introduction
Virtual Goods are intangible assets that your app users can receive based on their interaction with your app. For example, you can reward users with badges after they've completed a series of Activities. This is a way to provide incentives to your users and promote engagement.
This article explains how you can reward users with Virtual Goods. There are various Virtual Goods available on Cogniss:
Badges: For users to feel a sense of achievement post-Activity completion
Profile Avatars: For users to add a graphical representation of themselves in your app
Stickers: For users to convey emotions or a specific response in a fun way on your app's Newsfeed
How to set it up
Pre-requisite: Show Virtual Goods
To display specific rewards using Cogniss, ensure you have enabled the following through your App settings within Creator:
For Badges:
Go to Settings>Footer section>Enable the Profile menu>Enable Use Badges
For Profile Avatars:
Go to Settings>Footer section>Enable the Use Edit Profile
In the same Settings menu and go to the User Profile Avatar section>Enable Show Profile Avatar
For Stickers:
Go to Settings>Footer section>Enable the News button menu (to use the stickers within the Newsfeed)
Step 1: Create the Virtual Good
You will first need to create the Virtual Good(s) to be rewarded.
Navigate to the Virtual Goods section in Creator, then select Create new virtual good
Virtual good name: [The name of the badge]
Description: [What the badge is for]
Type: Select the type of Virtual good from the dropdown list: BADGE, AVATAR_PIECE, or STICKER
Maximum Quantity: 1
File: [Select or upload an image for the Virtual Good]
Locked image (optional): [Select the image shown when the Virtual Good is not rewarded yet]
Step 2. Set up Behaviors
After creating Virtual Goods, the next step is to display them to your users. One way of doing so is through Behaviors.
This feature relies on defining a Trigger, which corresponds to a user's action, leading to a rewarding outcome. In this instance, the reward will consist of a Virtual Good and a message.
Users will see the Virtual Good and message on your app's Dashboard/ Home screen after they complete the corresponding Activity.
Go to Creator>Behaviors tab and click Create a new behavior:
Name: Reward Badge after [activity name] completion
Add Trigger:
Type: REQUEST
Model: ActivityResponse
Operation: UPDATE
Subject, Topic, Activity: Select the specific Activity
Tick Complete, Complete state = COMPLETE
Add Criteria (Legacy)* (optional)
Criteria serve as an additional tier of specific conditions or rules that your users must fulfill in order to earn a Virtual Good. In our example scenario above, if we want to implement criteria stating that users must complete the activity five times before receiving a badge reward, we can configure this section.
While optional, this section proves to be a powerful tool for customizing rules within the behaviors.
Type: COUNT
Model: ActivityRepsonse
Subject, Topic, Activity: Select the specific Activity from the Trigger step
Leave Score and Percent Correct empty
Tick Complete, Complete state: COMPLETE
Count: 5 (no. of times they have to complete the Activity)
Remove Criteria (Legacy) to reward the user if they only need to complete the Activity once.
Add Results:
This is where you'll set the Virtual Good you want to reward your users with.
Result: Transaction
Type: VIRTUAL_GOOD
Virtual Good: Select the Virtual Good from Step 1
Quantity: 1
Next, let's display a message to your users.
Click Add another result
Result: Notification
Type: VIRTUAL_GOOD
Title and Text: [Type a relevant message to go with the Badge]
Count: 1
Virtual Good: Select from the list of Virtual Good
Email/push notification/in-app pop-up: Leave them unticked
Ensure only the Open option is ticked.
Enable the Recurring option to ensure consistent rewards for the user whenever the behavior occurs.
Save changes to complete this step. You should see the results as an in-app pop-up.
Step 3. Set up Feedback (optional)
Another method of displaying Virtual Goods is through Feedback.
While Behaviors (see step 2) allow you to display Virtual Goods on your app's Dashboard/ Home screen, Feedback allows you to display them immediately to your user after an Activity completion. They won't have to return to the Dashboard/ Home screen to view their Virtual Good(s).
Navigate to the Feedback tab in Creator>Content, then click Create new feedback
Add a Feedback name and a Description (optional).
Page Type: Virtual Good
For the title and text, follow the same Title and Text you created from the Results in Step 2
Set up the Button label and Save changes
Navigate to the Activity settings where you want this Feedback to appear.
Note that Feedback will always appear after the completion of an Activity.
Scroll down to Feedback and search for the Feedback you just created.
Save changes, preview and test your app to see the results!