For publishers

Ad unit mapping for Open Bidding

Connect Ad units to ad networks
This feature is in Beta
Features in Beta phase might not be available in your network. Watch the release notes for when this feature becomes generally available.

Ad unit mapping provides a way for publishers to connect a Google Ad Manager Ad unit to the ad network required parameters for a specific ad format (i.e. Banner, Native, etc.) and environment (i.e. mobile or web).

You can have a maximum of 200 ad unit mappings. Learn the best practices for ad unit mapping and discover available partners.

Add an ad unit mapping

You can add one ad unit mapping at a time or bulk upload mappings.

  1. Sign in to Google Ad Manager.
  2. Click Delivery and then Yield partners*.
    * If you are participating in the Bidders beta, click Delivery and then Bidders.
  3. Click on the name of your yield partner.
  4. Click New Ad unit mapping.

Select the ad unit

  1. Select the type of Ad unit: "Run of network" or "Specific Ad unit"
  2. Select the "Format".
  3. Select "Inventory type".
    • If you select Web, you must also select "Inventory URLs".
    • If you select Mobile application, you must select the name in "Mobile application".

Choose the mapped inventory

  1. Select the corresponding "Partner inventory".
  2. If you've connected to an available Yield partner's API, additional parameters will automatically populate. Otherwise, click Manual entry to enter those parameters.
  3. Click Save.

Review a Yield partner's existing ad unit mappings

  1. Click Delivery and then Yield Partners*.
    * If you are participating in the Bidders beta, click Delivery and then Bidders.
  2. Select name of your Yield partner.
  3. Click Ad unit mapping.
  4. Click Download Download to download a CSV file with all existing ad unit mappings for this Yield partner.

Bulk upload Ad unit mappings

Upload multiple Ad unit mappings using a CSV.

  1. Click Delivery and then Yield Partners*.
    * If you are participating in the Bidders beta, click Delivery and then Bidders.
  2. Select name of your Yield partner.
  3. Click Ad unit mapping.
  4. Click Upload Upload.
  5. Click Download sample CSV file to download a file that you can use to define your ad units. Open the CSV file and make changes based on the example to include your ad units and parameters. When you're done, save the CSV file using your file editor.
  6. Upload the edited Ad unit mapping CSV.
  7. Click Confirm.

Best practices

The following recommendations will help you plan your ad unit mapping:

  • To ensure you don't exceed the maximum of 200 ad unit mappings, create only top level ad units.
  • We recommend coverage of all ad units, available formats, and inventory because yield partners will not bid without ad unit mappings.
  • Map specific ad unit IDs rather than "run of network" in order to map specific inventory with matching formats and inventory types.

Expand all  Collapse all

How to use the sample CSV file

The sample CSV file contains fields and examples relevant to your account.

  • Don't remove columns or change the column order. Doing so results in a failed upload
  • Delete header rows from bulk upload sample CSV prior to upload. If you don't delete header rows, the upload will likely fail
  • Remove semicolon (;) from your file editor's list of delimiter or separator characters to ensure the sample file renders columns and values correctly
Mobile only: Claim your apps in the app store
  • To use ad unit mapping, claim your mobile app in Ad Manager.
  • If you re-release an app to the app store, it may be given a new ID. Claim your re-released app.

Ad unit mapping fields

These fields are required to support ad unit mapping.

Field Example Description
Ad unit mapping ID 123456789 ID associated with an ad unit. Required when uploading CSV files to edit existing Ad unit mappings.
Leave this blank when creating new mappings.
Ad unit path top-level/parent1/child1

Full path for ad units, unique within a hierarchy level. The path should separate directories with a /.

Format Banner Available Formats include "Banner", "Interstitial", "In-stream Video", "Native", and "Rewarded"
Inventory type Mobile

Inventory type identifies the kind inventory or the context in which ad creatives serve. Values you can select include: Web, Mobile, and Video

Mobile application ID 987654321

ID associated with your mobile application.

This field will be empty if the Ad unit mapping is for "Web" or "Video".

Inventory URLs (optional) example.com

One or more URLs for web-based Inventory.

Parameters

Key: Value

Third-party inventory identifiers for Open Bidders. It is possible to have one or more parameters.
 

Available partners

Ad unit mapping is available for third-party yield partners with custom SDKs. It is not available to ad exchanges.

AdColony

AdColony is available for ad unit mapping.

AppLovin

AppLovin is available for ad unit mapping.

Field Example Description
Parameters

SDK Keys: 987612xxxxx_6789

Third-party inventory identifiers for Open Bidders. It is possible to have one or more of these columns.
Meta Audience Network

Meta Audience Network (FAN) is available for ad unit mapping.

Field Example Description
Parameters Placement ID: 12345xxxxxxx_xx321

Third-party inventory identifiers for Open Bidders. It is possible to have one or more of these columns.

Placement ID is the Meta SDK's identifier for your Ad unit.

 (Optional) Connect to FAN API

For Meta ad units only, you can connect to the FAN API to allow ad unit data to be shared with Google Ad Manager.

  1. Before you choose your mapped inventory, click API Login to authorize Google Ad Manager to manage your Meta business and allow data about your placements to be shared.
  2. Once authorized, you will return to Google Ad Manager and the ad unit mapping will indicate API Connected.

Some Meta best practices:

  • All app banner ad sizes should map to the Meta placement format of "Banner"
Tapjoy

Tapjoy is available for ad unit mapping.

Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue

Search
Clear search
Close search
Google apps
Main menu
Search Help Center
true
148
false
false