HTML5 banner requirements

  1. Technical requirements
  2. Moderation requirements

Technical requirements

HTML5 banners must be ZIP files that contain one HTML file and JavaScript, JSON, CSS, JPEG, GIF, PNG, or SVG files.

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

    <a id="click_area" href="#" target="_blank">...</a> 
    // after the "<a href ...></a>" element, 
    // assign its href attribute like this: 
    <script> 
       document.getElementById("click_area").href = yandexHTML5BannerApi.getClickURLNum(1); 
    </script>
  7. The following banner sizes are allowed: 160×600, 240×400, 240×600, 300×250, 300×300, 300×500, 300×600, 320×50, 320×100, 320×480, 336×280, 480×320, 728×90, 970×250, 1000×120. Specify the banner size in the <meta> element:

    <meta name="ad.size" content="width=300,height=250">
  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.

Moderation requirements

HTML5 banners must follow Yandex.Direct rules:

  • Do not use rapid animations, flickering graphic elements, or a flashing background. The time before switching to the next frame should be long enough to read all of the text shown on the frame.

  • The advertised site must open in a new window (and only open after a user clicks on the HTML5 banner).

  • 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.

  • 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.

  • HTML5 banners must meet CPU utilization requirements.

Learn more about moderation requirements for display campaign creatives.