Гайд по фидам

Товары могут попасть в Поиск через загруженный фид в кабинете Яндекс Товаров и с помощью микроразметки на страницах товаров на сайте интернет-магазина. Мы рекомендуем использовать оба варианта, так как у каждого из них есть свои преимущества.

Фиды позволяют быстрее обновлять данные о товарах в результатах выдачи и автоматизировать обновление, чтобы в Поиске всегда была актуальная информация. С помощью фида можно передать большое количество товаров. Это особенно удобно для крупных интернет-магазинов с обширным ассортиментом, который часто обновляется.

Микроразметка помогает поисковым роботам лучше понимать структуру и содержание страниц сайта: название товара, его цвет и другие характеристики. Это может положительно влиять на индексацию и отображение товаров в поисковой выдаче.

В этом гайде мы расскажем о процессе работы с фидами: как правильно создать и загрузить фид и избежать распространённых ошибок.

О том, как работать с микроразметкой, мы рассказываем в отдельном гайде.

Как сформировать товарный фид

Товарный фид — это файл формата YML с информацией о магазине и товарах. 

YML (Yandex Market Language) — это собственный стандарт Яндекса, который основан на XML. 

В товарном фиде можно описать каталог магазина в формате, который удобен для автоматической генерации. Это можно сделать разными способами:

• Через CMS

CMS (Content Management System) — это системы управления контентом вашего сайта, которые позволяют создавать готовые товарные фиды.

Для популярных CMS доступны модули подключения:

Все модули подключения разработаны для интеграции с Яндекс Маркетом и подходят, чтобы подготовить фид для Яндекс Товаров. Используйте модули и компоненты только для формирования фида и генерации URL, по которому фид доступен для скачивания. URL-адрес понадобится для загрузки фида в Яндекс Товары. 

Ещё больше вариантов CMS вы найдёте в Справке.

• Вручную

Если у вас небольшой магазин, фид можно создать вручную по описанию формата. Для этого отправьте разработчику инструкцию по созданию фида. 

Требования к фиду

У фида есть определённые требования и ограничения. Что важно сделать:

• Используйте формат YML.
• Загружайте файл размером до 2 Гб.
• Проверьте, что суммарное количество всех YML-файлов для сайта и его поддоменов — не больше 1 000.
• Не используйте непечатаемые символы с ASCII-кодами* от 0 до 31. Исключение — символы с кодами 9, 10, 13: табуляция, перевод строки, возврат каретки.
• Замените символы " & > < ' на эквивалентные коды:

• Используйте кодировку UTF-8 или Windows-1251.
• Сформируйте несколько фидов, если товары, их наличие, стоимость, условия продажи или доставки отличаются в разных регионах. Если данные идентичны, создайте один фид.

* ASCII (American Standard Code for Information Interchange) — стандарт кодирования букв латинского алфавита, цифр, некоторых специальных знаков и управляющих символов.

Структура фида

Фид содержит следующие блоки:

1. Заголовок. Должен начинаться с первой строки, с нулевого символа.<?xml version="1.0>
2. Корневой элемент <yml_catalog> содержит дату и время момента, на который актуальны данные в файле.

Версия каталога, которую вы загружаете, должна быть не старше 10 дней. Дату и время нужно указать согласно стандарту RFC 3339. Обязательно указывайте часовой пояс. Он отсчитывается от UTC*. Если файл долго генерируется, указывайте в атрибуте момент начала генерации. Обязательно укажите атрибут date, если передаёте остатки товаров или цены.  

1. Элемент <shop> описывает магазин и товары:

— <shop> — информация о магазине

— <offers> — информация о товаре

1. Закрывающие теги:

— </shop>

— </yml_catalog>

* UTC (Universal Coordinated Time) — международный стандарт регулирования времени во всём мире. 

Информация о магазине, или элемент <shop>

В элементе <shop> есть ряд обязательных блоков. Изучите их описание в таблице.

Список предложений магазина — блок <offers>

<offers> — обязательный элемент, который входит в <shop> и содержит список всех предложений магазина. Каждое предложение описывается в отдельном элементе <offer>.

Элемент <offer> может быть упрощённого или произвольного типа.

В каждом типе по-разному формируется название предложения. Остальной набор элементов совпадает.

Если название заполнено неверно, предложения, скорее всего, не отобразятся в Поиске. Далее мы подробнее расскажем, как заполнять эти элементы.

Чтобы Яндекс мог отличить предложение произвольного типа от упрощённого, к элементу <offer> нужно добавить атрибут <type="vendor.model">.

У элементов <offer> произвольного и упрощённого типа равные возможности. Они обеспечивают одинаковое качество привязки предложения к карточке товара и его отображения в Поиске. Именно поэтому выбирайте тот вариант, который удобнее использовать и поддерживать. 

Сохранили для вас пример фида — скачайте его из папки.

Рассмотрим наш фид:

• <offer id="...">

Идентификатор товара в вашей системе. Это может быть любая последовательность длиной до 80 знаков. Можно использовать английские и русские буквы (кроме ё), цифры и символы: . , / \ () [] — =.

