Getting started

This page shows you how to download, import, and configure the Bidapp SDK.

CocoaPods (Recommended)

To integrate the Bidapp SDK through CocoaPods:

1. Add the following lines to your Podfile:

pod 'bidapp'

1. Run the following command on the command line:

pod install --repo-update

For more information on using CocoaPods, refer to CocoaPods’ documentation.

The SDK requires that you set the iOS deployment target to iOS 11.0 or above.

Get the pubid string

Request pubid by sending email to [e-mail]

Integrate Custom SDK Adapters

Bidapp SDK contains implementations of adapters to other SDKs.

To install them:

1. Add the following lines or any combination of them to your Podfile:

pod 'bidapp/Applovin'
pod 'bidapp/ApplovinMax'
pod 'bidapp/Unity'
pod 'bidapp/Liftoff'
pod 'bidapp/AdMob'
pod 'bidapp/Chartboost'

1. Run the following command on the command line:

pod install --repo-update

If you want to receive release updates for adapters, subscribe to our GitHub repository: GitHub repository

Initialize the SDK

Initialize the SDK in your app delegate’s application:applicationDidFinishLaunching: method

Ad assets that are fully cached result in a better user experience. Therefore, always initialize the Bidapp SDK on startup so as to give mediated networks the maximum amount of time to cache ads. This is especially important with video ads.

Objective-C

#import <bidapp/bidapp.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    BIDConfiguration *bidConfig = [BIDConfiguration new];

    //Comment out those ad formats that you don`t use:
    [bidConfig enableInterstitialAds];
    [bidConfig enableRewardedAds];
    [bidConfig enableBannerAds];

    //TODO: replace this pubid with your personal, obtained from bidapp
    NSString *pubid = @“xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”;
    if (@available(iOS 14, *)) {
        dispatch_after(dispatch_time(DISPATCH_TIME_NOW, 1 * NSEC_PER_SEC), dispatch_get_main_queue(), ^{
            [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus s){}];
            
            [BidappAds startWithPubid:pubid config:bidConfig];
        });
    }
    else {
	[BidappAds startWithPubid:pubid config:bidConfig];
    }
    
    return YES;
}

Swift

import bidapp

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    BIDInterstitial.loadDelegate = self
    BIDRewarded.loadDelegate = self
        
    let bidConfig = BIDConfiguration()
        
    //Comment out those ad formats that you don`t use:
    bidConfig.enableInterstitialAds()
    bidConfig.enableRewardedAds()
    bidConfig.enableBannerAds()
    
    //TODO: replace this pubid with your personal, obtained from bidapp
    let pubid = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    if #available(iOS 14, *) {
        
        let deadlineTime = DispatchTime.now() + .seconds(1)
        DispatchQueue.main.asyncAfter(deadline: deadlineTime) {
            ATTrackingManager.requestTrackingAuthorization { _ in
                BidappAds.start(withPubid: pubid, config: bidConfig)
            }
        }
    } else {
        BidappAds.start(withPubid: pubid, config: bidConfig)
    }
      
    return true
}

Pay attention to the pubid string obtained earlier at Get the pubid string of this instruction.

iOS 14 Support

In iOS 14, Apple introduced global privacy changes that you need to comply with. This section explains how to comply with these changes and thereby avoid a material drop in revenue.

SKAdNetwork

Update your app’s Info.plist with network-specific identifiers. See the documentation for SKAdNetwork instructions.

iOS 15 SKAdNetwork Reporting

Enable iOS 15 SKAdNetwork install postback reporting by using the app’s Info.plist:

1. In your app’s Info.plist, create a new key named NSAdvertisingAttributionReportEndpoint of type String.

2. Give that key the value: https://postbacks-app.com

Consent and Data APIs

In order to ensure you obtain consent from your users in applicable jurisdictions on behalf of our monetization partners and correctly pass consent flag values to Bidapp, please review App Policy Settings

See the Interstitials Ads, Rewarded Ads and Banner Ads pages to learn how to integrate various ad formats.