Unity Ads

If you plan to use the MoPub SDK to load and display ads from Unity Ads via mediation, use this article for integration instructions and information unique to the ad network. To learn more about how MoPub mediation works, refer to our MoPub Network Mediation article.

Supported Ad Formats

Unity Ads currently supports the following ad formats. For support information, visit the Unity Ads homepage.

MoPub Formats Unity Ads Ad Formats
Banner Banner
Interstitial Interstitial
Rewarded Ad Rewarded Video

Download and Integrate

To download the Unity Ads adapters, navigate to the Mediation Integration Tool. You must also download the Unity Ads SDK:

  • Download the Unity Ads SDK for iOS

  • Download the Unity Ads SDK for Android

    Unity Ads adapters are released as an Android Archive (AAR) file starting with version The AAR includes any required Manifest data for Unity Ads. As a result, you no longer need to update your AndroidManifest manually for any generic data, such as permissions and Activities. Any other app-level placement configuration required by Unity Ads must be manually entered into the AndroidManifest.

For the latest download and integration instructions, consult Unity Ads’ tutorials before you integrate the SDK and adapters.

Set Up Unity Ads on the MoPub Dashboard

  • Game ID and Placement ID are required.
  • Placement ID is backwards-compatible with Zone ID.

Network Reporting and Auto CPM

The following setup is required to take advantage of Auto CPM. To enable Unity Ads network reporting and Auto CPM:

  1. Navigate to the MoPub UI’s Networks tab. (Refer to these additional instructions that provide more detail for the remaining steps.)

  2. In the Network settings page for Unity Ads:

    • enable reporting access

    • provide the API Key and Organization Core ID; you can find them within Unity Ads as shown below:

      unityads-reporting-1 unityads-reporting-2

  3. Navigate to the Auto CPM preferences page and turn on Auto CPM.

Migrate to the Unity Ads Monetization Stats API

If you set up Unity Network Reporting before May 18, 2020, you are connected to their legacy Applifier API, which is being sunset by Unity Ads on July 1, 2020. You must migrate to Unity’s new Monetization Stats API to maintain your connection to network reporting and Auto CPM. To migrate:

  1. Select Unity Ads within the Networks tab.
  2. Under Reporting Access, enter your API Key and Organization ID for Unity Ads’ new Monetization Stats API.
  3. Save.

Migrate Unity Ads from Custom Native Setup

  1. Transfer Game ID and Placemet ID (if applicable) from the old custom native connection to the supported Unity Ads instance. Note that if you are using Unity Ads 1.x, Unity Ads has renamed Zone IDs to Placement IDs. You can input Zone IDs in the Placement ID input field, and MoPub will handle the conversions.

  2. MoPub will initiate the following Unity Ads mediation adapter class names to render the ads:

    • iOS

      • UnityAdsInterstitialCustomEvent
      • UnityAdsRewardedVideoCustomEvent
    • Android

      • com.mopub.mobileads.UnityInterstitial
      • com.mopub.mobileads.UnityRewardedVideo

    If you are manually entering these class names, migrate to the new network setup and pause the Custom Native Network. If you are using your own mediation adapter class names, make sure that both the old custom native network and the new Unity Ads network UI are set up for backward compatibility.

Important: During migration, make sure the custom native network and the Unity Ads network are not both live at the same time, because this may impact your revenue.

Test an Ad

We recommend that you test your Unity Ads integration using MoPub mediation test mode to verify that the adapter works as expected. Test mode must be set up on both the MoPub side and the Unity Ads side.

Set Up Test Mode on the MoPub Side

Refer to our Mediation Test Mode article for complete details on using this mode.

Set Up Test Mode on the Unity Ads Side

The Unity Ads UI supports a global test mode, which you can enable for each platform, and target to specific test devices. For instructions on enabling test mode in the Unity Ads UI, refer to the Unity Ads instructions for testing. Note that test mode is applied to your project globally, but will only serve test ads to the test devices you have set up.

Enter your test device details in the Unity Ads UI to ensure that test ads are delivered only to your test device. Refer to the Unity Ads instructions for enabling a device for testing in the Unity Ads UI.

Additional Support

For inquiries and support, visit Unity Ads’ support center.

Last updated August 28, 2021

TWITTER, MOPUB, and the Bird logo are trademarks of Twitter, Inc. or its affiliates. All third party logos and trademarks included are the property of their respective owners.

© 2021 MoPub (a division of Twitter, Inc.)