Create and manage placements
Create and manage placements in the Unity Monetization Dashboard.
Read time 4 minutesLast updated a day 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 placement | Waterfall placement | |
|---|---|---|
| Required fields | Placement name |
|
| Optional fields | Not applicable |
|
Bidding setup
Important
You can only create one bidding placement per placement slot.
- Go to Placements from the navigation menu, then select Add placement.
- Enter the Placement name.
- Select your app Platform.
- Select the Ad format.
- Select Bidding as the setup type.
NoteThe 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.
- Select Add Placement.
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.
- Go to Placements from the navigation menu, then select Add placement.
- 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.
- Select your app Platform.
- Select the Ad format.
- Select Waterfall as the setup type.
- Set your geo targeting: select one or more regions, select a pre-made geo collection, or select Global.
- 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.
- Select + Target to add additional geo targets with different prices per placement as necessary.
- Select Placement to add more placements as necessary, and follow the previous step to complete it.
- 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:| Column | Description | Notes |
|---|---|---|
| The two-letter country code for the geo target. Use | Exporting your targets to CSV converts any applied Geo Collections into a list of countries when you re-import. |
| 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. |
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:
- Copy the new bidding Placement ID from the Unity Monetization dashboard.
- Update the Placement ID in your app code or mediation platform configuration.
- 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.