DT FairBid Test Suite allows you to check that your app is set-up properly and ready to mediate using DT FairBid mediation. DT FairBid Test Suite enables you to verify that the mediated networks you chose for the app are fully integrated, that Placements and Instances are set-up as expected and that ads are served successfully.

Showing the Test Suite

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

FairBid.ShowTestSuite();

Once you have launched DT FairBid Test Suite, you are presented with the main screen that contains 2 sections:

• Mediated Networks Integration Status
  To test that all selected mediated networks are properly integrated and ready to serve ads.
• Placements
  To test that all configured Placements and Instances in the Console are properly set-up and run as expected by DT FairBid's auction on a real-time ad request to your test device.
  

  

Mediated Networks Integration Status

The main screen of the Test Suite gives you an immediate idea of your mediated network's integration status. If the screen you see is green and shows a Successful Integration, congratulations! Scroll down to Testing Mediation Placements.

If the screen you see is red, displaying an Unsuccessful Integration, then it means some issues have been encountered with the integration of the mediated networks. It is recommended to fix these issues before going live with your app. Tap the red square for more information and to view the errors.

Successful Integration	Unsuccessful Integration

Troubleshooting Integration Errors

Integrating a mediated network can be tricky and a lot of different issues might occur during this process. If a red screen is shown, this means that not all of your mediated networks are successfully integrated, tap the red square to see more details of the errors encountered. Here is the list of issues the Test Suite can help you identify and how to fix them. 

Missing SDK

Issue Description	Suggested Fix
The DT 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.	To fix this issue, refer to the documentation on how to integrate that specific network into your project.

Not Configured in the Console

Issue Description	Suggested Fix
The DT 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.	To fix this issue, refer to the documentation on how to integrate that specific network into your project.

Missing Credentials

Issue Description	Suggested Fix
For the mediation stack of the DT 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.	To fix this issue, go to the console and make sure you have credentials for the relevant network.

Missing Activities (Android-only)

Issue Description	Suggested Fix
Some SDKs require activities to be added to your manifest.xml file in order to work.	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)

Issue Description	Suggested Fix
Some SDKs require specific permission to be added to your manifest.xml file in order to work.	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.

Testing Mediated Networks Instances

Your mediated networks are now successfully integrated and ready to work with the DT FairBid SDK.  You can use the Test Suite to make sure you can request and show ads from them, using the Instances configured in the console.

To do this:

1. Tap the green square on the main screen
2. Select the network you want to interact with from the list of networks.
3. Find the list of Instances that are used throughout your app.
   The Instances split into two different sections, the Mediation Placements (waterfall Instances) and the Programmatic Mediation Placements (bidding Instances). 

Waterfall Instances

This section lists all of the waterfall Instances which are configured in the console and used throughout your app. You can request and show ads for these Instances using the Request and Show buttons.

Bidding Instances

This section lists all the bidding Instances configured in the Console and used throughout your app.

Placements

The Placements section of the Test Suite provides you with advanced capabilities. You can test that the placements you set up for the app in the console perform as expected.

Tap the Placements section of the main screen to:

• Verify that Placement’s Instances setup is applied correctly according to the setup in Console
• See the actual order of a Placement’s Waterfall Instances taking into consideration the CPM predicted values by the DT FairBid algorithm for Instances you chose to set Auto CPM in Console
• Request an ad for a Placement and see in real-time how the DT FairBid auction runs through the waterfall and bidding Instances, and chooses a winner

Verify Placement Instance Set-Up

To see the configured Placements for your app and verify each Placement setup:

1. Tap the Placement section of the main screen (the blue square)
2. On the next screen, all the Placements configured for your app including the Placement name, ID and Type are displayed

To see Placement and Instance setup:

1. Tap on a Placement
2. Scroll down to see the bidding Instances set for the Placement

For each Instance, the following information is displayed:

• Mediated Network name
• Instance ID as was received when creating the Instance on the mediated network's dashboard and was set in the Console
• Predicted CPM Value - If the Instance is set with an Auto CPM, the predicted value by DT FairBid’s algorithm is displayed. If the Instance is set with Manual CPM, the Manual CPM value is displayed in bold, alongside the predicted value by FairBid’s algorithm if this method was chosen. The Instance is positioned in the waterfall by the CPM values in bold

Running the DT FairBid Auction

To run the DT FairBid auction and verify that the placement delivers ads successfully and instances are being called as expected tap the Request (Show for banner placements) button.

Once you tap the Request button, the DT FairBid auction starts running. First looking for an available ad from the Waterfall instances and then proceeding to the bidders’ auction looking for a bid higher than the Placement floor price or the winning Waterfall instance price.

The Auction status is displayed in the bottom section of the screen while the auction is running. Once the auction ends, the winning Instance is displayed. To view the winning ad, tap Show.

Waterfall Instance Responses

Response	Description
Requesting	Requesting an ad for the Instance
Fill	Instance replied with an ad available to display
No Fill	Instance replied with no ad available to display
Instance Timeout	Instance did not respond in the allotted time, but the SDK is still waiting for a response
Failure	Any failure related to this Instance request: adapter failure, error or capped.

Troubleshooting

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

Caching Mechanism

To start as quickly as possible, the DT FairBid SDK implements a caching mechanism of the console configuration. As a result, you might experience some delay between the moment where you change your console configuration and the moment where the changes are reflected in the SDK.

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