<!-- https://docs.youtarget.com/publisher/en/reference/banner.html -->

# Banner

> Banner: an ad block of a set size on the page. Embed code, sizes, timeout, no-fill fallback and events.

A banner shows an image or an HTML creative in a block of a set size. The code loads the ad when the page opens: the auction picks the highest suitable bid.

## Embed code

Paste the code where the banner should be on the page. The code consists of a `<div>` block and a script.

```html
<div id="ytrgt-3f9c2b7e5d1a4c6e8b0f2a9d7c5e3b1a"></div>
<script>
!function(w,d,s,o,f,js,fjs){w[o]=w[o]||function(){(w[o].q=w[o].q||[]).push(arguments)};w[o].q=w[o].q||[];js=d.createElement(s);fjs=d.getElementsByTagName(s)[0];js.async=1;js.src=f;fjs.parentNode.insertBefore(js,fjs)}(window,document,'script','ytrgt','https://cdn.example.com/runtime.js');
ytrgt('hb:load', '#ytrgt-3f9c2b7e5d1a4c6e8b0f2a9d7c5e3b1a', {"endpoint": "https://hb.example.com/hb", "publisherId": "3f9c2b7e5d1a4c6e8b0f2a9d7c5e3b1a", "sizes": [[300, 250]], "tmax": 1000, "showAdMark": true});
</script>
```

One code, one place on the page. Do not paste the same code twice: the blocks get the same `id`, and the ad shows in only one of them. For a second place, add another publisher.

The code changes with the settings. After you change the settings, copy the code again and replace the old one on your site.

## Settings

*Screenshot: Publisher settings*

| Field | Default | What it does |
| --- | --- | --- |
| **Sizes** | 300×250 | Banner sizes. Select several from the list (300×250, 728×90, 300×600, 160×600, 320×50) or add your own with the **Add size** button. More sizes mean more suitable ads |
| **Show "Ad" label** | on | Shows the "Ad" label and advertiser details above the banner. If you turn it off, the advertiser details are hidden too |
| **Auction timeout (sec)** | 1 | How long to wait for bids: from 0.1 to 3 seconds. Shorter means the banner appears faster, but fewer bids may arrive |
| **No-fill fallback** | off | What to do with the block if there is no ad: **Collapse block** or **Show custom HTML**. See below |
| **Floor price (CPM)** | empty | The minimum price per 1,000 impressions in US dollars |

**Auction timeout (sec)** is in the **Advanced settings** group at the bottom of the form.

### No-fill fallback

If you turn on **No-fill fallback**, select the **Mode**:

| Value | What happens |
| --- | --- |
| **Collapse block** | The banner block is hidden, and no empty space is left on the page |
| **Show custom HTML** | The block shows your HTML from the **Passback HTML** field: for example, another ad network's code or your own banner. Scripts in the HTML run |

The same applies if the ad failed to load because of an error or a timeout.

## Events

Subscribe to events to find out how loading ended. Instead of `#ytrgt-…`, use the block `id` from your code.

```html
<script>
ytrgt('hb:on', '#ytrgt-3f9c2b7e5d1a4c6e8b0f2a9d7c5e3b1a', 'hb:rendered', function (bid) { console.log('Banner shown', bid.w, bid.h); });
ytrgt('hb:on', '#ytrgt-3f9c2b7e5d1a4c6e8b0f2a9d7c5e3b1a', 'hb:nobid', function () { console.log('No ad'); });
</script>
```

| Event | When |
| --- | --- |
| `hb:win` | A bid is selected, and the creative starts loading |
| `hb:rendered` | The creative is shown |
| `hb:nobid` | There is no suitable ad |
| `hb:error` | A network error, a timeout, or the creative failed to render |

You can subscribe before or after the embed code.

## Which ads are shown

Banner campaigns with suitable sizes.

## Next steps

- Show both banners and videos in the same block: see [Multiformat](./multiformat.md).
- [No impressions or revenue](../troubleshooting/no-impressions.md)
