---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.3
alternate:
  - https://yandex.com/dev/rtb/doc/ru/ssp/banner-ads.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/rtb/doc/ru/llms.txt

# Баннерная реклама

Баннерная реклама не всегда представляет собой статичную картинку, как правило это контейнер — iframe в Web или WebView в InApp, внутри которого исполняется HTML, CSS и JavaScript (HTML5-баннеры, интерактив, анимация). Баннерная реклама поддерживает MRAID версий 2.0 и 3.0.

При отправке запроса к DSP необходимо точно описать рекламное место. Основные поля объекта `banner`:

#|
|| **Параметр** | **Описание**||
|| `format` | Размеры: `w` — ширина, и `h` — высота. ||
|| `mimes` | MIME-типы — указывает, какие форматы файлов поддерживает площадка. Например: `["image/jpeg", "image/png", "text/html", "application/javascript"]`. Если площадка не поддерживает HTML5, она не передаст text/html. ||
|| `pos` | Позиция на экране — параметр для оценки видимости. Возможные значения:
- `1` — видимая часть экрана без скролла (ATF, Above the Fold);
- `3` — нужно скроллить вниз (BTF, Below the Fold);
- `7` — на весь экран (Fullscreen). ||
|| `battr` | Блокируемые атрибуты (Blocked Attributes). Паблишер может запретить определенные типы креативов, например: 
- `1` — со звуком; 
- `8` — вызывающие всплывающие окна; 
- `3/4/5` — раскрывающиеся (expandable). ||
|| `api` | Поддерживаемые фреймворки — передает поддержку стандартов. Возможные значения: 
- `3` — MRAID 1.0
- `5` — MRAID 2.0
- `6` — MRAID 3.0
- `7` — OMID 1.0 для замера viewability. ||
|#

Более подробно про параметры поля `banner` [в документации IAB](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/main/AdCOM%20v1.0%20FINAL.md#list--creative-attributes-).

### Пример запроса

В этом примере площадка (мобильное приложение) запрашивает баннер. Место поддерживает два размера, находится в верхней части экрана, поддерживает HTML5 и MRAID, но запрещает баннеры со звуком:

``` json
{
  "id": "req-89b-432a-99ef-12345",
  "imp": [
    {
      "id": "imp-1",
      "bidfloor": 1.50, 
      "bidfloorcur": "USD",
      "banner": {
        "format": [
          { "w": 300, "h": 250 },
          { "w": 320, "h": 250 }
        ],
        "mimes": [
          "image/jpeg",
          "image/png",
          "text/html"
        ],
        "pos": 1,
        "battr": [ 1, 8 ], 
        "api": [ 3, 5, 7 ] 
      }
    }
  ],
  "app": {
    "bundle": "com.developer.coolgame",
    "name": "Cool Puzzle Game",
    "publisher": { "id": "pub-99" }
  },
  "device": {
    "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 16_4 like Mac OS X)...",
    "ip": "192.168.1.1",
    "ifa": "00000000-0000-0000-0000-000000000000",
    "os": "iOS",
    "osv": "16.4"
  }
}
```

### Пример ответа

DSP анализирует запрос, находит подходящего рекламодателя и делает ставку. Она должна передать сам креатив (код баннера), цену, которую готова заплатить, и домен рекламодателя.

``` json
{
  "id": "req-89b-432a-99ef-12345",
  "seatbid": [
    {
      "seat": "dsp-seat-42",
      "bid": [
        {
          "id": "bid-98765",
          "impid": "imp-1",
          "price": 2.10,
          "w": 300,
          "h": 250,
          "adomain": [ "domain.com" ],
          "crid": "creative-shoes-300x250",
          "adm": "<!-- Рекламный код начинается здесь --><a href='https://click.dsp.com/track?bid=98765' target='_blank'><img src='https://cdn.dsp.com/nike-banner-300x250.jpg' width='300' height='250' border='0'></a><img src='https://imp.dsp.com/track?bid=98765' width='1' height='1' style='display:none;'><!-- Конец рекламного кода -->"
        }
      ]
    }
  ],
  "cur": "USD"
}
```

{% cut "Примеры отображения Banner (Display)" %}

![](../_images/banner_billboard2_example.png)

![](../_images/banner_billboard_example.png)

![](../_images/banner_horiz_example.png)

![](../_images/banner_square_example.png)

{% endcut %}