Setting up an Adfox account for monetization with Header Bidding

You can set up Header Bidding in the Monetization section: connect monetizers at the account and placement list level, and manage ad delivery and targeting all in one place.

Alert

Setup via campaigns and manual setup will no longer be available starting August 10, 2026:

  • Campaigns and banners Header Bidding are no longer shown in the campaign list, and their parameters are unavailable. This doesn't affect reporting: historical data on Header Bidding is preserved. Previously saved reports still work.

  • Connect monetizers, set up placements and targeting in the Monetization section — for the account, placement list, or specific placement.

  • Monetizers with IDs are preserved, with IDs inheriting the previous campaigns IDs. You can find the ID in the Monetization section on the Parameters tab under the name of the monetizer.

Before setting up Header Bidding, make sure to:

  • Sign a separate Header Bidding contract with each monetizer you connect.

  • Create an ad unit in each monetizer's dashboard.

Setup through the Monetization section

The setup consists of three steps: enabling the monetizer at the account level in Monetization, adding it to the placements, and installing the configuration script. Campaigns and banners are created automatically.

Step 1. Connecting monetizers at the account level

Go to Monetization from the main menu and select the Parameters tab. Depending on the monetizer, connect it in the appropriate list:

The Connecting external monetizers list shows all available monetization platforms. Each of them shows the type of integration:

  • Yandex Header Bidding: Integration via Yandex's own solution.
  • Prebid.js: Standard open-source library for Header Bidding.

  1. Find the monetizer in the list or use the search bar (you can filter by status or type).

  2. Click next to the monetizer and select:

    • Edit: To change the monetizer parameters.
    • Ad platforms: To select sites, sections, and placements where you plan to run ads.
    • Targeting: To set up targeting criteria:
      1. Click Add a targeting.
      2. In the drop-down list, select targeting criteria — such as time, frequency, or geography.
      3. Fill in the required parameters and click Apply.
      4. Edit the list of targeting criteria: you can add a new targeting option or remove the ones you don’t need.
    • Delete: To remove a monetizer.

  3. Click Apply to confirm your changes.

  4. Enable the option in the Connected column, next to the monetizer. A Changed status appears in the row with the monetizer, indicating the parameters have been changed but not yet saved.

  5. Click Save at the bottom to apply your changes.

Warning

Once you're done, install the configuration script on your site — without this step, monetization won’t work.

  1. In the Connect monetizers for Adfox Header Bidding list, click Add and specify the ID of the monetizer's account in Adfox (ownerId). You can find it out from the monetizer or in the monetizer's ad tag.

  2. Click next to the monetizer and select:

    • Edit: To change the monetizer parameters.
    • Ad platforms: To select sites, sections, and placements where you plan to run ads.
    • Targeting: To set up targeting criteria:
      1. Click Add a targeting.
      2. In the drop-down list, select targeting criteria — such as time, frequency, or geography.
      3. Fill in the required parameters and click Apply.
      4. Edit the list of targeting criteria: you can add a new targeting option or remove the ones you don’t need.
    • Delete: To remove a monetizer.

  3. Click Apply to confirm your changes.

  4. Enable the option in the Connected column, next to the monetizer. A Changed status appears in the row with the monetizer, indicating the parameters have been changed but not yet saved.

  5. Click Save at the bottom to apply your changes.

Step 2. Connecting monetizers at the placement level

  1. Go to Monetization from the main menu and select the Placements tab.
  2. Click next to the placement name, then select Add under Header Bidding monetizers.
  3. Add the monetizers you want to connect. You can clear the list or click Copy all to quickly copy monetizers to another placement.
  4. Click Save.
  1. Go to Monetization from the main menu and select the Placements tab.
  2. Find and select the placement you need.
  3. Go to the Parameters tab.
  4. Under Header Bidding monetizers, add the platforms you want to connect. You can clear the list or click Copy all to quickly copy monetizers to another placement.
  5. Click Save.

Warning

If you see an exclamation mark next to a monetizer:

  • Activation requires signing a contract with this monetization platform.
  • The platform was connected earlier but isn't active. To activate the platform:
    1. Click next to the monetizer and select Ad platforms.
    2. Select the sites, sections, and placements where you want to run ads and click Apply.

Step 3. Preparing a configuration script

  1. Go to Monetization → HB configurator.
  2. Configure the parameters for each placement.
  3. Click Generate and copy the script.
  4. Install the script on the site, adding it to the <head> tag.

To learn more about installing the script, see Creating and placing a script on the site.

You can configure placements in the Monetization section on the Parameters tab (account-level setup) or the Placements tab (placement-level setup):

  1. Click next to the monetizer and select Ad platforms.
  2. Select the sites, sections, and placements where you want to run ads and click Apply.

Contact support

Send an email

Previous
Header Bidding
Next
Placing a script