Unity Mediation setup checklist#

Important: Ensure that you uninstall the Unity Ads SDK and any third-party Mediation SDKs in your project, and then remove direct usage of Unity Ads and other third-party Mediation solutions.

For step-by-step instructions and API references, see the following resources:

• If you are a Unity developer, see the Unity Mediation (C#) integration guide

• If you are an Android developer, see the Unity Mediation Android (Java) integration guide

• If you are an iOS developer, see the Unity Mediation iOS (Objective-C) integration guide

For more information about integrating Unity Mediation with your project, see the Troubleshooting integrations guide. Or, you can Contact Unity Support.

1. In the Unity Editor, open the project you are using for Mediation.

2. Go to Edit > Project Settings > Services > Mediation.

   Note: If you do not see Mediation under Project Settings, review step 3 of this checklist.

3. In the Adapter Configuration section, select and install the ad network adapters that you intend to use. For more information, see Mediation Editor configuration.

4. In the Code Generator Tool section, verify the selected platform and ad unit in the respective dropdown menus to generate a code snippet. Select Copy snippet, and then paste the script into your app code.

Designate Unity Mediation as the Mediation Partner for each project you want to set up to use Mediation.

1. Go to the Monetization dashboard.

2. Go to Current Project > Settings > Mediation partner.

3. Set the Mediation partner to Unity Mediation.

   Important: Failure to change the Mediation partner results in no traffic to Unity Mediation.

   This gives you access to the Waterfalls page, and converts any existing placements to ad units, which you can use to set up waterfalls.

   Note: Converting placements to ad units is not reversible. This conversion does not affect the live version of your project and ads continue to be served.

The requirements for ad source setup vary depending on whether you exclusively use the Unity Ads network, use third-party networks, or a mix of both.

• If you are exclusively using the Unity Ads network, skip to step 7 of this checklist.

• If you are using third-party ad networks, set up each ad network that you intend to use as an ad source:

  • AdColony

  • AdMob

  • AppLovin

  • ironSource

  • Meta Audience Network

  • Liftoff

After you successfully configure your Ad Sources, install adapters, and ensure that the adapters are enabled for use, your Ad Sources are set up from the dashboard side and the SDK side in your project, and your app can request ads from third-party ad networks.

In the Unity Editor, also confirm that you have installed the ad network adapters for each project you want to use with Unity Mediation.

For more information, see Configure an ad source.

Your mediation project comes with default Ad Units to cover different platforms and ad formats (Interstitial iOS, Interstitial Android, Rewarded iOS, and Rewarded Android), so no additional ad unit setup is needed.

To see all Ad Units, on the Unity Dashboard, go to Monetization > Ad Units.

To create additional Ad Units in your project, follow the steps in Configure an Ad Unit.

You are now ready to create waterfalls for your project in the dashboard.

For more information, see Create a waterfall.