HTML5 banner requirements

Technical requirements

HTML5 banners must be ZIP files no larger than 150 KB that contain one HTML file and JavaScript, JSON, CSS, JPEG, GIF, PNG, and SVG files. The file and directory names can only contain Latin letters, digits, and the symbols -._~.

An archive can not contain more than 20 files. Include source code from JavaScript, CSS, and SVG in the HTML file and combine all bit maps into a single file (a sprite atlas).

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

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">

When a user clicks on the banner, the page indicated in the Link to site field on the page where you create and edit ad groups will open. 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// add the href attribute value as shown below: <script>    document.getElementById("click_area").href = yandexHTML5BannerApi.getClickURLNum(1); </script>

All links in the banner should be related and lead to different files from the archive.

External calls to the JavaScript libraries located on Yandex servers are allowed in the banner. If the banner uses a different library, include it in the archive source code.

Moderation requirements

HTML5 banners must meet Yandex.Direct rules:

  • You can not use rapidly moving and flashing graphical elements and flickering backgrounds. The time it takes to switch between frames of animation should be sufficient to read all of the text shown on that 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 over the entire duration of the ad campaign in the following browsers: Yandex.Browser 14 and above, 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 (for example scripts that launch pop-ups, spoof IP addresses, etc.), browser extensions or plugins (Adobe Flash, etc.). The banner source code should not be obfuscated.

  • HTML5 banners must meet processor utilization requirements.

More about moderation requirements for display campaign creatives.