Header bidding line items

Last updated July 11, 2018

Note: Some features mentioned here may not be available in your region or based on your user roleA grouping of user capabilities that describe the tasks a user can perform in OpenX.. For more information, please visit the OpenX Support Community.

If you are using OpenX Ad ServerA complete digital advertising platform where publishers sell, manage, and deliver their advertising inventory across all digital formats., you can now set up dynamic price line items to deliver on bids from header bidder partners by turning on the Header BiddingA monetization tool that exposes each impression to programmatic demand before calling the ad server. This lets publishers realize the true value of their direct and indirect inventory in real time. option in a line itemThe primary unit of execution for an order, which represents a specific inventory purchase and the required conditions for ad delivery..

If this option is selected, the line item will be a non-guaranteed line itemFourth priority buying model, which does not reserve inventory. AKA “remnant line item.” that accepts a minimum bid that you specify. The line item is triggered by a specified bid keyA free-form string you associate to a header bidding line item, mapping it to a bid. It consists of a maximum of 20 lowercase characters.. The line item is not set at a specific price, but passes a dynamic price from a matching bid. This allows the line item to compete in the Ad Server at the accurate price with the OpenX Ad Exchange.

The actual bid prices will be captured in reporting. You can check on performance using a line item Bid Performance Report or Custom Key Value Report to see what was passed in and how many times.

Before you decide to use OpenX header bidding line items, you need to know a few things:

  • You will need to work with your header bidder partner(s) to set up header bidding on your pages.
  • Header bidding line item prices must be in CPMCost per mille, a pricing method which calculates cost based on the number of impressions (per 1000). only. You cannot pass in prices in micros or any other format. If needed, you must set up a conversion to CPM before passing the price from the header bidder to OpenX.
  • Header bidding line items are non-guaranteed only. You cannot set up guaranteed header bidding line items.
  • You can set up only one key value (the Bid Key) per line item.
  • The Bid Key is considered a custom key by OpenX. Make sure to manage your custom keys appropriately and avoid collision of keys.
  • To report on the custom keys of your header bidding line items, you will need to have them whitelisted by OpenX. To complete this task, please open a support ticket through the OpenX Support Community

Note: The Custom Key Value Report has limitations on the amount of key values it stores before it aggregates them.

Before setting up header bidding line items:

  • Work with your header bidder partner(s) to get the header bidder code.
  • Request the key value(s) to be whitelisted by OpenX.
  • Implement your header bidder code.

To create a header bidding line item:

  1. Go to Orders in OpenX Ad Server and select the account that owns the order to which you would like to add a line item.
  2. The View Order screen opens.

    OpenX's View Order Screen

  3. Click Add Line Item to open the Create Line Item form.
  4. The Create Line Item form is organized into four main sections:

    • Line Item Details
    • Delivery Settings
    • Targeting
    • Summary on the right side for easy review
  5. Enter a unique name for the new line item and provide a description to help others recognize it.
  6. Choose the Inventory Type that this line item should run on, like Mobile or Web. Each line item can run on one type of inventoryAd space available on a website or app. The basic unit of inventory for OpenX is an ad unit..
  7. After you save the line item, you cannot change this setting.

  8. Click the Header Bidding switch to set it to On. This will enable the rest of the settings you need to create a header bidding line item.
  9. When you turn on header bidding for the line item, the Buying ModelFor Publishers: The terms under which a specific inventory purchase is made, as well as the priority order in which OpenX considers a line item for selection, including: 1. Guaranteed – exclusive; 2. Guaranteed – share of voice; 3. Guaranteed – volume goal; 4. Non-guaranteed – preferred access; 5. Non-guaranteed; 6. House. For Demand Partners: A framework for purchasing inventory. All Demand Partners can buy on open auctions that are accessible to any members of the OpenX Ad Exchange. If enabled by OpenX to use the Programmatic Direct framework, Demand Partners can also buy in private marketplaces from publishers with whom they have purchasing deals. automatically defaults to Non-Guaranteed.

    Line Item Details with Header Bidding

  10. Set a Minimum Bid in CPM, which is the minimum acceptable price for an opportunity to activate this line item. For example, if you set up the line item to have a minimum bid price of $3.00 CPM and during ad requestCommunication from a web browser or app to an ad server to display an ad., you send in 2.99 as the price in the key value, the line item will not be activated.
  11. Set an Impression GoalThe maximum number of impressions to deliver for a line item in a single day (per day) or over the duration of the line item’s flight (total). When a line item reaches a daily impression goal, it is temporarily ineligible for ad selection. For example, if you set the daily impression goal to 5 and the line item reaches 5 impressions in a single day (e.g., on day 5 of a 20 day flight), then the line item is not available for ad serving for the rest of the day. However, the line item becomes eligible again for ad serving on day 6. When a line item reaches its total impression goal, no matter which day of the flight, it is no longer available for ad serving. for the line item. Type in the maximum number of impressions to deliver for this line item in a single day (per day), or over the duration of the line item's flight (total), or both.
  12. Enter a Bid Key. The Bid Key is a custom key with a maximum of 20 characters. Characters must be lowercase.
  13. Example: index300x250

  14. Continue completing and targeting the line item as described in Creating line items.
  15. Test your line item, with the help of your header bidder partner. Contact OpenX if needed. You can run Custom Key Value and Ad Server Reports to review performance and compare results with numbers from your header bidder partner.


Fill out my online form.