Technical requirements for banners

You can upload an image banner or HTML5 banner.

Technical requirements for HTML5 banners

HTML5 banners must be ZIP files that contain one HTML file and JavaScript, JSON, CSS, JPEG, GIF, PNG, or SVG files. You can add several variants of your HTML5 banner to be served on different screens or Yandex Home page versions:

Full Yandex Home page version Mobile Yandex Home page version New tab page
Screen regular HiDPI
Size in pixels 728 × 90 1456 × 180 640 × 134 1456 × 180
Maximum archive size 1 МВ

Currently, HTML5 banners are not available for the mobile version of the Yandex Home page.

The archive and its files must meet the following requirements:
  1. The file and directory names can only contain Latin letters, digits, and the symbols -._~.

  2. All links in an HTML5 banner must be relative and lead to other files in the archive.

  3. The archive can contain up to 20 files. Include source code from JavaScript, CSS, and SVG in the HTML file and combine all bitmaps into a single file (a sprite atlas).

  4. The maximum size of the archived index.html must be less than 150 KB.

  5. All event handlers must be explicitly specified within the script tag, for example:

    <script>
        document.onload = init;
    </script>
  6. When a user clicks on an HTML5 banner, this opens the page indicated in the Link to site field on the page where you create or edit ad groups. Calls to the yandexHTML5BannerApi.getClickNum(1) method should generate click-throughs to that page in the banner.

    <a id="click_area" href="#" target="_blank">...</a> 
    // after the "<a href ...></a>" element, 
    // assign the value of the href attribute like this: 
    <script> 
       document.getElementById("click_area").href = yandexHTML5BannerApi.getClickURLNum(1); 
    </script>
  7. The HTML5 banner size must be specified in the content attribute of the meta tag. See the example below:
    <meta name="ad.size" content="width=728,height=90">
    or
    <meta name="ad.size" content="width=1456,height=180">
  8. External calls to Yandex-hosted JavaScript libraries are allowed. If an HTML5 banner uses a different library, include it in the archive source code.

  9. The link in an HTML5 banner must not exceed 1024 characters and must be UTF-8 encoded.

  10. The banner must not use statistics collection tools (pixels, tags, etc.).

    When you create a campaign, you can specify a Yandex.Audience pixel or ADFOX tag (for details, see How to launch a campaign). You can also use UTM tags in the link to your website.

  11. A banner can feature the View again button for restarting the animation scenario.

The archive will ignore the contents of the __MACOSX folder andDS_Store and Thumbs.db files. These are the operating system's auxiliary files which are not necessary for the HTML5 banner to work.

Download a sample HTML5 banner

Technical requirements for image banners

You can add several variants of your image banner to be served on different screens or Yandex Home page versions:

Full Yandex Home page version Mobile Yandex Home page version New tab page
Screen Regular HiDPI
Size in pixels 728 × 90 1456 × 180 640 × 134 1456 × 180
Maximum file size 1 MB
Format JPG, PNG or GIF