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 — the domain and URL of the page where the block is located (default value) are sent;
  • partial — only the ad platform domain is sent;
  • minimal — only the second level domain is sent;
  • no information sent.
Tip.

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 elastic units (with the exception of square ones) and for custom units on the Yandex.Direct tab.

  • for horizontal ad space — from 1 to 4
  • for vertical ad space and custom units — from 1 to 9.
The maximum number of Yandex.Direct ads that can be placed in an adaptive unit is 2.

Configuring Direct ad design

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

In addition, you can enable and disable the display of illustrated ads on theme-based platforms.

Please keep in mind that the design of your ad block significantly influences its CTR and, consequently, your site revenue.

Traffic management strategies

You can select a traffic management strategy on the Strategy tab. Read more about strategies.

Showing your 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.

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

  • Do not specify the Yandex.Direct block calling 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 portion of code required to display your ads will be compiled and added to 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.

Regional display settings

You can limit RTB ad display for website visitors 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 banner ads

Use the Themes tab to limit the display of banner ads of certain themes. Select a category or categories in the tree of categories, 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 limit the display of ads of certain brands (for example, competitor brands). This setting only works for banner ads provided by the Yandex banner 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, begin typing its name into 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 theme or brand in our list, please contact our Support service.

Asynchronous ad code

Use the RTB code insert for a website form in the visual code designer (Obtain code button) to select a 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 from 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 theme-based platforms

Please note that all settings defined for a theme-based platform function in RTB blocks.