Map your ad units

Mapping your ad units is an essential step in mediation. To map your ad units, you’ll need to know the mapping details for the ad units. Mapping details are the unique identifiers for the ad units created in your third-party account. Each ad source may have different required mapping details, and can be identifiers such as App ID or Slot ID. 

Adding your mapping details allows AdMob and third-party ad sources to work together to fill your impressions. It also helps ensure accurate reporting and optimization for third-party waterfall ad sources in your AdMob account. 

On this page

• Create additional mappings for an ad unit
• Manage your ad unit mapping details from your mediation group page
• Manage your ad unit mapping details from your ad source page
• Troubleshoot mapping & optimization issues

When you map your ad units by ad source, you won’t have to map the ad units again when you add the ad source to a mediation group . Instead, you’ll be selecting which ad unit mapping to use when you add the ad source to a mediation group. Also note that some bidding ad sources do not require ad unit mapping.

Create additional mappings for an ad unit 

Creating additional mappings allows you to call a third-party waterfall ad source more than once in the mediation waterfall. Each ad source instance in a mediation group must have its own unique mapping. This means that you’ll need to set up an additional ad unit in your third-party ad source account before you add an additional mapping in your AdMob account. 

To set up additional mapping from your mediation group or ad source page, follow the instructions below. 

Manage your ad unit mapping details from your mediation group page 

You can edit your ad unit mapping details or add additional mappings for your ad units directly in your mediation groups.

Complete the following steps to add or edit ad unit mappings from the mediation group page.

1. Sign in to your AdMob account at https://admob.google.com .
2. Click  Mediation in the sidebar.
3. In the mediation groups table, click the name of the mediation group with the ad unit mapping you want to update.
4. In the ad sources table, in the “Ad unit mapping” column, click Editnext to the instance you want to change. 
   Note: Bidding ad sources can only have one mapping per ad unit.
5. Select the ad unit mapping you’d like to add from the list. You can use the search option to find the ad unit mapping you want to use. Click Done. 
6. If you want to update or add an ad unit mapping, click Add or edit mappings.
7. Make the updates to your ad units mappings. To add additional mappings, click Add mapping. Note that you set the name of the ad unit mapping.  Click Save.
   Tip: Remember that updates to an ad unit mapping will be applied to the same ad unit mapping across all mediation groups.
8. Once you’re finished making changes, click Save.

Manage your ad unit mapping details from your ad source page

You can edit your ad unit mapping details or add additional mappings for your ad units in the Ad source page of your account. Complete the following steps to add or edit ad unit mappings from an ad source page. 

1. Sign in to your AdMob account at https://admob.google.com .
2. Click  Mediation in the sidebar.
3. Click the Bidding sourcestab to edit mapping details for a bidding source. Click the Waterfall sourcestab to edit or add additional mappings for a waterfall source.
   Note: Bidding ad sources can only have one mapping per ad unit.
4. Select the ad source with the mapping you’d like to add or edit. 
5. Click the  Ad unit mappingtab. 
   Note: In the ad unit mapping table, the “Mappings” column shows the total number of mappings for an app.
6. Find the app with the ad unit mapping you’d like to add or edit. Click.
7. Click Manage mappingto edit your mappings. To add additional mappings, click Add mapping. Note that you set the name of the ad unit mapping. 
8. (Optional) When you add mappings for a waterfall source, you can use Network eCPMto enter the eCPM floor from the network ad unit. This reference helps you easily identify ad unit mappings for the ad source.
9. (Optional) In the “Mediation groups” column, you can add the mediation groups associated with a mapping.
   • If the mapping has no mediation groups, click Add. Click Next, confirm your selection, and then click Apply.
     Note: You can add up to 10 mediation groups for each ad unit mapping.
10. Once you’re finished making changes, click Save.

Troubleshoot mapping & optimization issues

You can check the status of your ad source’s ad unit mapping and optimization in the Ad source page of your account. The table below shows the statuses and what they mean.

Status

What it means

This ad unit is successfully mapped. 

–

The ad unit mapping hasn’t been verified yet. This status occurs when you’ve recently created an ad unit or recently added mapping details.

Incorrect mapping

The mapping details you provided are incorrect.

Missing mapping

Some required mapping details are missing. Enter the mapping details for each ad unit for third party reporting and optimization to begin. In most cases, these details will be available in your account with the ad source.

Not able to optimize

AdMob wasn't able to optimize this ad source.

Not enough impressions

Your ad unit doesn’t have enough impressions. Your ad unit must have a minimum of 100 impressions per day for 3 days out of the last 10 days in order for all of your ad units to be optimized.

No requests

No requests were made to this instance of the ad source. This could be due to:

• The mediation group priority is too low.
• This ad source instance is ordered too low in the mediation waterfall.
• Requests are likely to be filled by higher priority mediation groups and ad sources that are higher in the mediation waterfall.

Optimization in progress

You’ve entered credentials for this source, but optimization and eCPM updates for reporting haven’t started yet.

When optimization is enabled and credentials are entered, there may be a delay while AdMob gathers data. Optimization will begin automatically once AdMob has gathered enough data. This can take up to 3 days.