Unity Mediation setup checklist

Attention: The Unity Mediation package is no longer available for new installs as of December 2022. Publishers interested in implementing or maintaining a monetization solution are recommended to use Unity LevelPlay via the Ads Mediation package in the Unity Editor. Learn how to integrate Unity LevelPlay with the Unity Editor by installing the Ads Mediation package. Once integrated, refer to the Unity Mediation to Unity LevelPlay migration guide for more details.

Follow this checklist to install, set up, and use Unity Mediation in your app.

Getting started

1On the Monetization dashboard select an organization to use for Unity Mediation, or create a new organization.

Install the Unity Mediation SDK

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.

Configure your app code for Mediation


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

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

Install ad network adapters in the Unity Editor

  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.

Select Unity Mediation as the Mediation Partner in the Dashboard


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.

Set up Ad Sources


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.

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.

Optional: Configure Ad Units in the Dashboard


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.

Create waterfalls in the Dashboard


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

For more information, see Create a waterfall.