Unity

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.

Prerequisites

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

Important

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

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

2. Importing FairBid Unity Plugin Raw Package

Integrating Through Unity's Package Manager

This is the recommended method to integrate the DT FairBid Unity Plugin in your Unity project.

The DT FairBid Unity Plugin is provided as a package in the NPM 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.

JSON

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

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

JSON

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

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

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

↓ Unity Plugin 3.66.1

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.

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, you can initialize and show the DT Offer Wall.