Technical limitations

  1. Restrictions for ads
  2. Restrictions for campaigns and accounts
  3. Video
    1. Videos in Text & Image ads, Campaign Wizard, and display campaigns.
    2. Product video in a unified performance campaign, in a product campaign, and in smart banners
  4. Images
  5. Banners
    1. Banners in image ads
    2. Banners in a display campaign
    3. Banners in a fixed CPM display campaign
  6. Technical requirements for HTML5 banners
  7. Recommendations for displaying HTML5 banners
  8. Have questions?

Restrictions for ads

Maximum number of characters including spaces:

Text & Image ads

  • title — 56 characters (including spaces and punctuation marks), maximum 22 characters per word

  • additional title — 30 characters and 15 punctuation marks, maximum 22 characters per word (in some cases, ads may be displayed without the additional title)

  • ad text — 81 characters and 15 punctuation marks, maximum 22 characters per word (the ad text may be cut off depending on the display location)

  • link — 1024 characters (including protocol)

  • display link — 20 characters (excluding the domain)
  • callouts — 25 characters (including spaces), the total callout length for an ad mustn't exceed 132 characters for desktop impressions and 66 characters for mobile impressions
  • sitelink — 30 characters (title), description — maximum 60 characters
Ads for mobile apps

  • title — 56 characters (including spaces and punctuation marks), maximum 22 characters per word

  • ad text — 75 characters, maximum 23 characters per word

  • link — 1024 characters (including protocol)

  • tracking link — 1024 characters (including protocol)

Dynamic ads

  • ad text — 81 characters including spaces and 15 punctuation marks, maximum 23 characters per word

Restrictions for campaigns and accounts

Keywords

The maximum keyword length is 4096 characters (including negative keywords, spaces, and Yandex Direct operators). The number of keywords per group cannot exceed 200. Each keyword can contain a maximum of 7 words.

Negative keywords in a group

A list of negative keywords can contain a maximum of 4096 characters, not counting spaces. Maximum of 7 words per negative keyword.

Negative keywords in the Campaign Wizard

When advertising a mobile app in the Campaign Wizard, the number of keywords per group can't exceed 200. When advertising a site, the maximum number of characters (excluding spaces) is 20,000.

Negative keywords in a campaign

A list of negative keywords can contain a maximum of 20,000 characters, not counting spaces. Maximum of 7 words per negative keyword.

Ad group

Maximum of 1000 groups per ad campaign.

Number of ads

Maximum of 50 ads per group.

Ad campaigns

Maximum of 3000 campaigns per account, of which no more than 1000 can be active (active campaigns are considered to be all campaigns not located in the archive).

Video

Videos in Text & Image ads, Campaign Wizard, and display campaigns.

То placе Text & Image ads, as well as ads for mobile apps with videos, videos about your store in a product campaign, or video ads in display campaigns, you can use the following videos:

Format MP4, WebM, MOV, QT, FLV, AVI
Size 100 MB maximum
Length Between 5 and 60 sec
Recommended aspect ratio 16 : 9; 1 : 1; 9 : 16
Minimum resolution 360p
Recommended resolution 1080p
Video frame rate From 20fps
Video codecs H.264, VP6F, VP8, Theora
Number of video tracks 1
Minimum quality 44 kHz, 16 Kbit/s, stereo
Audio codecs AAC, MP3, Vorbis
Number of audio tracks No more than 1
File codec avc1, F4V, isom, M4A, M4V, mmp4, mp41, mp42, qt
Cover No
Format MP4, WebM, MOV, QT, FLV, AVI
Size 100 MB maximum
Length Between 5 and 60 sec
Recommended aspect ratio 16 : 9; 1 : 1; 9 : 16
Minimum resolution 360p
Recommended resolution 1080p
Video frame rate From 20fps
Video codecs H.264, VP6F, VP8, Theora
Number of video tracks 1
Minimum quality 44 kHz, 16 Kbit/s, stereo
Audio codecs AAC, MP3, Vorbis
Number of audio tracks No more than 1
File codec avc1, F4V, isom, M4A, M4V, mmp4, mp41, mp42, qt
Cover No

  • For non-skippable ads, max video duration is 15 seconds.

  • For video banners (including those served in Yandex Search), the aspect ratio can only be 16:9.

Product video in a unified performance campaign, in a product campaign, and in smart banners

This video can be used both for a product in a product campaign and for smart banners based on a feed:

Format MP4
Size 100 MB maximum
Length Between 5 and 45 sec
Recommended aspect ratio 16 : 9; 1 : 1; 9 : 16
Minimum resolution 360p
Recommended resolution 1080p
Video frame rate From 20fps
Video codecs H.264, VP6F, VP8, Theora
Number of video tracks 1
File codec mmp4, mp41, mp42
Cover No
Format MP4
Size 100 MB maximum
Length Between 5 and 45 sec
Recommended aspect ratio 16 : 9; 1 : 1; 9 : 16
Minimum resolution 360p
Recommended resolution 1080p
Video frame rate From 20fps
Video codecs H.264, VP6F, VP8, Theora
Number of video tracks 1
File codec mmp4, mp41, mp42
Cover No

Once your videos are added to a feed and updated in Yandex Direct, the system will upload and check videos one-by-one against the requirements. Serving of processed videos will start within 24 hours. If your feed contains tens of thousands of videos, it might take up to several days to process them.

Images

Text & Image ads Ads for mobile apps Search banners Campaign Wizard, Product campaign
Size in pixels At least 450 on each side From 1080 to 5000 240 × 400 from 450 × 450
Format JPG, PNG or GIF JPG or PNG JPG, PNG or GIF JPG, PNG or GIF
Maximum file size 10 MB 10 MB 120 KB 4 MB
Text & Image ads Ads for mobile apps Search banners Campaign Wizard, Product campaign
Size in pixels At least 450 on each side From 1080 to 5000 240 × 400 from 450 × 450
Format JPG, PNG or GIF JPG or PNG JPG, PNG or GIF JPG, PNG or GIF
Maximum file size 10 MB 10 MB 120 KB 4 MB

Technical requirements for HTML5 banners

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 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 150 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 page specified in the Link to site field, a mobile app (if installed), or the app's page in an app store (if the app isn't 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:
  <script> 
    document.getElementById("click_area").href = yandexHTML5BannerApi.getClickURLNum(1); 
 </script>
  7. The HTML5 banner size must be specified in the content attribute of the meta tag. See the examples below:
    • Banner on a new Yandex Browser tab:
      <meta name="ad.size" content="width=1456,height=180">
    • Other banners in display campaigns and image ads:
      <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.

  9. All event handlers must be explicitly specified within the script tag, for example:

    <script>
    document.onload = init;
</script>

  10. The link in an HTML5 banner must not exceed 1024 characters and must be UTF-8 encoded.

  11. The display campaign banner must not use statistics tools (pixels, tags, etc.).

    When you create a campaign, you can specify a Yandex Audience pixel or an Adfox tag (to learn more, see How to launch a banner under the search barβ campaign). You can also use UTM tags in the link to your website.

  12. A banner can feature the View again button for restarting the scenario.

Recommendations for displaying HTML5 banners

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

  2. 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. If applicable, relevant browser support should be considered in the file.

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

Have questions?

Attention. Our customer service can help you with the campaigns created under the same login that 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.