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	Parameters
iOS	Banner	BidMachineWaterfallCustomEventBanner	{"bm_pf":"1.00", "source_id": "your_source_id"}
iOS	Interstitial	BidMachineWaterfallCustomEventInterstitial	{"bm_pf":"1.00", "source_id": "your_source_id"}
iOS	Rewarded Video	BidMachineWaterfallCustomEventRewarded	{"bm_pf":"1.00", "source_id": "your_source_id"}
iOS	Native	BidMachineWaterfallCustomEventNativeAd	{"bm_pf":"1.00", "source_id": "your_source_id"}
Android	Banner	com.google.ads.mediation.bidmachine.waterfall.BidMachineWaterfallAdapter	{"bm_pf":"1.00", "source_id": "your_source_id"}
Android	Interstitial	com.google.ads.mediation.bidmachine.waterfall.BidMachineWaterfallAdapter	{"bm_pf":"1.00", "source_id": "your_source_id"}
Android	Rewarded Video	com.google.ads.mediation.bidmachine.waterfall.BidMachineWaterfallAdapter	{"bm_pf":"1.00", "source_id": "your_source_id"}
Android	Native	com.google.ads.mediation.bidmachine.waterfall.BidMachineWaterfallAdapter	{"bm_pf":"1.00", "source_id": "your_source_id"}

Parameters description:

Parameter name	Description	Type	Example
source_id	Your Source Id	String	"source_id": "your_source_id"
bm_pf	eCPM of BidMachine ad source	double	1.0

JSON format

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

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.

note

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