Documentation

Ad Ops - Google AdMob Waterfall

Regular BidMachine waterfall integration. It requires adding specific Custom Events for selected Mediation Group.

❗️Adapter Compatibility
BidMachine waterfall integration has been supported since v3.1.1.40 for Android and v3.1.1.2 for iOS.

Automatically using Chrome extension

  1. Install the AdMob Helper extension

  2. Open the extension and go to the Google AdMob dashboard. The extension will detect your account and find mediation groups associated with it.

  1. Select a Mediation Group where you want to add BidMachine Waterfall.
  1. Fill out your data:
  • Source Id - Source Id from your account
  • Integration type - Waterfall type should be selected
  • Keep overwriting existing BidMachine Custom Events checked if you want the extension to replace previously created Custom Events for BidMachine (both prebid and waterfall)
  • Price Points - an array of Price Points used for Custom Events. Can be modified manually
  1. Press the Create button, and you're all set.

Manual

  1. Creating BidMachine custom events within the mediation group

Go to the Google AdMob dashboard and choose the mediation group where you want to create BidMachine ad sources.

Go inside the chosen mediation group and start creating BidMachine custom events with the prices you want to use

  1. Setting up Class names and parameters for custom events

Enter the label of the ad source set up the price and click Continue

Then in the next window set up the class name and class parameters according to the following table

PlatformAd TypeClass NameParameters
iOSBannerBidMachineWaterfallCustomEventBanner{"bm_pf":"1.00", "source_id": "your_source_id"}
iOSInterstitialBidMachineWaterfallCustomEventInterstitial"bm_pf":"1.00", "source_id": "your_source_id"}
iOSRewarded VideoBidMachineWaterfallCustomEventRewarded"bm_pf":"1.00", "source_id": "your_source_id"}
iOSNativeBidMachineWaterfallCustomEventNativeAd"bm_pf":"1.00", "source_id": "your_source_id"}
AndroidBannercom.google.ads.mediation.bidmachine.waterfall.BidMachineWaterfallAdapter"bm_pf":"1.00", "source_id": "your_source_id"}
AndroidInterstitialcom.google.ads.mediation.bidmachine.waterfall.BidMachineWaterfallAdapter"bm_pf":"1.00", "source_id": "your_source_id"}
AndroidRewarded Videocom.google.ads.mediation.bidmachine.waterfall.BidMachineWaterfallAdapter"bm_pf":"1.00", "source_id": "your_source_id"}
AndroidNativecom.google.ads.mediation.bidmachine.waterfall.BidMachineWaterfallAdapter"bm_pf":"1.00", "source_id": "your_source_id"}

Parameters description:

Parameter nameDescriptionTypeExample
source_idYour Source IdString"source_id": "your_source_id"
bm_pfeCPM of BidMachine ad sourcedouble1.0

Example of filling Class name and parameters for iOS Banner:


❗️

IMPORTANT

In parameters in bm_pf field - specify exactly the same price as you used for creating ad source

📘

Price Floors Examples

Banners/Native/MrecSkippable (Int + Video)Non-Skippable (Rewarded)
0.1
0.3
0.4
0.5
1.0
1.5
3.0
1.0
5.0
10.0
20.0
30.0
40.0
70.0
100.0
1.0
5.0
10.0
20.0
30.0
40.0
70.0
100.0
200.0

When you are finished filling all the needed info - click Done

  1. Finalising setup

You can create several ad sources within the same mediation group. Once you are done creating them - you should see a final waterfall with your networks and newly created BidMachine ad sources.

If you want to change the prices of created ad sources - you should not only change the eCPM but also change bm_pf value in the parameters of it.

🚧

Having several BidMachine custom events will not affect latency in terms of filling the ads because BM SDK will return results instantly as the ad will be fetched prior to calling waterfall ad networks