Идентификатор должен быть уникальным для каждого товара.

Важно: нельзя менять идентификатор после присвоения. Например, если вчера в фиде у конкретного офера offer id = 'AAA', а сегодня у него же offer id = 'BBB', это может приводить к проблемам, вплоть до временной пропажи из выдачи, так как офер с новым id будет считаться новой сущностью и заново индексироваться.

• <name>

Полное название товара. Составляется по схеме: тип + бренд или производитель + модель + особенности (цвет, размер или вес) + количество в упаковке.

Требования к названию:

• Оптимальная длина — 50–60 символов, максимальная — 150
• Не должно содержать название магазина, информацию о скидках, акциях, стране-производителе, слова «новинка», «хит», «бесплатная доставка» 
• Не должно быть написано большими буквами (исключение: устоявшиеся названия брендов и моделей)

• <vendor>

Название производителя. Указывайте название так, как его пишет сам бренд. Например, Samsung, Xiaomi.

• <vendorCode>

Артикул товара — код, который присвоил производитель. Если артикулов несколько, укажите их через запятую.

• </description>

Описание товара, которое помогает покупателю представить себе товар. Оно рассказывает, чем продукт хорош, как им пользоваться, кому он подойдёт.

Требования к описанию:

• Составляйте лаконичное описание длиной 400–600 знаков. Учитывайте максимальное ограничение — 3 000 знаков.
• Не используйте в описании товара рекламно-информационные предложения и слова: «распродажа», «акция», «бесплатно», «специальная цена».
• Не давайте инструкций по установке и сборке.
• Не указывайте цену, регион, способы оплаты, доставки, контактную информацию, ссылки на товар.

• <picture>

Изображение товара. Чтобы ваш товар попал в товарную карточку и получил больше показов, нужны качественные изображения.

Требования к изображениям:

• Товар на фотографиях должен располагаться в естественной среде, по центру и быть достаточно крупным, чтобы его можно было рассмотреть.
• На фотографиях должен быть тот товар, который указан в названии.
• Фотографии, ссылки на которые вы передаёте в фиде, совпадают с фотографиями товара на сайте.
• На изображении запрещены рекламно-информационные надписи, адреса сайтов, почты, логотипы, водяные знаки, ценники, рамки, поля, тени, отражения.
• Для одного товара возможно добавить до 20 изображений.
• Допустимы форматы JPEG, PNG или WEBP.
• Вес изображения должен быть до 10 Мб, размер — не меньше 300 × 400 пикселей. Рекомендуем использовать соотношение сторон изображения 3 : 4.

Примеры изображений:

• <url>

Адрес страницы на вашем сайте с фотографиями и описанием товара.

Требования к адресу страницы сайта:

• Используйте в URL максимум 512 символов. 
• Записывайте его согласно стандарту RFC 3986.
• Добавляйте уникальный URL для каждого товара. Например, «мужская рубашка 52-го и 56-го размера» — это два разных товара. Каждому нужно присвоить уникальный URL, иначе в Поиске будет отображаться только первый товар.

• <price>

Стоимость единицы товара со всеми налогами. Данные по цене обновляются в Поиске раз в четыре часа. Чтобы быстро обновить цену, используйте API Поиска.  

Подробнее об элементах упрощённого и произвольного типа читайте в Справке. 

Объединённая карточка товара

В блоках «Популярные товары по запросу» и в разделе Поиска «Товары» может отображаться одна модель с предложениями от нескольких магазинов — каждое в отдельной товарной плитке.

Для карточки и товарной плитки информация берётся из конкретного магазина: название, цена и фотографии товара, а также название самого магазина, где можно оформить покупку. Эти данные Поиск получает из микроразметки страницы товара на сайте интернет-магазина или из товарного YML-фида, который загружен в Яндекс Товары.

Чтобы объединение товаров прошло успешно, в фид нужно добавить определённые теги. Среди них есть и необязательные, но мы всё равно рекомендуем их передавать:

• param — характеристики товара: цвет, размер, материал, технические особенности
• barcode — штрихкод товара
• vendorCode — артикул товара

Эти теги желательно добавлять, чтобы повысить вероятность показа в сравнении с аналогичными предложениями.

Алгоритмы Поиска для показа предложения по запросу пользователя анализируют актуальность цен и других данных в фиде с данными на сайте магазина, а также определяют, доступен ли этот товар для заказа в регион, в котором находится пользователь. Если в регионе пользователя недоступна покупка этого товара, предложение не отобразится в Поиске. Следите, чтобы данные фида совпадали с информацией на сайте. Так ваш ассортимент сможет показываться аудитории Поиска.

Как загрузить товарный фид

Когда ваш фид будет готов, останется передать данные в Яндекс Товары.

1. Перейдите в личный кабинет Яндекс Товаров в раздел «Товары» → «Фиды».

1. Во вкладке «Фиды» нажмите «Добавить» и укажите ссылку на файл либо загрузите фид через API.
2. Отредактируйте текст в поле «Название фида». Название фида отобразится в списке во вкладке «Фиды» для удобного поиска.

