Advanced settings

Set UserID

IronSource.setUserId(userID)

Define Segments

• Device Properties: the LevelPlay SDK collects certain standard parameters that pertain to the users' device automatically such as device model, device manufacturer, app version, OS, etc. You do not need to convey this data to us
• User Properties: user data which is not collected by our SDK, such as age, gender, creation date, etc. (see full list of supported segment properties with descriptions below) must be relayed through the API. Follow the instructions to send us these details so our SDK can apply the relevant ad settings to the segments you defined on the ironSource platform
• Custom Segments: you can create a custom segment with predefined conditions without conveying user details to our servers and tailor ad settings for that user segment on the ironSource platform

Pass User Properties

let segment: ISSegment = ISSegment()

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

   segment.segmentName = "YOUR_SEGMENT_NAME"

2. Send us the user details. ironSource provides a range of standard user properties that you can set to attribute a user to a segment in the API. See table below for descriptions.

   // Set user agesegment.age = USER_AGE// Set user gendersegment.gender = ISGender.IRONSOURCE_USER_FEMALE// Set user's total in-app purchasessegment.iapTotal = USER_IAP_TOTAL// Set user's levelsegment.level = USER_LEVEL// Set user's paying statussegment.paying = USER_PAYING_STATUS// Set user creation datesegment.userCreationDate = NSDate() as Date!

   In addition, you can set up to 5 custom user properties per segment:

   segment.setCustomValue("CUSTOM_VALUE", forKey: "CUSTOM_KEY")    

   Next, to serve your ad units based on segments, call the following function complete with either the segment name or user properties:

   IronSource.setSegment(YOUR_SEGMENT);

Supported Segment Properties

Obtain the User's Segment Name

1. Adopt this interface in your class to conform to the Segment Name protocol and enable the receipt of the segment name [icode]ISSegmentDelegate[/icode]
2. Register to the following delegate to receive the segment name that your user belongs to. The SDK will then notify your delegate of the event.

   IronSource.setSegmentDelegate(self)(void)didReceiveSegement:(NSString *)segmentfunc didReceiveSegement(_ segment: String!)

Custom Parameters for iOS

Implementation Code

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

[IronSource setRewardedVideoServerParameters:(NSDictionary *)parameters];[IronSource clearRewardedVideoServerParameters];

Price floor configuration

Intersitial Ads Example

// Define a price floor configurationLPMInterstitialAdConfig *adConfig = [[[LPMInterstitialAdConfigBuilder new] setBidFloor: 1.23] build]; // Set the price floor in USD// Apply the configuration to an interstitial ad unitLPMInterstitialAd *interstitialAd = [[LPMInterstitialAd alloc] initWithAdUnitId:@"adUnitId" config:adConfig];

// Define a price floor configurationlet adConfig = LPMInterstitialAdConfigBuilder().set(bidFloor: 1.23) // Set the price floor in USD.build()// Apply the configuration to an interstitial ad unitlet interstitialAd = LPMInterstitialAd(adUnitId: "adUnitId", config: adConfig)

Rewarded ads Example

// Define a price floor configurationLPMRewardedAdConfig *adConfig = [[[LPMRewardedAdConfigBuilder new] setBidFloor: 1.23] build]; // Set the price floor in USD// Apply the configuration to a rewarded ad unitLPMRewardedAd *rewardedAd = [[LPMRewardedAd alloc] initWithAdUnitId:@"adUnitId" config:adConfig];

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

Banner ads example

// Define a price floor configurationLPMBannerAdViewConfig *adConfig = [[[LPMBannerAdViewConfigBuilder new] setBidFloor: 1.23] build]; // Set the price floor in USD// Apply the configuration to a banner ad unitLPMBannerAdView *bannerAd = [[LPMBannerAdView alloc] initWithAdUnitId:@"adUnitId" config:adConfig];

// Define a price floor configurationlet adConfig = LPMBannerAdViewConfigBuilder().set(bidFloor: 1.23) // Set the price floor in USD.build()// Apply the configuration to a banner ad unitlet bannerAd = LPMBannerAdView(adUnitId: "adUnitId", adConfig)

LevelPlay SDK Error Codes