Step 3. Select and create ads

You can add only one active ad for catalog pages to a group.

1. Specify the source for creating ads:

   Catalog pages found on the site

   The Yandex robot crawls catalog pages on the site. In order for the robot to accurately identify the catalog pages, they must be marked up in special structured data format.

   Feed uploaded via a link or from desktop

   CSV file

   If you don't use structured data markup in your site's code, prepare and upload a CSV file. You can only upload one file per group.

   File requirements

   1. CSV format with UTF-8 encoding.
   2. Use commas “,” or semicolons “;” as the separator.

      If you choose to use commas as the separator, check if any field contains commas in its text. If it does, the entire text of that field must be enclosed in quotes. For example: "Dairy, plant-based drinks".

   3. The file header must include the full list of columns: Url, Title, Description, Offer minimal price, Currency, Image url 1, Image url 2, Image url 3, Image url 4, Image url 5.

      Name and description of fields:

      Name	Description
      URL	Link to the catalog page. Each link must be unique. Required field.
      Title	Catalog name. Up to 56 characters including spaces and punctuation. Required field.
      Description	Description. Up to 81 characters including spaces, and up to 15 punctuation marks. Recommended field.
      Offer minimal price	Minimum product price in the category. Integer without separators. If the number is a fraction, round it to a whole number. For example: 150000.
      Currency	Alphabetic currency code. For example: RUB, USD, EUR. Required if you provide "Offer minimal price".
      Image url 1, Image url 2, Image url 3, Image url 4, Image url 5	Links to images on the site. These must be direct links to an image, rather than links to a page where the image can be downloaded. For example, you can't use Yandex Disk links. Recommended field.

      Name	Description
      URL	Link to the catalog page. Each link must be unique. Required field.
      Title	Catalog name. Up to 56 characters including spaces and punctuation. Required field.
      Description	Description. Up to 81 characters including spaces, and up to 15 punctuation marks. Recommended field.
      Offer minimal price	Minimum product price in the category. Integer without separators. If the number is a fraction, round it to a whole number. For example: 150000.
      Currency	Alphabetic currency code. For example: RUB, USD, EUR. Required if you provide "Offer minimal price".
      Image url 1, Image url 2, Image url 3, Image url 4, Image url 5	Links to images on the site. These must be direct links to an image, rather than links to a page where the image can be downloaded. For example, you can't use Yandex Disk links. Recommended field.

   4. The maximum number of rows is 1000

   How to create a CSV file

   Enter your data in any spreadsheet editor, like Excel or Numbers. Save the file in the CSV format with comma delimiters.

   In Excel (Windows):

   1. In the top menu, select File → Save as.
   2. Name the file using the File name field.
   3. Select Save as type“CSV (Comma delimited) (*.csv)”
   4. Click Save.

   In Numbers (iOS):

   1. In the top menu, select File → Export to→ CSV....
   2. In the Export Your Spreadsheet window, go to the CSV tab and open the Advanced Options.
   3. In the Text Encoding field, select “Unicode (UTF-8)”
   4. Click Next....

   Possible errors when uploading a file

   • Invalid encoding: Make sure that your file has UTF-8 encoding.
   • File can't be empty: Make sure that your file contains rows with catalogs.
   • List can't include more than 1000 rows: Make sure that your file contains less than 1000 rows.
   • Field can't be empty: Make sure that all required fields are filled in.
   • Title can only include characters supported in banners: Make sure that the file doesn't contain invalid characters.
   • Word length can’t exceed: Make sure that there are no words longer than 56 characters in the file header and 81 characters in the file body.
   • Loose comma: Make sure that all commas and quotes adhere to the CSV schema.
   • Enter different values: Make sure that all links in the URL field are unique.

   Download sample file

   YML feed

   Use a feed with a special <collections> tag to pass information about catalogs: collection id, link, image, title, and description. We recommend also passing links to catalogs within <offer> elements. Learn more

   1C-Bitrix users can quickly generate a feed with catalog pages by following the instructions.

   If you work with the InSales platform and have set up automatic feed updates, catalog info will be automatically added to it, with no additional actions required on your part. You can also create a feed with catalogs using a custom export to Yandex Market by following the instructions.

2. In the Filter section, select which catalogs you want to advertise. If you are transmitting data about catalog pages using a YML feed, you can filter ads by link to catalog page (url), offer name (name), and catalog (collection id). For CSV files, you can set up filters by title and URL. For pages found on a site, filters by name (in the site microdata) and by URL are available.

   Filtering conditions are joined using the “AND” operator, so only those catalogs that match all the conditions will generate impressions.

