這份文件已更新。
中文(香港) 的翻譯尚未完成。
英文更新時間:2021年11月3日
中文(香港) 更新時間:2021年8月25日

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