Prebid Server Access (without HTL BID code)

This document explains how to access and use HTL’s Prebid Server without using the HTL BID code, offering publishers a solution to optimize their ad monetization efforts.

For additional information on Prebid Server visit Module - Prebid Server Adapter for Header Bidding

⚠️

To implement this integration, publishers must have Prebid already set up, and have the ability to add the new Prebid Server IDs that will be provided.

There are two parts to the integration for the publisher:

1. Adding the Prebid Server SSP IDs that will be used for Prebid Server into your current Prebid structure
2. Adding the HTL Prebid Server endpoints, account ID and bidders list

1. Adding the Prebid Server SSP IDs into the Prebid code

HTL will provide a file with the Prebid IDs for the SSPs that need to be added to your Prebid configuration. These SSPs and IDs will be used through HTL’s Prebid Server, but they need to be included in your current pbjs config.

Adding the IDs should be done the same way as Prebid Client. The only difference is that these IDs will run through Prebid Server as long as the bidder is listed in the array in the s2s config in next section.

⚠️

With Prebid.js version 9, adding the bid adapter code Client-side for Prebid Server is no longer required (it is with version 8). However, the Prebid IDs must still be added to the pbjs config by the publisher.

Example:

var adUnits = [{
  code: '/12345/testunit',
  mediaTypes: {
    banner: {
      sizes: [[300, 250], [300,600]]
    }
  },
  bids: [{
  // Add the Prebid Server IDs
    bidder: 'appnexus',
    params: {
      placementId: 13144370
    },
	  bidder: "rubicon",
	  params: {
       accountId: 14062,
       siteId: 70608,
       zoneId: 498816
    }
  }]
}];

2. Adding the HTL Prebid Server Endpoints

To call the HTL PBS instance, you need to set the following in your pbjs config:

Add the endpoints:

Endpoint: https://amspbs.com/openrtb2/auction
Sync Endpoint: https://amspbs.com/cookie_sync

Account ID: Provided by the HTL team
Bidders: Include the list of bidders that will run through Prebid Server

Example:

pbjs.setConfig({
  s2sConfig: {
    enabled: true,
    accountId: '12345',
    endpoint: 'https://amspbs.com/openrtb2/auction',
    syncEndpoint: 'https://amspbs.com/cookie_sync',
    bidders: [
      'appnexus',
      'rubicon',
      '...',
    ],
  },
});

// pbjs.mergeConfig can also be used instead of pbjs.setConfig