Для того, чтобы разобраться в том, как выполняется поиск товаров и какие настройки поиска можно сделать, необходимо изучить информацию, предложенную ниже.
Товарный провайдер
Товарный провайдер — это сервис (или площадка) для торговли. Именно от товарного провайдера поступает информация о товарах (названия, настройки, конфигурации и тд) и товарных категориях в OT API и потом, с помощью ключа, транслируется на сайт владельца ключа.
На данный момент доступны для подключения Taobao (включая Tmall), Yahoo.co.jp, 1688.com .
Получить список доступных провайдеров и некоторую информацию о них можно методом GetProviderInfoList.
Таобао и Tmall
Поиск по Таобао может осуществляться по разным направлениям. Направление напрямую зависит от задач сайта, на котором устанавливается ключ.
| Название | Идентификатор | Описание |
|---|---|---|
| Расширенный поиск | Extended | Поиск по всему каталогу Таобао, используя специальные алгоритмы OT |
| Tmall поиск | Official | Поиск по товарам Tmall, используя официальное API |
Yahoo.co.jp
Содержит в себе 2 провайдера:
- Обычная продажа товаров.
- Аукционные товары.
Каждый провайдер имеет один поиск.
Свой каталог
С помощью дополнительного модуля «Товары на складе» появится провайдер «Склад», для которого можно создать и заполнить свой каталог товаров.
Подробнее о модуле и его подключении: http://key.otcommerce.com/ru/service-payments-rates
Способы поиска
У каждого товарного провайдера есть свой набор условий поиска. Этот набор можно варьировать под цели сайта. Получить список доступных способов поиска и полную информацию о том, что они поддерживают, можно методом GetProviderSearchMethodInfoList.
Условие поиска | Параметр для описания способа поиска | Применение условия поиска |
|---|---|---|
| Способ поиска | SearchMethod | Название способа поиска (Тип используемого поискового метода) |
Название способа поиска (на нужном языке) | DisplayName | Отображаемое название способа поиска (на нужном языке) |
Особенности выбранного способа поиска | Flags | Список особенностей способа поиска |
| UseOptimalFrameSize | Признак использования оптимального размера фрейма вместо переданного | |
Количество выводимых товаров на одну страницу (влияет на скорость загрузки страницы и работу скорости поиска) | OptimalFrameSize | Оптимальное число запрашиваемых товаров (размер страницы) |
| Максимальное количество товаров на страницу (влияет на скорость загрузки страницы и работу скорости поиска) | MaximumFrameSize | Максимальное число запрашиваемых товаров (размер страницы) |
| Максимальное количество товаров выбранного способа поиска (влияет на скорость загрузки страницы и работу скорости поиска) | MaximumItemsCount | Максимальное число товаров, до которых может выдать способ поиска |
| Сортировки в выбранном способе поиска | AvailableSorts | Список допустимых сортировок в способе поиска (OrderBy в параметрах поиска) |
| Товарный провайдер | Provider | Тип провайдера Nullable<ItemProviderType> |
Поиск в категории | CategoryId | Идентификатор категории, в которой искать товары |
| CategoryMode | Режим выдачи категорий в результатах поиска | |
Название товара | нет параметра (доступен всегда) | |
| ItemTitle | Поисковая строка по названию товара | |
| Язык поиска | LanguageOfQuery | Язык поисковой строки по названию товара |
| Артикул товара | нет параметра (доступен всегда) | |
| Ссылка на товар | нет параметра (доступен всегда) | |
| Поиск товаров внутри категории | нет параметра (доступен всегда) | |
Имя продавца | Vendor | Поддерживает ли способ поиска продавца (VendorId в параметрах поиска) |
| VendorName | Имя продавца | |
| VendorId | Идентификатор продавца | |
Местонахождение продавца | VendorLocation | Поддерживает ли способ поиска местонахождение продавца (VendorAreaId в параметрах поиска) |
| VendorAreaId | Идентификатор местонахождения продавца (зоны) | |
По рейтингу продавца | VendorRatingRange | Поддерживает ли способ поиска фильтр по рейтингу продавца (MinVendorRating и MaxVendorRating в параметрах поиска) |
| MinVendorRating | Минимальное значение рейтинга продавца | |
| MaxVendorRating | Максимальное значение рейтинга продавца | |
Название бренда | Brand | Поддерживает ли способ поиска бренды (BrandId в параметрах поиска) |
| BrandId | Идентификатор искомой торговой марки | |
| BrandPropertyValueId | Идентификатор значения искомой торговой марки (устаревший параметр, используйте BrandId) | |
В диапазоне цен | PriceRange | Поддерживает ли способ поиска фильтр по цене товара (MinPrice и MaxPrice в параметрах поиска) |
| MinPrice | Минимальная цена | |
| MaxPrice | Максимальная цена | |
По объему продаж | VolumeRange | Поддерживает ли способ поиска фильтр по объему продаж (MinVolume и MaxVolume в параметрах поиска) |
| MinVolume | Минимальный объем продаж | |
| MaxVolume | Максимальный объем продаж | |
| По состоянию товара (новый, б/у, неиспользованый) | StuffStatus | Поддерживает ли способ поиска фильтр по состоянию товара (StuffStatus в параметрах поиска) |
Характеристики товара (цвет, модель и тд) | Configurators | Список поисковых свойств, представленных структурой. Поддерживает ли способ поиска характеристики товара (Configurators в параметрах поиска) |
| Features | Список искомых фич товара | |
| Аукционные товары | Features/Auction | Список специальных фильтров, поддерживаемых способом поиска (Features в параметрах поиска) |
| Товары со скидками | Features/Discount | Список специальных фильтров, поддерживаемых способом поиска (Features в параметрах поиска) |
Использование в поиске нескольких значений одной характеристики (например, можно вывести только красное, красное И зеленое, красное ИЛИ зеленое) | MultipleConfiguratorLogic | Логика работы способа поиска по нескольким значениям одной характеристики |
| OrderBy | Параметры сортировки | |
| OutputMode | Режим выдачи результатов поиска | |
| IsOriginal | Признак выбора только оригинальных товаров | |
| IsTmall | Признак выбора только товаров из Tmall | |
| StuffStatus | Состояние товара | |
| IsClearItemTitles | Признак очистки заголовков товаров |
Поиск по всем товарным провайдерам
Кроме того, если у вас к ключу подключено сразу несколько товарных провайдеров, есть вариант поиска сразу для всех товарных провайдеров и всех возможных условиях поиска. Для этого необходимо воспользоваться специальным поиском по OT API. Описание метода: BatchSearchItemsFrame
Что получаем еще вместе с поиском товара