Configuring RTB blocks

To edit the blocks you added, go to the list of RTB blocks: Products → Content sites → RTB blocks, find the desired block, 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
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

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.
A maximum of two Yandex.Direct ads can be placed in an adaptive ad block.

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.

You can also enable or disable display of illustrated ads and video ads on content sites.

The design of your ad block significantly influences the CTR and, consequently, your site revenue.

Note. You can create multiple designs for an RTB block and use the Design auction tool to select the most profitable design for your site.

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:

<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:

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.