Technical limitations
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
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 for 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).
Videos
For placing Text & Image ads, as well as ads for mobile apps with videos, or video ads in display campaigns, you can use the following videos:
Format | MP4, WebM, MOV, QT, FLV, AVI |
Size | maximum 100 MB |
Duration | Between 5 and 60 sec |
Aspect ratio | 3:1, 2:1, 1.9:1, 16:9, 4:3, 1.91:1, 1:1, 3:4, 4:5, 9:16, 1:2, 1:3 |
Minimum resolution | 360p |
Recommended resolution | 1080p |
Video frame rate | from 20 frames/second |
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 | maximum 100 MB |
Duration | Between 5 and 60 sec |
Aspect ratio | 3:1, 2:1, 1.9:1, 16:9, 4:3, 1.91:1, 1:1, 3:4, 4:5, 9:16, 1:2, 1:3 |
Minimum resolution | 360p |
Recommended resolution | 1080p |
Video frame rate | from 20 frames/second |
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 video ads and a Large banner with a video on the Yandex Home page, you can only use videos up to 15 sec.
For video banners, the aspect ratio can only be 16:9.
Images
Text & Image ads | Ads for mobile apps | Search banners | Logo for smart banners | |
---|---|---|---|---|
Size in pixels | At least 450 on each side | From 1080 to 5000 | 240 × 400 | Up to 800 × 800 |
Format | JPG, PNG or GIF | JPG or PNG | JPG, PNG or GIF | JPG or PNG |
Maximum file size | 10 MB | 10 MB | 120 KB | 100 KB |
Text & Image ads | Ads for mobile apps | Search banners | Logo for smart banners | |
---|---|---|---|---|
Size in pixels | At least 450 on each side | From 1080 to 5000 | 240 × 400 | Up to 800 × 800 |
Format | JPG, PNG or GIF | JPG or PNG | JPG, PNG or GIF | JPG or PNG |
Maximum file size | 10 MB | 10 MB | 120 KB | 100 KB |
Display banners
Banners in a display campaign
Technical requirements:
- Maximum file size: 512 KB.
- File type:
- ZIP (for HTML5 banners). Technical requirements for HTML5 banners.
- JPG, PNG, or GIF (for image creatives).
Sizes are shown in the table:
Size of an ad block in pixels Recommended sizes of creatives served on screens with a high pixel density 160 × 600 320 × 1200 or 480 × 1800 240 × 400 480 × 800 or 720 × 1200 240 × 600 480 × 1200 or 720 × 1800 300 × 250 600 × 500 or 900 × 750 300 × 300 600 × 600 or 900 × 900 300 × 500 600 × 1000 or 900 × 1500 300 × 600 600 × 1200 or 900 × 1800 320 × 50 640 × 100 or 960 × 150 320 × 100 640 × 200 or 960 × 300 320 × 480 640 × 960 or 960 × 1440 336 × 280 672 × 560 or 1008 × 840 480 × 320 960 × 640 or 1440 × 960 728 × 90 1456 × 180 or 2184 × 270 970 × 250 1940 × 500 or 2910 × 750 1000 × 120 2000 × 240 or 3000 × 360 Size of an ad block in pixels Recommended sizes of creatives served on screens with a high pixel density 160 × 600 320 × 1200 or 480 × 1800 240 × 400 480 × 800 or 720 × 1200 240 × 600 480 × 1200 or 720 × 1800 300 × 250 600 × 500 or 900 × 750 300 × 300 600 × 600 or 900 × 900 300 × 500 600 × 1000 or 900 × 1500 300 × 600 600 × 1200 or 900 × 1800 320 × 50 640 × 100 or 960 × 150 320 × 100 640 × 200 or 960 × 300 320 × 480 640 × 960 or 960 × 1440 336 × 280 672 × 560 or 1008 × 840 480 × 320 960 × 640 or 1440 × 960 728 × 90 1456 × 180 or 2184 × 270 970 × 250 1940 × 500 or 2910 × 750 1000 × 120 2000 × 240 or 3000 × 360
Banners in a fixed CPM display campaign
- Requirements for image banners
-
Banner for the full version of the Yandex Home page and new Yandex Browser tab Banner for the mobile version of the Yandex Home page Large banner for the full version of the Yandex Home page Large banner for the mobile version of the Yandex Home page Size in pixels 1456 × 180 640 × 134 1836 × 572 640 × 268 Maximum file size 1 MB Format JPG, PNG or GIF Banner for the full version of the Yandex Home page and new Yandex Browser tab Banner for the mobile version of the Yandex Home page Large banner for the full version of the Yandex Home page Large banner for the mobile version of the Yandex Home page Size in pixels 1456 × 180 640 × 134 1836 × 572 640 × 268 Maximum file size 1 MB Format JPG, PNG or GIF - 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.
Banner on the Yandex Home page Large banner on the Yandex Home page Size in pixels 1456 × 180 1836 × 572 Maximum archive size 1 MB Banner on the Yandex Home page Large banner on the Yandex Home page Size in pixels 1456 × 180 1836 × 572 Maximum archive size 1 MB The archive and files used in the banner must meet the following requirements:
The file and directory names can only contain Latin letters, digits, and the symbols
-._~
.All links in an HTML5 banner must be relative and lead to other files in the archive.
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).
The maximum size of the archived index.html must be less than 150 KB.
The archive will ignore the contents of the __MACOSX folder andDS_Store and Thumbs.db files. These are the operating system's auxiliary files which are not necessary for the HTML5 banner to work.
A click on the banner opens the page specified in the Link to site or Turbo page field, 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.|||UNTRANSLATED_CONTENT_START|||<a id="click_area" href="#" target="_blank">...</a> // после элемента "<a href ...></a>" // присваиваем для него значение атрибута href так: <script> document.getElementById("click_area").href = yandexHTML5BannerApi.getClickURLNum(1); </script>|||UNTRANSLATED_CONTENT_END|||
- The HTML5 banner size must be specified in the content attribute of the meta tag. See the examples below:
- Banner on the Yandex Home page:
<meta name="ad.size" content="width=1836,height=572">
- Large banner on the Yandex Home page
<meta name="ad.size" content="width=1836,height=572">
External calls to Yandex-hosted JavaScript libraries are allowed. If an HTML5 banner uses a different library, include it in the archive source code.
All event handlers must be explicitly specified within the script tag, for example:
<script> document.onload = init; </script>
The link in an HTML5 banner must not exceed 1024 characters and must be UTF-8 encoded.
The banner must not use statistics collection tools (pixels, tags, etc.).
When you create a campaign, you can specify a Yandex Audience pixel or ADFOX tag (to learn more, see How to launch a campaign). You can also use UTM tags in the link to your website.
- A banner can feature the View again button for restarting the scenario.
- Technical requirements for a banner with expandable block
-
The HTML5 banner with expandable block is a ZIP archive containing two HTML files (the main banner and the expandable block), as well as JavaScript, JSON, CSS, JPEG, GIF, PNG, SVG, and MP4 files.
Size of the main banner in pixels 1456 × 180 Maximum archive size 21 MB Maximum video size (unpacked file) 20 MB Maximum weight of the banner content without video (unpacked files) 1 MB Size of the main banner in pixels 1456 × 180 Maximum archive size 21 MB Maximum video size (unpacked file) 20 MB Maximum weight of the banner content without video (unpacked files) 1 MB The archive and its files must meet the following requirements:
- General requirements
-
The file and directory names can only contain Latin letters, digits, and the symbols
-._~
.All links in an HTML5 banner must be relative and lead to other files in the archive.
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).
The size of the archive without the video file must be less than 1 MB. The maximum size of the video file is 20 MB, so the maximum size of the video file archive is 21 MB. Each HTML file in the archive must be less than 150 KB.
The archive will ignore the contents of the __MACOSX folder andDS_Store and Thumbs.db files. These are the operating system's auxiliary files which are not necessary for the HTML5 banner to work.
- The main banner must not contain interactive elements, click handlers, or additional links, including the repeat animation button. When the user clicks on the main banner, the banner's expandable block opens.
- The HTML5 banner size must be specified in the content attribute of the meta tag. See the example below:
<meta name="ad.size" content="width=1456,height=180">
External calls to Yandex-hosted JavaScript libraries are allowed. If an HTML5 banner uses a different library, include it in the archive source code.
All event handlers must be explicitly specified within the script tag, for example:
<script> document.onload = init; </script>
The link in an HTML5 banner must not exceed 1024 characters and must be UTF-8 encoded.
The banner must not use statistics collection tools (pixels, tags, etc.).
When you create a campaign, you can specify a Yandex Audience pixel or ADFOX tag (to learn more, see How to launch a campaign). You can also use UTM tags in the link to your website.
- Requirements for expandable block
-
The expandable block must display correctly when its height changes from 360 to 675 pixels and width changes from 640 to 1200 pixels. This means that when the banner size changes within the range from the banner's minimum to maximum height and width, no artifacts or distortions should appear on the banner.
All important information must be centered.
The entire area of the expandable block must be clickable, meaning that any click on any segment of the banner must either perform the actions enabled by the interactive banner elements or lead to the advertiser website.
- A link click must be generated by calling the method
homeExpandableDesktopBannerAPI.clickAndClose(clickNum)
, where clickNum is the ordinal number of the link specified in the field Links to website on the ad creation or editing page. This method closes the expandable block and navigates to the advertiser website.|||UNTRANSLATED_CONTENT_START|||<a id="click1_area"><div>баннер</div></a> <script> document.getElementById("click1_area").addEventListener("click", function(){ homeExpandableDesktopBannerAPI.clickAndClose(1); }); </script>|||UNTRANSLATED_CONTENT_END|||
The banner can't be transparent or contain a frame.
The entire area of the expandable block must be free of elements for closing it.
The expandable block of the banner must have the meta tag with the ad.bgrcolor attribute that sets the layer color, for example:
<meta name="ad.bgrcolor" content="FFFFFF">
The layer must not differ significantly from the main color of the banner.
The expandable block of the banner must not contain the ad.size tag.
In the banner's expandable block, you can add the View again button that restarts the animation scenario.
- Requirements for banners with video
-
- You can only use a video in the expandable block. The video file format is MP4. The maximum video duration is 5 minutes. The video must be accessed using the
homeExpandableDesktopBannerAPI.getVideoURL()
method:var url_video = homeExpandableDesktopBannerAPI.getVideoURL();
- If the video plays back automatically on loading the expandable block, its audio must be muted. If the video plays back on the “Play” button, the playback can start with the sound on.
- The user must be able to pause and resume the video at any time.
- You can't play back audio separately from video.
- Audio ads
-
Requirements for audio files
Format MP3, WAV, M4A
Maximum size 10 MB Duration From 5 to 30 seconds. We recommend using audio files that are 15 seconds long
Minimum quality 44 kHz, 16 Kbit/s, stereo Audio codecs MP3, AAC Number of audio tracks 1 Format MP3, WAV, M4A
Maximum size 10 MB Duration From 5 to 30 seconds. We recommend using audio files that are 15 seconds long
Minimum quality 44 kHz, 16 Kbit/s, stereo Audio codecs MP3, AAC Number of audio tracks 1 Requirements for images used with audio files
Format PNG, JPEG, non-animated GIF
Maximum size 90 KB Size in pixels 900 × 900 Format PNG, JPEG, non-animated GIF
Maximum size 90 KB Size in pixels 900 × 900