Как проверить фид на ошибки

1. Как проверить валидность YML
2. Инструкция к сервису проверки YML-файла
3. Скриншот с инструкцией

Для того чтобы названия, описания, изображения, ссылки на товары с сайта корректно подтягивались в письма ваших триггерных кампаний, необходимо добавить соответствующий требованиям Яндекс YML-фид в разделе Товары личного кабинета Emailtools.ru. Видеоинструкция по настройке этого пункта здесь.

Подготовить сам файл YML можно несколькими способами:

1. Установить плагин, формирующий соответствующий файл
2. Разработать фид кодом (требуются навыки разработчика)

Во втором случае необходимо следовать следующим правилам: 

• Файл должен быть один на все товары, автоматически обновляемым, чтобы не быо устаревшей информации в письмах.
• Регулярность выбираете сами, обычно это раз в день, на крупных проектах — раз в час.
• YML — это уже разновидность формата XML, требования к формату общие — https://yandex.ru/support/partnermarket/export/yml.html#yml-format

Созданный любым способом фид можно проверить в Вебмастере Яндекса по ссылке https://webmaster.yandex.ru/tools/xml-validator/

Инструкция к сервису проверки YML-файла:

Что нужно выбрать в сервисе проверки:

1. В пункте «Выберите схему валидации документа» выберите «маркет»
2. В пункте «Выберите источник XML-данных для валидации» выберите «по ссылке»

Скриншот с инструкцией

Для чего используется YML фид?

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

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

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

YML feed — это разновидность файла XML-выгрузки с сайта. Стандарт разработан компанией Yandex для передачи данных о товарах в сервис Yandex Market.

Описание правил YML, а также пример готового файла для скачивания можно найти в Яндекс Справке в разделе «Ваш ассортимент — Автоматизация работы с ассортиментом».
Здесь вы можете ознакомиться с правилами и параметрами.

Требования к фиду YML для организации email-триггеров

В некоторых сервисах триггерных рассылок, например emailtools.ru, используется стандартный YML, который используется для Яндекс Маркета.

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

• в файле должны быть данные о всех товарах.
  Мы сталкивались с ситуацией, когда, в соответствии с маркетинговой задачей, в ЯМ передаются данные не о всех товарах сайта. В таких случаях необходимо создать фид со всеми товарами, иначе отсутствующие в фиде товары попросту не будут отображены в триггерных письмах;
• в ряде систем онлайн фид обновляется только вручную, в таких условиях необходимо инициировать обновление после каждого изменения данных о товарах, таких как: наименование, описание, стоимость, ссылку на товар, добавление или удаление товаров, — иначе в письма подставятся некорректные данные;
• некоторых CMS YML-фид выгружается файлом, т.е. недоступен онлайн;
  В таких случаях фал необходимо вручную загружать на любой хостинг и обновлять его сохраняя постоянным ссылку доступа к нему.

Как проверить YML-фид по ссылке

Проверить фид на соответствие схеме и корректность состава можно, как файл YML, так и фид, доступный по ссылке.

Сделать это можно в YML-валидаторе Вебмастера Яндекс в разделе «Инструменты — XML-валидатор».

Чтобы проверить YML-фид по ссылке, выберите схему валидации документа «Маркет» и источник XML-данных для валидации «из файла», загрузите файл и нажмите кнопку «Проверить».

Аккаунт, по которому вы входите в Webmaster Yandex, не имеет значения и не влияет на результат проверки.

Как проверить структуру YML-файла.

Чтобы проверить YML-фид по ссылке, выберите схему валидации документа «Маркет» и источник XML-данных для валидации «по ссылке», вставьте ссылку на фид и нажмите кнопку «Проверить».

Если при проверке автоматически сгенерированного фида обнаружились ошибки, вы можете обратиться в саппорт @emailtools (телеграм) с вопросом о критичности ошибок и возможности запуска кампаний без их исправления.

Как получить YML

В большинстве случаев можно бесплатно выгрузить данные о товарах и категориях вашего интернет-магазина в YML-файл или сгенерировать ссылку на него.

В первую очередь проверьте — возможно вы уже используете этот формат для рекламы на Яндекс Маркете или для передачи данных о товарах и категориях в другие сервисы.
Если это так, то вам остаётся только найти его и вставить в соответствующее поле настроек сервиса триггерных рассылок.

