Skip to content

Getting Started

This guide covers the integration of Boldwin SDK for Unity applications through mediation platforms.

Important: Boldwin SDK for Unity is available exclusively through mediation platforms. Direct integration is not supported. Publishers must integrate through either AppLovin MAX or ironSource to access Boldwin's ad inventory.

Requirements

  • Unity 6000.0 LTS or higher
  • iOS deployment target: iOS 12.0 or higher (may vary depending on mediation SDK)
  • Android minimum API level: 21 (Android 5.0) or higher
  • .NET Standard 2.1 or .NET Framework
  • Active AppLovin MAX or ironSource account

Supported Mediation Platforms

Boldwin SDK supports integration through the following mediation platforms:

AppLovin MAX

  • Full support for all ad formats
  • Automated dependency management via EDM4U (External Dependency Manager for Unity)
  • Native dependencies configured through XML files

ironSource

  • Full support for all ad formats
  • Automated dependency management via EDM4U (External Dependency Manager for Unity)
  • Native dependencies configured through XML files

Installation

Step 1: Install Boldwin SDK

Add the Boldwin SDK package to your Unity project using the Unity Package Manager (UPM):

https://bitbucket.org/boldwin-sdk/boldwin-unity.git?path=package/boldwinsdk-core

For detailed installation instructions, refer to Unity's official documentation: Install a UPM package from a Git URL

Step 2: Configure Native Dependencies

Configure the native dependencies for your chosen mediation platform using one of the following options:

Option A. Import Relevant Sample

The package includes prepared Dependencies.XML files in Editor folders of individual examples.

Use the Samples tab of Package Manager UI for importing.

Package manager UI -- All Samples

Assets -- XML location

Option B: Download Dependencies XML from Repository

Download the appropriate Dependencies.xml file for your mediation platform:

Mediation Platform Dependencies File
AppLovin MAX BoldwinApplovinDependencies.xml
ironSource BoldwinIronSourceDependencies.xml

Place the downloaded file in the Editor folder within your project's Assets directory.

Integration Steps

1. Install Mediation SDK

Install your chosen mediation platform's SDK by following their official integration guides:

Note: Boldwin adapters for ironSource are designed for version 8.x. Use version 8.10.1 of the Ads Mediation package (not 9.0.0+).

2. Configure Boldwin Network

Configure Boldwin as a custom network in your mediation platform dashboard. For detailed setup instructions, refer to the platform-specific guides:

Mediation Platform iOS Configuration Android Configuration
AppLovin MAX iOS Setup Guide Android Setup Guide
ironSource iOS Setup Guide Android Setup Guide

3. Initialize Mediation Platform

Initialize your chosen mediation platform according to their official documentation. The Boldwin adapter will initialize automatically during the mediation platform initialization process.

4. Configure Targeting (Optional)

Enhance ad performance and revenue by configuring advanced targeting options. Refer to the Custom Targeting API documentation for detailed configuration options, including:

  • Demographic targeting (age, gender)
  • Geographic targeting
  • Device and network targeting
  • Custom parameters for audience segmentation
  • Real-time bidding optimization

Testing Integration

To verify your Boldwin SDK integration:

  1. Enable test mode in your mediation platform
  2. Add test device IDs to your mediation dashboard
  3. Verify that Boldwin appears in the mediation debugger
  4. Test all ad formats through your mediation platform
  5. Monitor fill rates and revenue metrics in both dashboards

Revenue Optimization

Maximize revenue performance by implementing the following strategies:

  1. Configure Targeting: Use the Custom Targeting API to implement advanced audience targeting
  2. Waterfall Positioning: Position Boldwin in your mediation waterfall based on performance metrics
  3. A/B Testing: Test different waterfall configurations to identify optimal settings
  4. Geographic Optimization: Configure region-specific targeting for improved fill rates

For additional configuration options and advanced targeting features, refer to the Custom Targeting API documentation.