Для того, чтобы разобраться в том, как выполняется поиск товаров и какие настройки поиска можно сделать, необходимо изучить информацию, предложенную ниже.
Товарный провайдер
Товарный провайдер — это сервис (или площадка) для торговли. Именно от товарного провайдера поступает информация о товарах (названия, настройки, конфигурации и тд) и товарных категориях в 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 |
BrandId | Идентификатор искомой торговой марки Тип String | ||
BrandPropertyValueId | Идентификатор значения искомой торговой марки (устаревший параметр, используйте BrandId) Тип String | ||
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 | |
CategoryMode | Режим выдачи категорий в результатах поиска Тип Nullable<SearchCategoryMode> : SearchCategoryMode | ||
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 | |||
39 | |||
40 | Configurators |
| |
41 | OrderBy | Параметры сортировки Тип String | |
42 | OutputMode | Режим выдачи результатов поиска Тип Nullable<SearchOutputMode> : SearchOutputMode | |
43 | |||
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
Что получаем еще вместе с поиском товара