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

# Баннер

> Баннер: рекламный блок заданного размера на странице. Код вставки, размеры, таймаут, показ при отсутствии рекламы и события.

Баннер показывает картинку или HTML-креатив в блоке заданного размера. Код загружает рекламу при открытии страницы: аукцион выбирает самую дорогую подходящую ставку.

## Код вставки

Вставьте код в то место страницы, где должен быть баннер. Код состоит из блока `<div>` и скрипта.

```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>
```

Один код — одно место на странице. Не вставляйте один и тот же код дважды: у блоков совпадёт `id`, и реклама покажется только в одном. Для второго места добавьте ещё одну площадку.

Код меняется вместе с настройками. После изменения настроек скопируйте код заново и замените старый на сайте.

## Настройки

*Скриншот: Настройки площадки*

| Поле | По умолчанию | Что делает |
| --- | --- | --- |
| **Размеры** | 300×250 | Размеры баннера. Можно выбрать несколько из списка (300×250, 728×90, 300×600, 160×600, 320×50) или добавить свой кнопкой **Добавить размер**. Больше размеров — больше подходящих объявлений |
| **Метка «Реклама»** | включено | Показывать над баннером метку «Реклама» и сведения о рекламодателе. Если выключить, сведения о рекламодателе тоже скрываются |
| **Таймаут аукциона (сек)** | 1 | Сколько ждать ставки: от 0,1 до 3 секунд. Меньше — баннер появится быстрее, но ставок может прийти меньше |
| **Показ при отсутствии рекламы** | выключено | Что делать с блоком, если рекламы нет: **Скрыть блок** или **Показать свой HTML**, см. ниже |
| **Мин. ставка (CPM)** | пусто | Минимальная цена в долларах США за 1000 показов |

**Таймаут аукциона (сек)** находится в группе **Расширенные настройки** внизу формы.

### Показ при отсутствии рекламы

Если включить **Показ при отсутствии рекламы**, выберите **Поведение**:

| Значение | Что происходит |
| --- | --- |
| **Скрыть блок** | Блок баннера скрывается, на странице не остаётся пустого места |
| **Показать свой HTML** | В блоке показывается ваш HTML из поля **HTML для passback**: например, код другой рекламной сети или свой баннер. Скрипты в HTML выполняются |

Так же блок ведёт себя, если реклама не загрузилась из-за ошибки или таймаута.

## События

Подпишитесь на события, чтобы узнать, чем закончилась загрузка. Вместо `#ytrgt-…` укажите `id` блока из вашего кода.

```html
<script>
ytrgt('hb:on', '#ytrgt-3f9c2b7e5d1a4c6e8b0f2a9d7c5e3b1a', 'hb:rendered', function (bid) { console.log('Показан баннер', bid.w, bid.h); });
ytrgt('hb:on', '#ytrgt-3f9c2b7e5d1a4c6e8b0f2a9d7c5e3b1a', 'hb:nobid', function () { console.log('Рекламы нет'); });
</script>
```

| Событие | Когда |
| --- | --- |
| `hb:win` | Выбрана ставка, креатив начал загружаться |
| `hb:rendered` | Креатив показан |
| `hb:nobid` | Подходящей рекламы нет |
| `hb:error` | Ошибка сети, таймаут или креатив не отрисовался |

Подписку можно ставить до или после кода вставки.

## Какая реклама показывается

Баннерные кампании подходящих размеров.

## Что дальше

- Показывать в том же блоке и баннеры, и видео: [«Мультиформат»](./multiformat.md).
- [Нет показов](../troubleshooting/no-impressions.md)
