Header Complete Implementation Guide

Last Updated February 28, 2019

One of the most difficult aspects of working with a header bidding wrapper is the coding involved with implementing, updating, and maintaining the header bidding code on your site. Adding and removing partners invites bugs to creep into your code, updating the library can cause issues, and the header bidding code in general is just messy.

We recognized this issue across our vast array of publishers and decided there had to be a better way to perform header bidding on websites. This led to the creation of Header Complete.

About Header Complete

Header Complete gets rid of the hassle of maintaining header bidding code through a simple user interface within Meridian.

Think of it as a managed header bidding wrapper. You plug in the necessary values for each ad unit and partner, then we take care of building the script and maintaining the Prebid library.

Implementing Header Complete is as easy as pasting a single line of code into the head of your page. After that, no more code work is required and all changes to the setup can be made in Meridian’s UI.

This article is meant to be a simple explanation of what the new Header Complete is and how to use it.

The interface has 3 levels to configure your header bidding setup:

  1. The script level
  2. The ad unit level
  3. The ad tag level

Below is the conceptual overview of Header Complete, as seen in the Meridian UI.

header-complete-implementation-guide-1

To summarize:

  • The top level contains the individual scripts.
  • Within the scripts are the ad units.
  • Within the ad units are the ad tags.

Continue reading for more in-depth information on each level.

The Script Level

header-complete-implementation-guide-2

The Header Complete Setup is contained within the “Ad Tags” section of your Meridian account.

The “Manage Header Scripts” page the top level of your Header Complete setup. This page contains your individual header bidding scripts.

One script = one header bidding configuration.

There is no limit on the number of scripts you can create within Sovrn’s Header Complete. These scripts are meant to be created for individual ad configurations, meaning they may be broken out between sites, pages, and page layouts.

If your site is responsive between desktop, tablet, and/or mobile, you can create custom breakpoints within each script. Within each breakpoint, you configure the appropriately sized ad tags.

Within each script contains all the pertinent ad units for the ad configuration you are creating.  Clicking on the “Manage Units” button takes you to the next level: The ad unit level.

The Ad Unit Level

header-complete-implementation-guide-3

Within each script is an interface to configure the ad units. These ad units correspond to the ad slots on the page for the particular ad layout you are working on.

The only information Header Complete needs to create an ad unit is the div ID that is being used on your site. The Ad Unit Name can be anything, but we recommend using the DFP ad unit name for the sake of consistency.

In the example, we are working with a 3 ad slot page layout. Currently, there are not any ad tags attached to these ad units. Clicking on “Select Tags” will allow you to venture to the last level: the ad tag level. This is where you add demand to your ad units through ad tags.

The Ad Tag Level

header-complete-implementation-guide-4

Within each ad unit you align existing tags simply through toggling them on or off. You also have the option of creating new tags in each ad unit by clicking on “Add a New Header Tag.”

header-complete-implementation-guide-4

When you add a new header tag, you have the option of creating a new Sovrn tags or a 3rd party SSP tag. Each 3rd party tag requires its own set of information to work properly. This information is provided by your 3rd party SSP representative.

OpenX’s tag form, for example.

After you fill in the tag information and click “Save.”  Your new tag will be automatically aligned with the ad unit you created it in.

header-complete-implementation-guide-7

You repeat this tag alignment process for each ad unit within each script based off your ad stack’s specifications.

Once you have completed that, you can implement Header Complete!

Implementation Overview

Implementing Header Complete from this point is just a quick copy and paste into the head of your web page.

You can find the Header Complete script tag on the Script Configuration page.  Click on “View Code” to reveal it.

header-complete-implementation-guide-8

Once that script tag code is pasted into the head of your page above the GPT defineslot functions, you are all set!

If you need to make any changes to the setup, all you have to do is make them in the Header Complete UI and the changes will automatically update to your live site through the script tag. No more messy coding required for header bidding!

If you’re interested in learning more, don’t hesitate to contact us for further information!

How satisfied are you with this article?

  • Not at all satisfied
  • 1
  • 2
  • 3
  • 4
  • 5
  • Completely satisfied