Mediation management
Stay organized with collections
Save and categorize content based on your preferences.
The AdMob API lets you manage your AdMob Mediation setup programmatically.
You can create and update mediation
groups, add ad source
instances, and
provide the ad unit
mappings to enable calls
to multiple third-party networks.
The following activities are available through the AdMob API and UI.
|
Create |
Patch |
List |
| App |
|
|
|
| Ad unit |
|
|
|
| Ad unit mappings |
|
|
|
| Mediation group |
|
|
|
With the AdMob API you can:
- Create apps, link them to app stores, and add ad units.
- Create ad unit mappings for all of the waterfall ad sources you want included
in your setup.
- Create a mediation group with geo targeting and waterfall ad sources with
their associated ad unit mappings.
- Update a mediation group's ad sources, ad unit mappings, and eCPM values.
A mediation group can have many ad source instances, each having their own ad
unit mapping. For instance, mediation group A could have the following lines:
- Ad source
B with eCPM $10 and ad unit mapping b
- Ad source
C with eCPM $8 and ad unit mapping c
- Ad source
D with eCPM $6 and ad unit mapping d
The hierarchy of objects and maps is as follows:
Get started
Start creating mediation groups, group lines, and mapping ad units
programmatically with the following examples:
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-29 UTC.
[null,null,["Last updated 2025-08-29 UTC."],[[["\u003cp\u003eThe AdMob API allows programmatic management of your AdMob Mediation setup, including creating and updating mediation groups, adding ad sources, and defining ad unit mappings.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the API to create apps, link them to app stores, add ad units, and establish ad unit mappings for your desired waterfall ad sources.\u003c/p\u003e\n"],["\u003cp\u003eMediation groups enable geo-targeting and management of waterfall ad sources with associated ad unit mappings, including updating ad sources, mappings, and eCPM values.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides access to information on ad sources and adapters, facilitating the creation of ad unit mappings and overall setup for programmatic mediation management.\u003c/p\u003e\n"]]],[],null,["# Mediation management\n\nThe AdMob API lets you manage your AdMob Mediation setup programmatically.\nYou can create and update [mediation\ngroups](/admob/api/v1/mediation-groups), add [ad source\ninstances](/admob/api/v1/ad-sources), and\nprovide the [ad unit\nmappings](/admob/api/v1/ad-unit-mappings) to enable calls\nto multiple [third-party networks](/admob/api/v1/ad-sources-reference).\n\nThe following activities are available through the AdMob API and UI.\n\n| | Create | Patch | List |\n|------------------|--------|-------|------|\n| App | | | |\n| Ad unit | | | |\n| Ad unit mappings | | | |\n| Mediation group | | | |\n\nWith the AdMob API you can:\n\n- Create apps, link them to app stores, and add ad units.\n- Create ad unit mappings for all of the waterfall ad sources you want included in your setup.\n- Create a mediation group with geo targeting and waterfall ad sources with their associated ad unit mappings.\n- Update a mediation group's ad sources, ad unit mappings, and eCPM values.\n\nA mediation group can have many ad source instances, each having their own ad\nunit mapping. For instance, mediation group `A` could have the following lines:\n\n- Ad source `B` with eCPM $10 and ad unit mapping `b`\n- Ad source `C` with eCPM $8 and ad unit mapping `c`\n- Ad source `D` with eCPM $6 and ad unit mapping `d`\n\nThe hierarchy of objects and maps is as follows:\n\nGet started\n-----------\n\nStart creating mediation groups, group lines, and mapping ad units\nprogrammatically with the following examples:\n\n- Complete your [setup](/admob/api/v1/getting-started) to make requests using Curl.\n- Programmatically get information on [ad\n sources](/admob/api/v1/ad-sources) and [adapters](/admob/api/v1/adapters-guide) to [create ad\n unit mappings](/admob/api/v1/ad-unit-mappings).\n- Create [apps and ad units](/admob/api/v1/app-ad-units).\n- Create [mediation\n groups](/admob/api/v1/mediation-groups)."]]
