Create and manage placements
Create and manage placements in the Unity Monetization Dashboard.
Read time 4 minutesLast updated 6 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 each placement supports only one setup type. Because waterfalls are no longer supported, new placements can be set up only for bidding. Existing waterfall placements keep their original setup type until you switch them to bidding or archive them.
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 create only bidding placements. Waterfall placements are unavailable.
| Bidding 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.
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.
Transition waterfall placements to bidding
As waterfall placements are no longer supported, you can no longer create waterfalls or edit existing ones that aren’t converted to bidding. Existing waterfalls continue to serve ads.
Cross-reference existing waterfall placements
To review your waterfall placements, follow these steps from the Reporting page of the Unity Monetization dashboard.
- Go to Reporting > Unity Ads report.
- Select Dimensions > Placements.
- Select + Add Filters, then filter Placement type by Waterfall. Click Apply.
A list of all existing waterfall placements in use within your app is filtered. Use this information to transition your monetization strategy from waterfall to bidding.
To update your placement IDs to support bidding, choose one of the following options:
- Switch waterfalls to bidding (recommended)
- Archive waterfall placements and recreate as bidding placements
- Leave waterfall placements as they are
Switch waterfalls to bidding
Switching your existing waterfall placements to bidding placements is the recommended best practice to continue earning revenue in your app with minimal effort to change your setup from the Unity Monetization Dashboard.
To switch a waterfall placement to bidding, do the following in the Unity Monetization Dashboard:
- Select Placements to open the placements page, then click the Waterfall tab.
- Locate the waterfall placement you want to change to a bidding placement from the waterfall placements list.
- Click the ellipses (...), then select Switch to bidding.
- Select Continue in the confirmation dialog.
- Enter a new placement name for the bidding placement, then click Save.
- Repeat steps 2-5 for all waterfall placements you intend to convert to bidding placements.
All waterfall placements you convert to bidding placements are visible from the Bidding tab of the Placements page.
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.
Depending on your mediation partner's requirements for supporting Unity Ads bidding, this might require an app update.
Archive waterfall placements and create new bidding placements
If a waterfall placement is no longer generating significant revenue, the recommended best practice is to archive it from the Unity Monetization dashboard. Then, create a new bidding placement from the New Unity Dashboard to maximize your app revenue.
Archive waterfall placements
To archive an existing waterfall placement, do the following:
- From the Unity Monetization dashboard, review your existing waterfall placements from the Reporting page. Take note of waterfall placement IDs to archive.
- Select Placements to open the placements page, then click the Waterfall tab.
- Locate the waterfall placement you want to change to a bidding placement from the waterfall placements list.
- Click the ellipses (...), then select Archive ad unit.
- Select Archive in the confirmation dialog.
All waterfall placements you archive are visible from the Archived tab of the Placements page.
Create new bidding placements
Go to the New Unity Dashboard and create a new bidding placement. Ensure to map each new bidding placement into your mediation partner dashboard after creating it.
Repeat this step until you have all the desired bidding placements to account for the archived waterfall placements.
Update app code and mediation platform placement IDs
To update your placement IDs after archiving waterfall placements and creating new bidding placements, do the following:
- In your app code, remove the waterfall placements and replace it with the corresponding bidding placements you created.
- In your mediation platform, update your former waterfall placement IDs to reference the corresponding bidding placement IDs.
Leave waterfall placements as they are
You can leave your waterfall placements unchanged. They will continue to serve ads, but are no longer editable. No SDK or configuration update is required for this option.