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

# Макросы

Баннер встраивается на страницу с помощью HTML-фрагмента, называемого обвязкой. Обвязка может содержать макросы — специальные мнемоники, которые RTB-хост заменяет на значения.

В обвязке макрос начинается с символа доллар, за которым следует название в фигурных скобках. Ниже показан пример макроса `AUCTION_ID`.

`http://www.admaster.com/landing${AUCTION_ID}`

## Макросы RTB-хоста

Следующие макросы RTB-хост заменяет на собственные значения.

#|
|| **Макрос**  | **Значение**  ||
|| AUCTION_ID       | Идентификатор аукциона ([id](*id) из запроса RTB-хоста). ||
|| AUCTION_IMP_ID   | Идентификатор рекламного блока ([id](*imp_id) объекта Impression из запроса RTB-хоста). ||
|| AUCTION_BID_ID | Идентификатор заявки на участие в аукционе ([bidid](*bidid) из ответа DSP). ||
|| AUCTION_PRICE | Стоимость пакета показов. Валюта пакета указана в ответе DSP (параметр [cur](*cur)). ||
|| AUCTION_PAGE_URL | URL страницы показа рекламы. ||
|| AUCTION_LOSS | Причина проигрыша в аукционе. Cоответствует статусу из раздела [Уведомление о причине проигрыша](https://yandex.com/dev/rtb/doc/ru/api/bid-loss-notification.md). ||
|| AUCTION_CURRENCY | Валюта, в которой указана ставка. ||
||
AUCTION_MINIMUM_BID_TO_WIN
AUCTION_MIN_TO_WIN
MIN_BID_TO_WIN
| Победившая ставка в аукционе. Поддерживается только для `lurl`. ||
|#

{% note alert %}

Имена данных макросов зависимы от регистра. RTB-хост распознает только **верхний регистр**.

{% endnote %}

[*id]: Идентификатор аукциона, присвоенный RTB-хостом. DSP возвращает этот идентификатор в ответе.

[*imp_id]: Идентификатор рекламного блока на HTML-странице.

[*bidid]: Идентификатор заявки на участие в аукционе по внутренней нумерации DSP.

[*cur]: Валюта, в которой указана ставка – параметр `price`. Возможные варианты:
* RUB — российский рубль;
* USD — американский доллар;
* EUR — евро;
* CHF — швейцарский франк;
* TRY — турецкая лира;
* UAH — украинская гривна;
* KZT — казахстанский тенге.