Что такое фид данных?

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

XML и YML: кто они и какова их миссия?

Специальный файл, в котором определенным образом описан ассортимент интернет-магазина  — это и есть фид. В нем собраны и структурированы товары и их атрибуты. Существует много форматов файлов, которые используют для описания контента сайта. Например: XML, YML, Excel, TXT, CSV и другие. Но каждая площадка или сервис имеет свои рекомендации и ограничения по выгрузке. У Multisearch тоже есть свои требования — нам подходит фид данных только в формате XML/YML.

XML/YML-файлы содержат подробные описания товаров, услуг или статей на вашем сайте. 

Что это за форматы?

• XML  или “eXtensible Markup Language” – дословно переводится как “расширяемый язык разметки”, а простыми словами – язык для описания данных. Он ничего не делает, а служит для структуризации, хранения и передачи информации между сайтами, площадками или сервисами.
• YML же – изотоп формата XML от Yandex, который создали для размещения товаров на Яндекс.Маркете. Этот язык разметки понятный практически любой системе и не имеет значимых отличий от XML.

Почему XML/YML, а не Excel? 

• Это самые распространенные форматы, которые магазины используют для экспорта данных на прайс агрегаторы и маркетплейсы.
• Такие файлы удобны благодаря определенным стандартам, то есть специалистам не надо разбираться, что, под каким названием и в каком поле вы передаете, все описано с учетом правил.

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

Фид нужен всем: интернет-магазинам, блогам, информационным порталам

XML или YML необходим для работы Multisearch на любом сайте. Выгрузку можно разбить на несколько файлов, например, по категориям или наличию товаров. Чем больше информации вы предоставите в фиде, тем лучше алгоритмы поиска распознают запросы пользователей. Информация в таких файлах прописывается с помощью атрибутов. 

Что указать интернет-магазину?

Если для интеграции Multisearch вы используете API, обязательными атрибутами для интернет-магазина будут: 

• ID категории;
• название категории;
• ID товара;
• название товара;
• наличие;
• артикул;
• характеристики товара;
• бренд;
• описание товара.

Помимо этих полей рекомендуем внести: тип товара (спецпредложение, новинка, акция, хит продаж), ссылку на товар, ссылку на фото товара, цена, старая цена, ссылку на категорию, дату создания товара, ключевые поля, рейтинг товара.

Интеграция через плагин требует больше информации, поэтому обязательно укажите:

• ID товара; 
• название товара;
• артикул;
• ID категории; 
• название категории;
• ссылка на товар;
• наличие;
• цена;
• характеристики товара;
• ссылка на фото товара;
• бренд;
• описание товара.

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

Какая информация необходима для информационных сайтов?

Некоммерческим сайтам, использующим API, необходимо вносить: 

• ID категории;
• название категории;
• ID статьи;
• название статьи.
• текст статьи.

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

Если для информационного сайта вы используете плагин, обязательно внесите:

• ID статьи;
• название статьи;
• ID категории статьи;
• название категории; 
• ссылка на статью

Дополнительные поля: текст статьи, ссылка на категорию статьи, дата создания статьи, ключевые поля, рейтинг статьи, ссылка на фото.

Ваш фид – это конфиденциальная информация, поэтому все описания элементов мы показываем на нашем примере выгрузки для интернет-магазина и информационного сайта. 

Неочевидно, но важно: ответы на вопросы про обновление товаров и количество фидов

Как часто обновлять выгрузку? Мы рекомендуем обновлять фид раз в час. 

Нужно ли вносить в фид отсутствующие товары? Мы рекомендуем указывать все товары, даже те, которых нет в наличии, потому что:

• отображение товаров “Нет в наличии” влияет на рост конверсии;
• отсутствующая позиция может снизить процент отказов, если посетитель сможет перейти на похожие товары или связаться с отделом продаж для уточнения даты появления товара.

Также такие позиции можно отображать только при 0 результате выдачи. Детальнее об этом можете  прочитать в статье “ "Товара нет в наличии: удалить или оставить на сайте и в поиске". 

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

• полный фид, в котором необходимо передавать всю информацию о товаре. Обновление каждую ночь;
• “быстрый” фид, в котором нужно указать только цену и наличие. Обновление раз в час.

