Get Started with Unity

Before You Begin 🔗

Sign up for a Chartboost Mediation (formerly Helium) account.
Add apps to the Mediation platform. (See Import Apps)
Set up Ad Placements in the Mediation platform. (See Manage Placements)

GitHub Repository 🔗

Our Chartboost Mediation Unity SDK is open source and available on GitHub.

Minimum Supported Development Tools 🔗

Software	Version
Xcode	14.1
Android Studio	2020.3.1+
iOS	11.0+
Minimum Android API Level	5.0+ (API level 21)
Targeted Android API Level	13.0+ (API level 31)
Minimum Unity Version	2021.3.36f1 (2021 LTS)
Gradle	7.6
Kotlin	1.7.20
Swift	5.0+

API 34+ Compatibility 🔗

Many of our Partners have transitioned to using newer versions of Gradle than what is currently supported by our minimum Unity Editor version of 2020.3. In the event that you encounter Gradle related problems when compiling for API 34+, we recommend one of the following solutions.

Upgrading to Unity 2022.3 🔗

Upgrading to Unity 2022.3 will get the latest set of Android tools compatible with the newest adapters and libraries.

Android Studio AGP Upgrade Tool 🔗

A workaround using Android Studio’s Android Gradle Plugin Upgrade Tool will allow you to upgrade your Gradle version from 6.1.1, to anything higher. We have documented the process in a short video where we upgrade from AGP 4.0.1 to 8.1.2.

Integrate Chartboost Mediation Unity SDK 🔗

Chartboost Mediation Unity SDK is distributed using the public npm registry as such it is compatible with the Unity Package Manager (UPM). In order to add the Chartboost Mediation Unity SDK to your project, just add the following to your Unity Project’s manifest.json file. The scoped registry section is required in order to fetch packages from the NpmJS registry.

                  "dependencies": {
    "com.chartboost.mediation": "4.9.0",
    ...
  },
  "scopedRegistries": [
    {
      "name": "NpmJS",
      "url": "https://registry.npmjs.org",
      "scopes": [
        "com.chartboost"
      ]
    }
  ]

              

Add Your Mediation App ID and App Signature 🔗

Go to Chartboost Mediation > Edit Settings
Add your Mediation App ID and Mediation App Signature

Make sure that these are the Mediation AppId and AppSignature values that you obtain directly from your Mediation Dashboard for your app as opposed to credentials from Chartboost or any other Ad Network.