Ad unit mapping for Open Bidding - Google Ad Manager Help [gg-admanager-en]

For publishers

Ad unit mapping for Open Bidding

Connect Ad units to ad networks

Next: Open Bidding FAQ

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  Yield partners*.
   * If you are participating in the Bidders beta, click Delivery  Bidders.
3. Click on the name of your yield partner.
4. Click New Ad unit mapping.

Select the ad unit

5. Select the type of Ad unit: "Run of network" or "Specific Ad unit"
6. Select the "Format".
7. 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

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

Review a Yield partner's existing ad unit mappings

1. Click Delivery Yield Partners*.
   * If you are participating in the Bidders beta, click Delivery Bidders.
2. Select name of your Yield partner.
3. Click Ad unit mapping.
4. Click  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 Yield Partners*.
   * If you are participating in the Bidders beta, click Delivery  Bidders.
2. Select name of your Yield partner.
3. Click Ad unit mapping.
4. Click  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.

Next: Open Bidding FAQ