Super Auction Beta

Overview

What is Super Auction?

Super Auction is a feature of the Millennial Media Ad SDK that gives you the opportunity to hold a unified auction across AOL’s internal mobile demand prior to calling into MoPub. Essentially a server-side header bidding container for in-app inventory, Super Auction enables your programmatic demand sources to compete head-to-head with your line items and the MoPub Exchange.

How does Super Auction work?

At a high level, the Super Auction flow is fairly straightforward:

  1. After integrating Millennial Media Ad SDK directly in your app, the SDK will call the AOL Super Auction server at ad request time.

  2. Super Auction simultaneously calls every integrated demand partner, including AOL’s unique demand.

  3. Super Auction conducts a unified auction and passes the winning bid back to the MM SDK.

  4. The MM SDK calls into the MoPub SDK, which passes the bid to the MoPub ad server as a keyword parameter. Within the MoPub ad server, line items are setup to target various bid prices, allowing the Super Auction demand to compete with the publisher’s other demand or the MoPub exchange on a per-impression basis.

  5. If the MoPub ad server decides that the Super Auction bid is the best price for that impression, MoPub will call back into the MM SDK, telling it that the bid won. The MM SDK will then display the winning ad. If MoPub decides that another line item has the highest value, then MoPub will handle the request as it does today.

What if I use MoPub for mediation?

If currently use MoPub as an SSP for mediation, using Super Auction means integrating the MM SDK directly in your app code. In other words, you will need to switch out calls with MoPub Ad Unit IDs in your app for calls with Millennial Media Site/Placement IDs. You should not create new Ad Unit IDs for Super Auction. Instead, keep using your existing MoPub waterfall and Ad Unit IDs to ensure that your current demand is competing against Super Auction to yield the highest price for each impression. See How Should I Test Super Auction section for instructions on how to test Super Auction alongside your existing MoPub setup.

What about the Millennial mediation adapter?

If you were previously using MoPub to mediate to Millennial Media demand, do not remove your existing adapters. For Super Auction, there will be both an upstream and downstream MoPub mediation adapter. There’s no harm in having the MoPub to Millennial adapter and the Millennial to MoPub adapter in your application. In the case where you’re using Millennial Media in both a Super Auction and traditional waterfall, both adapters are needed.

How should I test Super Auction?

We suggest that you decide on a set of placements that will be used to replace ad calls to MoPub (i.e. you will be calling Millennial Site/Placement IDs in place of MoPub Ad Unit IDs). Super Auction is designed to work in conjunction with your current, conventional mediation waterfall.

Integration and Setup

Add the SDK to your project

Download the latest version of the SDK and follow the integration instructions to add it to your project.

Android iOS

Add the MoPub Mediation Adapter to your project

Download the latest version of the Millennial to MoPub mediation adapter and follow the integration instructions to add the adapter to your project.

Android iOS

Configuring your Super Auction placements in the One by AOL: Mobile SSP

Because Super Auction is still in beta, Super Auction placement settings are only available to internal users. Please work with your AOL contact to configure your placement(s) for Super Auction.

Configuration in MoPub

With Super Auction, you’ll need to setup line items in the MoPub ad server that correspond with the value of the incoming Super Auction demand. This is done via keyword targeting.

  • Super Auction conducts an auction, and passes the winning bid to MoPub using a keyword parameter. You want to target this bid price with a line item that earns you the same amount if it serves.
  • If you had 1 line item for every bid at penny increments (i.e. $0.01, $0.02, $0.03, etc.), you’d need 1,000 line items just to account for bids from $1 to $10. That level of granularity would give the most accurate representation of the bids, but is unwieldy.
  • Instead, publishers typically use price buckets in varying granularity for the price ranges that matter. For example, interstitial ad placements may earn you $4.50 eCPM on average. You could group bids in 10 cent increments from $3-$4 so that bids of $3.04 or $3.06 would be rounded down into a single price bucket of $3.00. Then you could use 5 cent increments for the more important $4-$5 range for increased accuracy. In that case, a $4.04 bid would be rounded down to the $4.00 price bucket, and a $4.06 bid would be rounded down to the $4.05 price bucket.

For each price bucket, create an order with a new line item in the MoPub ad server and follow the instructions below:

Set the line item to Network and give it Priority 12. The Class and Data that you will enter will depend on the OS and placement type. Please reference the table below and replace the JSON data placeholders with the correct values for your placement.

Type Class Data
iOS Banner MoPubSmartYieldBanner {“adUnitID”:”<placement_ID>”, “dcn”:”<site ID>”, “adWidth”:<width here>, “adHeight”:<height here>}
iOS Interstitial MoPubSmartYieldInterstitial {“adUnitID”:”<placement ID>”, “dcn”:”<site ID>”}
Android Banner com.millennialmedia.clientmediation.MoPubSmartYieldBanner {“adUnitID”:”<placement ID>”, “dcn”:”<site ID>”, “adWidth”:<width here>, “adHeight”:<height here>}
Android Interstitial com.millennialmedia.clientmediation.MoPubSmartYieldInterstitial {“adUnitID”:”<placement ID>”, “dcn”:”<site ID>”}

MoPub_1

Next, set your line-item to start immediately. The eCPM should be set at the floor for the price bucket. In this example, it is set to $1.00. This line item will compete with your other demand on MoPub (as well as the MoPub exchange) at $1.00 eCPM.

MoPub_2

Next, target the MoPub ad unit that corresponds your Super Auction placement. Note that because of the line-item’s placement and OS-specific Class and Data, each Super Auction placement must have its own MoPub ad unit and set of line-items.

MoPub_3

Finally, set your keyword targeting to include all prices within the line-item’s price bucket. The Super Auction keyword parameter for bid price is “sy_bp:”. In this example, the $1.00 line item includes bids from $1.00 to $1.49.

MoPub_4