Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Through BroadFall in SpringServe, publishers can include video header bidding as part of their demand stack. These demand tags are automatically added to the a Broadcast tier of targeted supply tags' waterfalls. 

Table of Contents

Creating Header Bidding Demand Tags

To create new header bidding demand tags, go to the Demand tab and begin the standard demand tag creation process which can be done through a specific demand partner, campaign, or in the Demand Tags Demand tab by selecting Image Removedselecting "+Demand".

Enter the desired settings for the tag as usual, and set the tag Type tag Demand Class to Header Bidding

Image Removed

Once this demand tag type class is selected, a few new options will appear. These are:

Platform

Select the platform this header bidding tag belongs to. This will reveal the bid parameters specific to that platform. More information on integrating tags from these platforms can be found in the "Supported Platforms" section below.

Floor Type

Choose which type of floor will be applied to the bids coming through this tag. A Static floor is a fixed rate that SpringServe will use to ignore any bids that fall below the entered value. 

...

NOTE: A demand partner with a dynamic margin running on a supply tag with revshare or dynamic payment terms will set the submitted floor to $0.01.

Floor Rate/Margin

The static value or margin to calculate when SpringServe submits the floor in the header bidding request.

Bid Parameters

The platform-specific id(s) that connect this demand tag with the header bidding partner's tag. This can usually be found in the endpoint of the partner's tag (for more details, reference "Supported Platforms").

Adding Header Bidding Demand Tags to Supply Tags

Connecting header bidding tags to supply follows the standard process in SpringServe. 

Either navigate to the Supply Tags tab on the header bidding demand tag to Add Manually or Copy From DemandImage Removed

Or once the demand tag has been created, add it from the Demand Tags tab on the desired supply tag: 

Image Removed

Adding header bidding demand tags will enable BroadFall on the targeted supply, and as mentioned previously, will automatically place the header bidding demand within the broadcast tier.

NOTE: Header bidding demand tags cannot be moved outside of the broadcast tier, must be inside a broadcast-enabled tier and cannot serve on Flash , VAST Only, or DirectConnect or VPAID None supply.

Supported Platforms

AppNexus

To add an AppNexus header bidding demand tag, select AppNexus from the Platform drop-down. 

...

Enter this placement id in its respective field in SpringServe.

Beachfront

To add a Beachfront header bidding demand tag, select Beachfront from the Platform drop-down.

Once the floor has been set, input the App ID.

Conversant

To add a Conversant header bidding demand tag, select Conversant from the Platform drop-down.

Once the floor has been set, input the Site ID.

bRealTime

To add a bRealTime header bidding demand tag, select bRealtime from the Platform drop-down.

Once the floor has been set, input the Placement ID.

NOTE: bRealTime's header bidding integration is done through AppNexus, so the optional bid parameters used in the AppNexus platform can be used here as well.

district m

To add a district m header bidding demand tag, select district m from the Platform drop-down.

Once the floor has been set, input the Placement ID.

NOTE: Similar to bRealTime, district m's integration is done through AppNexus, so the optional bid params for AppNexus can potentially be applied here.

Index Exchange

To add an Index Exchange header bidding demand tag, select Index Exchange from the Platform drop-down.

Once the floor has been set, input the SiteId.

NOTE: Please check with your Index Exchange account representative to make sure that header bidding is enabled on their end.

OpenX

To add an OpenX header bidding demand tag, select OpenX from the Platform drop-down. 

Once the floor is set, input the delivery domain and the ad unit id into their respective fields in "Bid Parameters".

NOTE: Please check with your OpenX account representative to make sure that header bidding is enabled on this ad unit.

The delivery domain and ad unit id can usually be found in the OpenX endpoint, with the ad unit id identified by the auid= parameter – e.g. https://testing-d.openx.net/v/1.0/av?auid=987654&cb={{CACHEBUSTER}}&url={{URL}}&vwd={{WIDTH}}&vht={{HEIGHT}}&c.size=small

PubMatic

To add a PubMatic header bidding demand tag, select Pubmatic from the Platform drop-down.

Once the floor has been set, input the Publisher ID, Ad Slot, and select the linearity.

Rubicon

To add a Rubicon header bidding demand tag, select Rubicon from the Platform drop-down. Once Rubicon has been selected, set the floor do its desired type and value.

Rubicon requires a number of bid parameters, these include account id, site id, zone id, and size id. These can usually be found in your Rubicon endpoint:

http://video-ads.rubiconproject.com/video/[ACCOUNT_ID]/[SITE_ID]/[ZONE_ID]/[SIZE_ID]/vast.xml?tg_c.language=en


