Configuring RTB blocks
To edit the blocks you added, go to the list of RTB blocks: Edit., find the desired block, and click
All visual configuration changes in the block take effect automatically (without resetting the website code) within 30 minutes after changes are saved. If the code loading method (synchronous/asynchronous) or your ad code changes, the website code must be reset manually.
- Privacy level
- Block format and media banner formats
- Customizing the appearance of Yandex.Direct ads
- Traffic management strategies
- Displayin your own ads in an RTB block
- Location-based ad serving
- Restrictions for display ads and video ads
- Moderation of advertising platforms
- Asynchronous ad code
- General settings for content sites
- Archiving an RTB block
The Privacy level can be configured to limit the information transmitted about the platform to third-party advertising systems (DSP). Use the General tab to edit the privacy level.
How to send information about the ad platform:
- in full — Transmits the domain and URL of the page where the block is located (default value).
- partial — Transmits only the ad platform domain.
- minimal — Transmits only the second-level domain.
- no information sent
Block format and media banner formats
You can change the formats available for the RTB block on the Advertising formats tab. Read more about types and formats of RTB blocks.
On the Advertising formats tab, you can also change the maximum number of Yandex.Direct ads in the stretching blocks (except the square blocks) and the custom-size block:
- For horizontal ad space: from 1 to 6.
- For vertical ad space and custom-size blocks: from 1 to 9.
Customizing the appearance of Yandex.Direct ads
On the Advertising formats tab, you can change the visual design of Yandex.Direct ads in the RTB block by specifying your own font settings, border settings, and color parameters. You can also disable showing sitelinks and advertiser website icons. All changes will be instantly visible in the test block.
The design of your ad block significantly influences the CTR and, consequently, your site revenue.
Traffic management strategies
You can select a traffic management strategy on the Strategy tab.
Displayin your own ads in an RTB block
By adding your ad code to an RTB block code, you can display ads from other ad systems in the same ad spot or install a stub in case the auction has no suitable offer to serve. The number of ad impressions depends on the chosen strategy.
You can't use the RTB block code as the alternative code in other advertising systems.
Do not specify the Yandex.Direct ad block code as your advertisement code.
To configure ad serving for your custom ad, on the Strategy tab add the code to the Custom ad code field. Specify the size of your ad block. The code snippet for displaying your ad will be generated and added to the RTB block code automatically. Save your changes. You don't need to reinstall the code on your site.
If the auction finds no suitable offer (based on the selected strategy), your custom ad code is run. The ad will be shown in place of the ad block using iFrame. Such impressions are included in the Impressions of own ads in RTB blocks parameter in YAN statistics.
There's yet another method to set up your ad display: you can add your ad code to the RTB block code when placing the ad block on the site.
Location-based ad serving
You can limit RTB impressions for website users from specific geographic regions on the Geography tab.
In the region tree, select one or more regions and use the CPM field to set the CPM threshold in rubles without VAT. The CPM threshold of a higher-level region is automatically applied to all its nested regions.
Restrictions for display ads and video ads
You can limit the impressions of display ads and video ads of certain subjects on the Subjects tab.
In the list of subjects, select one or more categories, and use the CPM field to set the CPM threshold in rubles (without VAT). The CPM threshold of a category is automatically applied to all its subcategories.
To exclude individual brands from display ads (for example, the brands of your competitors), go to the Brands tab. This setting only works for media ads and video ads provided by the Yandex media ad system or external DSP systems. The brand list is provided by TNS Russia. To add an advertiser or brand to the blacklist, start typing their name in the designated field. Select the desired brand from the drop-down list. You can then set the brand's CPM threshold (in rubles, excluding VAT) or Block it.
If you did not find a particular category or brand in our list, contact the Support service.
Moderation of advertising platforms
YAN lets you place ads not only from Yandex.Direct, but also from ad platforms that Yandex has an agreement with. All the ads are moderated by Yandex. Moderators check the ads for compliance with the requirements, including the legal requirements of the country where the ads are displayed.
To expand the range of available ads, you can enable the Moderation on the DSP side option on the DSP tab in the RTB block settings. Please note that:
- Ads from the selected DSPs are moderated only on the DSP side.
Restrictions on subjects and brands won't apply to such DSPs.
- Ads from other platforms and from Yandex.Direct are moderated by Yandex.
By default, ad serving is disabled for ads moderated on the DSP side.
By enabling ads moderated on the DSP side, you agree to clause 3.16 of the YAN Terms of Participation.
Asynchronous ad code
Use the RTB code insert for a website form in the visual code designer (Obtain code button) to select the type of code execution: synchronous or asynchronous. If standard (synchronous) code is used, the page content and its ad block are loaded sequentially. Asynchronous code lets you load them at the same time. This reduces the total time needed to load the page.
Asynchronous code syntax differs from synchronous code syntax, so if you want to change the execution type, obtain a new version of the code in the designer and manually reinstall it on the website. We recommend using one execution type for all blocks on the same website page.
Select the Asynchronous code checkbox to use asynchronous code. Insert the following code in the place where the ad block should be displayed:
id variable, replace
yandex_rtb_R-A-12345-1 with a custom ad block ID — the same as in the ad code received from the ad designer.
The ad code should be inserted after this element. For example, it should be inserted at the end of the page's HTML code before the
General settings for content sites
Note that RTB ad blocks use the settings that you configured for content sites:
Archiving an RTB block
If you don't use an RTB block anymore, archive it. To do this, find a block in the list and click Archive. You can restore archived blocks by going to the Archive tab.