User Data
Our SDK provides user data tranfer for better ad targeting and higher eCPM. All parameters are optional.
Set User Id
To assign an ID to a user, please call this method before Appodeal initialization:
- UPM Distribution
- Manual Distribution
Appodeal.SetUserId("YOUR_USER_ID");
Appodeal.setUserId("YOUR_USER_ID");
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.
Custom Segment Matching
If the logic of your application allows specifying user's characteristics, then you can pass specific parameters to the Appodeal SDK. You can use Segments in the future.
- UPM Distribution
- Manual Distribution
- For gender use
PredefinedKeys.UserGender. - For age use
PredefinedKeys.UserAge.
Appodeal.SetCustomFilter("KEY_STRING", "SOME_VALUE");
Appodeal.SetCustomFilter("KEY_BOOL", true);
Appodeal.SetCustomFilter(PredefinedKeys.UserAge, 42);
Appodeal.ResetCustomFilter("KEY_STRING");
- For gender use
UserSettings.USER_GENDER. - For age use
UserSettings.USER_AGE.
Appodeal.setCustomFilter("KEY_STRING", "SOME_VALUE");
Appodeal.setCustomFilter("KEY_BOOL", true);
Appodeal.setCustomFilter(UserSettings.USER_AGE, 42);
Appodeal.resetCustomFilter("KEY_STRING");
Location
The SDK reads the device location only if your app has already obtained the OS location permission from the user. The SDK does not request the location permission itself — your app is responsible for requesting authorization.
To opt out of location collection, do not request/declare the location permission — on iOS omit the NSLocationWhenInUseUsageDescription key, on Android remove ACCESS_COARSE_LOCATION / ACCESS_FINE_LOCATION from the manifest. If the permission is missing, no location is collected.
Declare the collected location in your App Privacy Details (App Store / Google Play).
Send Extra Data
You can send key-value data to Appodeal.
- UPM Distribution
- Manual Distribution
Appodeal.SetExtraData("KEY_STRING", "SOME_VALUE");
Appodeal.SetExtraData("KEY_BOOL", true);
Appodeal.SetExtraData("KEY_INT", 42);
Appodeal.ResetExtraData("KEY_STRING");
Appodeal.setExtraData("KEY_STRING", "SOME_VALUE");
Appodeal.setExtraData("KEY_BOOL", true);
Appodeal.setExtraData("KEY_INT", 42);
Appodeal.resetExtraData("KEY_STRING");
To send the device identifier from a mobile attribution service and match it with the Appodeal user id, use
attribution_id as a key and a unique identifier from your attribution service as a value and if you use this
method for attribution, call it before Appodeal SDK initialization.