1. Нажмите на поле «Регионы продажи» и выберите из выпадающего списка регионы, в которые вы доставляете товары по конкретному фиду. В этих регионах ваш товар получит возможность показываться в Поиске.

1. Заполните поле «Ссылка на фид».

Инструкция по подготовке ссылки находится в разделе «Как подготовить ссылку».

1. Убедитесь, что HTTP-заголовок Content-type, который передаёт ваш сервер, содержит один из типов ресурса:

• application/xml

• application/octet-stream
• text/xml
• application/gzip
• application/x-gzip

Это можно проверить любой сетевой утилитой или стандартными инструментами браузера при переходе на ссылку фида. 

1. Нажмите «Добавить». Фид отобразится в разделе «Товары» → «Фиды».

Статусы товарных фидов

После загрузки в Яндекс Товары фиды могут отображаться с различными статусами:

Как только проверка завершится, статус фида изменится. Если будут найдены ошибки, ознакомьтесь с ними. Для этого кликните по строчке с фидом и перейдите во вкладку «Ошибки и рекомендации». Или нажмите на кнопку «Все ошибки и рекомендации», чтобы скачать и посмотреть все ошибки в одном файле.

Исправьте ошибки, обновите фид и нажмите кнопку «Перепроверить».

Фид проходит модерацию в течение пяти дней — после этого его статус обновится.

Отправить фид на проверку повторно можно до шести раз. Именно поэтому внимательно читайте рекомендации и отправляйте фид на повторную проверку, когда убедитесь, что всё исправили. Если фид не пройдёт контроль качества шесть раз подряд, магазин не будет допущен к размещению в Поиске. В этом случае необходимо обратиться в службу поддержки.

Распространённые ошибки в фидах

Разберём основные проблемы, с которыми сталкиваются специалисты при заполнении фида, и расскажем, как их решить.

• В фиде отсутствует обязательный элемент, например Offers или другие. Добавьте его.
• Фид содержит неподдерживаемый элемент. Фид с элементами фида Яндекс Маркета или фида Директа для запуска продвижения может не пройти проверку в Яндекс Товарах. Удалите его или замените на другой.
• Неверный формат фида. Поддерживается YML-файл с расширением XML, YML или в виде архива GZIP. Убедитесь, что загружаете файл с данными о товарах.
• Неверная стоимость товара, его нет в наличии или срок доставки больше 60 дней. Следите за обновлениями цены и ассортимента и вовремя обновляйте информацию в фидах
• Страницы товаров не открываются. Роботы Яндекса периодически проверяют страницы сайта на доступность. Если они обнаружат недоступную страницу, такое предложение будет скрыто из поиска по товарам. В течение суток робот проверяет доступность этой страницы раз в час:

• Если страница станет доступна в течение суток, предложение снова сможет появиться в Поиске
• Если проблема сохранится, предложение останется скрытым
• Открывается не отдельная страница товара, а каталог или страница товара с другими характеристиками. Укажите верную ссылку на предложение.
• Неправильно составлено название товара или указаны недействительные характеристики. Проверьте соответствие требованиям.
• Указана стоимость товара при заказе партии. Например, цена товара — 100 ₽, но она действительна при заказе четырёх единиц, а при заказе одной единицы цена составляет 150 ₽. Укажите цену всей партии или цену за одну единицу товара.
• Некорректные изображения товаров. Фото товаров должны соответствовать требованиям.

С этими и другими ошибками более подробно можно ознакомиться в Справке. Чтобы избежать большого количества ошибок, настройте автообновление фида.

Настройка автообновления фида

Большинство ошибок происходят из-за различий информации в фиде и на сайте — и  из-за них весь фид может быть заблокирован.Товары с несоответствиями не попадают в поисковую выдачу.

Необходимо, чтобы информация на сайте совпадала с информацией, которая передана в Поиск, и не вводила пользователей в заблуждение.

Чтобы избежать ошибок в фиде, регулярно редактируйте его вручную или настройте автообновление. Во многих CMS это можно сделать при создании и редактировании фида. Для этого в настройках нужно установить необходимую частоту обновлений.

Проверьте себя

Выводы

Вы узнали, как добавлять товары через фид в Яндекс Товарах. 

Напомним ключевые тезисы:

• Товарный фид — это файл формата YML с информацией о магазине и товарах. Фид можно создать через CMS (для популярных систем есть специальные модули) или вручную.

• У фида есть требования: формат YML, размер файла до 2 Гб, кодировка UTF-8 или Windows-1251, определённые ограничения на символы и другие.
• В фиде должны быть следующие блоки: заголовок, корневой элемент <yml_catalog>, элемент <shop> с информацией о магазине и товарами (<offers>).
• После создания фида его нужно загрузить в Яндекс Товары через личный кабинет или API.
• После загрузки фид проходит проверку. По её результатам он может иметь разные статусы: проверяется, принят, заблокирован и другие.
• Если в фиде найдены ошибки, их нужно исправить и отправить фид на повторную проверку.
• Для избежания ошибок рекомендуется настроить автообновление фида.