Get started with Unity Ads in-app bidding in Unity LevelPlay
Integrate Unity Ads in-app bidding with LevelPlay.
Read time 2 minutesLast updated 4 hours ago
To set up Unity Ads for in-app bidding in Unity LevelPlay, you can either:
- Use the automated setup, which is the recommended best practice. For more information, refer to the Unity Ads integration guide in the ironSource Knowledge Center.
- Use the manual process outlined in this guide.
Manual in-app bidding setup
1. Install the required adapter version
Install a LevelPlay adapter that supports Unity Ads SDK version 4.6.1 or above for the best performance on bidding. Get the adapter from the Unity Ads Change Log in the ironSource Knowledge Center.2. Create a Bidding Placement in the Unity Ads Monetization Dashboard
Use a Bidding Placement for third-party-mediated projects to receive the most competitive bid for your ad space. Unlike traditional waterfalls, where mediation platforms prioritize ad networks based on manual targets set by the publisher, bidding allows for a fair auction where multiple ad networks can compete in real-time for impressions. The ad network with the highest bid wins the bid request. To create a Bidding Placement:Important
A single Ad Unit can't include both Bidding and Waterfall Placement types at the same time. The recommended best practice is to add a new Ad Unit to create a Bidding Placement type. To create a Waterfall Placement type, the recommended best practice is to add a new Ad Unit, archive the preferred Ad Unit's Bidding Placement type, or move the Placement to a different Ad Unit.
- Go to the Monetization dashboard and select Placements > Add Placement.
- Select Bidding and enter the Placement Name.
Note
You don't need to set up a price or geo target for Bidding Placements.
- Select Add Placement.
Managing Placements
On the Placement Management page, select the more menu next to the preferred Placement to:- Edit Placement, including Placement Name
- Archive Placement
NoteYou can't unarchive a Bidding Placement for an Ad Unit that already supports a Waterfall Placement. You also can't unarchive a Waterfall Placement for an Ad Unit that already supports a Bidding Placement.
- Change Ad Unit
NoteYou can change or move a Placement to a different Ad Unit with the same platform. Moving Placements won't change Placement IDs, so you do not need to update the IDs in your mediator.
Troubleshooting Placements
If a Placement doesn't switch from bidding to a traditional waterfall after you change from LevelPlay to another mediation partner, this will cause the following load error to display when trying to load a placement:This error indicates that theHeader bidding load invocation failed: adMarkup is missing; objectId is missing
adMarkupobjectId- If you are using bidding, check that your integration is correct.
- If you are not using bidding, use the traditional waterfall Ad Unit/Placement to request ads. You can create traditional waterfall Ad Units/Placements on the Monetization dashboard.