# Headerbidding

  This sub-module sets up and manages headerbidding library [Prebid.js](https://docs.prebid.org/prebid/prebidjs.html) to run a client-side auction, before making a request to an adserver.
  Read more at https://docs.prebid.org/prebid/prebidjs.html

  Ads from headerbidding are rendered into a new iframe (with -hb-iframe postfix) usually within the same target element. The previous adserver iframe (that delivered just a script instruction to use the HB creative) is simply hidden with CSS. This is called "service creative" ("odbavovací kreativa" in czech)

  When adserver responds, we parse the response to see if HB won. In that case we skin catching of custom creatives and run it with a call from within the service creative.

## Service creative examples

### SAS
```html
  <!-- HB kreativa Area:%%AREA%% FCID: %%FCID%% Flight: %%FLIGHTID%% BidTier: %%BIDTIER%% -->
  <script type='text/javascript'>top.cpexPackage.headerbidding.reRender('%%AREA%%')</script>
  <!-- HB kreativa konec -->
```

### Demand manager example (iinfo)
```html
  <script src="https://ads.rubiconproject.com/prebid/creative.js"></script>
  <script>
    const ucTagData = {}
    ucTagData.adServerDomain = ""
    ucTagData.pubUrl = "%%PATTERN:url%%"
    ucTagData.adId = "%%PATTERN:hb_adid_appnexus%%"
    ucTagData.cacheHost = "%%PATTERN:hb_cache_host%%"
    ucTagData.cachePath = "%%PATTERN:hb_cache_path%%"
    ucTagData.uuid = "%%PATTERN:hb_cache_id_appnexus%%"
    ucTagData.mediaType = "%%PATTERN:hb_format_appnexus%%"
    ucTagData.env = "%%PATTERN:hb_env%%"
    ucTagData.size = "%%PATTERN:hb_size_appnexus%%"
    ucTagData.winurl = "%%PATTERN:hb_winurl%%"
    ucTagData.winbidid = "%%PATTERN:hb_bidid_appnexus%%"
    ucTagData.mobileResize = "hb_size:%%PATTERN:hb_size_appnexus%%"
    ucTagData.hbPb = "%%PATTERN:hb_pb_appnexus%%"
    top.cpexPackage.adserver.gamReRender('%%ADUNIT%%', () => { ucTag.renderAd(document, ucTagData) })
  </script>
```