Requirements for banners

Technical requirements for image banners

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 characters -._~.

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 index.html file in the archive must be under 150 KB.

5. The contents of the __MACOSX folders and the .DS_Store and Thumbs.db files will be ignored in the archive. These are the operating system's auxiliary files which are not necessary for the HTML5 banner to work.

6. A click on the banner opens the page specified in the Link to site field, a mobile app (if installed), or the app's page in an app store (if the app isn't installed). Banner clicks must open this page by calling the yandexHTML5BannerApi.getClickURLNum(1) method.

   <a id="click_area" href="#" target="_blank">...</a> 
    // after the "<a href ...></a>" 
    element,  // assign its href attribute as follows:
     <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=640,height=268">

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

Check the recommendations for displaying HTML5 banners too.

Moderation requirements