This page will show you how to directly integrate Leadbolt Video and Interstitial ads in your iOS app using Cocos2d-X. Download the SDK and sample app. Follow the instructions below and 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.


New You can now integrate Leadbolt Video and Interstitial ads in Cocos2d-X apps using SDKbox. To use SDKbox, follow the instructions, including download, provided by SDKbox here after Leadbolt Publisher signup.

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

Integrating Leadbolt SDK

Unzip and copy Leadbolt iOS SDK into your Xcode project (in the proj.ios folder of your Cocos2d-X App). This contains libAppTracker.a  and AppTracker.h file .

Now back in your Cocos2D-X Project’s main folder, add the AppTrackerWrapper.h  and  files to the “Classes” folder.

Please ensure the following frameworks are linked in your xcode project:

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

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:

Using Network Ads and Direct Deals

In your App’s .cpp file, add the following code to implement Leadbolt Ads. This code uses the Auto recaching option to fetch a new Ad automatically – no additional coding required.

You will need to replace   "YOUR_APP_API_KEY"   with the specific api key for your app (include the double quotes). This is available in the settings menu for your app, under the option “Get App API Key”. To get Direct Deal Ads in your App, click on “Direct Deals” link in the Publisher Portal and click on the Apply button.

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


  • 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.
  • This plugin has been tested on the following versions of Cocos2dx: v3.13.1


← Return to Help Center