Documentation

Ad Ops - Google Ad Manager Waterfall

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.

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
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 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/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 Save

Finalising setup

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


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.