6a - Header Bidding with Prebid.js (part 1)

With Header Bidding, publishers can fetch bids from multiple partners (demand sources) using a framework which is integrated directly on the publisher's page.

Prebid.js is a free, open source, javascript framework to implement header bidding. Smart AdServer has developed an adaptor for Prebid.js: publishers can add Smart AdServer as a demand source.

How Prebid.js works

  • the Prebid.js library fetches bids from multiple partners (Smart AdServer, etc.)
  • Prebid.js passes information about the retrieved bids (including the price) to the ad tag on the page
  • the ad tag passes the information to the ad server as query string parameters
  • in the ad server, there are line items which target these parameters

Activation

Using Smart AdServer as a demand source in Prebid.js requires activation. Get back to your Technical Account Manager to see if you are eligible. Without activation, Smart AdServer will send empty ad responses ("noad").

Setup in Smart AdServer User Interface

To be able to use Prebid.js with Smart AdServer, you need to set up RTB+ in Smart AdServer's user interface.

Sign in to the user interface

Sign in to the user interface

Sign in to the user interface here (use your Manage ID and Password ②. The Manage ID has the format yourUserName@networkName (example: johnsmith@mediaxyz)

Formats

Go to Administration > Formats

Formats

Click New

Edit format

Formats represent sizes of ad slots (e. g. 300x250 / medium rectangle).

  • Define a name
  • Under Platform settings, define width and height for the Desktop position (e. g. 300 x 250)
  • Click Save

Repeat the process for each format.

About the sizes

There is no need to create additional formats for similar sizes. For instance, it is sufficient, to have one "300x250" format, which accepts both 300x250 and 300x300. The actual accepted sizes for a format are specified client-side (see sizes: [[300, 250]], in the example in the part 2 article).

Websites

Go to Administration > Websites & pages

Websites

Click Site: New

Edit website

Create at least one website. Creating an individual Smart AdServer Website for each "real" website is only necessary, if you need granular reporting ("by website").

  • Define the Site Name
  • Optionally, for Site URL, enter the website domain (in format: http://domain.com). When placing the bid request, Smart AdServer will use this domain as a backup for the referrer URL.
  • Click Save

Page groups

Page groups

Click New page group and enter a name (typically, the same name as the website).

Edit page group

Edit page group

Edit the page group as shown above.

Enable formats

Enable formats

Enable all the formats and click Save.

Pages

Pages

Click New page

Edit page

Edit page
  • Enter a Page name; typically, the same name as the website (one page per website is sufficient)
  • Click Save

Getting the Ids for bid parameters

In Administration > Websites, click on the website in the left column and select Download all tags for the site

Access

On the following page, click Generate to download the txt file. In the txt file copy the Ids siteId, pageId, formatId and foward them to the developer who does the client-side integration. The Ids will be used as bid parameters.

Example

siteId:		50513,	// 
pageId:		364469,	// Page : mywebsite/mypage
formatId: 	21720,	// Format : myformat

Create RTB+ advertiser

  • Go to Administration > Advertisers and click New
  • Name it "Smart RTB+" (recommended)
  • Click Save and create a campaign
Create an RTB+ advertiser

Create RTB+ campaign

Create RTB+ campaign
  • Define a Name for the campaign. Recommended name: "RTB+ - [Current Year]"
  • Set Start and End date (end date should be at least the end of the current year)
  • For Booking > Status set the status Sold
  • Click Save and create an insertion

Create RTB+ insertion

Create RTB+ insertion

You need to create one insertion per format.

  • Define the Name; use the format's name, e. g. 300x250
  • Select Insertion category Web
  • Leave the priority unchanged
  • ④ Enable the option Activate "Holistic yield" mode
  • Click Save and go to next step

Edit placement

Edit placement
  • Select the format (1); only one format is possible; copy the insertion if you need other formats (see below)
  • Select the website(s) and move it/them to the right column
  • Click Save and go to next step

Creatives

Click Template library

Creatives

Select script template

Select script template

Search for the RTB+ script templates and select the RTB+ Default Banner script template

You can ignore the field "Acceptable sizes" since it is not relevant for Header Bidding with Prebid.js.

Put insertion online

Put insertion online

Click Put online. The insertion will be active within a few seconds.

Copy RTB+ insertions

Copy RTB+ insertions

You need one insertion per format.

To copy your existing insertion:

  • Click on the campaign's name
  • Select the insertion to be copied
  • Click Copy

Finalize copies

In the copied insertion

  • change the name (e. g. to 160x600)
  • select the appropriate format on the Placement tab

The result may look as follows:

Finalize copies

Create deals

You can also create deals (direct deals, private auctions). The following articles include more details:

Next step

Read the part 2 article 6b - Header Bidding with Prebid.js (part 2), which includes:

  • the client-side integration on publisher site
  • the setup in publisher ad server
  • limitations
Was this article helpful?
0 out of 0 found this helpful
Powered by Zendesk