Interactive banner requirements

  1. Technical requirements
  2. Moderation requirements

Technical requirements

An interactive banner is created based on an HTML5 banner: a ZIP archive including a single HTML file and JavaScript, JSON, CSS, JPEG, GIF, PNG, and SVG files. The maximum archive size is 3 MB.

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

  2. All links in an HTML5 banner must be relative and lead to other files in the archive. When the ad materials are served, no external network requests must be made. All the auxiliary JS libraries needed must be provided with the ad materials.

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

    <a id="click_area" href="#" target="_blank">...</a> 
     // after the "<a href ...></a>" 
     element,  // assign its href attribute as follows:
        document.getElementById("click_area").href = yandexHTML5BannerApi.getClickURLNum(1); 
  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 comply with 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 app or store page must open in a new window (and only after the user left-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.

Have questions?

Attention. Our customer service department can only help you with the campaigns created under the same username you use to contact us. You can see your current login in the upper-right corner of the screen. Our team can access your data only when processing your request.

You can contact us from 10:00 to 19:00 (UTC+3) by phone:

Moscow: +7(495)780-65-20

Toll-free within Russia: 8(800)234-24-80, ext. 9


To access campaigns, a customer service specialist will need your PIN.