Его можно сгенерировать с помощью специальных генераторов — модулей или плагинов.

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

Например, для WordPress есть бесплатный плагин генерации YML-фида «YML for Yandex Market», в настройках вы указываете периодичность выгрузки данных о товарах и категориях сайта в YML, указываете товары из каких категорий нужно добавлять в фид. После сохранения настроек, ссылка на генерируется автоматически.

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

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

Важно! При настройке фида категории (элемент <categories>) передаются, чтобы настроить триггер брошенной категории, поэтому не стоит им пренебрегать.

Особенности генерации ссылки фида в онлайн-cms

С сайтами на онлайн-конструкторах (веб-платформами) ситуация сложнее, но решаема.

Для некоторых платформ разработан функционал генерации ссылки для онлайн доступа к YML.

В некоторых онлайн-CMS есть особенности обновления фида, например: ссылку необходимо обновлять вручную или товары в нем обновляются автоматически, но с определённым интервалом. Использовать такой фид для триггерных рассылок можно, если соблюдать одно простое правило: отслеживать, чтобы товары публиковались на сайте прямо перед обновлением фида. Иначе подписчикам будут приходить пустые письма.

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

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

Альтернативные форматы фида для email-триггеров

Формат фида для триггерных рассылок должен иметь структуру YML, но расширение может быть не только «.yml».

Это могут быть так же и расширения xml, php.

В некоторых системах, как в cms, так и в веб-платформах нет онлайн генератора фида, но есть генератор файла YML или XML. Эти форматы подходят для добавления товаров в триггеры.

Необходимо проверить структуру файла в xml-валидаторе вебмастера яндекс. Если схема верна и ошибок нет, то загрузить этот файл на хостинг и вставить ссылку на товары в соответствующий раздел настроек сервиса триггерных рассылок (необходима авторизация/регистрация).

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

Для каких основных платформ существуют модули автоматической генерации YML

Сам Яндекс разработал плагины и модули генерации YML-фида для cms:

• 1-C Битрикс и входящий в его состав модуль;
• InSales;
• 1С:Предприятие;
• OpenCart;
• МойСклад.

Эти приложения можно смело использовать для организации экспорта товаров из вашего интернет-магазина и импорта их в письма триггерных рассылок.

Приложения для генерации YML фида от сторонних разработчиков

• Модуль для Shop-Script
• Модуль для OpenCart 2.
• Модуль для InSales
• Модуль для PHPShop 6.1.4+
• Модуль для 1С УТ 11.1
• Модуль для AdvantShop 8.5.9
• Модуль для УТ, ERP, КА
• Платформа Adapter
• SellerMarket
• Система учета FBY для 1С
• Платформа POPSO
• Платформа OrderAdmin
• Модуль FBS для платформы Shop2you
• RDV Маркет

Данный раздел необходим для пользователей, которые хотят проверить на валидацию предполагаемый товарный фид

Проверить можно товарный фид в формате XML-файла (указав ссылку на него). Необходимо проверить товарный фид с инструкцией по работе с XML-фидом

А также вы можете проверить товарный фид в виде Excel-файла, загрузив заполненную таблицу Excel по шаблону или указав ссылку на файл

Многие интернет-магазины попадают в Яндекс.Маркет, не все там остаются надолго. Одно из условий присутствия в ЯМ-е – наличие корректного прайса в специальном формате YML.

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

Данная статья – попытка обобщить те ошибки, с которыми сталкиваются программисты, впервые создающие инструменты (будь то автономный скрипт или плагин для CMS) для генерации YML-файла. Тем, кто с этим чудным форматом имел дело раньше, статья уже будет не столь интересна, ибо всё шишки набиты. Впрочем, вдруг и ветераны борьбы за своё место под солнцем Яндекса узнают что-то новое для себя. А то и поделятся собственным фронтовым опытом.

Классификация ошибок

