Documentation

Ad Ops - Google AdMob

❗️

Auto-Refresh

This integration method involves manual loading of ads, so make sure that auto-refresh is disabled for ad units.

Step 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

Step 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

PlatformAd TypeClass NameParameters
iOSBannerBidMachineCustomEventBanner{"bm_pf":"1.00","bm_pf_compare":"equal_or_above_pf"}
iOSInterstitialBidMachineCustomEventInterstitial{"bm_pf":"1.00","bm_pf_compare":"equal_or_above_pf"}
iOSRewarded VideoBidMachineCustomEventRewarded{"bm_pf":"1.00","bm_pf_compare":"equal_or_above_pf"}
iOSNativeBidMachineCustomEventNativeAd{"bm_pf":"1.00","bm_pf_compare":"equal_or_above_pf"}
AndroidBannercom.google.ads.mediation.bidmachine.BidMachineAdapter{"bm_pf":"1.00","bm_pf_compare":"equal_or_above_pf"}
AndroidInterstitialcom.google.ads.mediation.bidmachine.BidMachineAdapter{"bm_pf":"1.00","bm_pf_compare":"equal_or_above_pf"}
AndroidRewarded Videocom.google.ads.mediation.bidmachine.BidMachineAdapter{"bm_pf":"1.00","bm_pf_compare":"equal_or_above_pf"}
AndroidNativecom.google.ads.mediation.bidmachine.BidMachineAdapter{"bm_pf":"1.00","bm_pf_compare":"equal_or_above_pf"}

Parameters description:

Parameter nameDescriptionTypeExample
bm_pfeCPM of BidMachine ad sourcedouble1.00
bm_pf_comparerule of how to compare ad source eCPM with the price of ad response.

If equal_or_above_pf - SDK will fill the ad if ad source price is equal or below the price of current ad.
Example: BM SDK responds with ad with price 5.34$
AdMob sent ad sources with eCPMs of 6.00$, 5.00$, 4.00$
6.00$ Ad source - No fill
5.00$ Ad source - Fill

If equal_pf - SDK will fill the ad if ad source price is equal the price of current ad.
Example: BM SDK responds with ad with price 5.34$
AdMob sent ad sources with eCPMs of 6.00$, 5.00$, 4.00$
6.00$ Ad source - No fill
5.00$ Ad source - No fill
4.00$ Ad source - No fill
SDK will fill the ad only if AdMob has 5.34$ ad source
string
values: equal_or_above_pf, equal_pf
equal_or_above_pf

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

❗️

IMPORTANT

Please add only prices from the list below.
Adding other prices can lead to the line item not working properly or introduce discrepancies.

Please, add ALL ad units from the list to maximize fillrate and a successful integration.

Banners/Native/MrecSkippable (Int + Video)Non-Skippable (Rewarded)
0.05
0.1
0.15
0.2
0.25
0.3
0.35
0.4
0.45
0.5
0.55
0.6
0.65
0.7
0.75
0.8
0.85
0.9
0.95
1
1.1
1.2
1.3
1.4
1.5
1.6
1.7
1.8
1.9
2
2.2
2.4
2.6
2.8
3
3.2
3.4
3.6
3.8
4
4.2
4.4
4.6
4.8
5
5.5
6
6.5
7
7.5
8
8.5
9
9.5
10
0.5
1.5
2.5
3.5
4.5
5.5
6.5
7.5
8.5
9.5
10.5
11.5
12.5
13.5
14.5
15.5
16.5
17.5
18.5
19.5
21.0
23.0
25.0
30.0
35.0
40.0
45.0
50.0
55.0
60.0
70.0
80.0
90.0
100.0
125.0
150.0
175.0
200.0
225.0
250.0
275.0
300.0
325.0
350.0
375.0
400.0
425.0
450.0
475.0
500.0
0.5
1.5
2.5
3.5
4.5
5.5
6.5
7.5
8.5
9.5
10.5
11.5
12.5
13.5
14.5
15.5
16.5
17.5
18.5
19.5
21.0
23.0
25.0
30.0
35.0
40.0
45.0
50.0
55.0
60.0
70.0
80.0
90.0
100.0
125.0
150.0
175.0
200.0
225.0
250.0
275.0
300.0
325.0
350.0
375.0
400.0
425.0
450.0
475.0
500.0

❗️

IMPORTANT

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

Step 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.

🚧

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