This page will show you how to integrate Leadbolt Video and Interstitial ads in your iOS app with Google AdMob with Firebase SDK. Download the SDK and sample app. Make sure you can compile the sample app and see test ads.

To get started sign up for a Leadbolt Publisher account here or login to the Publisher Portal here.

gstart


Add your apps

Login to the Publisher Portal and select the ‘Create New App’ button from the “Apps” page. Fill in your app’s details including name and platform. Once app is added, it is recommended that you also apply for our premium deals by clicking “Direct Deals” in the Publisher Portal. Once approved, a “Direct Deals” section should be visible under your app in the Publisher Portal. Use the “Add Section” button if not visible.

 


Copy Your Integration Details

Your integration details will be displayed on the last page of the Create App process. These integration details will be needed when you integrate the Leadbolt SDK into your app.

Create App Dialogue-3


The following initial steps allow you to add the Leadbolt as Mediation source within the Google Admob portal.

Setting Up Network Ads and Direct Deals

Add an interstitial ad unit

Once you login to the Google Admob portal, access or setup your app and add a interstitial ad unit to the App as a container for the Leadbolt SDK Ads.

Add Leadbolt Ad Network

Once the App and ad unit is setup, click on “Edit mediation”. Click on the “New Ad Network” button. From the list of available ad networks, select “Leadbolt”.

admob_ios1

Enter your App’s API Key found in the Leadbolt Portal. For Direct Deals/Networks Ads use “inapp” (without quotes) as the Location Code. 

To get started, please untick the “Ad Network Optimization” setting and also set a higher floor eCPM for Leadbolt than AdMob Network as shown in the screenshot below. 

admob_ios2

To generate sufficient Leadbolt impressions when you start, please click on “AdMob Network” settings and untick both “Optimise AdMob Network” and “Enable eCPM Floor”.

admob_ios2

Once your Leadbolt account is showing sufficient impressions you can enable “Ad Network Optimization”. You can obtain the required Publisher ID and Secret Key from the Accounts page of your Leadbolt portal.


Setting Up Rewarded Video

Add a rewarded video ad unit

Once you login to the Google Admob portal, access or setup your app and create a new Ad Unit. On this page, select “Rewarded Video” and save.

Add Leadbolt Ad Network

Once the App and ad unit is setup, click on “Edit mediation”. Click on the “New Ad Network” button. Then click on “Custom Event”.

admob_ios1

Enter “GADMAdapterAppfireworks” (without quotes) in the Class Name field. Under Label enter “Leadbolt” (without quotes). Under Parameter, please enter your App’s API Key found in the Leadbolt Portal. NB: If you are using both, Interstitial Ads and Rewarded Videos, in your app, please make sure to use the same API Key from the Leadbolt Portal for both Ad Unit’s during the setup.

To get started, please untick the “Ad Network Optimization” setting and also set a higher floor eCPM for Leadbolt than AdMob Network as shown in the screenshot below. 

admob_ios2

To generate sufficient Leadbolt impressions when you start, please click on “AdMob Network” settings and untick both “Optimise AdMob Network” and “Enable eCPM Floor”.

admob_ios2

Once your Leadbolt account is showing sufficient impressions you can enable “Ad Network Optimization”. You can obtain the required Publisher ID and Secret Key from the Accounts page of your Leadbolt portal.


Integrating Leadbolt SDK inside your App

Setup App with AdMob with Firebase SDK

Setup your iOS Project with Google AdMob with Firebase SDK  as outlined here.

Link Leadbolt SDK in your App

Unzip the Leadbolt iOS SDK zip file and copy the Leadbolt SDK + AdMob Adaptor file ( AppTracker.framework and libAdaptorAppTracker.a ) to your xcode project.

Add the required frameworks to your xcode project:

  • AdSupport.framework
  • AVFoundation.framework
  • CoreMedia.framework
  • CoreTelephony.framework
  • SystemConfiguration.framework
  • StoreKit.framework
  • libz.tbd

Under the “Build Settings” tab, please ensure ObjC  flag is set under “Other Linker Flags” setting.

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

Add Interstitial Ads to your App

To implement AdMob Interstitial Ads in your app, follow the guide as outlined here.

Add Rewarded Video to your App

To implement AdMob Rewarded Video in your app, follow the guide as outlined here.


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 to ensure 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.
  • Please Note: mediation platforms often require optimization settings, can take time to sync mediation setup for your App. Please check the mediation sdk log messages, allow ‘sufficient’ time for sync and if relevant contact Mediation partner for help.
  • This plugin has been tested and compatible with Google Mobile Ads SDK for iOS version 7.19.0

gstart

← Return to Help Center