1. Неактуальные ошибки

   • Не та кодировка. Первое обо что спотыкались в старые добрые времена. Большинство движков работают на UTF-8, а ЯМ когда-то требовал только любимую кодировку Windows. Поговаривают, что капризного Яшу можно было объегорить – сделать вид, что согласны на богомерзкую cp1251 при утверждении магазина, после того как «таможня даёт добро» – преспокойно заменить прайс на расово верный Юникод. Что интересно – CSV (как нежелательную альтернативу YML) Яндекс.Маркет принимает исключительно в UTF-8

   Все остальные грабли лежат всё там же.

2. Ошибки спецификации XML

   
   YML – это частный случай XML. А значит, должен соответствовать его основным правилам. Не забываем об обязательном наличии <?xml ?> и <!DOCTYPE>, следим за правильной вложенностью тегов, заменяем «великолепную пятёрку» («, &, <, >, ‘) на их мнемонические эквиваленты.

   Причём, в самих мнемониках символ & на его мнемонику &amp; менять не нужно, а то какая-то бесконечная рекурсия может получиться. Прежде чем применять к тексту (для элемента <description>, например) функцию htmlspecialchars, следует учесть, что там уже могут мнемоники изначально присутствовать

3. Критичные ошибки YML

   Теперь Ваш прайс – кошерный XML, но Яндекс наотрез отказывается его принимать. Разбираемся дальше.

   • Ошибки в использовании элементов. Перечитываем 3 раза (а ещё лучше — 5) внимательно официальную документацию, не забываем про глобальные теги (<yml_catalog>, <shop>), следим за правильным написанием названий, не занимаемся отсебятиной в виде придумывания несуществующих в спецификации тегов, всю иерархию расставляем по yml-скому фен-шую, указываем правильно параметры и т.д.
   • 
     Отсутствие обязательных элементов. Самые частые ошибки новичков и не очень новичков. Особенно часто такое всплывает при формировании offer-ов. Необязательный тег для одного вида описаний может оказаться обязательным для другого. К примеру, <vendor>. На такое можно напороться, если раньше к продукции применялось упрощённое описание, а потом вдруг решили переделать на vendor.model.
   • Не каноничный порядок элементов. Очень подлая ошибка, прям-таки удар под дых для тех, кто с ней сталкивается впервые. Ситуация, когда Яндекс невозмутимо настаивает, что в строке такой-то позиция такая-то что-то не так, а в указанном месте ничего подозрительного и в упор не видно (причём, гугление форумов и медитация на офдокументацию эффекта не даёт) – способна довести любого до белого каления.
     А ларчик просто открывается – элементы должны идти именно в том порядке, в котором они перечислены в спецификации. Вот в упрощённом описании сначала название товара, а потом производитель. А в vendor.model сначала производитель, а потом название товара. И ни в коем разе не наоборот.
   • Повторы продукции по ID. Что умиляет, ошибка эта Яндексом выдаётся сразу двумя разными способами (чтобы никто не запутался) – сначала перечисляются элементы с некорректными идентификаторами, а потом идёт список предложений-дубликатов.
     С перепугу можно решить, что ошибок в 2 раза больше, чем на самом деле. И если с дубликатами всё понятно, то непосвящённым ещё предстоит догадаться чем именно некорректны некорректные идентификаторы.

4. Некритичные ошибки YML

   
   Яндекс почти ублажен. Поработаем ещё немного.

   • Некорректные URL. Часто это ссылки, например, содержащие пробельные символы или русские буквы. Вообще, во многих движках в таблицах БД обычно есть поля, хранящие прямые линки на страницы продукции. Что характерно, почти во всех CMS среди этих ссылок очень много мусора и поэтому обычно приходится генерировать самому.
   • Цена равна 0. Здесь программисту нужно посовещаться с контент-менеджером. Или фильтровать нулевые цены, но тогда о товарах, где забыли указать стоимость, вспомнят нескоро. Или не фильтровать и пускай в будущем контент-менеджер с претензиями Яндекса сам разбирается.
   • Неверные ссылки на картинки. Ну, тут примерно та же история, что и с неправильными URL. Прописанных в базе данных картинок часто не существует в природе. Прежде чем оформлять очередной <picture> – проверяйте наличие файла. Если картинка в наличии, но в названии есть злополучные пробелы – кодируйте ссылки в RFC3986 (функция rawurlencode Вам в помощь).

