By setting various user properties, such as level, cohort, and ID, you can automatically get powerful analytics insights from the Tapjoy dashboard. For example, by setting user level whenever your user gains or passes level, you can get a picture of how your users are distributed throughout the levels of your game:
Tapjoy.setUserLevel(1); // Set the user level to 1
This will let you see graphs in the "Game Trend" section of the dashboard.
You can set a user ID. Some Tapjoy SDK integrations do not need to do this. Tapjoy’s SDK will automatically generate a user ID for you. But there are certain situations in which you will want to specify your own user ID:
Failure to set the user ID properly (or setting in in a situation where you should be letting Tapjoy’s SDK set it for you) will result in users not getting rewarded for Tapjoy activities, or having user balances strangely appear and disappear.
NOTE: If you plan on using Push to Earn campaigns, this will need to be set before the connect call.
NOTE: For data privacy and GDPR-compliance reasons, you may NOT use email address, phone number, real name, or any other personally identifiable information in the user ID you set with this call.
If you need to set a user ID, you can do so with the following code (no dashboard setting is necessary):
Tapjoy.SetUserID("A_UNIQUE_USER_ID");
You can set up to five user cohort variables, which will enable you to target content at specific subset of your users, or to compare cohorts of users using the "side-by-side" view in the dashboard:
Tapjoy.SetUserCohortVariable(1, "Warrior");
Tapjoy.SetUserCohortVariable(1, "Enchanter");
Store cohort will enable you to track which store you application has been installed from.
Register the store cohort in Window > Tapjoy > Store
. String that stands for application stores such as ‘Amazon’ can be used for the value.
How many user cohort variables can I have?
Five.
How long will it take for these custom cohorts to appear in my dashboard once they are integrated and my app starts sending them?
The custom cohorts on the dashboard are created daily, so it might take up to 24 hours for them to appear.
Should I put setUserLevel
whenever user starts game/app?
No. Call only once when an initialization or changes of user level happened.
Besides user level, what are the other user variables I can utilize in dashboard?
You can send user ID, FriendCount, and custom user cohort variables.
How can I reset level information?
Send negative integer instead of level. [Tapjoy setUserLevel:-1];