Advanced settings for Android

Set User ID

IronSource.setUserId("UserID");

Define Segments

• Device Properties: the ironSource SDK collects certain standard parameters that pertain to the users’ device automatically, such as location, device model, device manufacturer, app version, and OS. You do not need to convey this data to us.
• User Properties: comprehensive user data (for example, age, gender, and creation date) must be relayed through the API. (See a full list of supported segment properties with descriptions in the following section.) Follow the instructions to send us your user’s details so our SDK can categorize your different users based on the segments you defined on the LevelPlay platform.
• Custom Segments: you can create a custom segment without conveying user details to our servers and tailor ad settings for that user segment.

Pass User Properties

1. If you are familiar with the segment that the user belongs to, enter the segment name:

mIronSegment.setSegmentName(name);

2. Send us the user details. ironSource SDK provides a range of standard user properties that you can set to attribute a user to a segment in the API. Scroll down for a table of the support user segment properties.

// Create segment object
mIronSegment = IronSourceSegment();
// Set user age
mIronSegment.setAge(age);
// Set user gender
mIronSegment.setGender(gender);
// Set user's level
mIronSegment.setLevel(level);
// Set user creation date
mIronSegment.setUserCreationDate(date);
// Set user's total in-app purchases
mIronSegment.setIAPTotal(iapt);
// Set user's paying status
mIronSegment.setIsPaying(isPaying);

// Set custom parameters (up to 5)
mIronSegment.setCustom(key,value);

IronSource.setSegment(mIronSegment);

Supported User Segment Properties

SegmentListener onSegmentReceived(String segment){}

Custom Parameters

1. Custom parameters work in conjunction with server-to-server completion callbacks only. You will receive the parameter as part of the callback string.
2. You may insert more than one custom parameter in the init request.

Implementation Code

Rewarded Video

• Custom Parameters can be set several times per session.
• To reset the value, use clearRewardedVideoServerParameters, and then set the new value.

IronSource.setRewardedVideoServerParameters(Map<String, String> params);
IronSource.clearRewardedVideoServerParameters();

Price Floor Configuration

Interstitial ads example

// Define a price floor configuration
var adConfig = new LevelPlayInterstitialAd.Config.Builder()
 .setBidFloor(1.23) // Set the price floor in USD
 .build();
// Apply the configuration to an interstitial ad unit
var interstitialAd = new LevelPlayInterstitialAd("adUnitId", adConfig);

Rewarded ads example

// Define a price floor configuration
val adConfig = LevelPlayRewardedAd.Config.Builder()
 .setBidFloor(1.23) // Set the price floor in USD
 .build()
// Apply the configuration to a rewarded ad unit
val rewardedAd = LevelPlayRewardedAd("adUnitId", adConfig)

Banner ads example

// Define a price floor configuration
var adConfig = new LevelPlayBannerAd.Config.Builder()
 .setBidFloor(1.23) // Set the price floor in USD
 .build();
// Apply the configuration to a banner ad unit
var bannerAd = new LevelPlayBannerAdView(context, "adUnitId", adConfig);

ironSource SDK Error Codes