Documentation

Unity Monetization Dashboard

Monetize Manage API

Open Monetization dashboard

Unity Monetization Dashboard

Create and manage placements

Create and manage placements in the Unity Monetization Dashboard.
Read time 4 minutesLast updated 2 days ago
Create and manage placements from the Placements page of the Unity Monetization Dashboard.

Plan your placement setup

When you plan your monetization strategy or create placements, remember that you can only set up an individual placement for either bidding or waterfall, not both.

Placement guidelines

  • For bidding setups, Unity recommends using the default six bidding placements provided automatically in your project for better performance and easier setup. Since bidding placements require no extra configuration, they are a convenient starting point.
  • You can't repurpose waterfall placements for in-app bidding because you need to generate a bidding Placement ID from the Monetization dashboard to link into your mediation partner's dashboard.
  • The dashboard generates a Placement ID based on your original placement name. While you can rename your placement later, you can't change the Placement ID, so choose the initial name carefully.

Mediation project guidelines

New projects using some mediation platforms, namely Unity LevelPlay and AppLovin MAX, can only create bidding placements. Waterfall placements are automatically unavailable. Projects with waterfall setups can continue to create and use waterfalls. Setup steps vary slightly between bidding and waterfall configurations, particularly for placements. For waterfall placements, define geo-targeting, set target eCPMs, and optionally add a backfill placement.
Bidding placementWaterfall placement
Required fieldsPlacement name
  • Placement name
  • At least 1 geo target
  • At least 1 eCPM target
Optional fieldsNot applicable
  • Additional placements
  • Backfill placement

Bidding setup

Important
You can only create one bidding placement per placement slot.
  1. Go to Placements from the navigation menu, then select Add placement.
  2. Enter the Placement name.
  3. Select your app Platform.
  4. Select the Ad format.
  5. Select Bidding as the setup type.
    Note
    The dashboard generates a Placement ID based on your original placement name. While you can rename your placement later, you can't change the Placement ID, so choose the initial name carefully.
  6. Select Add Placement.
If you use Unity LevelPlay or another trusted mediation partner like AppLovin MAX, locate the bidding placement you created and copy the associated Placement ID. This Unity bidding Placement ID is required to map to your partner's equivalent bidding placement in their dashboard.

Waterfall setup

Note
Waterfall placements are being phased out. Starting July 23, 2026, you can no longer create new waterfall placements. Any placements not converted to bidding or archived by this date will no longer be editable, but will continue to serve ads. See Transition waterfall placements to bidding.
  1. Go to Placements from the navigation menu, then select Add placement.
  2. Enter the Placement name.
Note
The dashboard generates a Placement ID based on your original placement name. While you can rename your placement later, you can't change the Placement ID, so choose the initial name carefully.
  1. Select your app Platform.
  2. Select the Ad format.
  3. Select Waterfall as the setup type.
  4. Set your geo targeting: select one or more regions, select a pre-made geo collection, or select Global.
  5. Set your target price for this region.
Note
Although eCPM targets can help drive your specified eCPM, implementing these restrictions limit delivery and can potentially impact your overall revenue. Higher targets have a higher risk of decreasing overall revenue by filling less.
  1. Select + Target to add additional geo targets with different prices per placement as necessary.
  2. Select Placement to add more placements as necessary, and follow the previous step to complete it.
  3. Select Backfill placement to add a backfill waterfall placement.
Note
Backfill waterfall placements are used to display ads when targeted ads aren't available. This optional setting is recommended because it ensures ads are always shown in your app, maximizing your ad fill rates and revenue.

Geo targets

Use the Geo Target field to select which countries to target. The default setting (Global) includes all countries. You can select from Geo Collection presets, or choose which countries to include manually. You can have multiple geo targets for a given Placement, but you must specify at least one geo target to create the Placement. Select Add Geo Target to add geo targets with distinct price points.
Note
Placements prioritize geo-specific prices over the global price setting, which is a blended average for all other countries (excluding those with specified targets).
Important
By default, the Global geo-target option sets the CPM for all countries with unspecified price targets and accepts ads at any price if you don't set a global floor with a price target. This can result in impressions with low eCPM being filled. To ensure your app revenue is optimized, set a global floor in addition to a country-specific floor for each geo-target in your project to avoid impressions with low eCPMs.

Bulk manage eCPM targets in a CSV

You can import a CSV file to bulk add or edit eCPM targets. You can download the template from the dashboard help text, or export your existing configuration by selecting Download. Edit the form by filling out the following columns:
ColumnDescriptionNotes
country code
The two-letter country code for the geo target. Use 
GLOBAL
for the global designation.		Exporting your targets to CSV converts any applied Geo Collections into a list of countries when you re-import.
target price
The eCPM value that you are targeting for the corresponding geos.Prices must use General format (as opposed to Number, Currency, or Accounting format). For more information, refer to the Microsoft documentation on Available number formats in Excel.
After you make your edits, save the document as a CSV file and select Upload to import your changes. You must verify any changes before saving them to the dashboard. If any errors exist in your file, the verification modal will advise you.

Transition waterfall placements to bidding

As waterfall placement support is being phased out, you have the following options to manage your existing waterfall placements before the July 23, 2026 deadline.

Switch to bidding (recommended)

To switch a waterfall placement to bidding, open the placement in the Unity Monetization dashboard and follow the prompts.
Note
Switching from waterfall to bidding creates a new bidding placement with a new Placement ID. You need to do the following to update your placement configuration:
  1. Copy the new bidding Placement ID from the Unity Monetization dashboard.
  2. Update the Placement ID in your app code or mediation platform configuration.
  3. If you use a mediation partner, add the new Unity bidding placement to your mediation platform dashboard and map it to the corresponding placement there.
Depending on your mediation partner's requirements for supporting Unity Ads bidding, this may require an app update.

Leave placements as they are

You can leave your waterfall placements unchanged. They continue to serve ads after the deadline, but are no longer editable. No SDK or configuration update is required.

Archive placements

If a waterfall placement is no longer generating significant revenue, consider archiving it. Archived placements can be unarchived at any time.