Macros
The banner is embedded on the page using an HTML block called a binding. The binding can contain macros, which are special symbols that the RTB host replaces with values.
In the binding, a macro starts with the dollar symbol, followed by the macro name in curly brackets. An example of the AUCTION_ID macro is shown below.
http://www.admaster.com/landing${AUCTION_ID}
RTB host macros
The RTB host replaces the following macros with its own values.
| Macro | Value |
|---|---|
| AUCTION_ID | Auction ID ( id from the RTB host request) |
| AUCTION_IMP_ID | Ad block ID ( id of the Impression object from the RTB host request). |
| AUCTION_BID_ID | ID of the auction proposal ( bidid from the DSP response). |
| AUCTION_PRICE | Cost of a package of impressions. The package currency is specified in the DSP response (the cur parameter). |
| AUCTION_PAGE_URL | The URL of the page for displaying ads. |
| AUCTION_LOSS | Reason for auction loss. The status corresponds to the status from the Notification for reason for loss section. |
| AUCTION_CURRENCY | The currency in which the bid is specified. |
Alert
The names of these macros are case-sensitive. The RTB host only recognizes uppercase letters.
ID of the auction, assigned by the RTB host. The DSP returns this ID in the response.
ID of the advertising block on the HTML page.
ID of the auction proposal using the DSP's internal numeration.
Currency that the bid is shown in price parameter. Acceptable values:
- RUB — Russian ruble.
- USD — United States dollar.
- EUR — Euro.
- CHF — Swiss franc.
- TRY — Turkish lira.
- KZT — Kazakhstani tenge.