Using Swift [iOS]

This page will show you how to integrate Leadbolt ads in your iOS native app. Download the SDK and sample app. Make sure you can compile the sample app and see test ads.

Before you begin

• Have you logged in to the Leadbolt Publisher Portal?
• Did you add an App in the portal?
• Ensure, you have downloaded the Leadbolt SDK and sample app from the link above

Add Leadbolt SDK framework

• Copy the downloaded AppTracker.framework file to your Xcode Project

Add the required frameworks

• Link the following frameworks in your Xcode Project. AdSupport.framework, AVFoundation.framework, CoreMedia.framework, CoreTelephony.framework, StoreKit.framework, SystemConfiguration.framework and libz.tbd

Add Bridging Header

• Add a new Header file in your app and name it Objective-CBridgingHeader.h.
• In the file, add the following lines of code:
  Swift

  @import UIKit; #import <AppTracker/AppTracker.h>

  1 2	@import UIKit; #import <AppTracker/AppTracker.h>

• Under your App’s Build Settings, find the Objective-C Bridging Header setting and add the full path of the Objective-CBridgingHeader.h file in there.

Configure App Transport Security (ATS) Settings

• To ensure all available Leadbolt ads display correctly on apps running on iOS 9/10, please include these ATS settings by adding the following lines of code to your Apps Info.plist file:
  
  XHTML

  <key>NSAppTransportSecurity</key> <dict> <key>NSAllowsArbitraryLoads</key> <true/> <key>NSAllowsArbitraryLoadsInWebContent</key> <true/> </dict>

  1 2 3 4 5 6 7

  <key>NSAppTransportSecurity</key> <dict> <key>NSAllowsArbitraryLoads</key> <true/> <key>NSAllowsArbitraryLoadsInWebContent</key> <true/> </dict>

Initialize Leadbolt SDK

• In your Project’s viewDidLoad method add the following line to initialize the Leadbolt SDK.
  
  Swift

  override func viewDidLoad() { super.viewDidLoad() // Initialize Leadbolt SDK with your api key AppTracker.startSession(self.API_KEY, with: AppTrackerEnableAutoCache); }

  1 2 3 4 5 6

  override func viewDidLoad() { super.viewDidLoad()   // Initialize Leadbolt SDK with your api key AppTracker.startSession(self.API_KEY, with: AppTrackerEnableAutoCache); }

To Cache and Show a non-Rewarded Ad

• To cache a non-Rewarded Ad
  
  Swift

  AppTracker.loadModule(toCache: "inapp");

  1	AppTracker.loadModule(toCache: "inapp");

• To show a non-Rewarded Ad
  
  Swift

  AppTracker.loadModule("inapp", viewController: self);

  1	AppTracker.loadModule("inapp", viewController: self);

• Please ensure that in your code, you do not call loadModule directly after loadModuleToCache. It will cause the SDK to fail and not display an Ad all together.
• For Advanced SDK options, including use of Event Listeners, click here.

To Cache and Show a Rewarded Ad

• To cache a Rewarded Ad
  
  Swift

  AppTracker.loadModule(toCache: "reward");

  1	AppTracker.loadModule(toCache: "reward");

• To show a Rewarded Ad
  
  Swift

  AppTracker.loadModule("reward", viewController: self);

  1	AppTracker.loadModule("reward", viewController: self);

• Please ensure that in your code, you do not call loadModule directly after loadModuleToCache. It will cause SDK to fail and not display the Rewarded Ad at all.
• To reward user, refer to the Advanced Integration on more information about Event Listeners and Rewarding Users

Test your Integration

• Run your Project on an iOS device.
• Ensure, test ads are displayed when the “loadModule” call is made in your App.
• Once test ads are seen on your device, go to your Leadbolt Portal and set your App to “Live”
• Once approved, you should see live ads in your App.

Congratulations! You have successfully integrated the Leadbolt SDK in your App
 

Troubleshooting

• Video and Interstitial Ads may not be available at all times in all countries. It is always best to test with your App in Test Mode in the Publisher Portal as Test Ads are generally always available.
• You should check your Publisher Portal and ensure the relevant section is visible under your App. Use the “Add Section” button to add if not available.
• You should check the SDK logs located in Device Logs (under Xcode -> Devices) and look for “AppTracker”.
• Always test the sample app provided to confirm any integration issues are SDK based.
• The SDK has been tested to be compatible on Xcode Verion 9.4

Advanced Integration

Checking Ad Availability

Leadbolt SDK provides additional ability to the developers to check before hand if an Ad is available before displaying it to create a better user-experience in your App. To check if a Network or Direct Deal Ad is available please use the code below:

To check if a Rewarded Ad is available to be displayed, please use the code below:

Passing Additional Information

You can increase your App’s performance by optionally including the additional information below. This allows selected premium advertisers to display their Ads to your users. To pass this additional information, use the following methods BEFORE calling loadModuleToCache

Using Event Listeners

With Event listeners, you can closely follow the ad states throughout your App. Leadbolt SDK will trigger events at all important stages of the Ad life-cycle. To implement event listeners in your App, you must implement the AppModuleDelegate class.

Setup SDK to use Event Listeners

Before using any of the Event Listener methods, first implement the AppModuleDelegate protocol your ViewController class as follows:

Now, set the AppModuleDelegate object in the viewDidLoad method BEFORE calling AppTracker.startSession() like so:

Event Listener Methods