Как редактировать yml файл. Интернет-магазины и Яндекс Маркет: YML файл. Желаем Вам высоких продаж и конкурентных цен
Данный документ без изменений взят с сайта http://partner.market.yandex.ru/ (компания «Яндекс»)
Технические требования
В соответствии с Общими условиями (http://partner.market.yandex.ru/legal/general/) в настоящем документе определены технические требования к структуре и иным характеристикам, в обязательном порядке предъявляемым к Материалам, размещаемым в базе данных Яндекс.Маркет.
Метод передачи данных
Размещаемые материалы должны быть опубликованы на сайте клиента по URL-адресу, согласованному с компанией «Яндекс», и доступны по протоколам HTTP или FTP. Допускается использование стандартной авторизации для автоматического скачивания файла роботом Яндекс.Маркета, при этом данные для авторизации должны также быть согласованы.
Формат данных
Передаваемые данные должны соответствовать спецификации формата YML (см. ниже). Допускается публикация в упакованном виде с помощью алгоритма GNU ZIP (суффикс gz). http://www.gzip.org/
Ссылки на сайт Клиента, публикуемые в составе предложений, должны вести на соответствующие «страницы товара», т.е. на страницы, содержащие описание предлагаемого товара, его цену и кнопку «Купить» или «Заказать». Каждому размещаемому предложению должна соответствовать отдельная страница товара.
Сайт клиента в целом и все страницы товаров должны находиться в рабочем состоянии и быть доступными любому пользователю в течение всего срока размещения предложений о продаже на Яндекс.Маркете.
На страницах товара не должны использоваться элементы, приводящие к открытию дополнительных окон браузера (popup, popunder) или переходу на другую страницу (redirect) без разрешения пользователя.
Описание формата YML
YML (Yandex Market Language) – стандарт, разработанный «Яндексом» для принятия и публикации информации в базе данных Яндекс.Маркет. YML основан на стандарте XML (Extensible Markup Language).
XML документ должен соответствовать следующему формату (DTD):
Общие замечания по формату (необходимо учитывать при создании файлов в стандарте YML)
Стандарт XML учитывает порядок следования элементов, поэтому важно соблюдать его в соответствии с прилагаемым DTD (см. приложение) или примерами, приведенными ниже.
Стандарт XML не допускает появления символов с ASCII-кодами в диапазоне значений от 0 до 31 (за исключением значений 9, 10, 13 – табуляция, перевод строки, возврат каретки) в текстовых полях. Также этот стандарт строго требует заменять в тексте все следующие символы.
Условия замены в текстовых полях
|
Текст |
Замена |
Описание формата полного списка товаров
Заголовок документа (XML header)
Элемент yml_catalog
Корневой элемент полного списка товаров магазина должен
содержать один элемент, выделенный тэгами
Элемент shop
Описание магазина и товаров магазина включает в себя следующие поля:
Элемент currencies
Список курсов валют магазина. Параметр id обозначает код валюты, а параметр – курс валюты к рублю. В случае, если параметр rate, описанный в этом элементе, имеет значение ‘CBRF’, то Яндекс.Маркет будет воспринимать курс валюты магазина как курс ЦБ РФ.
или ЦБ РФ + %
(в таком случае Яндекс.Маркет будет пересчитывать по курсу ЦБ РФ +3%, для каждой из валют)
Внимание! В качестве разделителя целой и дробной частей стоимости независимо от региональных установок используется точка (не запятая!).
Элемент categories
Список категорий магазина. Описание категории должно включать ее идентификатор ( параметр id) для всех категорий и идентификатор категории более высокого уровня для подкатегорий. Идентификатор категории должен быть уникальным положительным целым числом. Ни у одной категории параметр id не может быть равен «0». Если элемент parentId не указан, то категория считается корневой.
Параметры:
id – идентификатор Вашей категории товаров
parentId – идентификатор предыдущей по иерархии категории товаров
Элемент offers
Список товарных предложений магазинов. Содержит элементы типа offer .
Описание элемента offer
Ниже приведены несколько примеров.
Описание товарного предложения через «vendor.model» (наиболее удобный вариант с точки зрения Яндекс.Маркета)
Компьютеры / Принтеры
Принтер HP Laser Jet 5 100
Цены: 56400 р. ($1500)
BestShop
Доступность: в наличии
Наиболее простое описание при поиске:
Описание товарного предложения магазина в результатах поиска:
Компьютеры / Принтеры
Принтер HP Laser Jet 5 100
Цены: 56400 р. ($1500)
BestShop
Доступность: в наличии
Принтер. Формат А4, А3. Технология печати: лазерная. Процессор: 300 МГц. Память: 32 Мб. Разрешение при печати: 1200х1200 т/д. Скорость печати: А3 11 стр./мин., А4 22 стр./мин. Плотность бумаги: 60-199 г/м2. Нагрузка до 65000 страниц в месяц. Лоток 1: 100 листов. Лоток 2: 250 листов. Лоток 3: 500 листов.
Описание тэгов, входящих в элемент
|
Тэги |
Описание |
|
URL-адрес страницы товара |
|
|
цена, по которой данный товар можно приобрести |
|
|
идентификатор валюты товара (RUR,USD,…) |
|
|
Производитель |
|
|
наименование товарного предложения |
|
|
описание товарного предложения |
|
|
код товара (указывается, как правило, код производителя) |
|
|
статус товара |
|
|
состояние заказа («в наличии», «под заказ», «срок формирования заказа»). ordering является тэгом, обозначающим доступность товара на складе магазина. Этот тэг не должен отображать информацию о доставке. |
В YML существуют еще несколько типов описаний предложений
товаров:
Представление товарных предложений типа «книги» и «медиапродукция», описание которых может быть произведено посредством специализированных элементов:
Книги
Описание товарного предложения магазина в результатах поиска:
Книги / Художественная литература / Детективы
Александра Маринина «Мужские Игры»
Цены: 65 р.
BestShop
Доступность: в наличии
Доставка: Россия
Издательство: ЭКСМО-Пресс
Серия: Детектив глазами женщины
Год издания: 1999
ISBN: 32142143214
Автор: Александра Маринина
Кажется, невозможно подобрать ключ к новому, запутанному делу, что предстоит расследовать сотруднику уголовного розыска Анастасии Каменской. Крупный мафиози Эдуард Денисов дает сотруднику уголовного розыска Насте Каменской нить к разгадке преступлений.
Описание музыкальной продукции
В результатах поиска:
Музыка
Pink Floyd «Dark Side Of The Moon, Platinum Disc»
Цены: 150 р. ($150)
BestShop
Доступность: в наличии
Доставка: Россия
Год издания: 1999
Носитель: CD
Описание видео продукции:
В результатах поиска:
Фильмы
Свадьба Мюриэл
Цены: 93 р.
BestShop
Доступность: в наличии
Доставка: Россия
Носитель: DVD
Год издания: 1999
Режиссер: П. Д. Хоган
Страна: Австралия
Оригинальное название: Muriel"s Wedding
Главные роли: Тони Колетт (Toni Collette), Рэйчел Грифитс (Rachel Griffiths)
«Гадкий утенок» из провинциального городка покидает свое гнездо, и в компании своей подруги отправляется искать веселой жизни в большой и загадочный город. Фильм о мечтах и реальности, дружбе и юности молодой девушки, приключения которой повторяют судьбы Золушки и героини Джулии Робертс из ставшего классикой фильма «Красотка»…
Яндекс оставляет за собой право поменять вид выдачи предложений, поэтому не гарантирует показ предложений в том виде, в котором они представлены в примерах.
Тэг picture
Для каждого товарного
предложения в элементе
Пример:
По указанному URL-адресу должна отдаваться картинка формата jpeg, gif или png не меньше чем 100х100. Картинки большего размера будут уменьшены автоматически. Ссылка на HTML с картинкой не допустима.
Для того чтобы рядом с товарным предложением показывалось изображение этого товара, необходимо чтобы на вашем сервере в файле robots.txt изображения были открыты для индексирования.
Правила индексации в поисковой системе «Яндекс» можно посмотреть по ссылке:
Тэги description и name
В полях
Условия отключения сайта от базы данных Яндекс.Маркет
Интернет-магазин отключается от базы данных Яндекс.Маркет при несоблюдении вышеизложенных требований и условий, описанных в договоре.
Для выгрузки товаров в Яндекс Маркет из веб магазина в формате yml, есть . Тем не менее, частые заказы связаны с тем, что "программист взялся и yml написать осилил, но почему он не подходит Яндексу".
Мешает ограничение на 3 бесплатных проверки. Но елки палки, уж проверить то xml на валидность можно? Есть отличный онлайн сервис для проверки xml . Проверка в два этапа, сначала скармливаем yml, затем shops.dtd Это избавит от большей части ошибок. Перечислю самые частые.
1.В неправильном порядке перечислены элементы.
Пример yml файла, который не пройдет валидацию.
< offer id = "1208" available = "true" > < price > 3000 < / price > < url > http : //sdsfsfsfsfs.ru/catalogue/17/1208/ < currencyId > RUR < / currencyId > < categoryId > 17 < / categoryId > < picture > http : //sdsdssdsds.ru/uplfiles/2012101210550511.jpg < name > КомодЛотосскрышкой2.06 < / name > < vendorCode > КомодЛотосскрышкой2.06 < / vendorCode > < description > Размеры: Высота840 см, Ширина814 см, Глубина400 см< / description > < / offer > |
Элементы price и url перепутаны, а ведь порядок указан в shops.dtd, да и в мануале черным по-белому указано блюсти правильный порядок.
2. Запрещенные символы
Стандарт XML не допускает использования в текстовых данных непечатаемых символов с ASCII-кодами в диапазоне значений от 0 до 31 (за исключением символов с кодами 9, 10, 13 — табуляция, перевод строки, возврат каретки). Опять таки в мануале указаны 5 символов, которые подлежат замене на их эквиваленты в текстовых полях.
Error parsing XML feed: Unterminated entity reference, "gt" (строка 53105, столбец 25)
3. Несоответствие типу.
Выбирают тип vendor.model например и пытаются пихать в него какой либо элемент, специфичный для типа book. Или наоборот, не указывают обязательный эелемент. В результате примерно такое
Фатальная ошибка: Ошибка парсинга XML: Error parsing XML feed: Not enough elements to match content model: "(name,company,url,phone?,platform?,version?,agency?,email*,currencies,categories,store?,pickup?,delivery?,deliveryIncluded?,local_delivery_cost?,adult?,offers)" (строка 22, столбец
Или
Element "store" is not valid for content model
И перечень основных ошибок от Яндекса.
[скачать]
Для того, чтобы избавиться от этих ошибок, написал простенький класс, который работает с типом "vendor-model". В Яндекс Маркете их несколько, но vendor-model подходит для большинства веб магазинов. Скрипт генерирует валидный yml-файл, с нормальным заголовком, с правильным порядком элементов и заменяет "неправильные" символы.
Пример его использования. В примере всего 1 товар, но их можно добавить сколько нужно.
addCurr("RUR", 1); $market->addCurr("USD", "CBRF"); $market->addCat("Все товары",1); $model = self::_getModel(); $entries = $model->fetchEntries(); foreach ($entries as $entry) { // offer catId, title, entryId $offer = new OfferYmt($entry["id"]); $offer->setUrl("http://ikey.ru/product/" . $entry["uri"]); $offer->setRequired($entry["price1"], "RUB", 1, $companyName, $entry["title"]); $offer->setElem("description", $entry["data"]); $market->addOffer($offer->save()); } //var_export($entries); $xml = $market->save(); $this->_helper->layout->disableLayout(); $this->_helper->viewRenderer->setNoRender(); /* $view = new Zend_View(array("basePath"=>APPLICATION_PATH."/views")); $view->xml = $xml; $this->render("/yamarket/view") ;*/ header("Content-type:application/xml"); $yml = iconv("utf-8", "cp1251//IGNORE", $xml); //file_put_contents("ymt.xml", $yml); // а можно сохранить в файл echo $yml; }
< ? php include "YandexMarket.php" ; public function viewAction () { $ shopName = "Все для домофонных ключей" ; $ companyName = "OOO "ККККЕЙ"" ; $ siteURL = "http://kkkkey.ru" ; $ market = new YandexMarket ($ shopName , $ companyName , $ siteURL ) ; $ market -> addCurr ("RUR" , 1 ) ; $ market -> addCurr ("USD" , "CBRF" ) ; $ market -> addCat ("Все товары" , 1 ) ; $ model = self :: _getModel () ; $ entries = $ model -> fetchEntries () ; foreach ($ entries as $ entry ) { // offer catId, title, entryId $ offer = new OfferYmt ($ entry [ "id" ] ) ; $ offer -> setUrl ("http://ikey.ru/product/" . $ entry [ "uri" ] ) ; $ offer -> setRequired ($ entry [ "price1" ] , "RUB" , 1 , $ companyName , $ entry [ "title" ] ) ; |
Экспорт товаров в онлайн-сервис «Яндекс.Маркет» в Shop-Script выполняется с помощью плагина из магазина Webasyst. 1. Установите плагин Установите плагин «Яндекс.Маркет»: в бекенде вашего Вебасиста перейдите в приложение «Инсталлер»,...
Импортировать информацию о товарах из YML-файла удобно, когда необходимо перенести данные из своего старого интернет-магазина в Shop-Script.Плагин импорта товаров, описанный в этой статье, поддерживает получение данных из множества популярных CMS для...
Добрый день,YML. Импорт Yml-файла. На отметке 75,037% — Импорт изображений товаров (самая длинная часть, подождите, пожалуйста)…прошло порядка 3 часов с момента запуска инсталляции, файл небольшой, примерно 7000 позицийпс вчера инсталляцию...
Сделать настройки для сайта: цели в Яндекс.Метрике, экспорт YML-файл, микроразметку хлебных крошек.
Необходимо внести изменения на сайт: 1. Настроить цели в Яндекс.Метрике: Удачная регистрация - нажатие кнопки “регистрация” идентификатор: Registracia - ID: 20225845 Удачный вход - нажатие кнопки “Войти” идентификатор:...
Обновили скрипт и все, что было с ним через Инсталлер. До этого все работало, теперь увы... Стоит плагин "Оптовые цены", в котором настраивается, сколько нужно добавить к выгружаемой по дефолту из 1С оптовой цене, чтобы получилась...
Пытаюсь проимпортировать товары из YML файла. Но, после импорта оказывается, что названия всех продуктов пусты.фрагмент примера YML от яндексая: Добрый вечер!Мне необходимо, чтобы в YML файле, экспортируемом плагином Яндекс.Маркет, добавлялась метка utm_term со значением ID товара.Подскажите, можно ли это в коде как-то поковырять самостоятельно?Это мне нужно для сервиса PricsLabs, который по... +1
Существует множество площадок для размещения товаров, в большинстве своем они принимают особым образом сформированный ymlХорошо бы иметь возможность в плагине экспорта товаров разные шаблоны генерации yml файла в зависимости от профиля.Например.Есть... +7
Добрый вечер, Webasyst!
по факту текущая выгрузка категорий в плагине является ошибкой плагина в несоответствии категорий, которые выгружает плагин в YML файл, справочнику категорий Яндекса, Данную ошибку невозможно устранить без доработки wa... Есть решение
Не могу понять каким образом обновляется YML файл, вот, что меня вводит в заблуждение.Ест там такая фраза Команда CRON для автоматического обновления файла:А сразу ниже вот этоОбновление файла "Автоматически, но не чаще чем раз в день"это... Обновление с помощью cron-а используется в тех случаях, когда формирование фида по запросу (автоматически) занимает значительное время. В этом случае, чтобы не экспортировать файл каждый раз руками можно настроить cron для этих задач с нужной периодичностью (раз в час, раз в сутки и т.п.)
Хотел импортировать из YML файла. Процедура прошла без ошибок. НО когда открыл файл ни одна характеристика файла не перенеслась и картинки из трех только одна:(В чем может быть проблема? Настройка YML файла для корректной выгрузки в Я. Маркет
Приветствую. Стоит плагин для формирования прайс листа для яндекс маркета. По данному файлу товары попадают не в ту категорию на маркете. Саппорт маркета рекомендовал убрать все подкатегории и в этом случае робот будет ориентироваться по названию на... в yml файл попадают картинки рандомно, а нужно чтоб попадала главнаяв результате того что базовый плагин /yandexmarket/ упаковывает в файл ссылку не на первую картинку в списке в карточке товара, а какую попало картинку, на яндекс марткет, гугл... Есть решение
В плагине Яндекс.Маркет, после последнего обновления перестала создаваться ссылка на yml-файл. Теперь вместо ссылки вида https://сайт.ru/yandexmarket/2156-358.xmlФормируется ссылка https://сайт.ru/my/При этом старые файлы экспорта... Почистите кеш Вебасиста.Проверьте, нет ли ошибок в структуре сайта.Попробуйте отключать плагины, кроме «Яндекс.Маркета» — возможно, какой-то из них с ошибками.
Rat
Здравствуйте!можно ли написать скрипт, который будет ежедневно обновлять цены на товары(по артикулу) подтягивая yml файл с другого сайта?или это как то делается через cron? Есть решение
Добрый день!Подскажите пожалуйста, возможно ли импортировать товары из YML файла?!Благодарю Это делается с помощью плагина Переход на Shop-Script 6, добавляющего соответствующий раздел в секции Магазин → Импорт/экспорт
Есть решение
Нужно добавить элемент delivery в YML файл для каждого товара, т.к. магазин выставляется на яндекс.маркете,то это нужно прописать вручную. Где это можно сделать и что прописать? Если вы пользуетесь Shop-Script 6, то в настройках экспорта товаров в Яндекс.Маркет есть соответствующее поле:
Есть или нет в Webasyst возможность настроить экспорт
информации о товарах и услугах из базы данных Интернет-магазина в YML-файл?
Если есть, то, как это сделать?
Может есть плагин который я не заметил, пропустил?
Или способ, о котором я не... Доброго времени суток. В YML файле, который выгружает система имеются буквы в id товаров (торговые предложения), есть ли какой-то способ использовать только числовые значения?
Я как и многие, кто будет читать данный раздел являюсь пользователем замечательной системы InstantCMS. Также я купил модуль InstantShop, для того чтобы создать интернет магазин. В настоящий момент у меня есть два интернет магазина различных тематик, и вот для одного из них и необходимо было создать файл YML для того, чтобы подключить интернет магазин к сервису Яндекс.Маркет.
Этим документом я постараюсь рассказать, как в полуавтоматическом режиме создать файл YML. Возможно, кто-то найдет в моем описание огрехи и предложить более короткий путь. Автор готов к обсуждению.
Начну с того, что весь прайс-лист магазина находится у меня в таблицах Excel. Мне это было необходимо, для того чтобы данные можно было конвертировать в магазин в автоматическом режиме.
Каждый лист моей таблицы Excel содержал только часть информации которая необходима для создания файла YML.
Поговорим немного о самом формате YML и что в нем должно содержаться. (пример моего файла YML - Прайс лист в формате YML). Там же лежит файл lavka_price.xml
Заголовок файла YML, мне пришлось писать руками, откроете мой файл и все поймете, там нет ничего сложного.
Товары внутри файла YML должны быть описаны внутри тегов
Каждый и товаров внутри тегов должен содержать следующие данные:
Из всех указанных выше данных у меня отсутствовали следующие данные:
- ссылка на страницу товара
- категория товара
- ссылка на фотографию товара
Также отсутствовала валюта товара, но т.к. она единая для всего магазина, то она не требует много знаний кроме как просто ее добавить в нужный столбец и все.
Для того чтобы получить недостающие данные пришлось писать формулы для Excel.
1. Создание ссылки на товар
Внутри InstantShop каждому товару присваивается страница с наименованием товара + .html
Для того чтобы получить необходимую страницу пришлось вначале избавляться от пробелов, и заменять их знаком тире, формула =ПОДСТАВИТЬ(номер ячейки;" ";"-"), далее избавляемся от больших букв, т.к. название страниц только маленькие буквы, для этого я использовал формулу =СТРОЧН(номер ячейки).
Далее выполняем сцепку, полученный строчный результат cube-steatite-vm-50s4cm, дополняем недостающими значениями, формула: =СЦЕПИТЬ("http://www.lavka.od.ua/shop/bytovaja-tehnika/vodonagrevateli/";L6;".html") и получаем на выходе в нужной ячейке значение: http://www.lavka.od.ua/shop/bytovaja-tehnika/vodonagrevateli/cube-steatite-vm-50s4cm.html
Примечание, у Вас может быть сложное название товара (FHR G (AN))в таком случае необходимо делать несколько преобразований, т.к. в названии страницы не может быть скобок и знака /.
2. Категория товара
Она создается на основе логической формулы вот такого примера, для раздела холодильники:
=ЕСЛИ(N6="однокамерный";259;ЕСЛИ(N6="двухкамерный";260;ЕСЛИ(N6="трехкамерный";261;ЕСЛИ(N6="винный";262;ЕСЛИ(N6="морозильник";263;ЕСЛИ(N6="комби";264;ЕСЛИ(N6="side-by-side";265))))))).
Т.к Все мои товары были разложены по подкатегориям (для холодильников это 7 подкатегорий), то система сама все сделала. Т.е в зависимости к какому под разделу относится товар (однокамерный, двухкамерный и т.д) будет вставлена соответствующая цифра 259, 260 и т.д.
3. Ссылка на фотографию
Используя ID товара, можно без труда создать ссылку на фото товара, т.к InstantShop создает ссылки используя номер ID.
Форула: =СЦЕПИТЬ("http://www.lavka.od.ua/images/photos/medium/shop";E6;".jpg") на выходе получаем следующий результат: http://www.lavka.od.ua/images/photos/medium/shop500.jpg
Теперь несколько оговорок, полученный XML файл необходимо дополнить заголовком и всей необходимой требухой которую требует Яндекс. Далее переименовать расширение файла из XML в YML.
Все Ваш файл готов.
Рыба, катамаран, плохо дело!
Наиболее часто встречаемой проблемой, из-за которой пользователи не могут открыть этот файл, является неверно назначенная программа. Чтобы исправить это в ОС Windows вам необходимо нажать правой кнопкой на файле, в контекстном меню навести мышь на пункт "Открыть с помощью", а выпадающем меню выбрать пункт "Выбрать программу...". В результате вы увидите список установленных программ на вашем компьютере, и сможете выбрать подходящую. Рекомендуем также поставить галочку напротив пункта "Использовать это приложение для всех файлов YML".
Другая проблема, с которой наши пользователи также встречаются довольно часто - файл YML поврежден. Такая ситуация может возникнуть в массе случаев. Например: файл был скачан не польностью в результате ошибки сервера, файл был поврежден изначально и пр. Для устранения данной проблемы воспользуйтесь одной из рекомендаций:
- Попробуйте найти нужный файл в другом источнике в сети интернет. Возможно вам повезет найти более подходящую версию. Пример поиска в Google: "Файл filetype:YML" . Просто замените слово "файл" на нужное вам название;
- Попросите прислать вам исходный файл еще раз, возможно он был поврежден при передаче;
