Managing Orders and Line Items

In order to monetize your app with MoPub, you will need to set up orders and line items. An Order is a a group of related Line Items, which are also known as campaigns. Line items are campaigns that have different targeting. For example, you receive a Coca-Cola Order for a 728×90 United States Campaign, a 320×50 UK campaign, and a 300×250 United States and UK campaign. Each of these campaigns can be created as a separate Line Item, which rolls up into one Order.

  • The Orders page allows you to create guaranteed orders, promotional orders, non-guaranteed and backfill promotional orders.

  • Please note that MoPub will not provide any of this demand and this should be booked directly through an advertiser.

Each Order has one or more Line Items. A Line Item is a set of creatives and targeting parameters that runs with a specific budget.

Guaranteed

A Guaranteed line item is typically a direct sold line item with a set CPM for a certain number of impressions and a start and end date. (Default is Priority 6)

Promotional

A Promotional line item is for house ads like advertising another of your applications, ads for the paid version of your app or other functions like a “rate this app” line item. (Default is Priority 10)

Marketplace

A Marketplace line item is typically used to set a floor price for MoPub Marketplace for users in a particular geography, or to prioritize Marketplace higher than other network campaigns which default to priority 12. (Default is Priority 10)

Network

A Network line item is typically used to traffick a special or one-time network campaign at a higher priority than your other network campaigns which default to priority 12. This is useful for running a network with a limited budget or for a limited time period. (Default is Priority 10)

Non-Guaranteed

A Non-guaranteed line item is typically used to traffick a campaign without a guaranteed number of impressions. Non-guaranteed line items are set by default to a priority level of 12, and compete with your Ad Networks and MoPub Marketplace as an ad source. (Default is Priority 12)

Backfill

A Backfill line item is typically a promotional line item like house ads that are only used when no other higher priority line items are available. (Default is lowest Priority level, 16)

An Order is a set of Line Items, usually created for an ad campaign. The Order targets one or more Ad Units to display creatives

After logging into app.mopub.com, go to your ‘Orders’ tab. Click on the ‘Add a New Order’ button at the top right.

orders01.png

Name your Order, drop in the Advertiser, and add a short description.

Screen Shot 2014-04-04 at 8.27.02 PM.png

Next, you will create your first Line Item for this Order. Each Order has one or more Line Items. A Line Item is a set of creatives and targeting parameters that runs with a specific budget.

For the Line Item, include the Line Item type & priority, start & stop time, delivery rate, budget and speed. Once the Line Item is created, the type will be locked, but the priority level can be changed.

Day Part Targeting enables you to limit when your campaign runs to specific times and days of the week. You can select up to two different time periods for each line item. Time periods are based on the user’s local time zone.

Screenshot 2014-05-07 13.29.43.png

Now you can select which apps and/or ad units you’d like this Line Item to target. You also have the option of completing this step later.

Screenshot 2014-05-07 15.27.08.png

Add location and device targeting to target users who might meet criteria for country, connectivity, and device.

Screenshot 2014-05-07 15.27.39.png

Finally, you can add criteria to fine-tune the users you wish to reach. You can target users who have or don’t have specific apps, set frequency caps, override the default refresh rate (link to Refresh Rate article), use keywords if your app is sending keywords with the ad request, or allocate the percentage of requests this line item will deliver. Screenshot 2014-05-07 15.25.59.png

You will then be directed to the Line Items page to upload a creative.

Screenshot 2014-05-07 13.28.18.png

If you want to create a Guaranteed Order you must do the following:

Select ‘Guaranteed’ as the Line Item Type.

guaranteedlineitem.png

  • Select the Integer Priority Level from a range of 1-16. All line items on the same priority level will prioritized by eCPM level.

  • Name your line item.

  • Indicate the start & stop time, delivery rate, budget, and speed.

  • Delivery rate can be set to a CPM or a CPC line item. If you set your line item to a CPM, you will be directed to drop in the US dollar CPM with a budget of impressions/day or total campaign impressions. If you set your line item to a CPC, you will be directed to drop in the US dollar CPC with a budget in US dollars/day or total US dollars.

  • Target the appropriate ad units and update ‘Advanced Options’ if necessary.

