Line Item Setup for MoPub

Overview

To use Super Auction with MoPub as your primary SDK, you’ll need to:

1. Add your Site ID to your app

Ensure your app’s Site ID (DCN) - found in your ONE by AOL: Mobile console - is hardcoded to your MM SDK integration in step 3 in Android and step 7 of iOS.

2. Setup line items in the MoPub console

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.

  • After receiving the bid price via Super Auction’s requestBid API, pass this bid price as a keyword parameter to MoPub. You will need to target this bid price with a line item that is set at the same amount as the bid price.
  • 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 it 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 (MoPub’s default priority level) so that it competes with the rest of your demand. Please note that if you use another priority level as your default, you should use that for this line item. The Network type needs to be set at “Custom Native Network”. The Class and Data that you will enter depends 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 MPMillennialBannerCustomEvent {“adUnitID”:”<placement_ID>”, “dcn”:”<site ID>”, “adWidth”:<width here>, “adHeight”:<height here>}
iOS Interstitial MPMillennialInterstitialCustomEvent {“adUnitID”:”<placement ID>”, “dcn”:”<site ID>”}
Android Banner com.mopub.mobileads.MillennialBanner {“adUnitID”:”<placement ID>”, “dcn”:”<site ID>”, “adWidth”:<width here>, “adHeight”:<height here>}
Android Interstitial com.mopub.mobileads.MillennialInterstitial {“adUnitID”:”<placement ID>”, “dcn”:”<site ID>”}

MoPub_1

Next, set your line item to start immediately. The eCPM should be set at the floor of 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 Marketplace) at $1.00 eCPM.

Publishers will typically set the eCPM for their line items at the floor of the price bucket, which means bid prices may be higher than the eCPM, especially for less granular setups. There may be other methodologies that work better for you (e.g. setting eCPM as an average price).

MoPub_2

Next, target the MoPub ad unit that corresponds to 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. Note that the keyword can be anything you choose; just make sure it’s the same one you are using to send the Super Auction bid to MoPub. In this example, the keyword is ‘sa_keyword’ and the $1.00 line item includes bids from $1.00 to $1.49.

MoPub_4