Поддерживаемые форматы заданий:
JSON ( в том числе через API), XLS/CSV, стандартные выгрузки для яндекс-маркета (XLS, XML/YML).
Как отправить задание:
разовые задания
Для отправки файла с заданием любого формата используйте форму отправки либо виджет справа.
В селекторе выберите “Задание по запросу”
Там же находится информация об оставшихся проверках на балансе.
Свяжитесь с нами, если Вам удобнее отправлять файлы с заданиями по почте.
задания по расписанию
Для установки задания по расписанию используйте форму отправки.
В селекторе выберите “Задание по расписанию”
Потребуется прямая ссылка на файл с заданием.
При обновлении файла по ссылке будет, естественно, загружаться обновленная версия.
Облачные ссылки вроде Google-disk или Yandex-disk не поддерживаются.
Какие задачи выполняет сервис parser.market:
Ниже подробнее рассмотрены все варианты, показаны примеры заполнения файла-задания.
Если возникают вопросы по заполнению файла-задания – напишите в поддержку support@parser.market
Приложите к письму прайс-лист, мы составим пример файла-задания на основе ваших данных.
1. автоматический поиск карточки товара по товарной позиции вашего прайс-листа и вывод предложений в карточке:
Поддерживаются 2 типа файлов-заданий:
1-1. Если Вы уже торгуете на Яндекс-маркете, можете просто сделать свою обычную выгрузку в привычном формате.
Это может быть YML или CSV, либо XLS, большие файлы можно упаковать в архив ZIP.
Просто отправьте эту выгрузку через форму на сайте и дождитесь результатов.
достоинства: никаких дополнительных настроек, можно начать мониторинг “здесь и сейчас”.
недостатки: не поддерживает дополнительные возможности
1-2. Составить задание, сгенерировав файл JSON или же заполнив файл EXCEL по образцу (скачать образец файла-задания).
Файл EXCEL может быть формата EXCEL (*.xls или *.xlsx), CSV либо CSV с расширением *.txt – важно сохранение заголовков в файле.
Структура JSON аналогична, пример – на этой странице.
достоинства: поддерживает возможности, описанные в пунктах 2-6
недостатки: требуются дополнительная подготовка выгрузки
Важно:
- обязательно сохраняйте заголовки в файле-задании – первой строкой и в том же порядке, что и в образце!
- поле “name” не должно быть пустым!
Если какие-то колонки пустые – в CSV файле должно стоять пустое значение, примеры:
CSV:
category;code;productid;brand;name;linkset;marketid;price;donotsearch;textsearch
;Пример-001;TDA 2320;Bosch;Утюг;;;0;;
;Пример-002;;;Утюг Bosch TDA 2320;;;0;;
EXCEL:
Автоподбор карточки в большинстве случаев сокращает трудозатраты на их ручной поиск, но не дает 100% точности результатов.
Почему это происходит – подробнее на этой странице.
Скорректировать карточку для системы можно, указав правильную карточку в следующем заказе и отправив задание способом 2, 3, 4 или 5.
Однажды скорректированная карточка запоминается системой и будет использована в следующий раз, если не менялось название, код, артикул или бренд.
2. вывод предложений по заданному Вами id карточки:
Если Вам известен id карточки товара, по которой требуется провести мониторинг цен, укажите id карточки в поле marketid:
Система пропустит этап подбора карточек и запомнит указанную в заказе.
Поддерживаются только вариант файла-задания по образу (скачать образец файла-задания):
3. вывод предложений по заданной Вами ссылке на карточку:
Карточку можно также указать ссылкой на нее в поле linkset:
Ссылки могут быть как на страницу с описанием:
так и на страницу с предложениями:
4. вывод предложений по нескольким карточкам:
В случае, если для вашего товара на маркете есть несколько карточек – для адекватного представления о ценах может потребоваться мониторить все.
Для того, чтобы получить результаты мониторинга по нескольким карточкам, укажите в поле linkset несколько карточек через пробел:
Обратите внимание, ссылки должны быть именно на карточку товара!
В приведенном примере ссылки, выделенные красным, будут проигнорированы.
Предложения с нескольких карточек будут сведены в один результат и отсортированы по возрастанию цены.
5. уточнение характеристик товара внутри карточки:
Необходимо, когда в одной карточке с фильтрами собран товар с разными характеристиками:
Оба товара на примере – в одной карточке, при этом – естественно, разные позиции прайс-листа.
Для адекватных результатов, очевидно, требуется уточнение.
Подробнее – ниже на странице в разделе “Тонкие настройки“
6. уточненный запрос:
Внимание: выбирается первая карточка товара, показанная поиском Яндекс-маркета.
Этот вариант может пригодиться, если поиск карточки осуществляется, например, по штрих-коду и Вы уверены в 100%-м результате.
Поля в заголовках файла задания
(данный раздел относится к варианту EXCEL и CSV, образец задания – скачать)
1. поля идентификации
- category – категория товара, в случае, если у Вас есть подкатегории – можно использовать удобный Вам разделитель, например “|”.
- code – уникальный код товара в вашей системе, иногда совпадает с артикулом, дублировать артикул в поле code не нужно.
Эти поля не используются для поиска карточек, заполнять их не обязательно, однако, с ними удобнее обрабатывать результаты.
2. поля поиска
productid – общепринятый артикул, не путайте его с кодом!
brand – бренд товара
name – наименование товара, обязательное поле
Поля, отмеченные синим, формируют запрос на поиск карточки товара, например, “Утюг Bosch TDA 2320”.
Если поля productid и brand не заполнены, крайне желательно, чтобы общепринятый артикул и бренд товара присутствовали в названии.
Важно: не путайте code (код товара в вашей системе – зачастую просто порядковый номер) и productid – общепринятый артикул или модель товара!
Если бренд и артикул уже содержатся в наименовании товара, например, Электронная книга PocketBook 632, специально дублировать их в отдельных полях не нужно.
Важно, чтобы бренд и название были как можно ближе к общепринятому написанию, в идеале – к наименованию товара в той карточке, где Вы хотели бы видеть свой товар.
3. уточняющие поля
price – используется для заполнения колонки “позиция цены” в отчете EXCEL.
linkset – ссылка или ссылки на карточку товара, если заполнено – marketid игнорируется
marketid – прямое указание на карточку товара, состоит только из цифр.
donotsearch – если “1” – система не будет искать новую карточку даже при ошибке 404.
textsearch – текстовый запрос для метода “получение результатов из поиска”.
Если название в прайс-листе подходит для поискового запроса – продублируйте название.
Если поле textsearch непустое – linkset и marketid игнорируются.
4. порядок использования полей
- textsearch
Если непустое – система выдает результаты поиска на Яндекс-маркете.
Поля linkset, marketid, donotsearch при этом игнорируются. - linkset – производится поиск по ссылке/ссылкам, поля marketid, donotsearch при этом игнорируются.
- marketid – вывод результатов по заданной карточке товара
Это несколько ограниченный вариант в сравнении с предыдущим, но у многих в базах накоплен массив id.
Тонкие настройки:
Пояснения по полю marketid:
Поле marketid – это идентификатор карточки товара, состоит только из цифр. Пример id карточки в адресной строке браузера:
https://market.yandex.ru/product–kofemolka-bosch-mkm-6000-6003/116335/offers?cpa=1&how=aprice&grhow=supplier&lr=213&local-offers-first=0
Пример заполнения:
category | code | productid | brand | name | linkset | marketid | price | donotsearch | textsearch |
МБТ | Кофемолки | Пример-005 | MKM 6000 | Bosch | Кофемолка | 116335 |
При заполнении поля в первом заказе система пропускает поиск карточек и собирает данные непосредственно из указанной.
Это ускоряет процесс обработки прайс-листа и уменьшает вероятность ошибок.
Система запоминает id карточки и в дальнейших заказах, даже если он не указан.
Если указано – система перезаписывает имеющийся в базе id карточки и в дальнейшем ориентируется уже на новую.
Таким образом делается корректировка id карточки в системе.
Если новая карточка приводит к ошибке 404 – система начинает поиск карточки, как если бы она не была указана.
Фильтры и сводный отчет по нескольким карточкам – пояснения по полю linkset:
Поле linkset (набор ссылок) незаменимо в сложных случаях, когда поиск карточек, соответствующих вашему товару заведомо приведет к некорректным, либо, как минимум – неполным результатам.
Пример 1 – карточек слишком мало (фильтры)
Товар: Кофе в зернах Lavazza Oro 250 грамм
Система в данном случае находит подходящую карточку с id 168903162 – https://market.yandex.ru/product–kofe-v-zernakh-lavazza-qualita-oro/168903162?cpa=1
В этой карточке 102 предложения, из которых подходящих – всего 20, остальное – кофе в пакетах по 500 и 100 грамм, есть еще предложения упаковок по 2 и 4 штуки.
Результаты по найденной карточке будут содержать излишние данные и неверные данные по минимальной цене (если нужно отследить цены на упаковку 500гр)
В этом случае для получения корректных результатов нужно открыть страницу с карточкой товара, либо предложениями по ней и отфильтровать нужные позиции:
После чего, скопировать ссылку в адресной строке браузера и вставить ее в поле linkset:
category | code | productid | brand | name | linkset | marketid | price | donotsearch | textsearch |
Кофе | https://market.yandex.ru/product–kofe-v-zernakh-lavazza-qualita-oro/168903162/offers?glfilter=23674510%3A250~250_100419608814&cpa=1&how=aprice&grhow=supplier&local-offers-first=0&sku=100419608814 |
В полученных результатах останется только нужный Вам товар,
Если, помимо этого, в Яндекс-маркете присутствую и другие карточки на этот же товар – этот метод можно комбинировать с пунктом “Пример 2”
Пример 2 – карточек слишком много (сводный отчет по нескольким карточкам)
Товар: Мягкий бак для душа EKUD 200 л. На момент написания текста этому товару соответствует как минимум 4 карточки на яндекс-маркете:
Цена | Продавец | Ссылка |
2285 | Благодатный мир | https://market.yandex.ru/product–miagkii-bak-dlia-dusha-ekud-200-l/1458514945?cpa=1 |
2550 | Техмос | https://market.yandex.ru/product–miagkii-bak-ekud-dlia-dusha-200-litrov/2000414863824?cpa=1 |
2290 | Умная Техника | https://market.yandex.ru/product–emkost-dlia-letnego-dusha-ekud-200-l/101485615730?cpa=1 |
2290 | EKUD | https://market.yandex.ru/product–skladnaia-emkost-dlia-letnego-dusha-200-litrov-90-90-35/870860135?cpa=1 |
Очевидно, что стандартный поиск карточек даст какой-то один результат, выбранный алгоритмом по степени похожести вашего названия и названия в карточке.
Проку с таких результатов немного – искаженное количество предложений и диапазон цен, правильная минимальная цена – если повезет.
Чтобы система выполнила мониторинг всех этих карточек, нужно собрать эти ссылки в поле linkset таким образом:
category | code | productid | brand | name | linkset | marketid | price | donotsearch | textsearch |
Товар: Мягкий бак для душа EKUD 200 л. | https://market.yandex.ru/product–miagkii-bak-dlia-dusha-ekud-200-l/1458514945?cpa=1 https://market.yandex.ru/product–miagkii-bak-ekud-dlia-dusha-200-litrov/2000414863824?cpa=1 https://market.yandex.ru/product–emkost-dlia-letnego-dusha-ekud-200-l/101485615730?cpa=1 https://market.yandex.ru/product–skladnaia-emkost-dlia-letnego-dusha-200-litrov-90-90-35/870860135?cpa=1 |
Для этого открываете нужную страничку карточки (описание товара либо список предложений в карточке), копируете ссылку в адресной строке браузера и вставляете в поле linkset.
Важно: Ссылки должны начинаться с “https://” и отделяться друг от друга пробелами (собрать их из разных ячеек в EXCEL поможет формула вида =F14&” “&F15&” “&F16&” “&F17)
Ссылки должны быть именно на карточки товара (product), а не на предложения (offer), результаты поиска (search) или каталог (catalog).
Результаты будут отсортированы по цене. Неверные (ошибочные) ссылки отбрасываются.
Так же, как и с полем marketid, сведения о фильтрах запоминаются системой и будут использованы в следующем задании, даже если они не указаны.
Это дает возможность один раз подкорректировать фильтры по товару, и в дальнейших заданиях использовать выгрузки XML или EXCEL для яндекс-маркета.
(запоминание ссылок и фильтров пока в стадии открытого тестирования, поэтому замечания и предложения приветствуются, как и всегда)
Как понять, понадобится ли указание ссылок?
Если В прайс-листе много позиций, просматривать сразу все – это слишком долго. Рекомендуется в первый раз запустить поиск в автоматическом режиме.
В отчете EXCEL обратите внимание на графу “Фильтры”
В этой графе отображается информация о фильтрах, присутствующих в карточке товара, а именно: название фильтров и единица измерения (как в карточке товара).
Если фильтры представляются Вам значимыми для результатов (кому-то не важен, например, цвет товара) – это означает, что требуются вышеописанные уточнения.
В карточке подробных сведений тоже есть информация о фильтрах (в квадратных скобках), помимо названия фильтра и единицы измерения есть их значения в предложении магазина:
В примере на этой картинке продавец вообще не указал сведения о цвете товара, конфигурация не указана в фильтрах предложений, при этом указана в описаниях и фильтруется.
Если в карточке немного предложений – возможно, стоит задуматься о мониторинге по нескольким карточкам.
Проверить это Вам поможет список дополнительных карточек:
Тут можно посмотреть, найдены ли системой похожие карточки товара (есть название в карточке, id карточки, ссылка на карточку). Если есть – рекомендуется также поискать ссылки вручную, поскольку в списке могут быть не все подходящие карточки.