MAX Custom Adapter

Before You Begin

📘

To integrate the Bidease SDK, you need an active publisher account on the Bidease Monetize platform. If you don't have one yet, please reach out to your Bidease account manager or contact us at [email protected].

❗️

Prerequisites

Minimum deployment target: iOS 13.0

Minimal Applovin MAX version:13

1. Installation

Add the AppLovin adapter subspec to your Podfile:

platform :ios, '13.0'
...

pod 'BideaseSDK/AdapterApplovin', '2.0.3'

⚠️ Make sure to always use the latest available SDK versions from Bidease.

2. Initialization

2.1. Getting your App Key

Your App Key is available in the Bidease Monetize dashboard:

1. Log in to your account at monetize.bidease.com
2. Go to Applications
3. Open the required application
4. Copy the App Key

2.2 Set Bidease App Key

Before initializing AppLovin MAX, set your Bidease app key:

import BideaseMobileSDK

BideaseApplovinMediationAdapter.setAppKey("YOUR_APP_KEY")

❗️

Don't forget to replace YOUR_APP_KEY with the App Key from your Bidease Monetize dashboard.

3. Configure Bidease in MAX Dashboard

📘

Before configuring AppLovin MAX, make sure your app and placements are registered in the Bidease Monetize dashboard. Placement names must match exactly what you configure here. Set up your placements →

3.1. Add Bidease as a Custom Network

1. In your AppLovin dashboard, go to MAX → Mediation → Manage → Networks
2. Scroll to the bottom and click Click here to add a Custom Network
3. Fill in the following fields:

4. Click Save

3.2. Enable Bidease on Your Ad Units

1. Go to MAX → Mediation → Manage → Ad Units
2. Select the ad unit where you want to enable Bidease
3. Find Bidease in the custom networks list and enable it
4. Enter the placement details:

5. Click Save

Please allow 30–60 minutes for changes to take effect.

4. Test Mode

Once you've implemented the SDK, you can test ads before release using one of the two methods below.

Option 1: Enable via Code

Add additional pod to enable test ads:

pod 'BideaseSDK/AdapterApplovin', '2.0.3'
pod 'BideaseSDK/TestMode', '2.0.3'

Option 2: Enable via Dashboard

You can also activate test mode directly in the Bidease Monetize dashboard without any code changes:

1. Go to Applications and open the required app
2. Navigate to Test Devices and add the devices you want to test on — use IDFA (iOS)
3. Enable Test for the application

QA Checklist

⚠️

Important — please read before testing:

• Test Mode provides nearly 100% fill — this is expected behavior for QA only.
• Disable Test Mode before submitting your app to the App Store.
• Ensure IDFA tracking is enabled on your test device so the Bidease team can review logs and assist with troubleshooting if needed.
• If you run into any issues, contact your Bidease account manager.