Для того, чтобы разобраться в том, как выполняется поиск товаров и какие настройки поиска можно сделать, необходимо изучить информацию, предложенную ниже.
Товарный провайдер
Товарный провайдер — это сервис (или площадка) для торговли. Именно от товарного провайдера поступает информация о товарах (названия, настройки, конфигурации и тд) и товарных категориях в OT API и потом, с помощью ключа, транслируется на сайт владельца ключа.
Доступные для подключения товарные провайдеры.
Получить список доступных провайдеров и некоторую информацию о них можно методом GetProviderInfoList.
Таобао и Tmall
Поиск по Таобао может осуществляться по разным направлениям. Направление напрямую зависит от задач сайта, на котором устанавливается ключ.
| Название | Идентификатор | Описание |
|---|---|---|
| Расширенный поиск | Extended | Поиск по всему каталогу Таобао, используя специальные алгоритмы OT |
| Tmall поиск | Official | Поиск по товарам Tmall, используя официальное API |
Yahoo.co.jp
Содержит в себе 2 провайдера:
- Обычная продажа товаров.
- Аукционные товары.
Каждый провайдер имеет один поиск.
Свой каталог
С помощью дополнительного модуля «Товары на складе» появится провайдер «Склад», для которого можно создать и заполнить свой каталог товаров.
Подробнее о модуле и его подключении
Способы и условия поиска
У каждого товарного провайдера есть свой набор условий поиска. Этот набор можно варьировать под цели сайта. Получить список доступных способов поиска и полную информацию о том, что они поддерживают, можно методом GetProviderSearchMethodInfoList.
Сам поиск можно выполнить двумя методами: SearchItemsFrame и BatchSearchItemsFrame. По работе они полностью идентичны, только с помощью второго метода можно получить различную дополнительную информацию сразу за один запрос, помимо самого поиска. Возможная дополнительная информация будет описана далее.
Условия самого поиска также идентичны, передаются в параметр xmlParameters, и представлены структурой.OtapiSearchItemsParameters. Как и все структурные параметры, он имеет формат xml. xmlParameters в SearchItemsFrame обязателен, так как он определяет, что собственно ищем. Примеры будут описаны далее.
В следующей таблице представлено сравнительное описание условий поиска, как они представлены в структуре параметров, и как они представлены в описании способов поиска.
Параметр | Условия поиска | Информация о способе поиска | ||||
|---|---|---|---|---|---|---|
| Название параметра | Пример значения | Описание параметра | Название параметра | Пример значения | Описание параметра | |
| Провайдер | Provider | Taobao | Если в условиях поиска не указан провайдер явно, он будет определен по другим условиям (например, категории). Если ни одно условие не определяет провайдера, поиск будет произведен в провайдере по умолчанию. Если разные условия поиска ведут к различным провайдерам, то такой поиск невозможен и приведет к ошибке. | Provider | Taobao | Идентификатор провайдера |
| Способ поиска
| SearchMethod | Official | Если не указано, используется определенный в настройках способ поиска по умолчанию. | SearchMethod | Official | Название способа поиска |
| DisplayName | Фирменные товары (Tmall) | Отображаемое название способа поиска (на нужном языке) | ||||
| Flags | Список особенностей способа поиска | |||||
| Ограничения на число товаров | UseOptimalFrameSize | true/false | Признак использования оптимального размера фрейма вместо переданного. Если данное условие передано в значении true, то параметр frameSize игнорируется, и будет использовано OptimalFrameSize из выбранного способа поиска. | |||
| OptimalFrameSize | 40 | Оптимальное число запрашиваемых товаров (размер страницы). Если использовать страницы данного размера, это обеспечивает максимальную возможную скорость работы поиска, т.к. оно соответствует размерам страниц у провайдера. | ||||
| MaximumFrameSize | 200 | Максимальное число товаров, которое можно получить за 1 запрос. Может работать значительно медленнее, чем при использовании оптимального числа. | ||||
| MaximumItemsCount | 4000 | Число товаров, до которого в принципе можно получить по одним и тем же условиям поиска. Чтобы получать больше товаров, надо менять и уточнять условия поиска. | ||||
| Сортировка товаров | OrderBy | Price:Asc | Если не указано, или указанное значение не входит в число допустимых, будет использована определенная в настройках сортировка по умолчанию. | AvailableSorts | Список допустимых сортировок в способе поиска. | |
Категория | CategoryId | 16 | Идентификатор категории, в которой искать товары. | Category | true/false | Поддерживается ли поиск по категории |
Название товара | ItemTitle | платье | Поисковая строка по названию товара. Если в поисковой строке указаны только идентификатор (артикул) товара или ссылка на страницу на сайте провайдера, то будет найден и выдан именно этот единственный товар (или пусто, если таковой товар отсутствует). | Text | true/false | Поддерживается ли поиск по тексту |
| LanguageOfQuery | ru | Язык поисковой строки по названию товара. Если не указан, считается равным языку выдачи товаров. Если не равен языку провайдера, то производится автоперевод на язык провайдера. | ||||
Продавец | VendorId | Идентификатор продавца | Vendor | true/false | Поддерживается ли поиск по продавцу | |
| VendorName | Имя продавца | |||||
Местонахождение продавца | VendorAreaId | Идентификатор местонахождения продавца (зоны) | VendorLocation | true/false | Поддерживает ли способ поиска местонахождение продавца | |
Рейтинг продавца | VendorRatingRange | true/false | Поддерживает ли способ поиска фильтр по рейтингу продавца | |||
| MinVendorRating | 5 | Минимальное значение рейтинга продавца | MinVendorRating | 1 | Минимальное значение рейтинга продавца | |
| MaxVendorRating | 15 | Максимальное значение рейтинга продавца | MaxVendorRating | 20 | Максимальное значение рейтинга продавца | |
| Бренд | BrandId | Идентификатор искомой торговой марки | Brand | true/false | Поддерживает ли способ поиска бренды | |
| BrandPropertyValueId | Идентификатор значения искомой торговой марки (устаревший параметр, используйте BrandId) | |||||
| Цена | MinPrice | 10 | Минимальная цена | PriceRange | true/false
| Поддерживает ли способ поиска фильтр по цене товара |
| MaxPrice | 1000 | Максимальная цена | ||||
| CurrencyCode | CNY | Код валюты, в которой указан диапазон цен. | ||||
Объем продаж | MinVolume | 100 | Минимальный объем продаж | VolumeRange | true/false | Поддерживает ли способ поиска фильтр по объему продаж |
| MaxVolume | 500 | Максимальный объем продаж | ||||
| VolumeRangeLogic | None / Range / OnlyMin / OnlyMax | Логика работы условий по объему продаж: диапазон, только минимум, только максимум. | ||||
| Минимальная партия | MinFirstLot | 5 | Минимальный размер первой партии товара | FirstLotRange | true/false | Поддерживает ли способ поиска фильтр по минимальной партии |
| MaxFirstLot | 10 | Максимальный размер первой партии товара | ||||
| Состояние товара (новый, б/у, неиспользованый) | StuffStatus | New / Unused / Second | Состояние товара | StuffStatus | true/false | Поддерживает ли способ поиска фильтр по состоянию товара |
Характеристики товара (цвет, модель и тд) | Configurators | Список поисковых свойств, представленных структурой. | Configurators | true/false | Поддерживает ли способ поиска характеристики товара. | |
| MultipleConfiguratorLogic | None / All / And | Логика работы способа поиска по нескольким значениям одной характеристики. Использование в поиске нескольких значений одной характеристики. (например, можно вывести только красное, красное И зеленое, красное ИЛИ зеленое) | ||||
| Особенности товара | Features | Список искомых специальных фильтров | Features | Список специальных фильтров, поддерживаемых способом поиска | ||
| Поиск по фото | ImageUrl | Адрес изображения для поиска товаров | Module
| Image | Параметры поиска по фото допустимы только в способе поиска, в котором свойство Module равно Image
| |
| ImageFileId | Файловый идентификатор изображения для поиска товаров Используется, если искомое изображение сперва было загружено через OTAPI. | |||||
| Управление выдачей | OutputMode | Full / TotalCount / Provider | Режим выдачи результатов поиска. По умолчанию делается обычный поиск, с выдачей товаров и всего сопутствующего. Другие варианты:
| |||
| CategoryMode | Nothing / External / InternalLeaf / CurrentLevel | Режим выдачи категорий в результатах поиска. В результатах поиска помимо товаров есть еще, хоть и не всегда, список категорий, в которых находятся найденные товары. Обычно они называются уточняющими категориями. Есть несколько вариантов обработки и выдачи данного списка.
| ||||
| IsClearItemTitles | true/false | Признак очистки заголовков товаров. По умолчанию true, то есть поиск выдает только оригинальные не-переведенные названия товаров, т.к. в большинстве случаев названия не показываются в списке товаров, то данное поведение сильно экономит ресурсы транслятора и немного ускоряет получение результатов поиска. При значении false, в каждом товаре также выдается и переведенное название. | ||||
| Устаревшие условия | IsOriginal | true/false | Признак выбора только оригинальных товаров | |||
| IsTmall | true/false | Признак выбора только товаров из Tmall | ||||
Примеры параметров с условиями поиска и запросов поиска
| Пример | Значение xmlParameters | Тестовый запрос |
|---|---|---|
| Поиск по товарам провайдера: Taobao | ||
| Поиск по категории: otc-4, Taobao, 50000671 | ||
Поиск по характеристике: футболка размера XL, красного цвета | ||
| Поиск первых 100 товаров в категории/каталоге или запроса: первые 100 товаров по запросу «красная футболка» | ||
| Поиск по артикулу: 534184932247 | ||
| Поиск по ключевому слову: футболка красная женская | ||
| Поиск по продавцу: maxmartin玛玛绨旗舰店 | ||
| Поиск на оригинальном языке: 红色T恤 | ||
Поиск на языке сайта:
| ||
| Поиск по названию бренда: vero moda | ||
| Поиск по английскому слову (без перевода на китайский): 3D Vision | ||
| Поиск в определенном регионе: Гуанчжоу | ||
Поиск товаров по рейтингу продавца:  и больше | ||
| Поиск товаров с ограниченной стоимостью: от 10 до 40 юаней | ||
| Поиск товаров со скидкой: товары со скидкой | ||
| Поиск аукционных товаров: товары участвующие в аукционе | ||
| Поиск товаров по объему продаж: по убыванию количества продаж | ||
| Поиск б/у товаров или новых товаров: только новые товары | ||
| Поиск товара по спец фиче: обувь — пляжная |
Описание результатов поиска
Результаты поиска представлены структурой OtapiItemSearchResult, ниже описание её полей.
| Параметр | Описание |
|---|---|
| Items | Список найденных товаров с указанием полного числа товаров |
| Categories | Список категорий, в которых есть искомые товары (уточняющие товары) |
| Brands | Список брендов, в которых встречаются товары (уточняющие бренды) |
| TranslatedItemTitle | Текст, по которому реально искались товары (переведенный на язык провайдера) |
| Provider | Товарный провайдер, в котором был произведен поиск |
| SearchMethod | Способ поиска, которым был произведен поиск |
| CurrentSort | Реальная текущая сортировка |
| CurrentFrameSize | Реальный текущий размер фрейма (страницы) |
| MaximumPageCount | Максимальное число страниц в поиске |
| IsFoundByItemId | Если true, то в результатах поиска содержится 1 товар, который был найден по артикулу или ссылке |
Дополнительные блоки информации в BatchSearchItemsFrame
Используя метод BatchSearchItemsFrame, можно получить дополнительную информацию за тот же один запрос к OTAPI. Список дополнительных блоков передается в параметре blockList, через запятую. Результатом является BatchItemSearchResult, который включает в себя обычный OtapiItemSearchResult, а также все свойства для дополнительной информации.
| Название блока | Описание |
|---|---|
| SubCategories | сразу получить подкатегории, если поиск был по категории |
| SearchProperties | сразу получить фильтры по характеристикам/свойствам |
| RootPath | сразу получить путь к корню, если поиск был по категории |
| Vendor | сразу получить информацию о продавце, если поиск был по продавцу |
| Brand | сразу получить информацию о бренде, если поиск был по бренду |
| Category | сразу получить информацию о категории, если поиск был по категории |
| HintCategories | сразу получить подходящие по названию категории, если поиск был по тексту |
| AvailableSearchMethods | сразу получить список подходящих под данные параметры способов поиска, и всю информацию по ним |