In order to enable deals for prebid, the ad ops setup is slightly different from the standard header bidding setup. Specifically:
From the ad ops side, you’ll create separate orders and line items that target the deal ID key-values. These line items will be at different (probably higher) priorities than your standard header bidding line items.
From the dev side, if your page is using the standard prebid.js key-values, no change or work is required.
In this example we will use the DFP setup to illustrate, but the steps are basically the same for any ad server.
Whenever a bidder responds with a bid containing a deal ID, Prebid.js will generate and attach deal-related key-values to the ad server call in the format:
hb_deal_BIDDERCODE = DEAL_ID.
For example, given the submitted bids, prices, and deals shown here:
bid 1: Bidder = Rubicon, CPM = 1.50, Deal ID = RBC_123 bid 2: Bidder = AppNexus, CPM = 1.20, Deal ID = APN_456
The key-values attached to the ad server call (that the line items will target) will be:
hb_pb_rubicon = 1.50 hb_deal_rubicon = RBC_123 hb_pb_appnexus = 1.20 hb_deal_appnexus = APN_456 // hb_adid, hb_size, and hb_adid omitted
Whether your Ad Ops setup sends all bids to the ad server or just sends the top bid to the ad server, Prebid.js will generate the deal key-values for every bidder. The reason is that you may want to give deals higher priorities in the ad server, which needs to see all deal-enabled bids.
For each header bidding partner you work with, create a keyword in the format of
hb_deal_pubmatic. For more examples of the keyword format, see the API Reference for
In DFP, create a new line item.
Enter all the Inventory sizes for your deal (or deals):
Set the priority to the level you prefer.
Set Display Creatives to One or More since we’ll have one or more creatives attached to this line item.
Set Rotate Creatives to Evenly.
Then you’ll need to target the inventory that you want to this deal to run on.
Use Key-values targeting to target deal ID(s)
There are two ways to target deal IDs using Key-values targeting:
For instructions on attaching creatives to the line item, see Add a Creative.