5. Прочие ошибки

   ОК, все огрехи тотально устранены и скормленный Яндексу yml-прайс не выплёвывается обратно. Погодите расслабляться, через пару дней вполне может прийти «письмо счастья» от менеджеров ЯМ-а, в котором уведомляется, что:

   • Товарный ряд сплагиачен из другого магазина. Особо тяжкое преступление, караемое по всей строгости закона.
   • В вашем прайсе мы упорно искали и таки нашли дубликаты!
   • И кстати, некоторые ссылки ведут не туда.
   • Какой идиот создавал эту категоризацию?
   • В качестве фото продукции используются заглушки.
   • Одни и те же фото у разных товаров. Ну и что с того, что на официальном сайте производителя то же самое?
   • А некоторые картинки вообще не с Вашего сайта.
   • В мутных водах элементов <description> плавает «рыба».
   • В магазине 100% предоплата, но почему об этом ни гу-гу в теле необязательного элемента <sales_notes>?
   • Ах, у Вас из 500 товаров есть всего один «под заказ»? А почему у него aviable=’true’, а не ‘false’?
   • У вас, уважаемые, доставка 3 дня, а по нашим понятиям товар считается «доступным» если доставляется в течении 2-х.
   • … и всякое-такое прочее.

   А посему Ваша лавочка пока отстранена от присутствия в торговой вселенной Яндекс.Маркета на срок от недели до навсегда.

   По большому счёту, подобные ошибки вне компетенции кодеров. За них отвечают другие специально обученные люди – контент-менеджеры, SEO-шники, маркетологи или кого там ещё нагрузили следить за содержимым сайта. Впрочем, программисты иногда могут помочь и здесь. Например, фильтруя картинки-заглушки (определяя их по стандартным названиям) или не пропуская описания продукции, почему-то начинающиеся со слов «Lorem ipsum» и «bla bla bla».

Как и где проверять ошибки

Отлавливать все эти многочисленные ляпы проще всего в таком порядке.

• Ошибки XML. Хозяюшке на заметку – дублируйте yml-файлы с расширением xml, по крайней мере в период тестирования (да и потом может пригодиться). В браузерах и текстовых редакторах yml-документы открываются как унылые текстовики, что делает их неудобными для просмотра и анализа. В дебрях XML ориентироваться намного проще: там всегда весёленькая подсветка тегов + элементы можно «схлопнуть» в соответствии с их иерархической структурой + браузер услужливо подскажет где несоответствия спецификации. В общем, отследить ошибки YML проще, открыв его как XML.
• Проверка в Яндекс-Маркете. Ну, и последнее слово – за Яндексом. Зарегистрировав магазин, проверяйте файл в ихнем валидаторе и устраняйте выдаваемые ошибки до победного конца.

Ссылки

Яндекс:

Официальная спецификация YML
Требования к методу передачи данных
Валидатор
Вопросы и ответы
Требования к рекламным материалам

Хабрахабр:

Яндекс.Маркет – to be or not?
Размещение товаров на Яндекс.Маркете. Типичные проблемы и их решение
Ночное ворчание о Яндексе, Маркете и интерфейсах вообще

Опрос

Приходилось ли вам с нуля писать скрипты/плагины для генерации YML?

Проголосовали 143 пользователя.

Воздержались 30 пользователей.

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

Ключевая особенность и преимущества площадки

Особенность СберМегаМаркета — объединение предложений разных продавцов в единую универсальную карточку товара. Например, ноутбук определенной модели могут продавать МВидео, ИП Соколов и региональный компьютерный магазин. Такой подход сводит вывод товара к одному клику — в тот момент, когда оффер продавца прикрепился к соответствующей карточке на маркетплейсе, товар отображается на витрине.

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

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

Из чего состоит загрузка ассортимента

Путь товара от продавца до витрины СберМегаМаркета состоит из трех основных этапов:

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

1. Выбрать способ загрузки товара на маркетплейс

Передать товарное предложение можно двумя способами на выбор:

Чем у магазина больше товара, тем внимательнее на старте стоит отнестись к выбору способа загрузки.

В каких случаях подойдет Excel фид:

В каких случаях подойдет XML фид:

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

2. Сформировать фид выбранным способом

