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
Download Bidon SDK v0.7.4. After you download the SDK unzip it and add Bidon.xcframework into your project.
Add the following linker flag to the build settings at: Target → Build Settings → Linking → Other Linker Flags:
-ObjC
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
- Objective-C
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
}
⋮
#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
}];
⋮