Skip to main content

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 deployment target: iOS 13.0
  • Minimal Xcode version: 16.4
  • Minimal AppLovin MAX version: 13

1. Installation​

Current published version: 3.0.1. Install with CocoaPods or Swift Package Manager — pick one, not both.

Podfile
platform :ios, '13.0'

pod 'BideaseSDK/AdapterAppLovinMax', '3.0.1'

Then run pod install.

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

App Key location in the Monetize dashboard

2.2. Set Bidease App Key​

Before initializing AppLovin MAX, set your Bidease app key:

import BideaseMobileSDK
import BideaseAdapterAppLovin

BideaseAppLovinMediationAdapter.setInitParams(
  InitParams(
      key: "YOUR_APP_KEY",
      privacyParams: PrivacyConfig(/* see Privacy & Consent */),
      customProps: ["ipv4": "203.0.113.17"]
  )
)
warning
Replace YOUR_APP_KEY with the App Key from your Bidease Monetize dashboard.
note

Only the app key is required. In Swift use BideaseAppLovinMediationAdapter.setInitParams(InitParams(key: "YOUR_APP_KEY")); in Objective-C use [BideaseAppLovinMediationAdapter setInitParamsWithKey:@"YOUR_APP_KEY"].

3. Configure Bidease in AppLovin MAX Dashboard​

Before configuring AppLovin MAX, ensure 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:
FieldValue
Network TypeSDK
NameBidease
iOS Adapter Class NameBideaseAppLovinMediationAdapter
  1. 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:
FieldValue
App IDYour Bidease app key
Placement IDAdFormat_ecpm_X.X — e.g., Interstitial_ecpm_1.3, Banner_ecpm_0.5
CPM PriceEnter the same floor price value as in your Placement ID (the X.X value)
  1. 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 BideaseMobileSDK

let privacyParams = PrivacyConfig(
    coppaEnabled: false,
    subjectToGdpr: true,
    subjectToCoppa: false,
    usPrivacyString: "1YNN",
    gppString: "DBACNYA~CPXxRfAPXxRfAAfKABENB-CgAAAAAAAAAAYgAAAAAAAA~1YNN",
    gppSid: [2, 6],
    userConsentString: "CPXxRfAPXxRfAAfKABENB-CgAAAAAAAAAAYgAAAAAAAA",
    subjectToLgpd: true
)
FieldTypeDescription
coppaEnabledBool?Enable COPPA compliance
subjectToGdprBool?Subject to GDPR
subjectToCoppaBool?Subject to COPPA
usPrivacyStringString?IAB US Privacy string (e.g. "1YNN")
gppStringString?IAB GPP consent string
gppSid[Int]?GPP section IDs
userConsentStringString?IAB TCF consent string
subjectToLgpdBool?Subject to Brazilian LGPD

5. SKAdNetwork IDs​

The Bidease SDK supports SKAdNetwork so partner networks can attribute installs when IDFA is unavailable. Add the SKAdNetworkItems entry to your Info.plist:

  1. In Xcode, select Info.plist in the Project navigator.
  2. Right-click Info.plist → Open As → Source Code.
  3. Copy the SKAdNetworkItems array from the file below and paste it into your Info.plist.
Download SKAdNetworkItems.plistApple SKAdNetwork IDs

6. Test Mode​

Option 1: Enable via Code​

Podfile
pod 'BideaseSDK/AdapterAppLovinMax', '3.0.1'
pod 'BideaseSDK/TestMode', '3.0.1'
caution

Remove the test-mode dependency before releasing to production.

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 IDFA (iOS)
  3. Enable Test for the application

7. QA Checklist​

Read before shipping
  • Test Mode provides nearly 100% fill — 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.
  • If you run into any issues, contact your Bidease account manager.
Last updated on