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.
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.
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 |
Adding IDs to the UI
Once the file has the IDs, there are two ways to add them to HTL BID:
- Manually → Add them to each Prebid Group
- 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.
*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
*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.