Skip to main content
Version:

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:

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. You can use Segments in the future.

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

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.

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.