Overview

Header Bidding with prebid.js allows you to connect Equativ as a bidder to the prebid.js wrapper in the header of the page while using your primary ad server (Google Ad Manager, Xandr, etc.) to display either Equativ's winner ad, a winning ad from another SSP (bidder), a direct campaign or another RTB ad. This type of usage is what Equativ calls “Header Bidding standalone”. The setup of header bidding is done client-side and in Monetization.  

A guaranteed deal (also referred to as “programmatic guaranteed”) is a deal type with a fixed price where the buyer commits to buy 100% of the impression volume. 

This article describes all the steps to set up guaranteed deals in “Header Bidding standalone” implementations.  

Enabling guaranteed deals

If you are using Equativ's Header Bidding in “standalone” mode, the guaranteed deal functionality is only enabled upon request - ask your service contact to have it enabled.  

Setup in Equativ UI

Creating RTB insertion

As a first step, you must create an RTB insertion where you define all the parameters of the guaranteed deal: time frame, impression volume, inventory (websites, pages, formats), script template. 

Read the Activate open auctions article for the general setup of an RTB insertion.   

When done, put your RTB insertion online.

Creating guaranteed deal

Create your guaranteed deal as described in Create programmatic guaranteed deal and connect this deal with the RTB insertion you just created.  

Prebid.js setup

Set up prebid.js and deals using these resources:

• Prebid.js developer documentation
• Prebid.js deals documentation
• Supply inventory with prebid.js header bidding

By design, guaranteed deals are supposed to deliver 100% of the scheduled impression volume because the buyer commits to buying all eligible impressions. This means that the deal must deliver even if its price is less than the top bid. To make this work you must force prebid.js to send all bids to the primary ad server (Google Ad Manager) by setting enableSendAllBids to true. 

Whenever Equativ's bid includes a deal ID, prebid.js will attach the key values related to this deal in the following format: hb_deal_smartadserve = MY_EXTERNAL_DEAL_ID.   

Primary ad server setup

Google Ad Manager setup

Create the key value hb_deal_smartadserve as explained in this article.

Then, create a line item with a guaranteed priority (Sponsorship).

Target the line item to the key hb_deal_smartadserve and set the deal ID as the value of the key.  

Notes:

• In case of new deals in the future, you can keep the same line item and just target it to the new deal Id.
• Prefixing the deal Id with SMART_ (as shown in the screenshot above) is not mandatory. Using the deal Id only (e. g.: 894756379) is sufficient.

For all other steps to set up line items, refer to the Google Ad Manager documentation and the documentation on the prebid website.