- The Integration Wizard

Sign into the Dashboard

To begin, go to the FairBid Dashboard and log in with the email and password you used to sign up with FairBid. You'll land on the main page of the Dashboard.

Accessing the Integration Wizard

Click on the Start Integrating button.

The Integration Wizard will lead you through the process of selecting networks, and aiding in the setup of information about your app. enter image description here

Step 1: Network Configurations

By default, your app is configured to use the FairBid Exchange (formerly known as Heyzap Exchange).

To configure your app to use additional third party networks, you will need to follow some additional steps.

Selecting AdditionalThird Party Ad Networks

Not all third party networks support every device platform or ad format. Use the Network Selection wizard to select any additional third party networks you will be integrating. At the end of the Integration wizard, you will be presented with specific instructions and links to the third party SDKs which correspond to your selection(s).

  1. Click the Network(s) you wish to enable for your app.
  2. Once you are happy with your settings, click Continue.

enter image description here

Step 2: Adding a New App

Selecting Your Framework

  • Select your framework by clicking the platform icon enter image description here

Please note:

The platform selection indicates which platform you will deploy your build. If you are using a Unity , you will need to pass an Android app id when your app is launched on an Android device. If you are using the REST API, you will need to use an Android app id when requesting offers for an Android device. Once you have selected your framework, it cannot be changed.

Entering Your App Details (Published Apps)

App details identify your app to our system. We use the URL, if provided, to fetch an icon for your app from the Google Play Store. The dashboard also uses the app's name to help you identify your apps.

  1. Enter the name of your app, the url of your app in the Google Play Store or the Android package id (or if using IOs the bundle id) into the search field.
  2. Click Search. to locate and select your app.
  3. Once you are happy with your settings, click Continue. enter image description here

Entering Your App Details (Unpublished Apps)

  1. Click the link You can add your app manually by clicking here.
  2. Enter the name of your app into the Name field. You may use the same name for multiple apps in the dashboard, but we recommend you provide a name which is easily distinguishable from other apps.
  3. Depending on the platform you have selected, you will be need to enter either your Android Package or your Bundle Identifier
  4. Click Add.
  5. Once you are happy with your settings, click Continue.


For Android devices:
Your Android package name can be found in the Google Play Store url. It usually takes the form com.developername.appname.
Example: 'https://play.google.com/store/apps/details?id=com.fyber.mysuperapp'

Package name: 'com.fyber.mysuperapp'

For iOS Your Bundle Indentifier can be found by opening Xcode > select Xcode project > choose Target > "General" tab > Bundle Identifier.

Step 3: Optional: Third Party Network Credentials

Third party network credentials allow FairBid to synchronize and mediate ad formats on your behalf.

For each third party network you have selected to integrate with, you will need to enter specific parameters as required by the third party network. Each third party network has different requirements.

  1. Enter information as required for each element
  2. When you have finished entering the required parameters, click Continue
  3. Continue until all third party networks have been completed.

Please Note:

If you do not have an account with a third party network, you can choose Skip this network, create and account with the third party and edit these settings at a later time under the Mediation Settings.

Step 4: SDK Integration

The framework that you choose includes all of the third party networks. You will need to integrate the downloaded FairBid SDK in your app to use the FairBid platform to monetize your app(s).

  • Click the icon which represents your framework type

enter image description here

Please Note:

When you click the icon which represents your chosen framework, your settings are automatically saved. You can modify them at any time by using the Mediation Dashboard, or relaunching the Integration Wizard.
Clicking the framework icon will also redirect you to the relevant documentation integration guide.

Next Steps

If you need to go back and modify some of your configurations, our documentation can walk you through that.

Otherwise, proceed to the integration guide of your chosen framework.