If you want to create a Promotional, Non-Guaranteed, or Backfill Order you must do the following:

Select ‘Promotional’, ‘Non-Guaranteed’ or ‘Backfill Order’ as the Line Item Type.

Screenshot 2014-05-07 15.37.14.png

  • Select the Integer Priority Level from a range of 1-16. All line items on the same priority level will prioritized by eCPM level.

  • Name your line item.

  • Drop in the start & stop time and delivery rate.

You can manage your Orders & Line Items directly from the Orders page.

  • Checking the box next to each of the Orders allows you to pause, resume, and archive.

  • The ‘Quick Jump’ selection allows you to quickly jump between different Orders and Line Items

  • Clicking on ‘Add a new order’ gives you the ability to create an entirely new Order

  • The Line Item tab shows all line items that are currently running across your Orders

  • The ‘Export’ button allows you to export a report of all of the current Orders.

orders.png

You can manage your Orders & Line Items directly from the Orders page.

  • Checking the box next to each of the Orders allows you to pause, resume, and archive.

  • The Quick Jump button allows you to quickly jump between different Orders and Line Items

  • Clicking on ‘Add a new order’ gives you the ability to create an entirely new Order

  • The Line Item tab shows all line items that are currently running across your Orders

  • The ‘Show’ button allows you to segment the Line Items you would like to look at, including Line Items that are running, scheduled, completed,
    paused, and archived.

  • The ‘Export’ button allows you to export a report of all of the current Orders.

Line Item Settings:

Within MoPub’s dashboard, Orders & Line Item settings can be adjusted on different ad sources for a particular ad unit. Line item types include: Guaranteed (G), Network (N), MoPub Marketplace (M), Promotional (P), Non-Guaranteed (NG), or Backfill Promotional (B).

Line item CPMs and other settings

Adjust CPM values and other line item settings directly in MoPub Dashboard tab using the Quick Edit feature. These sheets offer a shortcut to edit the most frequently used settings for each available line item.

Procedure:

  1. Within the ‘Dashboard’ tab, navigate to the “Edit” column in the Ad Source Breakdown table and select the pencil icon next to the line item you wish to update.

Screen Shot 2014-05-01 at 10.20.42 AM.png

  1. Change CPMs and other key data for that line item in the sheet. The available fields reflect the most frequently used attributes for that particular line item type. For example, a Guaranteed line item will display budgeting fields. While for a Network line item, the Network CPM, Frequency Caps, and Allocation percentages may all be modified.

  1. Save the changes by clicking “Update and Close.” If you wish to make changes to fields not shown in the sheet, select the shortcut link to the specific ad source in the lower left.

Adding Creative to Line Items

After you have created your guaranteed, promotional or backfill promotional Line Items, MoPub will ask you to add creative.  If at any time you would like to add an additional creative, simply click on ‘Add a Creative’ icon on the right hand side.
  • To add a creative, first select the ‘Format’. The format should be the ad unit size creative that you are uploaded.  Please note that if you are uploading a creative for a 320×50, but the line item isn’t targeted to an ad unit with that ad size, the creative will not serve.
  • Next, select the creative type– Image, Text and Tile, or HTML.
After you select the creative type, you will need to do the following:
  • Name the creative
  • Make sure you implement a click-through URL
  • Implement an Impression Tracking URL if your advertiser would like a 3rd party impression tracker
  • Add the App Store URL or Android package if you plan on tracking conversions. Please make sure that you have done the technical work to have conversion tracking setup properly on iOS & Android.
  • Upload the creative
    • Note: there is a 1MB file size limit for direct served creative.
Updated: October 2017