HTML 5 banner requirements

Media campaigns are undergoing beta testing.

Technical requirements

HTML 5 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 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 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="click1_area" href="#" target="_blank">...</a>
// after the "<a href...></a>" element 
// assign them the href attribute values as follows:
document.getElementById("click1_area").href = yandexHTML5BannerApi.getClickURLNum(1);

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

HTML 5 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 HTML 5 banner).

  • HTML 5 banners must work correctly and the same way for all users on all platforms during the entire campaign period in the following browsers: Yandex Browser 14 and later, Google Chrome 14 and later, Mozilla Firefox 14 and later, Opera 14 and later, Internet Explorer 9 and later, Microsoft Edge.

  • In HTML 5, you can not 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.

  • HTML 5 banners must meet processor utilization requirements.

    Processor utilization requirements

    A computer with an Intel Core 2 Duo P9600 2.53 GHz processor, 2 GB of RAM, 64-800 MB of video memory, and a 64-bit version of Windows 7 Professional is used to test processor utilization. A page containing only a test banner is loaded on it. When the system is tested this way, the banner shouldn't utilize more than 50% of the CPUs over a measurable time period (a fraction of a second) or more than 70% of the CPUs at any given moment. A standard “Task manager” is used to measure processor utilization.