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 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. A click on the banner opens the page specified in the Link to site or Turbo page field, the mobile app (if installed), or the app page in the store (if the app is not installed). Banner clicks must open this page by calling the yandexHTML5BannerApi.getClickURLNum(1) method.

   |||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.
13. The advertised site must open in a new window (and only open after a user clicks on the HTML5 banner).

14. HTML5 banners should display correctly and work the same way for all users on all platforms throughout the ad campaign in the following browsers: Yandex Browser 14 and higher, Google Chrome 14 and higher, Mozilla Firefox 14 and higher, Opera 14 and higher, Internet Explorer 9 and higher, and Microsoft Edge.

15. In HTML5, you can't use video or audio clips, script behavior that is annoying or malicious (like scripts that launch pop-ups or spoof IP addresses), browser extensions or plugins (Adobe Flash and others). The banner source code should not be obfuscated, meaning it should not be difficult to analyze.

16. HTML5 banners must meet CPU utilization requirements.

    CPU utilization requirements

    A computer with Intel Core 2 Duo P9600 2.53 GHz CPU, 2 GB of RAM, 64-800 MB of video memory, and the 64-bit version of Windows 7 Professional is used to test CPU utilization. A single page containing only the banner under testing is loaded. The banner shouldn't utilize more than 50% of the CPU over a measurable time period (a second or a fraction of a second) or more than 70% of the CPU at any given moment. The Task Manager is used to measure processor utilization.

Download a sample HTML5 banner

Check the recommendations for displaying HTML5 banners too.

Moderation requirements