Getting Started

This guide covers the integration of Boldwin SDK for Android applications.

Demo Application: For a complete working example, check out our Android Demo Apps.

Requirements

Android 6.0 (API level 23) or higher
Gradle 7.0 or later
Kotlin 1.5.0 or later (optional, for Kotlin projects)

Installation

Repository Configuration

Include the Boldwin SDK repository configuration (where you declare Maven central):

// In your project-level build.gradle or settings.gradle
repositories {
    maven { url 'https://bw-sdk.s3.us-east-1.amazonaws.com/android' }
}

Integration

Add the Boldwin SDK to your app's build.gradle file:

dependencies {
    implementation 'com.boldwin.sdk:core:1.15.14'
}

To use Boldwin SDK with AppLovin MAX, add the adapter dependency:

dependencies {
    // AppLovin Boldwin Adapter
    implementation 'com.boldwin.sdk:applovin-adapters:1.15.14'
}

To use Boldwin SDK with ironSource, add the adapter dependency:

dependencies {
    // ironSource Boldwin Adapter
    implementation 'com.boldwin.sdk:ironsource-adapters:1.15.14'
}

Basic Setup

1. Add Required Permissions

Add the following permissions to your AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<!-- Optional -->    
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<!-- Optional -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

2. Initialize the SDK

Initialize the Boldwin SDK in your Application class:

class CustomApplication : Application() {

    override fun onCreate() {
        BoldwinSDK.initialize(PUBLISHER_ID, applicationContext) { status ->
            if (status == BoldwinInitializationStatus.SUCCEEDED) {
                Log.d(TAG, "SDK initialized successfully!")
            } else {
                Log.e(TAG, "SDK initialization error: $status\n${status.description}")
            }
        }
    }
}

The SDK provides options for configuring advanced settings. It also supports defining custom targeting parameters to help maximize revenue. In addition, the SDK integrates with consent management providers in compliance with industry standards.

3. Implement Ad Format

To use Boldwin as a standalone ad SDK, see:

To use Boldwin through a mediation platform, see: