This sample app demonstrates the DT FairBid SDK integration best practices. It is aligned with the DT FairBid developer documentation, which we recommend you to read as well.
Please note that when it comes to actually demonstrating the product "DT FairBid" as a monetization platform this sample app might fail due to the fact that ad delivery depends on factors like your country, your device your AAID/IDFA or any other kind of information that ad networks might have collected about you and that are taken into consideration when placing a bid to show an ad to you.
- Prerequisites
- Project Setup
- Set the target platform in Build Settings
- Build and Run
- Navigating the project code
- Mediation
- Support and documentation
- License
- Unity Editor version 2020.*
- Android 4.1 (API level 16)+ (when building for Android)
- iOS 9.0+ (when building for iOS)
*The app will work on unity versions <= 2022 but requires some adjustments to the build and resource files.
You have two different ways to integrate DT FairBid in this Unity project. Choose the one more convenient for you.
Please, note that this sample app is integrating DT FairBid Unity Plugin through the Unity Package Manager. If you want to use the raw Unity Package instead, the one manually downloaded from our developer portal, you will have to remove the dependency to the Unity Package Manager and native SDKs in order to avoid integrating them twice.
Note that this setup is the default for this sample app.
We provide, for your convenience, our Unity Plugin as an NPM package. This package can be imported using the Unity Package Manager.
To achieve that, a dependency to the DT FairBid Unity Plugin is added in the Package manifest file here, along with the new entry in scopedRegistries, so that the dependency can be resolved.
When opening Unity 3D, click on Window -> Package Manager and, in the drop down that lets you select among the repositories, choose In Project. You should be able to see DT FairBid integrated.
The DT FairBid Unity Plugin takes care of adding the dependencies to the native SDKs automatically. This means, DT FairBid for Android and for iOS would be added to your project.
Before building the project, you need to import the FaidBid Unity Plugin. For this, you need to download DT FairBid Unity Plugin from Digital Turbine's developer portal.
Remember to remove the DT FairBid dependency here if importing the raw .unitypackage is your chosen build option.
With this project open in Unity, double-click the downloaded DT FairBid Unity Plugin package (FairBidSDK.unitypackage) file to import the DT FairBid Unity Plugin. When the Import Unity Package window opens, click All to select everything before importing.
After the import is completed, you need to select the target platform (Android/iOS) you wish to run this project on and click on File -> Build Settings.
Follow the platform specific setup in our developer portal
You're now ready to run this project. Click File -> Build and Run. Unity will build the project and run the Sample Unity application in the targeted platform (Android/iOS).
In the folder Assets/Scenes/, we have the following scenes:
- SDK Initialization is located in MainScene
- App id is defined here
- Requesting Banner Ads - BannerScene
- Placement id for Banner Ads is defined here
- Requesting Interstitial Ads - InterstitialScene
- Placement id for Interstitial Ads is defined here
- Requesting Rewarded Ads - RewardedScene
- Placement id for Rewarded Ads is defined here
If you want to test mediation features using this Sample app, there are a couple of steps you will need to take first:
-
Add the 3rd party mediation network configuration from their dashboard to the Digital Turbine's console. Refer to the section Integrating Mediation Partners in Digital Turbine's developer portal for instructions.
-
Integrate 3rd party networks in the project. Go to the mediation network table and select the network you wish to integrate in the sample app. Then follow the instructions respective to the integration approach you choose. There are two different approaches to achieve this:
- Using External Dependency Manager for Unity
- Using Gradle and Cocoapods
Regardless of the platform you're running the sample on, you can always use the Test Suite to double check all the mediated networks were integrated successfully.
Please visit our documentation.
Please, check here.