3. For ads from a YML feed, set up titles and texts in the Texts section:

   • When creating ads, you can use titles and texts that Yandex Direct will automatically generate from the elements within the <collections> feed, rephrasing them as necessary. As part of manual setup, the title is taken from the <name> element, and the text is taken from the <description> element.

   • Set the default text. It'll be used in ads if it's possible to generate text automatically or compose it from feed fields.

If needed, you can replace the feed when creating or editing an ad. To do this, select the desired feed from the sources or upload a new one. Yandex Direct will try to reuse filters that were previously set up in the ad. If the information about categories and products in the feed has changed, check and adjust the filter. If there are no elements in the feed that match the filter, it will be reset.

1. In the Link in ad field, enter the site page URL that your ad will lead to. The site must match the ad text and meet the Yandex requirements.

2. Describe your offer and what sets it apart from the competition:

   • Generate your ad using the neural networks. Based on the advertised page, Yandex Direct will create up to six ad versions using various generative algorithms and models, such as YandexGPT (title and text generation) and YandexArt (image generation). Select the appropriate ad. Edit it if necessary:

     • Change the ad title and text or replace any element with a custom one.

     • Crop the AI-generated image or replace it with a custom one.

   • Add a custom text, title, and image. The image will be animated automatically.

   Review our recommendations for writing ads.

   For ads served in the product gallery, make sure to indicate the price.

3. To make your ad more noticeable and informative, under Video, add a file with a video clip or use a video clip from the gallery. Learn more.

4. Enable the image carousel. It will help you showcase different aspects of the product or service promoted by your ad, tell users how you produce or develop them, and highlight their advantages or features. You can add between 2 and 10 images to your ad in the specified order.

5. Double check the company's contact information.

6. Set up an action button. It draws attention and encourages user engagement. The button adds one more link to ads with an image or video.

7. Describe the advantages and benefits of your offer using callouts.

8. Use Sitelinks to provide shortcuts to important information on your site.

Fill in all the ad elements, including the additional title. Yandex Direct uses them in different design options for creatives, including the various layouts that appear in search results.

1. In the Link in ad field, enter the site page URL that your ad will lead to. The site must match the ad text and meet the Yandex requirements.

2. Add a creative. You can upload it from your computer or from the internet, or create one using the Ad Builder.

   • Create using Ad Builder
   • Upload from the computer or the internet

   An adaptive creative automatically adapts to the ad unit so that you can serve your ad on the maximum number of sites. In the Ad Builder, you can automatically generate a creative based on your site content or build it from a template, adjusting the design parameters as needed.

   More information about Ad Builder.

   You can only add one creative per ad.

   To build a creative, you can use HTML5 banners or image files. Ad creatives uploaded from a computer or the internet must meet the following requirements:

   • Maximum file size: 512 KB.
   • File type:

     • ZIP (for HTML5 banners). Technical requirements for HTML5 banners.
     • JPG, PNG, or GIF (for image creatives).
   • The size of an HTML5 banner must exactly match the size of the ad unit (see the table). The size of an image creative in pixels can be two or three times larger.

     Size of an ad unit in pixels	Recommended sizes of image creatives served on screens with a high pixel density
     240 × 400	480 × 800 or 720 × 1200
     300 × 250	600 × 500 or 900 × 750
     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

     Size of an ad unit in pixels	Recommended sizes of image creatives served on screens with a high pixel density
     240 × 400	480 × 800 or 720 × 1200
     300 × 250	600 × 500 or 900 × 750
     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

   How to select a size for ad creative

   If you are planning to create components without using Ad Builder, we recommend preparing them to fit the most common ad sizes first: 240 × 400, 300 × 250, and 728 × 90 pixels. Image ads with these types of creative will cover a significant audience.

   Usually the following ad unit sizes are used for desktop versions of websites (in pixels): 240 × 400, 300 × 250, 300 × 500, 300 × 600, 336 × 280, 728 × 9, and 970 × 250.

   We recommend uploading your creatives in double or triple resolutions if you want to serve them on screens with high pixel densities. That is, use the resolutions of 480 × 800 or 720 × 1200 pixels instead of 240 × 400.

   Creatives that are 640 × 100, 640 × 200, 640 × 960, and 960 × 640 pixels are typically used for mobile versions of websites and mobile apps. Although smaller ad units are more common for ads served on mobile devices (320 × 50, 320 × 100, 320 × 480, and 480 × 320 pixels), Yandex recommends that you upload larger ad creatives so that your ads don't look blurry on screens with a high pixel density (for example, on Retina displays).

   Your image ad needs to satisfy certain requirements in order to pass moderation. More information about image ad design requirements.

   After saving an ad, you can only replace the creative for that ad with other components of the same size. An adaptive creative can only be replaced with another adaptive creative. You cannot change the source for the ad creative. For example, an ad creative from Ad Builder can only be replaced with other Ad Builder creatives.