Test Suite

Introduction

The Test Suite allows you to check if all mediated ad networks are properly integrated in your application and ready to serve and display ads.

 

Showing the Test Suite

Showing the Test Suite is easy. Simply import the FairBidSDK.h header and call the following:

Code to Call
FairBid.ShowTestSuite();

🚧 Important

Make sure you have started the SDK before calling this.

 

Checking your Integration’s Status

The Test Suite’s main screen directly gives you an idea of your integration’s status. If the screen you see looks more like the Successful Integration below, then congratulations, your integration is looking great and you can scroll down to the section about Testing Mediation Placements.

If the screen you see looks more like the Unsuccessful Integration, then it means there are some issues with your integration. It is recommended to fix them before going live with your application.

Successful Integration Unsuccessful Integration
Successful Integration Unsuccessful Integration
 

Integration Issues

Integrating a mediated ad network can be tricky and a lot of different issues might occur during this process. Here are the list of issues the Test Suite can help you find and how to fix them.

 

Missing SDK

Notes Image Suggested Fix
The FairBid SDK requires the mediated ad network’s SDK to work. If the Test Suite mentions that a network is missing its SDK, then it might mean you forgot to drop the network’s SDK into your project. missing sdk To fix this issue, refer to the documentation on how to integrate that specific network into your project.
 

Not Configured in the Console

Notes Image Suggested Fix
The FairBid SDK requires the mediated ad networks to be enabled on the console. If the Test Suite mentions that a network is not configured on the console it means you might have forgotten to enable it and configure it for your application on the console. not configured on console To fix this issue, refer to the documentation on how to integrate that specific network into your project.
 

Missing Credentials

Notes Image Suggested Fix
For the mediation stack of the FairBid SDK to work, the SDK needs to have access to your credentials for the different networks you integrate. If the Test Suite mentions that a network is missing credentials, it means the network was not configured with credentials in the console. missing credentials To fix this issue, go to the console and make sure you have credentials for the relevant network.
 

Missing Activities (Android-only)

Notes Image Suggested Fix
Some SDKs require activities to be added to your manifest.xml file in order to work. missing activities To fix this issue, refer to the integration documentation specific to the faulty network and make sure all its required activities are added to your manifest.xml file.
 

Missing Permissions (Android-Only)

Notes Image Suggested Fix
Some SDKs require specific permission to be added to your manifest.xml file in order to work. missing permissions To fix this issue, refer to the integration documentation specific to the faulty network and make sure all its required permissions are added to your manifest.xml file.
 

Caching Mechanism

To start as quickly as possible, the FairBid SDK implements a caching mechanism of the console configuration. As a result, you might experience some delay between the time where you change your console configuration to when the changes are visible in the SDK.

To mitigate this issue, we advise you to fix as many issues at once and also delete and reinstall your application after every change in the console.

 

Testing your Mediation Placements

Once your mediated ad networks are successfully integrated and ready to work with the FairBid SDK you can use the Test Suite to make sure you can request and show ads from them, using the mediated placements configured in the console.

To do this, select the network you want to interact with in the list of networks. There you should find the list of mediation placements which are used throughout your application. They are split into two different sections, the Mediation Placements and the Programmatic Mediation Placements.

 

Mediation Placements

This section lists all the non-programmatic mediation placements which are configured on the console used throughout your application. You can request and show ads for these placements using the request and show buttons.

Programmatic Mediation Placements

This section lists all the programmatic mediation placements configured in the console used throughout your application.

 

Troubleshooting

Requesting an ad can sometimes fail for many reasons. Below is a list of things to check that can help you get an ad:

Problem Resolution
Console Credentials Make sure you are using the right credentials and mediation placements
Console Logs Mediated ad networks sometimes log tips in the console on how to get ads
Network Documentation Mediated ad networks often provide tips on how to get fills, like specifying test devices through their SDK’s AP (e.g. AdMob) or enabling Test Ads for certain placements (e.g. AdColony)
 
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request