Prebid parameters - Advanced

This article explains the basics of the Prebid parameter menus and the order they are applied in.

Many settings for HBA are available from the Prebid parameters menus. These settings are applied via a hierarchy described later in this document.

Prebid parameters

The settings have different scopes. In general they are applied per placement, with the exception of Generic Prebid Config Data and User ID modules that are applied per Prebid configuration.

  • General settings - Used for enabling Mobile App and AMP support per placement.
  • Generic Placement Data - Both built-in settings per placement (e.g. reload / lazy-load) and user-created settings per placement. Such user-created settings are available in JavaScript and created using Placement Tag Fields.
  • Generic Prebid Config Data - Both built-in settings per Prebid configuration (e.g. custom JavaScript and prebid timeouts) and user-created settings per Prebid configuration. Such user-created settings are available in JavaScript and created using Prebid Config Tag Fields.
  • Outstream video settings - Settings for outstream video per placement.
  • Instream video settings - Settings for instream video per placement.
  • Native settings - Settings for native content per placement
  • SSPs - One box of settings per header bidding-supported SSP. These settings are applied per placement and include the bidder parameters. See below.
  • User ID modules - One box of settings per User ID module added.

SSPs and bidder parameters

The SSP settings let you control settings including custom bidder parameters per SSP and placement.

Prebid bidder parameters

  • The first parameters are built-int parameters such as Disable Bidder and Bidding type.
  • For some SSPs, there are built-in UI elements for certain bidder parameters. In the example above Site ID is used to control the siteId bidder parameter for Rubicon/Magnite (link). 
  • Custom Parameters are used for manually editing the bid parameters so that there are no built-in UI elements.
  • Inherited parameters show settings already inherited from a higher level in the setting hierarchy (read-only). Parameters are where you can edit the bid parameters directly using JSON.

Order prebid parameters are applied - the "settings hierarchy".

Sometimes you want to apply settings globally, sometimes per websites, and sometimes per placement, etc. Therefore the Prebid parameters settings are available on multiple levels and applied in a certain order.

On every level in this hierarchy, you can override the settings from the higher levels using the "override toggle" that exists for every setting. When a setting is not overridden the grayed-out value represents the current value as inherited from a higher level - or from the settings' default value.

Order per-placement settings are applied:

  1. Global level - Prebid parameters
  2. Global level - Placement type prebid parameters
  3. Account level  (Publisher) - Prebid parameters
  4. Account level (Publisher) - Placement type prebid parameters
  5. Site level - Prebid parameters
  6. Placement level - Prebid parameters
  7. Prebid configuration prebid paramters on Account level
  8. Prebid configuration prebid paramters on Site level
  9. Prebid configuration prebid paramters on Placement level
  10. (when applicable) Child Prebid configuration prebid paramters on Account level
  11. (when applicable) Child Prebid configuration prebid paramters on Site level
  12. (when applicable) Child Prebid configuration prebid paramters on Placement level

Order per-placement settings are applied - with images where they are located:

  1. Global level - Prebid parameters
    Global prebid params
  2. Global level - Placement type prebid parameters
    Placement type prebid params
  3. Account level (Publisher) - Prebid parameters
    Publisher prebid params
  4. Site level - Prebid parameters
    Site prebid params
  5. Placement level -  Prebid parameters
    Placement prebid params
    Notice: The Generic Placement Data settings are available directly below the Prebid parameters instead of in the menu itself.
  6. Prebid configuration prebid paramters on Account level
  7. Prebid configuration prebid paramters on Site level
  8. Prebid configuration prebid paramters on Placement level
    Parent prebid config prebid params
    Notice: The image above shows all 3 of levels 6-8. 
  9. (when applicable) Child Prebid configuration prebid paramters on Account level
  10. (when applicable) Child Prebid configuration prebid paramters on Site level
  11. (when applicable) Child Prebid configuration prebid paramters on Placement level
Child prebid config prebid paramsNotice: The image above shows all 3 of levels 9-11. These settings are only applied when a child prebid configuration is indeed used.

Order Generic Prebid Config Data settings are applied:

  1. Global prebid parameters
  2. Account (Publisher) prebid parameters
  3. Site prebid parameters
  4. Prebid configuration - under Configuration data
  5. (when applicable) Child Prebid configuration - under Configuration Data