Guides

Yandex Banners. Mediasniper Requirements

Suggest Edits

Technical requirements for HTML banners for running on Yandex.

  1. File format - zip.
  2. Max file size is 150 KB.
  3. Archive may contain main html-file and some other files (JS, JSON, CSS, JPG, GIF, PNG, SVG).

❗️

Archives will ignore content of __MACOSX folder and .DS_Store files. They are created while archiving on Apple Mac OS X and they aren't required for running ad materials.

  1. Files and directories names may contain the following characters:
    -._~ , numbers and Latin letters.
  2. All the links in ad materials must be a relative path in the zip archive. When creating the ad there must not be any external network access. If you use any external JS libraries, you must provide them with ad materials together.
  3. It is required to minimize the number of files in the archive and combine images into one sprite sheet. It is possible to merge all JS/CSS/Image documents into one HTML file, if appropriate. Max number of files is 50.
  4. Ad materials must run correcrly in the following browsers: Internet Explorer 9 and higher, Firefox 14 and higher, Safari 5 and higher, Chrome 14 and higher, Opera 14 and higher, Яндекс.Браузер 14 and higher, Microsoft Edge. It is important to consider browser operability requires for its working.
  5. Adverised website must be opened in a new window with the left button clicking on the banner.
  6. Clicks on the banner must receive the address of the advertiser’s landing page via yandexHTML5BannerApi.getClickURLNum(1) for the first click, yandexHTML5BannerApi.getClickURLNum(2) for the second click etc.
<a id="click1_area" href="#" target="_blank">...</a> 
<a id="click2_area" href="#" target="_blank">...</a> 
// after announcing tags "<a href ...></a>" 
// assign click handlers for them as follows: 
<script> 
   document.getElementById("click1_area").href = yandexHTML5BannerApi.getClickURLNum(1); 
   document.getElementById("click2_area").href = yandexHTML5BannerApi.getClickURLNum(2); 
</script>
  1. The tag shows the size of the banner file in the following manner: 
<meta name="ad.size" content="width=300,height=250">
  1. The Yandex ad library must be included immediately after the tag:
<HEAD> 
   <script type="text/javascript" src="https://awaps.yandex.net/data/lib/adsdk.js"> 
   </script>
  1. In ad materials it is permitted to use external links to several base libraries, included in the developer tools for HTML5: Adobe Edge Animate CC, Adobe Flash CC HTML5 Canvas, CreateJS, GreenSock, Swiffy and others. Only external links leading to the site of the library's creator can be allowed in the banner.
  2. A placeholder and ALT text must be added separately to the archive (up to 100 characters). The image must go through separate moderation including the size. Image and text will be used for display in browsers not included in the list of supported browsers from page 7.
  3. It is forbidden to use irritating or harmful script behavior, e.g. calls for the spontaneous opening of pop-up, change of page addresses, etc. It is forbidden to use browser extensions (flash/java etc.).
  4. Ad banner must not lead to confusion (obfuscation).
  5. It is assumed that the banner must behave identically and uniformly in all environments, on all platforms, each time the banner is opened and over all campaign period.
  6. Ad banner must meet the requirements for CPU1 usage.
  7. Ad materials must meet the requirements specified in the document "Banner ads. Advertising requirements", paragraphs 3-10.
  8. The banner animation should not distract user or make it difficult for him to view the website pages (it is forbidden to use banners with flashing and fast-moving graphics as well as backgrounds etc.).
  9. When preparing banners make sure you don't use low-quality graphical elements, including:
  • deformed images or images with artifacts resulting from file compression
  • low-resolution (pixelated) images, or images that are blurry.
  1. Besides, MP4 videos can be loaded (if permitted in the product). The maximum size for the video file is 2 MB.
    Access to videos must be via URL JS call, starting from 1. For example, for video 1
    var url_video1 = yandexHTML5BannerApi.getVideoURLNum(1);
    The video must play only when clearly initiated by the user. It must be possible to stop and restart the video at any moment. The size of the video must be displayed. It is forbidden to play sound separately from the video. For security reasons and for speed up the loading, the video must be stored on Yandex servers.
    Advertiser can count the number of times the video starts. To do it, he must set up a javascript call for each time the button is pressed:
    For video 1: yandexHTML5BannerApi.reportVideoStart(1);
    For video 2: yandexHTML5BannerApi.reportVideoStart(2);
  2. Audio clips are not supported.
    An example of a completed HTML5 banner is available to download here. The example code shows how points 5, 8, 9, 10, 11, and 12 are completed.

Updated about 3 years ago