UI Setup for Mobile DSPs

Bidders should use this information after API integration to configure their UI and begin conducting bids.
As always, the Oath Ad Platforms SSP Demand Services staff is available to provide assistance.

Technical Considerations

Maximum Auction Time

For the protection of our publishers and their users against excessive latency, the Oath Ad Platforms SSP enforces a time limit on each auction. The timing begins when each bid request is issued. Any bid responses not received within the allotted time window will be flagged as a timeout and not eligible to participate in the auction. Frequent bidder timeouts can have a negative effect on overall SSP performance and therefore must not be used by bidders as an intentional means of communicating no-bids.

Currently, the auction time limit is 200ms, but this is subject to change. Oath reserves the right to disable bidders with unusually high levels of timeouts.

Connection Management

HTTP connection management is a substantial factor in participating in an RTB Auction. One of the simplest and most effective ways of improving connection performance is to enable HTTP Persistent Connections, also known as HTTP Keep-Alive. This has a profound impact on overall performance by reducing connection management overhead as well as CPU utilization for both bidders and the Marketplace.

Oath reserves the right to disable bidders not using HTTP Keep-Alive.

Using the Interface

There are a number of settings you can use to customize the UI.

Traffic Control

Bidders influence various aspects of RTB functionality using the Traffic Control settings presented in the table below. The first three settings listed are generally referred to as configuration settings. The configuration settings are established prior to enabling RTB traffic and tend to be rarely adjusted thereafter. The remaining traffic control settings allow bidders to filter the bid requests sent to them from the Marketplace. Traffic can be filtered by auction type, country of origin, and/or content category of the site. Traffic meeting these filter criteria can also be rate limited to a maximum number of bid requests per second.

Setting Description
Bid Request Base URL Base URL for receiving bid requests.
Win Notice URL Win notice URL used by default if not specified in bid response.
Bid Price Units Bid pricing units if not specified in bid response, default to $CPM
Rate Limit (QPS*) Maximum bid requests per second (0 suspends); default is unlimited
Auction Types Auction types allowed – 1st Price, 2nd Price Plus, or Both (default)
Site Types Filter by site type; Mobile Web, Application, or All
Bid Request Objects Choose to receive Banner/Interstitial objects, Video objects, or all objects
Location Filter Block bid requests that do not have location information
Ad Size(s) Choose which ad sizes you wish to receive traffic from
User ID Preference Only receive traffic that has Device ID for in-app and/or matched users for Mobile Web (for DSPs utilizing User Matching)
Country List List of countries on which to filter; default is null
Country Filter Type Specify whether the country list is a block list or a white list
Country Group Name Name your country groupings
Content Category List List of site content categories on which to filter; default is null
Category Filter Type Specify whether the content category list is a block list or a white list
Publisher Filter Choose publishers to white list or block
Publisher Filter Type Specify whether the list is a block list or white list
Site Filter Choose sites to white list or block
Site Filter Type Specify whether the list is a block list or white list
*Rate limiting is approximate.  

Bidder Configuration

Allows you to change an endpoint and enter an optional Win Notice URL.


Traffic Filters - Give you control over volume limits, types of auctions and several other filtering options which help to maximize relevant traffic.

Country and Country Groups Filters - Allow you to White list or Block Countries or groups of countries as well asset a max QPS. Example: Mexico, Canada and USA are whitelisted, USA traffic is set to a max QPS of 4000 and the group Mexico/Canada is set to a max QPS of 3000. New "Country Groups" can be added using the "+ New Country Group" button. "Country Groups" can be removed using the trash icon to the right of each group. Countries can only be in one Country Group.

Content Categories Filter - IAB Tier 1 Content Categories can be white listed or blocked.

Nexage Connect - If you contract with any of the 3rd party data providers currently integrated into our Marketplace they will be visible here.

Publisher and Sites Filter - White list or block publishers and/or individual sites in this section.

In the example below, this configuration is block listing the publisher “Erica’s Test Company” and whitelisting the site “Becca’s Test App” from the publisher “A Test - update 1201 1”.
NOTE: We do not recommend white listing only one site, but for the purpose of this example, this bidder would only receive traffic from the site “Becca’s Test App”.

Please submit a request to your Account Manager if you have any questions about filtering.

The next step is to set up and run Reports.
For documentation on Reporting see Monitoring Performance in the UI for DSPs in the help center.

Have more questions? Submit a request