User Data

Our SDK provides user data transfer 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

Appodeal.SetUserId("YOUR_USER_ID");

Manual Distribution

Appodeal.setUserId("YOUR_USER_ID");

---

caution

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. Then you can use Segments to implement different logic for these groups.

UPM 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");

Manual Distribution

• 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");

---

Set Location Tracking

This method will take effect only on iOS platform

Should be called before the SDK initialization.

The SDK will check the location permission on the user's device. If this permission is missing, the user will get an alert message with a request for location tracking.

UPM Distribution

Appodeal.SetLocationTracking(true);

Manual Distribution

Appodeal.disableLocationPermissionCheck();

---

Send Extra Data

You can send key-value data to Appodeal.

UPM Distribution

Appodeal.SetExtraData("KEY_STRING", "SOME_VALUE");
Appodeal.SetExtraData("KEY_BOOL", true);
Appodeal.SetExtraData("KEY_INT", 42);

Appodeal.ResetExtraData("KEY_STRING");

Manual Distribution

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.

---