Это ускорит обновление информации и уменьшит нагрузку на ваш сайт.

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

Сколько фидов нужно для мультиязычного сайта? Для каждой языковой версии сайта нужна отдельная выгрузка.  

Знакомимся с основными элементами выгрузки

Каждая площадка для размещения имеет свои требования и особенности на счет выгрузки. Мы расскажем о главных элементах разметки XML, чтобы вы смогли как можно лучше описать данные со своего сайта. 

В блоке <categories> прописаны параметры для категорий <category>.  В нем указывают атрибут url со ссылкой на необходимую категорию. Например: <category id="14" url="https://domain.com/laptop/">Ноутбуки</category>. Эта ссылка используется для перехода из категорий в результатах поиска на категории в интернет-магазине.

Блок <offers> хранит информацию о товаре. Для элемента используют такие параметры:

• <label> со значением типа товара, например, новинка, хит, скидка, акция. Параметр используют для приоритетного отображения в выдаче спецпредложений; 
• <oldprice> со значением старой цены до скидки. Нужен для отображения перечеркнутой цены и новой цены;
• <presence> со значением наличия товара, например, склад, есть в наличии, временно нет в наличии, наличие уточняйте. Необходим, чтобы показывать результаты по наличию от первого к последнему;
• <createdAt> – дата создания товара. Используют для отображения новых товаров;
• <vendorCode> - артикул товара;
• <picture> – картинка, обязательно нужно указать путь к файлу с размером, приближенным к 160x160px.

Дополнительные теги и их функции

Если элемент имеет несколько значений, прописывайте их последовательно. Например:

• <categoryId>14</category>
• <categoryId>25</category>
• <label>Новинка</label>
• <label>Хит</label>

Чтобы настроить дополнительное ранжирование результатов, используйте параметр <ordering> с числовым значением. Тег пригодится, если на вашем сайте есть рейтинги/внутренний вес/score/популярность товара. Эти данные нужно внести в выгрузку, чтобы умный поиск учитывал их в выдаче результатов.

Ключевые фразы, или другими словами поисковые запросы, для приоритетной выдачи надо указывать с помощью параметра <keywords>. Например:
<keywords>Ноутбук для офиса, Популярный автор</keywords> 
или
<keyword>Ноутбук для офиса</keyword>
<keyword>Популярный автор</keyword>

Код поставщика можно использовать для поиска по разным кодам <code>4205D</code>.

Для вывода дополнительной информации под названием товара в результатах поиска
нужен тег <snippet>Код: 4205D</snippet>.

6 распространенных ошибок в выгрузке

Нередко в фиде, который мы получаем от клиентов, встречаются ошибки. Некоторые из них критичны и не дают возможности проиндексировать файл, а значит останавливают работу умного поиска. Например, отсутствие закрывающего тега для блока категорий. Если же ошибка встречается в оффере, поиск не найдет эту позицию. Например, если из 100 товаров, которые передаются в фиде, 20 содержат такие ошибки, то проиндексируется только 80 позиций. Поэтому мы делимся с вами самыми распространенными ошибками. 
 
Yandex пишет, что проблема может быть в:

1. YML несоответствии спецификациям XML - чтобы проверить так ли это, поменяйте расширение на .xml и посмотрите в браузере, также можно прогнать файл через валидатор;
2. несоблюдении требований формата: неправильное использование элементов, неправильный порядок, пустые элементы, наличие недопустимых символов;
3. неправильной кодировке;
4. повторе ID;
5. URL, который ведет на несуществующий файл или содержит недопустимые символы;
6. том, что не описаны категории в блоке категорий или не указаны ID категорий в товарах. 

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

Коротко — главные тезисы со статьи: 

• чем больше информации вы передаете в фиде, тем лучше поиск понимает пользовательские запросы;
• товары с пометкой “нет в наличии” нужно вносить в фид;
• для мультиязычных сайтов составляйте отдельную выгрузку для каждого языка; 
• создавайте несколько фидов, если у вас большой ассортимент;
• чем чаще обновление фида, тем актуальней информация на сайте.