Skip to main content

Console Setup

Manual Setup​

Bidding Adapter​

BidMachine's bidding adapter enables real-time bidding integration with AdMob. This setup allows BidMachine to participate in AdMob's bidding auctions.

Requirements
  • Android API level 23 or higher
  • BidMachine adapter version 3.4.0.1 or later (Use the latest available BidMachine adapter version for all formats)
  • Latest Google Mobile Ads SDK

Step 1: BidMachine Dashboard Configuration​

  1. Navigate to the Source tab in your BidMachine dashboard and select Edit. Copy the Integration ID for later use in the AdMob console.
  1. Click Add Placement to create new placements
Placement Management API

You can also create and manage placements programmatically using the Placement Management API — useful when provisioning placements at scale.

Bundle Identifier Format

When setting up your mediation group, use the appropriate bundle identifier format:

  • Android apps: Use alphabetic bundle identifier (e.g., com.example.app)
  • iOS apps: Use numeric app ID (e.g., 123456789)
  1. Save your changes and note the Placement ID for later use
  1. Access the app-ads.txt tab in the BidMachine dashboard, copy the content, and append it to your website's app-ads.txt file

Step 2: AdMob Console Setup​

  1. Sign into your AdMob account

  2. Navigate to Mediation and either create a new mediation group or edit an existing one

  1. Configure ad format and platform settings
  1. Select Add ad source under the Bidding card
  1. Locate and choose BidMachine from the available networks

  1. Establish the partnership agreement if prompted

  2. Add mapping with your Placement ID from the BidMachine dashboard

  1. Add BidMachine to GDPR and US state regulations ad partners lists per AdMob's European and US state regulations settings

Step 3: Enable Secure Signals & User Consent​

Required — most common cause of "no bids"

BidMachine will not bid unless Secure Signal sharing is enabled and BidMachine is allowed under your User Consent settings in the AdMob/GAM console. These toggles are off by default and are the most frequent reason publishers see no fill after an otherwise correct setup. Verify both before troubleshooting anything else.

1. Enable Secure Signal sharing

Secure signals are the encrypted bidding parameters BidMachine needs to participate in the auction. They must be explicitly enabled for the BidMachine bidder:

  1. Sign in to your Google Ad Manager account
  2. Go to Delivery → Bidders, open SDK Bidding, and select BidMachine
  3. Under Secure signal sharing (required), check whether each item shows Enabled or Disabled
  4. If anything is marked Disabled, click the link for each item to enable the library and the sharing of signals to BidMachine
  5. Confirm signals are being passed using Delivery Tools or Ad Inspector (the Buyer generated data field in the third-party bidding parameters should show a substantial character count)
Google reference

Follow Google's official guide for exact screenshots and current console paths: Verify your SDK Bidding setup → Enable secure signals.

2. Allow BidMachine under User Consent settings

  1. In the AdMob console, open Privacy & messaging and review your European regulations (GDPR) and US state regulations settings
  2. Make sure BidMachine is added to your list of allowed ad partners / commonly used ad partners for each applicable regulation
  3. If BidMachine is not on the consent vendor list, no consent signal will be passed and bidding will fail
App-side requirement

The console settings above only work if your app also forwards consent correctly — see Step 4: Privacy Implementation below.

Step 4: Privacy Implementation​

BidMachine automatically reads GDPR consent set by consent management platforms including UMP SDK. Similarly, it reads GPP consent automatically for US state compliance.

Ensure you have implemented a Consent Management Platform (CMP) in your app according to AdMob's privacy requirements.

Step 5: Testing​

  1. Register your test device for AdMob

  2. Enable test mode in BidMachine's SDK documentation

  3. Use Ad Inspector's single ad source testing feature to verify BidMachine ads

  4. Disable test modes before production release

Waterfall Adapter BETA​

Contact Your Account Manager

Waterfall integration is currently in beta. Please contact your BidMachine account manager for setup assistance and access.

BidMachine waterfall integration allows you to add BidMachine as a custom event in your AdMob mediation waterfall with specific price points.

Adapter Compatibility

Use Use the latest available BidMachine adapter version for all formats.

Manually​

Multiple Placements

To set up multiple placements, repeat the setup process for each placement with its corresponding Placement ID.

1. BidMachine Dashboard Configuration​

  1. Navigate to the Source tab in your BidMachine dashboard and select Edit

  2. Click Add Placement to create new placements (or create them programmatically via the Placement Management API)

  3. Save your changes and note the Placement ID for later use

  4. Access the app-ads.txt tab in the BidMachine dashboard, copy the content, and append it to your website's app-ads.txt file

2. AdMob Console Setup​

  1. Sign into your AdMob account

  2. Navigate to Mediation and either create a new mediation group or edit an existing one

  3. Configure ad format and platform settings

  4. Select Add Ad Source under the waterfall section

  5. Enter the eCPM value for this price point

  1. Locate and choose BidMachine from the available networks

  2. Add mapping with your Placement ID from the BidMachine dashboard

  3. Click Done to save the ad source

  4. Repeat steps 4-8 for each price point you want to add

Recommended Price Points:

Banners/Native/MrecSkippable (Int + Video)Non-Skippable (Rewarded)
0.1, 0.3, 0.4, 0.5, 1.0, 1.5, 3.01.0, 5.0, 10.0, 20.0, 30.0, 40.0, 70.0, 100.01.0, 5.0, 10.0, 20.0, 30.0, 40.0, 70.0, 100.0, 200.0
Waterfall Behavior

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

3. Privacy Implementation​

BidMachine automatically reads GDPR consent set by consent management platforms including UMP SDK. Similarly, it reads GPP consent automatically for US state compliance.

Ensure you have implemented a Consent Management Platform (CMP) in your app according to AdMob's privacy requirements.

4. Finalizing Setup​

Once you are done creating ad sources, you should see the final waterfall with your networks and newly created BidMachine ad sources.

6. Testing​

  1. Register your test device for AdMob

  2. Enable test mode in BidMachine's SDK documentation

  3. Use Ad Inspector to verify BidMachine waterfall ads at different price points

  4. Disable test modes before production release