Console Setup

Regular BidMachine waterfall integration. It requires adding a specific Yield Partner for selected Yield 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

Choosing a yield group

Go to yield groups in your GAM dashboard. Choose a yield group or create a new one by following this guide.

Open yield group and scroll to Yield Partners sections. Click on Add yield partner.

Adding BidMachine Custom Events

1. Choose yield partner type: Other company (Custom Other Company Network)
2. Choose integration type: Custom Event
3. Choose platform
4. Choose status: Active
5. Choose default CPM. You can use values from the list below
6. Select override dynamic CPM
7. Fill additinal yield parameters details
   1. Label - any value, eg: BidMachine Custom Event Interstitial 10$
   2. Class Name - Name of BidMachine Custom Event class, see table below
   3. Parameter - Custom Event specific parameters as JSON encoded string

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 Interstitial:

important

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

Price Floors Examples

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.