Parser.market — сервис, рассчитанный на компании разного уровня — от крупных оптовых компаний и вендоров со своим штатом IT-специалистов до небольших (пока) оптовиков и интернет-магазинов, руководители которых решают, как правило, широкий спектр задач.
Мы не гонимся (пока) за большим количеством форматов ввода данных и экспорта в различные системы, предпочитая сосредоточиться на качестве результатов мониторинга.
Вместе с тем, с уважением относимся к вашему времени, поэтому отчеты предоставляются в нескольких вариантах:
- Для программистов — форматы JSON/XML/CSV, для компаний, имеющих в штате или на фрилансе IT-специалистов, которые могли бы встроить полученные данные в собственную систему учета
- Для коммерсантов — формат EXCEL с удобной навигацией, позволяющий сразу ознакомиться с ситуацией на рынке людям, отвечающим за коммерцию, не дожидаясь обработки данных и ввода их в вашу учетную систему.
Отчеты в EXCEL (см также отчеты в csv, отчеты JSON/XML)
Листы в отчете
Отчет EXCEL состоит минимум из трех листов
- title — содержит лист с общими результатами мониторинга, пояснения по цветовым схемам, сведения о списании и остатках проверок на балансе заказчика.
- table_0 — сводная таблица результатов по товарным артикулам
- result_0 — подробные отчеты о предложениях по товарным позициям
Ограничения по таблицам — 10000 товаров для сводных таблиц, 300 — для подробных, далее таблицы разбиваются, появляется table_1, result_1 и так далее.
Чтобы комфортнее пользоваться таким отчетом, большие прайс-листы лучше отправлять в обработку частями — если в такой части будет до 10000 позиций, они все окажутся в одной сводной таблице, удобнее будет фильтровать, искать и сортировать.
Титульный лист и цветовые схемы
Помимо общих сведений о результате мониторинга титульный лист поясняет цветовые схемы таблиц:
Оранжевая — этим цветом подкрашены сведения из вашего заказа (указанные Вами категория, артикул, цена, наименование товара)
Синяя — сведения из найденной карточки товара на Яндекс-маркете (название товара на маркете, количество предложений магазинов, а также рейтинг товара, количество оценок, отзывов, вопросов о товаре, если таковые есть).
Зеленая — сведения о предложениях магазинов в подробной таблице, ценовая картина по предложениям (первая цена, средняя, медиана*, позиция вашей цены среди предложений).
«ПЕРЕЙТИ К ТАБЛИЦАМ РЕЗУЛЬТАТОВ» — ссылка на начало первой таблицы
* медиана — «честное среднее», цена, число предложений ниже и выше которой одинаково
Сводная таблица результатов
Сводная таблица интуитивно понятна, обратите внимание на две колонки:
ссылка — при нажатии на ячейку в этой колонке ваш браузер по умолчанию откроет предложения на карточке товара в Яндекс-маркете.
название на маркете — отображает название товара так, как оно указано в карточке на Яндекс маркете.
При нажатии на ячейку произойдет переход в соответствующую часть часть подробной таблицы,
По опыту, выбранная в этой части ячейка может оказаться вверху, либо внизу активного экрана, что скроет часть данных. Просто покрутите колесико мышки.
Наверное, переход можно было сделать изящнее, но это предполагает использование макросов, что далеко не в каждой компании приветствуется (по соображениям безопасности). По этой причине, в файле отчета макросы отсутствуют — используются только гиперссылки.
Подробная таблица
Переход на эту часть таблицы происходит в ячейку «Обновлено… Посмотреть предложения на Яндекс-маркете.»
Именно она, в зависимости от предыдущего перехода может оказаться сверху или снизу активного экрана (так уж устроено в EXCEL).
Эта же ячейка представляет собой ссылку на карточку Яндекс-маркета.
Соседняя ячейка с красным текстом «ВОЗВРАТ В ТАБЛИЦУ / … » тоже ссылка, клик по ней вернет Вас на то место, откуда Вы пришли.
Таким образом осуществляется навигация по документу.
Дополнительный список карточек
Нам удалось создать неплохой алгоритм сопоставления вашего товара карточке на Яндекс-маркете, но, не секрет, что любой подобный алгоритм работает не всегда точно.
Иначе говоря, Вы получаете данные не о том товаре, которым интересуетесь.
Причин тут несколько, они, возможно, будут описаны отдельно.
Пока отметьте, что первая позиция в дополнительном списке — это еще одна карточка на тот же самый товар.
Если перейти на эту карточку, предложений по ней нет, но, возможны варианты.
Мы учитывали этот фактор и стараемся искать наиболее популярную карточку, но стопроцентного успеха гарантировать невозможно.
По этой причине при первом мониторинге снизу от блока карточек будет показан список «похожих» по мнению системы карточек (до 5 шт).
Впрочем, можно уточнить карточку при следующем запросе (о том, как это сделать — в соответствующем разделе).
Отчеты в JSON/XML
Поля отчетов JSON/XML
Поля в отчете описаны ниже под спойлером.
Не все из них будут заполнены, некоторые относятся к другому типу задачи, какие-то устаревают с изменениями на Яндекс-маркете.
Общие сведения по заданию:
id | идентификатор задания |
username | имя пользователя |
regioncode | код региона в задании |
ordermail | электронная почта для уведомлений |
items_received | количество позиций в прайс-листе |
items_accepted | количество принятых позиций (при недостатке проверок на балансе обрабатываются первые позиции по числу доступных проверок) |
received | задание получено |
started | задание запущено или помещено в очередь заданий |
finished | задание закончено |
used_checks_total | использовано проверок всего (не всегда совпадает с количеством позиций в прайс-листе) |
used_checks_free | использовано бонусных проверок |
used_checks_paid | использовано оплаченных проверок |
cost_rub | стоимость по заданию в рублях |
checks_free_before | бонусных проверок до отчета |
checks_paid_before | бонусных проверок после отчета |
checks_free_after | оплаченных проверок до отчета |
checks_paid_after | оплаченных проверок после отчета |
report_operationcomment | комментарии при составлении отчета |
csvfile | ссылка на отчет CSV |
xlsfile | ссылка на отчет XLS |
jsonfile | ссылка на отчет JSON |
xmlfile | ссылка на отчет XML |
comments | замечания по выполнению задачи |
[data] массив результатов обработки товарных позиций
[data] — общее
Первые поля повторяют поля в вашем задании, за исключением linkset.
Массив linkset в распознанном виде присутствует в массиве [sku] (элемент массива [data]), если он был указан в задании либо сохранен системой ранее
category | категория товара, если указана в задании |
code | код товара из системы пользователя, если указан в задании |
productid | общепринятый артикул товара, если указан в задании |
brand | бренд, если указан в задании |
name | название товара, указанное в задании (обязательное поле) |
marketid | id карточки товара на яндекс-маркете, если указано в задании или сохранено системой |
price | цена из вашего прайс-листа, если указана |
donotsearch | 1 — директива не искать карточки товара помимо указанных если они не найдены системой |
textsearch | поисковый запрос, если заполнен — показываются только результаты поиска на яндекс-маркете по этому запросу |
searchquery | сформированный системой запрос для поиска по карточек либо testsearch |
link | найденная ссылка на карточку товара либо результаты поиска |
[sku] | массив свойств найденной карточки |
[offers] | массив найденных предложений |
[data] — [sku] — данные по карточке товара (для поиска по нескольким карточкам — по первой из них)
[Similar_id_list] | ARRAY | Массив «похожих по названию карточек»: place — буквенно-цифровой индекс «похожести» названия rating — не используется offers — количество предложений, если найдено name — найденное имя товара name_0 — не используется marketid — id карточки cardlink — ссылка на карточку |
WorkMethod | STRING | заданный метод сканирования (автопоиск, поиск по карточке, поиск по запросу) |
[ServiceData] | ARRAY | служебные данные для сбора статистики |
Name_found | STRING | Название товара в карточке яндекс-маркета |
Slug_found | STRING | слаг (читабельная часть URL карточки) |
[Breadcrumbs] | ARRAY | «хлебные крошки», для варианта парсинга результатов поиска: name — отображаемое название подкатегории link — ссылка подкатегории |
[Item_filters_found] | ARRAY | фильтры, найденные в карточке no — INT, порядковый номер, начиная с 0 name — STRING, название фильтра measure — STRING, единица измерения [values] — ARRAY OF STRING, значений, которые есть в предложениях карточки |
Offers_declared | INT | количество предложений, указанное на главной странице карточки |
Offers_сounted | INT | количество предложений показанное внутри карточки |
Rating_found | DOUBLE | рейтинг товара, если есть |
Rates_found | INT | количество оценок пользователей, если есть |
Replies_qty | INT | количество отзывов о товаре, если есть |
Questions_qty | INT | количество вопросов о товаре, если есть |
Popularity | STRING | популярность товара, например «4 636 покупок за 2 месяца» |
Brands_selected | ARRAY OF STRING | отфильтрованные бренды, для варианта парсинга результатов поиска |
Note | STRING | комментарии |
Reviews | INT | количество обзоров о товаре |
[data] — [offers] — данные по предложениям в карточке
IsFromFar | INT | 1, если доставка из другого региона |
Place | INT | место в списке, начиная с нуля |
Name | STRING | название, указанное продавцом |
ShopId | STRING | id продавца на маркете (в последнее время маркет часто указывает свой) |
OfferId | STRING | id предложения |
Marketid | STRING | id карточки |
Skuid | STRING | id SKU яндекс-маркета |
ShopRating | DOUBLE | рейтинг магазина |
SkuRating | DOUBLE | рейтинг товара, для варианта парсинга результатов поиска |
SkuRates | INT | количество оценок товара, для варианта парсинга результатов поиска |
SkuProperties | ARRAY OF STRING | свойства товара, указанные продавцом |
ShopReviews | INT | количество отзывов о магазине |
ShopUrl | STRING | ссылка на предложение магазина |
Price | DOUBLE | цена товара |
PickupTerm | STRING | условия самовывоза |
PickupCost | DOUBLE | стоимость самовывоза, -1.0, если нет |
DeliveryExpress | BOOLEAN | экспресс-доставка |
DeliveryTerm | STRING | условия доставки |
DeliveryCost | DOUBLE | стоимость доставки, -1.0, если нет |
PostalTerm | STRING | условия отправки почтой |
PostalCost | DOUBLE | стоимость отправки почтой, -1.0, если нет |
BuyOnMarket | BOOLEAN | покупка на маркете |
Promos | ARRAY OF STRING | наличие промокодов и промоакций |
PromoCode | STRING | промокод, если указан в карточке |
PromoConditions | STRING | условия промоакции, если указаны в карточке |
PromoPrice | DOUBLE | промоцена |
OldPrice | DOUBLE | старая цена, если есть прямая скидка |
Comment | STRING | комментарии |
[Offer_filters] | ARRAY | фильтры, указанные в предложении no — INT, порядковый номер, начиная с 0 name — STRING, название фильтра measure — STRING, единица измерения values — STRING, значений, которые есть в предложениях карточки |
Link_no | INT | порядковый номер карточки, начиная с нуля, при поиске по нескольким карточкам |
Отчеты в CSV (см также отчеты в EXCEL)
Отчет в CSV — это файл с разделителем «;» в кодировке UTF-8 со следующими полями:
поля, относящиеся к товару(карточке)
category — категория товара, как указано в вашем прайсе
code — код (не артикул!) товара из вашего прайса, для интеграции в систему
id — общепринятый артикул вашего товара
brand — бренд товара из вашего прайса
name — наименование товара из вашего прайса
marketid — найденный автоматически (либо указанный Вами) идентификатор карточки на Яндекс-маркете
price — ваша цена товара
link — ссылка на карточку товара в Яндекс-маркете
cardfound — 1, если карточка найдена, 0 — если нет
marketname — наименование товара в карточке на Яндекс-маркете
rating — рейтинг товара на Маркете
replies — количество отзывов о товаре
questions — количество вопросов о товаре
offers — количество найденных предложений
salepoints — количество точек продаж (не используется)
reviews — количество обзоров о товаре (не используется)
finished — время обработки
comments — результат обработки
поля, относящиеся к найденным предложениям по товару («1_» и т.д. — порядковый номер предложения)
1_Place — место (сортировка по возрастанию цены)
1_Price — цена товара
1_Name — наименование товара в предложении магазина
1_BuyOnMarket — «покупка на маркете» (True/False), похоже, уже не актуально — всегда True
1_ ShopName — название магазина
1_ ShopRating — рейтинг магазина
1_ ShopReviews — отзывов о магазине
1_ PickupCost — цена доставки (-1, если доставки нет)
1_ PickupTerm — условия доставки
1_ DeliveryCost — цена самовывоза (-1, если нет)
1_ DeliveryTerm — условия самовывоза
1_ PostalCost — цена почтовой отправки (-1, если нет)
1_ PostalTerm — условие отправки по почте
2_Place — место (сортировка по возрастанию цены)
2_Price — цена товара
……….