Integration

This page is describes how to donwload, import and configure the Bidon SDK.

Minimum requirements:

• iOS 12.0 or higher (iOS 12.4 if you use MyTarget). You still can integrate Bidon SDK into a project with a lower value of minimum iOS version. However, on devices that don't support iOS 12.0+ our SDK will just be disabled.
• Xcode 15.3 or higher.

Download

CocoaPods (Recommended)

To integrate the Bidon SDK through CocoaPods, first add the following lines to your Podfile:

# Mirror repo for Bidon SDK podspecs
# source 'https://github.com/bidon-io/CocoaPods_Specs.git'
source 'https://cdn.cocoapods.org/'

pod 'Bidon', '~> 0.7.4'

# For usage of Demand Sources uncomment following lines

# pod 'BidonAdapterAmazon'
# pod 'BidonAdapterAppLovin'
# pod 'BidonAdapterBidMachine'
# pod 'BidonAdapterBigoAds'
# pod 'BidonAdapterChartboost'
# pod 'BidonAdapterDTExchange'
# pod 'BidonAdapterGoogleAdManager'
# pod 'BidonAdapterGoogleMobileAds'
# pod 'BidonAdapterInMobi'
# pod 'BidonAdapterIronSource'
# pod 'BidonAdapterMetaAudienceNetwork'
# pod 'BidonAdapterMintegral'
# pod 'BidonAdapterMobileFuse'
# pod 'BidonAdapterMyTarget'
# pod 'BidonAdapterUnityAds'
# pod 'BidonAdapterVungle'
# pod 'BidonAdapterYandex'

Then run the following on the command line:

pod install --repo-update

Manual

1. Download Bidon SDK v0.7.4. After you download the SDK unzip it and add Bidon.xcframework into your project.

2. Add the following linker flag to the build settings at: Target → Build Settings → Linking → Other Linker Flags: -ObjC

3. Download and install adapters and Ad Networks SDK.

Ad Network	Adapter	SDK Guide
Amazon	BidonAdapterAmazon	Guide
BigoAds	BidonAdapterBigoAds	Guide
Mintegral	BidonAdapterMintegral	Guide
AppLovin	BidonAdapterAppLovin	Guide
BidMachine	BidonAdapterBidMachine	Guide
GoogleMobileAds	BidonAdapterGoogleMobileAds	Guide
GoogleMobileAds (Ad Manager)	BidonAdapterGoogleAdManager	Guide
DTExchange	BidonAdapterDTExchange	Guide
UnityAds	BidonAdapterUnityAds	Guide
Meta	BidonAdapterMetaAudienceNetwork	Guide
Vungle	BidonAdapterVungle	Guide
InMobi	BidonAdapterInMobi	Guide
Chartboost	BidonAdapterChartboost	Guide
IronSource	BidonAdapterIronSource	Guide
MobileFuse	BidonAdapterMobileFuse	Guide
MyTarget	BidonAdapterMyTarget	Guide
Yandex	BidonAdapterYandex	Guide

Initialize the SDK

Receive your APP_KEY in the dashboard app settings.

tip

We highly recommend to initialize the Bidon SDK in app delegate's application:applicationDidFinishLaunching: method.

Swift

import Bidon

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate
{
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool
    {
        // Register all available demand source adapters.
        BidonSdk.registerDefaultAdapters()

        // Bidon's server can either be self-hosted or managed by a third-party service. Please contact us at [email protected] for a list of recommended managed service providers.
        BidonSdk.baseURL = "https://[YOUR_BIDON_SERVER_DOMAIN.com]"

        // Configure Bidon
        BidonSdk.logLevel = .debug
        // Initialize
        BidonSdk.initialize(appKey: "APP KEY") {
            // Load any ads
        }

        ⋮

Objective-C

#import <Bidon/Bidon-Swift.h>

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Register all available demand source adapters.
    [BDNSdk registerDefaultAdapters];

    // Bidon's server can either be self-hosted or managed by a third-party service. Please contact us at [email protected] for a list of recommended managed service providers.
    [BDNSdk setBaseURL:@"https://[YOUR_BIDON_SERVER_DOMAIN.com]"];

    // Configure Bidon
    [BDNSdk setLogLevel:BDNLoggerLevelDebug];
    // Initialize
    [BDNSdk initializeWithAppKey:@"APP KEY" completion:^{
        // Load any ads
    }];

    ⋮

Configure Ad Types

• Interstitials
• Rewarded Ads
• Banners