Skip to main content

Integration

Static Badge

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, 13.0 if you use Yandex, Unity, DTExchange, IronSource). 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 16.1 or higher.

Download​

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.12.0'

# Available Demand Sources (AdNetworks)
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 'BidonAdapterMoloco'
pod 'BidonAdapterMyTarget'
pod 'BidonAdapterStartIo'
pod 'BidonAdapterTaurusX'
pod 'BidonAdapterUnityAds'
pod 'BidonAdapterVungle'
pod 'BidonAdapterYandex'

Then run the following on the command line:

pod install --repo-update

Manual​

  1. Download Bidon SDK vpod 'Bidon', '~> 0.12.0'. 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 NetworkAdapterSDK Guide
AmazonBidonAdapterAmazonGuide
AppLovinBidonAdapterAppLovinGuide
BidMachineBidonAdapterBidMachineGuide
BigoAdsBidonAdapterBigoAdsGuide
ChartboostBidonAdapterChartboostGuide
DTExchangeBidonAdapterDTExchangeGuide
GoogleMobileAdsBidonAdapterGoogleMobileAdsGuide
GoogleMobileAds (Ad Manager)BidonAdapterGoogleAdManagerGuide
InMobiBidonAdapterInMobiGuide
IronSourceBidonAdapterIronSourceGuide
MetaBidonAdapterMetaAudienceNetworkGuide
MintegralBidonAdapterMintegralGuide
MobileFuseBidonAdapterMobileFuseGuide
MolocoBidonAdapterMolocoGuide
MyTargetBidonAdapterMyTargetGuide
Start.ioBidonAdapterStartIoGuide
TaurusXBidonAdapterTaurusXGuide
UnityAdsBidonAdapterUnityAdsGuide
VungleBidonAdapterVungleGuide
YandexBidonAdapterYandexGuide

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.

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 hi@bidon.org 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
        }

        ⋮

Configure Ad Types​