Configuring RTB blocks

To edit added blocks, go to the list of blocks (Products → RTB blocks), find the block you need, and click Edit.

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

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

A high privacy level (“no information sent”, “minimal”) can lower the revenue from an ad block. Ad impressions on an unspecified ad platform are sold at auction at a lower price than for ad impressions on a well-known content site.

Block format and media banner formats

Use Direct and Media advertising tabs to edit the set of formats for RTB block ads. Read more about types and formats of RTB blocks.

You can also change the maximum number of Yandex.Direct ads for flexible ad blocks (with the exception of square ones) and for custom-size ad blocks on the Yandex.Direct tab.

  • For horizontal ad space — from 1 to 4.
  • For vertical ad space and custom-size blocks — from 1 to 9.
A maximum of two Yandex.Direct ads can be placed in an adaptive ad block.

Configuring Yandex.Direct ad design

You can change the visual design of Yandex.Direct ads in the RTB block by specifying custom font and frame settings and color options on the Yandex.Direct tab. You can also disable showing sitelinks and advertiser website icons. All configuration changes will be immediately visible in the test block. The design of your ad block significantly influences the CTR and, consequently, your site revenue.

In addition, you can enable and disable impressions for ads with images on content sites.

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. Read more about strategies.

Displayin your own ads in an RTB block

You can embed your ad code inside the RTB ad block code in order to display ads from other advertising systems in the same ad space, or to insert a placeholder if there aren't any suitable auction offers for showing an ad. The number of ad impressions depends on the chosen strategy.

  • The RTB block code cannot be inserted into the code of other advertising systems.

  • Do not specify the Yandex.Direct ad block code as your advertisement code.

If you want to specify static HTML as your ad code (a placeholder image, for instance), add the appropriate code in the Your ad code field on the Strategy tab. Specify the size of your ad block. The part of the code required to display your ads will be generated and inserted in the ad code automatically. Manually reinstall the code on the website after saving the block.

If you want to add third-party ad code, use a manual code insert.

Settings for regional impressions

You can limit RTB impressions for website users from specific geographic regions on the Geography tab.

Select one or more regions in the list and specify the CPM threshold in rubles (excl. VAT) in the CPM field. Subregions inherit the CPM threshold from the top level region.

Restrictions for media ads

Use the Categories tab to restrict showing media ads with certain themes. Select one or more categories in the list, and specify the CPM threshold in rubles (excl. VAT) in the CPM field. Subcategories inherit the CPM threshold from the parent category.

Use the Brands tab to restrict impressions for certain brands (for example, competitor brands). This setting only works for media ads provided by the Yandex media ad system or external DSP systems. We receive the list of brands from our partner TNS Russia. To add an advertiser or brand to the restrictions list, start typing the brand name in the entry field. Select the brand from the suggestions. Specify the CPM threshold in rubles (excl. VAT ) for the selected brand, or click Block.

If you did not find a particular category or brand in our list, contact the Support service.

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:

<div id="yandex_rtb_R-A-12345-1"></div>

For the 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 </body> tag or in a separate JavaScript file.

General settings for content sites

Note that RTB ad blocks use the settings that you configured for content sites: