AppLovin MAX Adapter

Integrate with AI ·Copy a step-by-step prompt for Claude Code, Cursor, Copilot, or ChatGPT.

Before You Begin

To integrate the Bidease SDK, you need an active publisher account on the Bidease Monetize platform.

Prerequisites:

• Minimum Android SDK: 23 (Android 6.0)
• Target API: 35
• Minimal AppLovin MAX version: 13

1. Installation

Current published version: 2.2.2.

build.gradle

dependencies {
  implementation("com.bidease:bidease-mobile:2.2.2")
  implementation("com.bidease:applovin-adapter:2.2.2")
}

warning

Always use the latest available SDK version 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 com.bidease.ads.adapter.applovin.BideaseMediationAdapter
import com.bidease.mobile.InitParams
import com.bidease.mobile.PrivacyParams

BideaseMediationAdapter.setInitParams(
  InitParams(
      key = "YOUR_APP_KEY",
      privacyParams = PrivacyParams(/* see Privacy & Consent */),
      customProps = mapOf("ipv4" to "203.0.113.17")
  )
)

warning

Replace YOUR_APP_KEY with the App Key from your Bidease Monetize dashboard.

note

Only key is required on InitParams — privacyParams and customProps are optional. Use BideaseMediationAdapter.setInitParams(InitParams(key = "YOUR_APP_KEY")) if you don't need either.

3. Configure Bidease in AppLovin MAX Dashboard

Before configuring AppLovin MAX, make sure your app and placements are registered in the Bidease Monetize dashboard. 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:

Field	Value
Network Type	SDK
Name	Bidease
Android Adapter Class Name	com.bidease.ads.adapter.applovin.BideaseMediationAdapter

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:

Field	Value
App ID	Your Bidease app key
Placement ID	AdFormat_ecpm_X.X — e.g., Interstitial_ecpm_1.3, Banner_ecpm_0.5
CPM Price	Enter the same floor price value as in your Placement ID (the X.X value)

5. Click Save

note

Allow 30–60 minutes for changes to take effect.

4. Privacy & Consent

Privacy signals and custom props are passed to the Bidease SDK via InitParams at initialization. Set them when you initialize the SDK, or update them at runtime via BideaseMobile.setPrivacyParams(...) / setCustomProps(...).

COPPA

Not for child-directed traffic. Bidease does not purchase or monetize traffic from applications directed to children or to individuals under the age of 13. Publishers are solely responsible for identifying child-directed inventory under COPPA and other applicable laws and must not integrate the Bidease SDK into, or send any traffic or personal data from, such inventory.

import com.bidease.mobile.PrivacyParams

val privacyParams = PrivacyParams(
    coppaEnabled = false,
    subjectToGdpr = true,
    subjectToCoppa = false,
    usPrivacyString = "1YNN",
    gppString = "DBACNYA~CPXxRfAPXxRfAAfKABENB-CgAAAAAAAAAAYgAAAAAAAA~1YNN",
    gppSid = listOf(2, 6),
    userConsentString = "CPXxRfAPXxRfAAfKABENB-CgAAAAAAAAAAYgAAAAAAAA",
    subjectToLgpd = true
)

Field	Type	Description
coppaEnabled	Boolean?	Enable COPPA compliance
subjectToGdpr	Boolean?	Subject to GDPR
subjectToCoppa	Boolean?	Subject to COPPA
usPrivacyString	String?	IAB US Privacy string (e.g. "1YNN")
gppString	String?	IAB GPP consent string
gppSid	List<Int>?	GPP section IDs
userConsentString	String?	IAB TCF consent string
subjectToLgpd	Boolean?	Subject to Brazilian LGPD

5. Test Mode

Option 1: Enable via Code

build.gradle

dependencies {
  implementation("com.bidease:bidease-mobile:2.2.2")
  implementation("com.bidease:applovin-adapter:2.2.2")
  implementation("com.bidease:bidease-mobile-test-mode:2.2.2")
}

Option 2: Enable via Dashboard

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

QA Checklist

Read before shipping

• Test Mode provides nearly 100% fill — expected behavior for QA only.
• Disable Test Mode before submitting your app to Google Play.
• Ensure GAID is available on your test device so the Bidease team can review logs.
• If you run into any issues, contact your Bidease account manager.