User properties
Define user properties such as level, user ID, or other attributes in Flutter to enable detailed analytics and behavior tracking within the Tapjoy dashboard.
Read time 2 minutesLast updated 8 months ago
By setting various user properties, such as level 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 1Tapjoy.getUserLevel(); // Get the user level
User ID
You can set a user ID.
Note
Some Offerwall SDK integrations do not need to do this.
The Tapjoy 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:
- If you are using Tapjoy with self-managed currency, you must specify a user ID. This is so that when Tapjoy’s server sends your server a message that a user has earned some currency, it knows which user to identify as the recipient.
- If you are using managed currency and want your users to be able to keep their currency balance across multiple devices, then you must specify your own user ID, and make sure it is the same across all devices for a given user.
Failure to set the user ID properly (or setting in in a situation where the Tapjoy SDK can set it for you) will result in users not getting rewarded for Tapjoy activities, or having user balances strangely appear and disappear.
Note
For data privacy and GDPR-compliance reasons, you cannot 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(userId: 'userId', onSetUserIDSuccess: () => {}, onSetUserIDFailure: (error) => {});Tapjoy.getUserID();