Console Setup

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.

Waterfall Adapter

Automatically (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.

3. Select a Mediation Group where you want to add BidMachine Prebid.

4. 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)
• Compare operator - select comparator from the dropdown menu
• Price Points - an array of Price Points used for Custom Events. Can be modified manually

5. Press the Create button, and you're all set.

Manually

1. Creating BidMachine custom events within mediation group

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

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

2. Setting up Class name and parameters for custom events

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

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

Platform	Ad Type	Class Name
iOS	Banner	BidMachineWaterfallCustomEventBanner
iOS	Interstitial	BidMachineWaterfallCustomEventInterstitial
iOS	Rewarded Video	BidMachineWaterfallCustomEventRewarded
iOS	Native	BidMachineWaterfallCustomEventNativeAd
Android	Banner	com.google.ads.mediation.bidmachine.waterfall.BidMachineWaterfallAdapter
Android	Interstitial	com.google.ads.mediation.bidmachine.waterfall.BidMachineWaterfallAdapter
Android	Rewarded Video	com.google.ads.mediation.bidmachine.waterfall.BidMachineWaterfallAdapter
Android	Native	com.google.ads.mediation.bidmachine.waterfall.BidMachineWaterfallAdapter

Class names

On Android, the class name is the same for all ad types, so you can use the same class name for all ad sources. On iOS, you need to specify the class name according to the ad type.

Parameters description:

Parameter name	Description	Type	Requirements	Example
source_id	Your Source Id	String	Required	"source_id":"your_source_id"
bm_pf	eCPM of BidMachine ad source	Double	Required	"bm_pf":"1.0"
placement_id	Placement ID from BidMachine Placement	UUID	Optional	"placement_id":"your_placement_id"

JSON format

Parameters should be in JSON format, so make sure to use double quotes for keys and values. For example:

{"bm_pf":"1.00", "source_id": "your_source_id", "placement_id": "your_placement_id"}

Example of filling Class name and parameters for iOS Banner:

Price Floors

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

Price Points for BidMachine ad sources can be set up in the following way:

Banners/Native/Mrec	Skippable (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

note

Not all ad units will be called in waterfall but only the one that matches BidMachine bid prices.

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

3. Finalising setup

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

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