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

# Нативная реклама

По сравнению с классическими баннерами DSP не присылает готовый дизайн, вместо этого отправляется набор ассетов — тексты, картинки, ссылки, а приложение или сайт (SSP) собирает из них рекламный блок так, чтобы он визуально не отличался от основного контента площадки (шрифты, цвета, отступы).

Для стандартизации этого процесса IAB выпустила отдельную спецификацию [OpenRTB Native Ads Specification](https://iabtechlab.com/wp-content/uploads/2016/07/OpenRTB-Native-Ads-Specification-Final-1.2.pdf).

### Механика работы

Вся логика строится вокруг нативных ассетов (native assets). В `Bid Request` площадка задает список того, что ей нужно для отрисовки рекламы. Каждому ассету присваивается свой ID. DSP должна прислать ответ в соответствии с этими ID.

Основные типы ассетов:

- `title` — заголовок с ограничением по длине, например до 25 символов.
- `image` — основное изображение (например, 1200x627) или иконка/логотип (50x50).
- `data` — различные текстовые элементы:
   - `desc` — описание, текст под заголовком; 
   - `sponsored` — название бренда, например `"Спонсор: Nike"`;
   - `rating` — рейтинг приложения от 1 до 5 звезд;
   - `ctatext` — текст для кнопки: «Купить», «Скачать».

### Особенности Native формата

- Трекинг показов — в баннерах DSP сама контролирует пиксель показа внутри HTML. В нативной рекламе DSP полностью доверяет приложению/сайту (паблишеру) вызов ссылок из массива `imptrackers`. Если разработчик приложения ошибся в коде и не вызывает эти ссылки, реклама будет крутиться бесплатно (показы не засчитаются, деньги не спишутся).

- Экранирование JSON (Stringification) — нативный объект передается как строка внутри поля `adm`: `"adm": "{\"native\":{...}}"`. Если кавычки экранированы неверно, это может приводить к ошибкам при парсинге на стороне SSP.

- Высокий CTR — из-за того, что реклама выглядит как контент сайта/приложения, пользователи кликают на нее значительно чаще, чем на классические баннеры. 

- Разнообразие размеров (Cropping) — SSP часто запрашивают картинку большого размера (например, 1200x627), но предупреждают DSP, что могут обрезать (сделать crop) ее до других пропорций (например, 1:1 или 4:3) при рендеринге. Поэтому главное изображение должно быть по центру (safe zone).

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

По стандарту объект нативного запроса передается внутри поля `imp.native.request`. Чаще всего этот объект передается как экранированная строка (escaped JSON string), но для наглядности представлен в виде обычного JSON-объекта.

``` json
{
  "id": "req-native-777",
  "imp": [
    {
      "id": "imp-1",
      "native": {
        "request": {
          "native": {
            "ver": "1.2",
            "plcmtcnt": 1, 
            "assets": [
              {
                "id": 1,
                "required": 1,
                "title": { "len": 90 } 
              },
              {
                "id": 2,
                "required": 1,
                "img": { "type": 3, "wmin": 1200, "hmin": 627 } 
              },
              {
                "id": 3,
                "required": 0,
                "data": { "type": 2, "len": 140 } 
              },
              {
                "id": 4,
                "required": 1,
                "data": { "type": 12, "len": 15 } 
              }
            ]
          }
        }
      }
    }
  ],
  "site": {
    "domain": "news.com",
    "page": "https://news.com/tech"
  }
}
```

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

В классическом баннере DSP отправляет в поле `adm` полный HTML-код креатива. В нативном формате в поле `adm` отправляется JSON-строка (здесь показана в развернутом виде). DSP должна ответить на те же ID ассетов, которые запросила SSP.

{% note alert %}

Массив ссылок `imptrackers` — очень важный элемент. Так как DSP не отдает HTML-код, она не может сама вставить пиксель показа. Она передает эти ссылки паблишеру, и паблишер обязан выполнить GET-запрос по этим ссылкам в тот момент, когда нативная реклама появится на экране устройства.

{% endnote %}

``` json
{
  "id": "req-native-777",
  "seatbid": [
    {
      "seat": "dsp-22",
      "bid": [
        {
          "id": "bid-555",
          "impid": "imp-1",
          "price": 3.50,
          "adm": "{\"native\":{\"link\":{\"url\":\"https://click.domain.com/promo\",\"clicktrackers\":[\"https://dsp.com/click?bid=555\"]},\"assets\":[{\"id\":1,\"title\":{\"text\":\"Новые кроссовки\"}},{\"id\":2,\"img\":{\"url\":\"https://cdn.domain.com/ad_1200x627.jpg\",\"w\":1200,\"h\":627}},{\"id\":3,\"data\":{\"value\":\"Легкость в каждом шаге. Успей купить со скидкой 20%.\"}},{\"id\":4,\"data\":{\"value\":\"Купить сейчас\"}}],\"imptrackers\":[\"https://dsp.com/imp?bid=555\"]}}"
        }
      ]
    }
  ]
}
```

