Ogury Prebid.js Adapter
The Ogury Prebid Adapter is a module connecting Prebid.js framework to Ogury's ad network. It enables you to request and render Ogury ads. This documentation provides integration guidelines.
- If your website will be trafficked in a country where GDPR applies, you must have implemented a consent management platform (CMP) which is compliant with TCF v2 and includes the Ogury vendor ID (31). The consentManagement Prebid.js module has also to be enabled so that the Ogury Prebid.js can access consent information.
- Your website needs to be integrated and set up with Prebid.js. Please refer to the Prebid.js documentation for more details.
- Desktop environment is not supported
The Ogury Prebid.js Adapter currently supports Thumbnail, Header Ad and Footer Ad formats.
The Ogury Prebid.js adapter is currently compatible with the following Prebid.js modules
- priceFloors: used to specify bid price floors. Note that prices need to be specified in USD or converted to USD.
You cannot use a Prebid integration with a Direct Integration on the same page. Besides, we are not supporting multi placements on the same page, which means you should declare only one adUnit per page.
The Ogury Prebid Adapter needs to be included in the Prebid.js script you use for mobile web header bidding.
The Ogury Prebid Adapter is fully supported by the official Prebid.js since version
6.6.0. This is the minimal version you should use. However, we recommend using the latest available version to benefit from functional and maintenance updates.
You can download or build the latest version of Prebid.js with Ogury Prebid Adapter here: https://docs.prebid.org/download.html
You only need to include
Oguryto your selected adapters to download a ready to use Prebid.js script.
Although the officially supported Ogury Prebid Adapter is available since version
6.6.0of Prebid.js, it is compatible with earlier 5.x and 4.x versions and can be used through a custom build from source code.
Assuming that you have a copy of the Prebid.js target version that you can build based on the official documentation:
- 1.Go to your Prebid.js folder
- 2.Download the latest Ogury Prebid Adapter files to the modules folder. You may do it using
wgetas follows:wget https://github.com/prebid/Prebid.js/raw/master/modules/oguryBidAdapter.md -O ./modules/oguryBidAdapter.mdwget https://github.com/prebid/Prebid.js/raw/master/modules/oguryBidAdapter.js -O ./modules/oguryBidAdapter.jswget https://github.com/prebid/Prebid.js/raw/master/test/spec/modules/oguryBidAdapter_spec.js -O ./test/spec/modules/oguryBidAdapter_spec.js
- 3.Build the Prebid.js library including the Ogury Prebid Adapter. You may use the
gulpcommand for that:gulp build --modules=oguryBidAdapter,... //add here other modules you use for your website
A successful build generates a production ready prebid.js library in this folder:
A typical Prebid.js ad unit configuration looks like the following:
var adUnits = [
sizes: [[1, 1]],
// You may have other Prebid.js bidder adapters to configure here
codefield (corresponding to 'iframe-1' in the example above) is the identifier of the div where the ad will be displayed, it will be used to close the div and avoid blank space.
In order to enable Thumbnail/Header Ad/Footer Ad, please make sure you use
banneras media type.
sizesfield must include [1,1]. This specific value enables the support of the custom sizing used by the Thumbnail/Header Ad/Footer Ad. You may of course include other sizes for additional bidders if needed. Please refer to skipping-the-check-of-sizes section if you need to adapt this behavior.
Thumbnail Ads will use by default a maximum of 180x180 pixels on the user's screen. This is the currently defined compromise between the readability of the content of the ad and the user experience. Additionally, this size maximizes the fill rate as it allows access to 16/9 and 4/3 for video and display.
Header Ad will have default position to 16/9 according to the viewport width of the user.
Footer Ad will have by default a 100% width size according to the viewport width of the user and 100px of height. Note that if 100px is higher than 25% of the full screen height, Footer Ad can take, in this particular case, only a 80px height in order to respect "Coalition for Better Ads" recommandations.
The Ogury Prebid Adapter currently relies on pixel-based user syncing performed by Prebid.js. This feature is enabled by default but if you need to customize the configuration, please make sure that the Ogury Prebid Adapter is allowed to perform user syncing.
bidders: ['ogury'], // add other adapters here if needed
Ogury Prebid Adapter can be configured along with Google Ad manager as an ad server. A typical configuration should be similar to what is described in the official Prebid.js documentation.
Here is an example of a working GAM creative:
Ogury Formats are not compatible with
SafeFramedelivery. Thus it has to be unchecked.
Ogury has proprietary formats that don't follow the common IAB Ad space sizes. While Ogury returns a creative size that is defined in the prebid ad unit configuration, the real creative size differs depending on the used format and returned media type.
The Ogury Prebid Adapter supports bid floor management. You can optionally set a floor as defined in the price floor Prebid.js documentation.
The Ogury Prebid Adapter supports only floors expressed in USD. Please make sure that you have defined your price floor in that default currency or you have properly configured currency conversion.
If you want to adjust the rendering of your selected Ogury Ad Format please refer to the individual ad format sections:
Two things to keep in mind when doing adjustments:
- For Prebid you'll need to switch the configuration parameters from snake case to camel case notation
- All configuration options will be listed in the params Object
Bidder configuration :
assetKey: string, // MANDATORY
adUnitId: string, // MANDATORY
xMargin?: number, // Thumbnail only
yMargin?: number, // Thumbnail only
gravity?: string, // Thumbnail only
headerSelector?: string, // Header Ad only
headerAdDomPosition?: string // Header Ad only
adSlotSelector?: string // Header and Footer only
Note that some parameters are optional (defined with
?) and may not be available if they are not configured in the Prebid configuration.
If you're are using prebid's gdprEnforcement module and you're not using the most recent Ogury Adapter or Prebid version, you might need to map the Ogury Bid Adapter to the right vendor ID, otherwise Ogury won't be able to perform the necessary cookie synching.