Для того, чтобы разобраться в том, как выполняется поиск товаров и какие настройки поиска можно сделать, необходимо изучить информацию, предложенную ниже.
Товарный провайдер
Товарный провайдер — это сервис (или площадка) для торговли. Именно от товарного провайдера поступает информация о товарах (названия, настройки, конфигурации и тд) и товарных категориях в OT API и потом, с помощью ключа, транслируется на сайт владельца ключа.
На данный момент доступны для подключения Taobao (включая Tmall), Yahoo.co.jp, 1688.com .
Получить список доступных провайдеров и некоторую информацию о них можно методом GetProviderInfoList.
Таобао и Tmall
Поиск по Таобао может осуществляться по разным направлениям. Направление напрямую зависит от задач сайта, на котором устанавливается ключ.
| Название | Идентификатор | Как работает |
|---|---|---|
| Специальный поиск | Extended | Может искать товары только в указанной категории товаров (например, если ищут «туфли» в женской обуви, то искать будет только там, результаты из детской обуви показаны не будут) |
| Tmall поиск | Official | В результатах поиска только товары Tmall |
Yahoo.co.jp
Содержит в себе 2 провайдера:
- Обычная продажа товаров.
- Аукционные товары.
Каждый провайдер имеет один поиск.
Свой каталог
С помощью дополнительного модуля «Товары на складе» появится провайдер «Склад», для которого можно создать и заполнить свой каталог товаров.
Подробнее о модуле и его подключении: http://key.otcommerce.com/ru/service-payments-rates
Способы поиска
У каждого товарного провайдера есть свой набор условий поиска. Этот набор можно варьировать под цели сайта. Получить список доступных способов поиска и полную информацию о том, что они поддерживают, можно методом GetProviderSearchMethodInfoList.
Условие поиска | Параметр для описания способа поиска | Применение условия поиска | |
|---|---|---|---|
| 1 | Способ поиска | SearchMethod | Название способа поиска (Тип используемого поискового метода) Тип String |
| 2 | Название способа поиска (на нужном языке) | DisplayName | Отображаемое название способа поиска (на нужном языке) Тип String |
| 3 | Особенности выбранного способа поиска | Flags | Список особенностей способа поиска Тип ProviderSearchFlag[] |
| 4 | Количество выводимых товаров на одну страницу (влияет на скорость загрузки страницы и работу скорости поиска) | OptimalFrameSize | Оптимальное число запрашиваемых товаров (размер страницы) Тип Int32 |
| 5 | Максимальное количество товаров на страницу (влияет на скорость загрузки страницы и работу скорости поиска) | MaximumFrameSize | Максимальное число запрашиваемых товаров (размер страницы) Тип Int32 |
| 6 | Максимальное количество товаров выбранного способа поиска (влияет на скорость загрузки страницы и работу скорости поиска) | MaximumItemsCount | Максимальное число товаров, до которых может выдать способ поиска Тип Int32 |
| 7 | Сортировки в выбранном способе поиска | AvailableSorts | Список допустимых сортировок в способе поиска (OrderBy в параметрах поиска) Тип ProviderSearchSortInfo[] |
| 8 | Товарный провайдер | Provider | Тип провайдера Nullable<ItemProviderType> Тип ItemProviderType |
| 9 | Название товара | нет параметра (доступен всегда) | |
| 10 | Артикул товара | нет параметра (доступен всегда) | |
| 11 | Ссылка на товар | нет параметра (доступен всегда) | |
| 12 | Поиск товаров внутри категории | нет параметра (доступен всегда) | |
| 13 | Имя продавца | Vendor | Поддерживает ли способ поиска продавца (VendorId в параметрах поиска) Тип Boolean |
| 14 | Местонахождение продавца | VendorLocation | Поддерживает ли способ поиска местонахождение продавца (VendorAreaId в параметрах поиска) Тип Boolean |
| 15 | Название бренда | Brand | Поддерживает ли способ поиска бренды (BrandId в параметрах поиска) Тип Boolean |
| 16 | В диапазоне цен | PriceRange | Поддерживает ли способ поиска фильтр по цене товара (MinPrice и MaxPrice в параметрах поиска) Тип Boolean |
| 17 | По объему продаж | VolumeRange | Поддерживает ли способ поиска фильтр по объему продаж (MinVolume и MaxVolume в параметрах поиска) Тип Boolean |
| 18 | По рейтингу продавца | VendorRatingRange | Поддерживает ли способ поиска фильтр по рейтингу продавца (MinVendorRating и MaxVendorRating в параметрах поиска) Тип Boolean |
| 19 | Минимальный рейтинг продавца | MinVendorRating | Минимальное значение рейтинга продавца Тип Int32 |
| 20 | Максимальный рейтинг продавца | MaxVendorRating | Максимальное значение рейтинга продавца Тип Int32 |
| 21 | По состоянию товара (новый, б/у, неиспользованый) | StuffStatus | Поддерживает ли способ поиска фильтр по состоянию товара (StuffStatus в параметрах поиска) Тип Boolean |
| 22 | Характеристики товара (цвет, модель и тд) | Configurators | Поддерживает ли способ поиска характеристики товара (Configurators в параметрах поиска) Тип Boolean |
| 23 | Аукционные товары | Features/Auction | Список специальных фильтров, поддерживаемых способом поиска (Features в параметрах поиска) Тип ProviderSearchFeatureInfo[] |
| 24 | Товары со скидками | Features/Discount | Список специальных фильтров, поддерживаемых способом поиска (Features в параметрах поиска) Тип ProviderSearchFeatureInfo[] |
| 25 | Использование в поиске нескольких значений одной характеристики (например, можно вывести только красное, красное И зеленое, красное ИЛИ зеленое) | MultipleConfiguratorLogic | Логика работы способа поиска по нескольким значениям одной характеристики Тип SearchMethodConfiguratorLogic |
| 26 | CategoryId | Идентификатор категории, в которой искать товары Тип String | |
| 27 | VendorName | Имя продавца Тип String | |
| 28 | VendorId | Идентификатор продавца Тип String | |
| 29 | VendorAreaId | Идентификатор местонахождения продавца (зоны) Тип String | |
| 30 | ItemTitle | Поисковая строка по названию товара Тип String | |
| 31 | LanguageOfQuery | Язык поисковой строки по названию товара Тип String | |
| 32 | MinPrice | Минимальная цена Тип Nullable<Decimal> : Decimal | |
| 33 | MaxPrice | Максимальная цена Тип Nullable<Decimal> : Decimal | |
| 34 | MinVolume | Минимальный объем продаж Тип Nullable<Int64> : Int64 | |
| 35 | MaxVolume | Максимальный объем продаж Тип Nullable<Int64> : Int64 | |
| 36 | MinVendorRating | Минимальный рейтинг продавца Тип Nullable<Int32> : Int32 | |
| 37 | MaxVendorRating | Максимальный рейтинг продавца Тип Nullable<Int32> : Int32 | |
| 38 | BrandId | Идентификатор искомой торговой марки Тип String | |
| 39 | BrandPropertyValueId | Идентификатор значения искомой торговой марки (устаревший параметр, используйте BrandId) Тип String | |
| 40 | Configurators | Список поисковых свойств, представленных структурой Тип OtapiValuedConfigurator[] | |
| 41 | OrderBy | Параметры сортировки Тип String | |
| 42 | OutputMode | Режим выдачи результатов поиска Тип Nullable<SearchOutputMode> : SearchOutputMode | |
| 43 | CategoryMode | Режим выдачи категорий в результатах поиска Тип Nullable<SearchCategoryMode> : SearchCategoryMode | |
| 44 | IsOriginal | Признак выбора только оригинальных товаров Тип Nullable<Boolean> : Boolean | |
| 45 | IsTmall | Признак выбора только товаров из Tmall Тип Nullable<Boolean> : Boolean | |
| 46 | StuffStatus | Состояние товара Тип Nullable<OtapiStuffStatus> : OtapiStuffStatus | |
| 47 | Features | Список искомых фич товара Тип OtapiSearchFeature[] | |
| 48 | IsClearItemTitles | Признак очистки заголовков товаров Тип Nullable<Boolean> : Boolean | |
| 49 | UseOptimalFrameSize | Признак использования оптимального размера фрейма вместо переданного Тип Nullable<Boolean> : Boolean |
Поиск по всем товарным провайдерам
Кроме того, если у вас к ключу подключено сразу несколько товарных провайдеров, есть вариант поиска сразу для всех товарных провайдеров и всех возможных условиях поиска. Для этого необходимо воспользоваться специальным поиском по OT API. Описание метода: BatchSearchItemsFrame
Что получаем еще вместе с поиском товара