Overview

This document outlines the features and client-side setup of Equativ as a bidder in prebid.js, using Equativ's new prebid.js adapter.

Using the new adapter is recommended for new implementations. 

For information about the setup in Equativ's Monetization platform, see Set up and manage client-side header bidding.

New versus legacy adapter

Equativ's new prebid.js adapter is recommended for new implementations. Make sure you upgrade to prebid.js v 9.52 or later to benefit from all features of the new adapter. 

Customers already using the legacy prebid.js adapter can either replace it by the new adapter or run both in parallel. 

Key benefits

Equativ's new prebid.js adapter offers the following key benefits:

• Use of Equativ's openRTB endpoint, allowing for enriched bid requests with all supported openRTB data points.
• Improved performance with faster responses and reduced timeouts.
• Support of media types banner, video, audio, and native.
• Support of more prebid.js modules, compared to the legacy adapter.
• Support of Multi-Impression Type (MIT), improving fill rates and increasing revenues as a single placement can be monetized with either a banner, native or an audio/video ad.

For a complete list of all features and supported modules, see the Equativ bidder page.

Limitations

The following limitations apply to Equativ's new prebid.js adapter:

• No rich media support: Equativ's creative templates cannot be used as the new adapter does not rely on insertions.
• Programmatic guaranteed deals are not supported as the new adapter does not rely on insertions.
• A Prebid Server adapter corresponding to the new prebid.js adapter is not available.

Documentation

For detailed technical documentation of the new adapter, refer to the Equativ bidder page (bidder code: equativ). This resource includes the supported features and components, bid parameters, ad unit setup including samples, and other valuable information.

Recommended modules

When you customize and download prebid.js, Equativ recommends to include the Supply Chain Object Module and the Currency module (see also section “Currency management”, later in this document).

User sync configuration

Equativ's bidder is using iframe-based, instead of image-based user syncing. To accommodate this, you must permit iframe syncs for the Equativ bidder. See section “User Syncing” on the Equativ bidder page for more details. 

Net price, gross price and bid price adjustment

By default, the Equativ adapter returns the bid price as a net value, meaning the price is indicated without Equativ's revenue share included. If you prefer to receive the bid price as a gross value, which includes Equativ's revenue share, you can request this change by contacting your Equativ representative.

In both cases, the Equativ adapter indicates in the bid response whether the price is net or gross, so you can still perform client-side bid price adjustments. For more information, see "2.2. bidCpmAdjustment" in the pbjs.bidderSettings documentation.

You can also apply bid price adjustment for deals if Equativ's revenue share for deals is different from the one for open auctions. For more information, see Deals in Prebid.  

Currency management

With the optional Prebid.js currency module, publishers can specify an ad server currency and convert all bids to this currency before the auction.

For example, the following snippet sets the adServerCurrency to EUR:

pbjs.setConfig({
  "currency": {
    "adServerCurrency": "EUR",
    "defaultRates": { "USD": { "EUR": 0.8 }}
  }
});

The optional defaultRates attribute is recommended in case there is an issue loading the currency file.

If the currency module is not installed, Equativ will consider the incoming bid floor—if it exists—as a USD bid floor, Equativ will bid in USD and prebid.js will process all bids as USD bids.

If the Currency Module is installed, and if an adServerCurrency is defined, Equativ will consider the incoming bid floor—if it exists—as a bid floor in the defined adServerCurrency, Equativ will bid in the defined adServerCurrency, and prebid.js will automatically convert all bids to the defined adServerCurrency.

Price Floors module

Equativ's prebid.js adapter supports the optional Price Floors Module. With this module, you can manage floors at a single location for all bidders and you can tailor floors to the individual page or auction context. Floors can be dynamic, using a third party in real time or static, if defined at ad unit level.

The bidFloor parameter of the Equativ adapter remains available. If it is defined, it overrides the values from the Floor Module.

AMP inventory

Header Bidding with prebid.js is not possible for AMP inventory. Use Prebid server instead.