Technical requirements for banners

Technical requirements for image banners

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

Technical requirements for HTML5 banners

The archive and files used in the banner 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. 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.

6. When a user clicks on the banner, the page indicated in the Link to site field or a Turbo page opens. Calls to the yandexHTML5BannerApi.getClickNum(1) method should generate click-throughs to that page in the banner.

   |||UNTRANSLATED_CONTENT_START|||<a id="click_area" href="#" target="_blank">...</a> 
   // после элемента "<a href ...></a>" 
   // присваиваем для него значение атрибута href так: 
   <script> 
      document.getElementById("click_area").href = yandexHTML5BannerApi.getClickURLNum(1); 
   </script>|||UNTRANSLATED_CONTENT_END|||

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=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. All event handlers must be explicitly specified within the script tag, for example:

   <script>
       document.onload = init;
   </script>

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

11. 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 (to learn more, see How to launch a campaign). You can also use UTM tags in the link to your website.

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

Download a sample HTML5 banner