# Get Started with Unity

## Before You Begin

- Sign up for a [Chartboost Mediation](https://chartboost.com/mediate) (formerly Helium) account.
- Add apps to the Mediation platform. (See [Import Apps](/en/mediation/import-apps/))
- Set up Ad Placements in the Mediation platform. (See [Manage Placements](/en/mediation/manage-placements/))



## GitHub Repository

Our Chartboost Mediation Unity SDK is open source and available on [GitHub](https://github.com/ChartBoost/chartboost-mediation-unity-sdk/tree/main).



## Minimum Supported Development Tools



<table>
	<thead>
		<tr>
			<th>Software</th>
			<th>Version</th>
		</tr>
	</thead>
	<tbody>
		
		<tr>
			<td>Minimum Unity Editor Version</td>
			<td>2022.3.22f1 (2022 LTS)</td>
		</tr>
		
		<tr>
			<td>Minimum Supported Android Version</td>
			<td>API 21 (Android 5.0 Lollipop)</td>
		</tr>
		
		<tr>
			<td>Android Compile Version</td>
			<td>API 34</td>
		</tr>
		
		<tr>
			<td>Gradle</td>
			<td>8.2</td>
		</tr>
		
		<tr>
			<td>Kotlin</td>
			<td>1.9.21</td>
		</tr>
		
		<tr>
			<td>Recommended Java</td>
			<td>17</td>
		</tr>
		
		<tr>
			<td>Minimum Supported iOS Version</td>
			<td>13</td>
		</tr>
		
		<tr>
			<td>Minimum XCode Version</td>
			<td>15</td>
		</tr>
		
		<tr>
			<td>Swift</td>
			<td>5.0</td>
		</tr>
		
	</tbody>
</table>



### 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.

<video controls preload="none" width="480" height="360">
  <source src="/assets/video/Unity_API34_Build_Steps.m4v" type="video/mp4">
</video>




## Integrate Chartboost Mediation Unity SDK

Chartboost Mediation Unity SDK is distributed using the public [npm registry](https://www.npmjs.com/search?q=com.chartboost.mediation) 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.

```json
  "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

1. Go to **Chartboost Mediation > Edit Settings** 
2. 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.