Advanced settings for iOS

Define Segments

• 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 LevelPlay platform
• User Properties: user data which is not collected by our SDK (for example, level, paying status, or 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 these details so our SDK can apply the relevant ad settings to the segments you defined on the LevelPlay platform
• Device Properties: the LevelPlay SDK collects certain standard parameters that pertain to the users' device automatically such as device model, device manufacturer, app version, and OS. You do not need to convey this data to us

Pass User Properties

LPMSegment *segment = [[LPMSegment alloc]init];

let segment: LPMSegment = LPMSegment()

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

   [segment setSegmentName:YOUR_SEGMENT_NAME];

   segment.segmentName = "YOUR_SEGMENT_NAME"

2. Send us the user details. See table below for descriptions.
   Objective-CSwift

   // Set user level[segment setLevel:USER_LEVEL];// Set user's paying status[segment setPaying:USER_PAYING];// Set user's total in-app purchase history[segment setIapTotal:YOUR_IAP_TOTAL];// Set user creation date[segment setUserCreationDate:YOUR_DATE];

   // 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:
   Objective-CSwift

   [segment setCustomValue:YOUR_CUSTOM_VALUE forKey:YOUR_CUSTOM_KEY];

   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:
   Objective-CSwift

   [LevelPlay setSegment:YOUR_SEGMENT];

   LevelPlay.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

   LPMSegmentDelegate

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.
   Objective-CSwift

   [LevelPlay setSegmentDelegate:self];

   LevelPlay.setSegmentDelegate(self)

   Implement the delegate callback. For example:
   Objective-CSwift

   - (void)didReceiveSegment:(NSString *)segment;

   func didReceiveSegment(_ segment: String!)

Custom Parameters for Rewarded server to server callbacks

setMetaData

LevelPlay_Rewarded_Server_Params

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

NSDictionary *params = @{ @"key1": @"value1", @"key2": @"value2" };NSData *jsonData = [NSJSONSerialization dataWithJSONObject:params options:0 error:nil];NSString *jsonString = [[NSString alloc] initWithData:jsonData encoding:NSUTF8StringEncoding];[LevelPlay setMetaDataWithKey:@"LevelPlay_Rewarded_Server_Params" value:jsonString];

let params = ["key1": "value1", "key2": "value2"]if let jsonData = try? JSONSerialization.data(withJSONObject: params),   let jsonString = String(data: jsonData, encoding: .utf8) {    LevelPlay.setMetaData(withKey: "LevelPlay_Rewarded_Server_Params", value: jsonString)}

Price Floor Configuration

Interstitial 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 configurationlet adConfig = LPMRewardedAdConfigBuilder()    .set(bidFloor: 1.23) // Set the price floor in USD    .build()// Apply the configuration to a rewarded ad unitlet rewardedAd = LPMRewardedAd(adUnitId: "adUnitId", config: 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", config: adConfig)

LevelPlay SDK Error Codes