Unity

Current Plugin Version: 3.67.0

DT FairBid and DT Offer Wall are integrated through the same Unity Plugin: the DT FairBid Plugin.

Prerequisites

• Android 4.4 (API Level 19) or later
• iOS 13 or later
• Unity 2021 or later

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:

• Integrating through Unity's Package Manager (recommended)
• 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, which you can find under the Packages folder:

• Add an entry under scopedRegistries. Unity knows where to search when adding the DT FairBid Unity Plugin dependency. This entry points to the NPM package registry.

JSON

{
    …
    "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.67.0",
        …
    }
    …
}  

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. To cross-check the integration of DT FairBid, navigate to the Unity 3D Window toolbar menu and click 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 to download the DT FairBid Unity Plugin package manually.

Manual Download

Unity Plugin 3.67.0

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.

Using the External Dependency Manager (EDM4U)

The External Dependency Manager for Unity (EDM4U), previously known as the Unity Jar Resolver, is an open-source tool that automatically manages native Android and iOS dependencies.

Declaring Network Dependencies

To declare network dependencies:

1. Create a new XML file.
2. Name the file with a Dependencies.xml suffix, for example, FairBidMediationDependencies.xml.
3. Add the file to the Editor folder.
4. Copy the required XML snippet for your selected network to the XML file. To generate the required XML snippet, see Supported Networks.

Resolving Dependencies

Dependency resolution works differently on Android and iOS; follow the instructions in the appropriate tab below.

Android

Dependencies resolve automatically for Android.

(Optional) To force dependency resolution:

• Go to Assets→External Dependency Manager→Android Resolver→Force Resolve.

iOS

EDM4U automatically resolves all the dependencies declared in a specific .xml file and adds the respective entries to your Podfile. In iOS, resolution occurs when you export the project.

To avoid compilation errors, configure the following iOS Resolver settings:

1. Navigate to Assets→External Dependency Manager→iOS Resolver→Settings.
2. Deselect the Link frameworks statically checkbox.

If you do not deselect this option, you may encounter a compilation error about missing the FairBidSDK/FairBidSDK-Swift.h file.

1. Open the .xcworkspace file in Xcode, not the .xcodeproj file. EDM4U creates the .xcworkspace file when it builds the project.
2. Locate the Podfile in the build folder and run pod install when the .xcworkspace file does not appear to generate .xcworkspace.

In addition to integrating the DT FairBid SDK, you must integrate chosen third-party networks' SDKs into their app.

• Set up your app in the network's dashboard and in the DT Console. For more information, see Setting Up DT FairBid.
• Download the relevant network's SDK. For more information about supported networks and their SDKs, see Supported Networks.

  • You must add additional configurations for each third-party network.
  • These entries are found by selecting your third-party networks in the table.

The DT FairBid SDK automatically detects and initializes SDKs from third-party networks.

Once you've added all third-party SDKs and set up your app in the console, you can initialize the DT FairBid SDK.