Когда способ передачи товарного предложения определен, нужно сформировать соответствующий файл с информацией о товаре — XML или Excel фид. В личном кабинете этот этап постарались сделать интуитивно понятным и добавили инструкции, которые можно изучить при необходимости.

Как пользоваться Excel фидом. Нужно скачать шаблон и корректно заполнить все обязательные поля. Затем передать заполненный файл через функцию «Загрузить фид».

Как пользоваться XML фидом. Нужно сформировать XML фид, загрузить его на FTP сервер и добавить в специальное поле ссылку на готовый файл.

Чтобы СберМегаМаркет смог получить фид по прямой ссылке, нужен FTP/HTTP/s3 сервер, через который передаются данные. В интернете есть платные и бесплатные серверы для работы с XML фидами.

3. Проверить фид и исправить ошибки

Главная ошибка, из-за которой фиды не грузятся или некорректно обрабатываются, — не заполнены обязательные поля или заполнены не теми типами данных.

Если фид содержит ошибки, система сообщит о них, но товар не загрузится. Ошибки нужно будет исправить, а фид загрузить снова.

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

4. Пройти матчинг после загрузки фида

После отправки и обработки фида все товарные предложения проходят матчинг. Поиск соответствий идет по нескольким алгоритмам:

В результате матчинга все товары распределяются по вкладкам «Подтверждение соответствия» и «Соответствия не найдены».

Во вкладку «Подтверждение соответствия» попадают товары, к которым на маркетплейсе нашлись карточки. Нужно проверить совпадения товара и карточки в каждом разделе, затем подтвердить их или отклонить.

Если ассортимент небольшой или нужно перепроверить каждую позицию — подтверждать и отклонять совпадения можно вручную соответствующими кнопками. А можно при помощи функции «Массовое соответствие» сразу выделить все товары-совпадения и сохранить для последующей склейки. Это быстро и удобно, когда продавец уверен, что правильно передал информацию о своем товаре, или совпадений слишком много для ручной обработки.

Во вкладке «Соответствия не найдены» будут товары, к которым на площадке нет карточек. В этом случае нужно завести новую карточку, с которой эти товары свяжутся автоматически. Заполнять все поля с нуля не придется — переданные ранее параметры товара для поиска совпадений подтянутся в новую карточку.

Почему матчинг может сработать некорректно

Если характеристики товара указаны неверно, поиск может предложить не те карточки, например, соединить дрель и сок, или вовсе не предложить соответствий. Так происходит, когда в отправленном фиде:

Неправильные связки товара и карточки можно разорвать и потом переклеить вручную. Для этого нужно нажать кнопку «Нет соответствия» и товар отвяжется от несоответствующего предложения.

5. Соединить предложение продавца с карточками товара

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

Эта функция автоматически соединит все совпавшие товары с карточками, если:

Автосклейка не сработает, если:

Все склейки товара с карточками можно посмотреть, проверить, неправильные откатить и переделать вручную.

Во вкладке «Готовые связки» отображаются все сохраненные соответствия товаров и карточек в результате склейки. Здесь их можно проверить и доработать, чтобы избежать проблем при продажах, например, несоответствия товара или неправильной цены за штуку/упаковку.

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

Статусы товара после склейки с карточкой

Все, что происходит с товаром после склейки, можно увидеть по соответствующему статусу во вкладке «Доступно к продаже».

Опубликованный товар можно легко скрыть. Для этого нужно нажать на «замок» и заблокировать готовую связку. Это удобно, например, для сезонных предложений или если товар заканчивается, а довоз под вопросом.

Ответы на самые частые вопросы продавцов

Вопрос: Как работают обновления?

Ответ: Обновляться можно через передачу фидов или вручную. Для обновления через XML нужно загрузить новые данные в фид и выставить актуальную дату, а для Excel — передать новый файл с измененными данными.

Вопрос: Новый товар — это новый фид?

Ответ: На новый товар нужно передать новый Excel-фид, а в XML-фиде добавить новый блок и обновить дату.

Вопрос: Как обновлять цены и остатки?

Ответ: Вручную или с помощью фидов. Для Excel — присылаете новый фид с новыми данными, для XML — обновляете цены, остатки и дату.