The size id in Rubicon indicates the position of the video ad.

Size IDPosition
201

Pre-Roll

202

Interstitial

203OutStream
204Mid-Roll
205Post-Roll
207Vertical Video

Once you've obtained these 4 ids, just input them into the bid parameters of the demand tag and save.

SpotX

To add a SpotX header bidding demand tag, select SpotX from the Platform drop-down. 

When setting the floor for SpotX Header Bidding tags, it's important to keep in mind that SpotX returns net bids, so the floors should be set to a net rate despite the fact that often such rates are displayed in gross within the SpotX platform.

NOTE: For SpotX in particular, both performance and overall bid behavior have historically been adversely affected by mismatched floors. It is because of this that SpringServe recommends that floors in SpotX are set to an equivalent value to the floor in SpringServeImage Removed, and recommend static floors over dynamic floors.

Once the floor set, the only bid parameter required is the SpotX Channel ID. This can be found on the selected channel in SpotX:

Image Added

Or in the url or that same page in parentheses:

Image Added

Or in the SpotX tag itself just before "?VPAID":

Image Added

Lastly, input this channel id in its respective field in SpringServe.

Telaria

To add a Telaria header bidding demand tag, select Telaria from the Platform drop-down. 

...

The supply code is the id directly before "ads.tremorhub.com" (in red), and the ad code is found in the "adCode" querystring parameter (in purple).

Once these ids are retrieved, input them into their respective fields in SpringServe.

Vuble

To add a Vuble header bidding demand tag, select Vuble from the Platform drop-down.

Once the floor has been set, input the Publisher ID, Zone ID, and select the Environment and Context.

Yield Nexus

To add a Yield Nexus header bidding demand tag, select Yield Nexus from the Platform drop-down.

Once the floor has been set, input the SPID and set the "Is An Interstitial" flag. 

Optional Parameters

SpringServe offers publishers the ability to pass additional parameters on header bidding demand tags for certain platforms. If optional params are available for that platform, you should see a place to add them in the "Bid Parameters" section of the demand tag settings. Simply click "+Optional Parameter" to add a new parameter.  Clicking this button will allow you to choose from a drop-down of keys, with a field for the values to the right. These params will be different depending on the platform that is selected. 

NOTE: Users must pass values that are compatible with that key. Macros are accepted as well for certain keys, but not all. See tables below for reference.

AppNexus Optional Parameters

(see AppNexus documentation for complete descriptions of each param)

ParameterExample InputMacros Accepted
code1234567yes
context1no
ext_inv_code22yes
frameworks2,3,4no
keywordskey=value&external_id=5419yes
maxduration60no
mimes1,2no
minduration15no
playback_method2no
position1no
prevent_dealsfalseno
skippabletrueno

NOTE: "Keywords"  is AppNexus' parameter for custom key-value pairs. These should all be inputted in the same field, separated by ampersands.

DO NOT include the "kw_" prefix in the keys that is sometimes found in other types of AppNexus calls.

OpenX Optional Parameters

ParameterExample InputMacros Accepted
customParamskey=value&list[]=entry1&list[]=entry2yes

NOTE: The "customParams" parameter for OpenX is an object that allows strings and string arrays. In the example above, the object contains both a list, list = ['entry1', 'entry2'], and a string, key='value'.

Rubicon Optional Parameters

ParameterExample InputMacros Accepted
inventoryrating[]=5-star&prodtype[]=tech&prodtype[]=mobileyes
visitorucat[]=new&search[]=iphoneyes

NOTE: Both of the Rubicon optional params are objects that take string arrays as their values.

SpotX Optional Parameters

(see SpotX documentation for complete descriptions of each param)

ParameterExample InputMacros Accepted
ad_mutefalseno
content_id9876543210

yes

customcategory=sports&wgt=9&vid=testyes

NOTE: Similar to AppNexus "keywords", the SpotX "custom" parameter is where custom key-value pairs should be inputted, separated by ampersands.



Removing Fees for Bidders Returning Gross Prices

Some bidders will return bid prices that are gross to the seller, meaning that the bidder's fee(s) have not been taken out of the bid price. This is problematic because it has the potential to give those bidders an unfair advantage over others that return net bids, and it can cause issues for rev share/dynamic supply tags that rely on an accurate revenue number to calculate cost. 

In order to solve for such bidders, SpringServe has the option on the Demand Partner or the Campaign to remove a fee % directly from the bid price. This will allow SpringServe to net out the bids from such bidders and report on this net amount as opposed to the gross value.

Image Added

NOTE: Enabling this option means that the fee is taken out of the revenue in reporting instead of being logged as a third party fee.