Guides

AdMob Custom Adapter

Integrate Bidease as a custom event in Google AdMob mediation.

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 AdMob version:12.

1. Installation

To integrate the Bidease SDK into your Xcode project using CocoaPods, add the following to your Podfile:

platform :ios, '13.0'
...

pod 'BideaseSDK/AdapterAdmob', '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. SDK Initialization

Before initializing Google Mobile Ads, set your Bidease app key:

import BideaseMobileSDK

BideaseMediationAdapter.setAppKey("YOUR_APP_KEY")
❗️

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

import GoogleMobileAds

GADMobileAds.sharedInstance().start()

The Bidease SDK initializes automatically when AdMob triggers the mediation adapter — no need to call BideaseMobile.initialize() separately.

3. Add Custom Events in Admob Mediation

📘

Before setting up custom events in AdMob, 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 →

Custom events are created directly inside a mediation group. For a full overview of how custom events work, see the AdMob Custom Events documentation.

  1. Go to admob.google.com and click Mediation in the left sidebar
  2. Select an existing mediation group or click Create mediation group
  3. In the Waterfall ad sources table, click Add custom event
  4. Enter a Label using the format AdFormat_ecpm_X.X — where AdFormat is the format type (Banner, Interstitial, Rewarded), and X.X is the floor price
    • Example: Interstitial_ecpm_1.3, Banner_ecpm_0.5
  5. Set the eCPM to the same floor price value as in the label
  6. Click Continue
  7. Fill in the mapping fields:
FieldValue
Class NameBideaseMediationAdapter — the same for all ad formats
ParameterAdFormat_ecpm_X.X — must exactly match the Label from step 4
  1. Click Done, then Save

Here are how custom events should look like for each ad format:

Banner

Interstitial

Rewarded

💡 Tip: You can create multiple custom events with different floor prices for the same ad format to optimize your waterfall performance.

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/AdapterAdmob', '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 Google Play.
  • Ensure GAID 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.

Updated 8 days ago

What’s Next