# Unity

{% hint style="info" %}
**Current Plugin Version: 3.66.1**

DT Offer Wall and DT FairBid are integrated through the same Unity Plugin: the DT FairBid Unity Plugin. Apps with an existing FairBid integration can proceed directly to the [Offer Wall Configuration](https://docs.digitalturbine.com/dt-offer-wall/publishers/dt-offer-wall-sdk/sdk-apis).
{% endhint %}

## Prerequisites

| PLATFORM | REQUIREMENT                           |
| -------- | ------------------------------------- |
| Android  | Android 4.4 (API Level 19) and later. |
| iOS      | iOS 13 and later.                     |
| Unity    | Unity 2021 and later.                 |

{% hint style="warning" %}
**Important**

Integrating DT FairBid for Unity iOS development requires a macOS environment. Building your iOS/Xcode project is not supported on Windows.
{% endhint %}

### Tooling

When integrating the FairBid SDK into your Unity app, make sure your development environment meets the following minimum compatibility requirements.

| UNITY EDITOR | ANDROID SDK  | KOTLIN | GRADLE | JDK | AGP   |
| ------------ | ------------ | ------ | ------ | --- | ----- |
| 2022.3       | API Level 19 | 2.1.0  | 7.6.3  | 11  | 7.4.2 |
| 2021.3       | API Level 19 | 2.1.0  | 7.6.3  | 11  | 7.4.2 |

While FairBid *may* work with other Unity Editor versions, DT tests FairBid against these specific versions. Additionally, the recommended tooling (JDK, Gradle, and AGP) versions reflect the defaults included with each Unity version. These can be overridden, but DT recommends using these versions to avoid conflicts in your build process.

## Integration

Digital Turbine supports two methods for integration in Unity:

1. [Integration through Unity's Package Manager](#integrating-through-unitys-package-manager)
2. [Importing FairBid Unity Plugin Raw Package](#importing-dt-fairbid-unity-plugin-raw-package)

### Integrating Through Unity's Package Manager

{% hint style="success" %}
This is the recommended method to integrate the DT FairBid Unity Plugin in your Unity project.
{% endhint %}

The DT FairBid Unity Plugin is provided as a package in the [NPM](https://www.npmjs.com/package/com.fyber.fairbid.unity) package registry. This package is imported using Unity Package Manager.

To import the package:

1. Add the following entries inside your `manifest.json` file, which you can find under the `Packages` folder:
   * Add an entry under `scopedRegistries` so Unity knows where to search when adding the DT FairBid Unity Plugin dependency. This entry points to the NPM package registry.

{% code title="JSON" %}

```json
  {
  "...": "Existing parameters",
  "scopedRegistries": [
    {
      "name": "npmjs",
      "url": "https://registry.npmjs.org/",
      "scopes": [
        "com.fyber.fairbid.unity"
      ]
    },
    "..."
  ],
"..."
}
```

{% endcode %}

* Add an entry under `dependencies`, which references the DT FairBid Unity Plugin version that you intend to integrate.

{% code title="JSON" %}

```json
{
   "..."
    "dependencies": {
        "com.fyber.fairbid.unity": "3.66.1",
       "..."
    }
    "..."
}
```

{% endcode %}

2. Save the changes and open your Unity 3D Project. The Unity Package Manager resolves the dependencies, and now the **DT FairBid Unity Plugin** is integrated into the project.
3. Cross-check the DT FairBid integration in Unity 3D Project by going to **Window→Package Manager**. The Package Manager window shows **DT FairBid** under the **DT** section and the DT FairBid Unity Plugin version.

You can also change the DT FairBid Unity Plugin version you are integrating through the Unity Package Manager.

### Importing DT FairBid Unity Plugin Raw Package

Follow the instructions below manually to download the DT FairBid Unity Plugin package.

### **Manual Download**

{% @dt-download-buttons/FairBid-Download-Button-unity %}

#### **Removing Current Plugin**

If you are updating the Plugin:

1. Make sure there is no trace of the previous version of the DT FairBid Unity Plugin.
2. Remove the `FairBid` folder. This is a fail-safe way to ensure no legacy file is left behind.

<div align="left" data-with-frame="true"><img src="https://592572939-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7drDlNSyycpmA7Zx8kgX%2Fuploads%2FCelws8MPbzoyKgICw0XU%2F67626ea-Unity1.png?alt=media&#x26;token=ff1a12b3-3f67-451e-8f30-d4c5ac478115" alt=""></div>

#### **Importing New Plugin**

1. Download the DT FairBid Unity Plugin.
2. Unzip the downloaded files.
3. Add the `FairBid.unitypackage` to your open Unity project.

Once you've added the DT FairBid Unity Plugin and [set up your app in the console](https://docs.digitalturbine.com/dt-offer-wall/publishers/app-setup-in-the-web-dashboard), you can [initialize and show the DT Offer Wall](https://docs.digitalturbine.com/dt-offer-wall/publishers/dt-offer-wall-sdk/sdk-apis).
