Enabling Prebid

In this section..

Learn about enabling & configuring Prebid and configuring your header bidding IDs

  • Setup Prebid
  • Creating Prebid ID Groups
  • Assigning IDs to Slots
  • Determining whether to use existing IDs or request new ones
  • Requesting IDs from SSP partners
  • Suggested ID Structure
  • Bulk uploading IDs
  • Creating GAM Line Items
  • Updating Ads.txt

Configuring Prebid

HTL BID allows configuring most Prebid settings via the user interface.

image

Prebid Version

HTL BID specifies a “default” prebid version. You can also choose the latest version of Prebid, or specify an exact version number such as 7.31.0.

Prebid Timeout

The timeout specifies the maximum numbers of milliseconds before a bidder times out and Prebid continues without receiving those bids.

Price Granularity

This determines how bids are rounded. It is critical to ensure the price granularity of GAM Line Items exactly matches the granularity configured here in the UI.

Creating Prebid ID Groups

Prebid Groups are the way to assign header bidding IDs to individual ad slots. Prebid Groups are a flexible mechanism to organize your IDs and there are two popular schemes.

Some publishers choose to have one group for every combination of ad slot and viewport size. For example, with 5 ad slots and 3 viewports, there will be 15 Prebid Groups. This offers the most granular and flexible configuration, but requires managing a lot of IDs.

Some publishers choose to have one group per ad size. This requires fewer IDs and is simpler to setup and maintain, but results in less granular reporting.

Each Prebid Group needs a name, and a list of associated bidders. HTL BID knows which parameters are required for each bidder.

screen

After creating a Prebid Group, it needs to be associated with an ad slot. Prebid Groups and Ad Slots form a many-to-many relationship, that is, each Prebid Group can be associated with multiple Ad Slots and each Ad Slot can be associated with multiple Prebid Groups.

screen

If you have lots of IDs, be sure to use the bulk-import.

Assigning IDs to Slots

  • Go to “Ad Configuration”
  • Choose the target slot
  • Click “Prebid ID Groups”
  • Choose the group(s) you wish to assign to the slot

Determining whether to use existing IDs or request new ones

When configuring Prebid, you will need to create or import your header bidding IDs.

  • If you are new to Prebid, or migrating from a different vendor, you may prefer to get new IDs
  • If you already have Prebid, you may wish to import your existing IDs

Requesting Header Bidding IDs

In most cases, you get header bidding IDs, it is necessary to contact your SSP partners

  • If you are using HTL’s SSP accounts, HTL will request IDs on your behalf. Speak with your HTL account manager to let them know which SSPs you want to work with
  • If you are using your own SSP accounts, you will need to request IDs from your SSP account manager.

There are 2 steps to requesting IDs from an SSP partner

  • Download the ID load sheet from the HTLBID user interface
  • Email the load sheet to your SSP partner
  • (some SSPs also have a self-serve option)

Downloading the ID Load Sheet

Navigate to the Prebid ID Groups tab, and press the “download” icon. This will download an Excel file containing your ad map. This file can be sent to SSPs when requesting new IDs.

For more details on IDs Load Sheets visit this link.

image

Suggested ID structure

HTL BID uses a many-to-many mapping that is flexible enough to accommodate your preferred ID structure. Publishers may choose to split-out IDs however they wish

HTL suggests separate IDs using following granularity

  • Website
  • Ad Slot
  • Device
  • Size(s)

For example, a slot name Top_Leaderboard would have separate IDs for each device and size.

Website
Ad Slot
Device
Size
ID
example.com
Top_Leaderboard
Desktop
728x90
72039
example.com
Top_Leaderboard
Desktop
970x250
72040
example.com
Top_Leaderboard
Tablet*
728x90
72041
example.com
Top_Leaderboard
Mobile
320x50
72042
example.com
Top_Leaderboard
Mobile
300x50
72043
💡
HTL strongly recommends using the suggested Header Bidding ID granularity and Load Sheet. This format is required to use the “Bulk Upload” feature.

Adding IDs to the UI

Once the file has the IDs, there are two ways to add them to HTL BID:

  1. Manually → Add them to each Prebid Group
  2. Bulk upload → If you are importing lots of IDs, you may prefer to use to the bulk-upload option. In order to use the Bulk Upload, you MUST use the ID Load Sheet format.
  3. *Note - this is an Admin-only feature as of May, 2023. Get in touch with your Technical Account Manager, and sign up for our newsletter for feature release updates.

Creating GAM Line Items

When modifying your Prebid Configuration, you may need to generate new line items if any of the following is true:

  • If you are adding a new SSP partner
  • If you are adding a non-standard ad size
  • If you have adjusted the line item price granularity
  • If you are migrating from a different vendor
💡
In many cases, you may also need to pause your old Prebid line items in GAM.

*Note - this is an Admin-only feature as of May, 2023. Get in touch with your Technical Account Manager, and sign up for our newsletter for feature release updates.

Updating ads.txt

If you are adding or removing an SSP partner, you also need to update your ads.txt file. You can update your ads.txt file manually, or let HTL BID manage ads.txt for you.