Integration

In-house mediation is not publicly available

In-house bidding with Audience Network is currently in Closed Beta and is not publicly available. We'll provide further updates if this changes.

As an alternative, you can access Audience Network Bidding through one of the mediation platforms we partner with.

Getting Started

Implement Waterfall and WaterfallEntry - Bidding Kit 3.0 requires these two interfaces to read and interact with waterfall.
Implement ABTest and ABTestSegment to enable AB-testing support (using AbAuction).
Initialise the system (BiddingKit.init)
Create Bidder and Auction (or AbAuction)
Run the remote auction - when the app is launched, and after the waterfall is updated on client side
Pre-load ads - as you would normally, using the updated waterfall retrieved once the auction has finished

Components

Waterfall and Waterfall Entry

Bidding Kit 3 needs to interact with your waterfall setup. A Waterfall represents the ordered list of traditional waterfall line items based on their historical eCPMs. Audience Network calls each entry as WaterfallEntry. A simple waterfall may look something like this:

Network	eCPM
A	$10
B	$9
A	$8
C	$7
B	$6

Each entry has the network information (for example, Name) and the eCPM, as either a historical average or real time. We have the ability to modify the waterfall and insert/delete entries to/from the list. Bidding Kit 3 adds new entries in the list for each bidder. The final list will look similar - different entries ordered by eCPM except that it'll also contain the bidder entries with real-time price.

Network	eCPM
A	$10
FB Bidder	$9.50
B	$9
Bidder 1	$8.50
A	$8
C	$7
Bidder 2	$6.20
B	$6

Bidder

A bidder represents a real time bidding ad network: Bidding Kit 3.0 integrates with Facebook, AppLovin, Tapjoy, Chartboost, Ironsource and Vungle. BK3 handles sending requests to the bidders, and has the ability to give a real-time price for an ad opportunity.

Auction

Auctions for real-time bidders are run on the server side in Bidding Kit Server.

Bidding Kit 3 will deliver new entries to you, for publishers to select the entry that fills with the highest price. This logic should be implemented by you; then let us know, through the API call, which entry was selected as the winner before displaying the ad.

ABAuction - A/B Test

Bidding Kit 3.0 provides the ability to A/B test, to check the incremental gains from adding new bidders to the current setup. For this, you have the ability to equally split your users into multiple segments so that each user should belong to the same segment for each request until the time of the test.

Audience Network’s SDK can have different setups of bidders for different segments. The following diagram shows an A/B test setup between waterfall and 3 new bidders using Bidding Kit 3.0.

Bidders and Ad Formats

Partner	Banner	Interstitial	Medium Rectangle	Native	Native Banner	Rewarded Video	Instream Video
Facebook	Yes	Yes	No	Yes	Yes	Yes	Yes
AppLovin	Yes	Yes	Yes	No	No	Yes	No
Chartboost	Yes	Yes	No	No	No	Yes	No
Ironsource	No	Yes	No	No	No	Yes	No
Vungle	No	Yes	No	No	No	Yes	No
Tapjoy	No	Yes	No	No	No	Yes	No