Поиск товаров для виджетов

  1. По идентификатору товара
  2. По поисковому запросу
  3. По поисковому запросу из html-тега или атрибута на вашем сайте
  4. По изображению
  5. По изображению в теге img на вашем сайте

По идентификатору товара

Используйте параметр searchModelIds, чтобы в виджет загрузились товары по их идентификаторам на Маркете или товары, которые рекомендует Маркет на основе указанного идентификатора.

Например: searchModelIds: [12559706, 1713398798].

Внимание. Для виджетов Где купить товар и рекомендательных виджетов можно указывать только один идентификатор товара.
Как узнать идентификатор товара

Откройте карточку товара на Маркете и посмотрите на ее URL. Идентификатор — это набор цифр после «.../product/». Например: https://market.yandex.ru/product/12559706.

По поисковому запросу

Задайте поисковый запрос в параметре searchText, чтобы в виджет загрузились товары, найденные по этому запросу. Указывайте в запросе основные параметры товара, чтобы нашлась нужная вам модель. Если модель не найдется, загрузятся результаты поиска Маркета.

Например: searchText: "Apple iPhone 7 64 Gb".

По поисковому запросу из html-тега или атрибута на вашем сайте

Выберите тег (селектор), из которого сформируется поисковый запрос, и укажите его в searchSelector. Чтобы задать отдельный атрибут, добавьте его в searchSelectorAttr.

Запрос сформируется из первого такого тега или атрибута на странице. В виджет загрузятся товары, найденные по этому запросу.

Совет. Чтобы в виджет с предложениями попал нужный товар, используйте тег или атрибут только с названием товара и его параметрами. Если в запрос попадут другие слова, результат поиска может быть неточным. Если на странице нет подходящего тега, вы можете добавить скрытый тег (с атрибутом style="display:none;").
Примеры селекторов и запросов
Тег на сайтеПараметр виджетаКакой поисковый запрос получится

Заголовок на странице или его часть:

<h1>Обзор зеркальной камеры <span>Canon EOS 5D Mark IV</span></h1>
searchSelector: "h1"

Обзор зеркальной камеры Canon EOS 5D Mark IV

searchSelector: "h1 span"

Canon EOS 5D Mark IV

Название страницы:

<title>Обзор зеркальной камеры Canon EOS 5D Mark IV</title>
searchSelector: "title"

Обзор зеркальной камеры Canon EOS 5D Mark IV

Любой тег с атрибутом id или name. Текст для запроса в самом теге:

<div id="model_name">Canon EOS 5D Mark IV</div>
searchSelector: "div#model_name"

Canon EOS 5D Mark IV

Любой тег с любым атрибутом. Текст для запроса в самом теге:

<span itemprop="title">Canon EOS 5D Mark IV</span>
searchSelector: "span[itemprop='title']"

Canon EOS 5D Mark IV

Любой тег с любым атрибутом. Текст для запроса в атрибуте:

<meta property="og:title" content="Canon EOS 5D Mark IV"/>
searchSelector: "meta[property='og:title']",
searchSelectorAttr: "content"
Canon EOS 5D Mark IV

По изображению

Задайте URL изображения в параметре searchImageUrl, чтобы в виджет загрузились товары, найденные по этому изображению. Если для товара не найдется модель, загрузятся результаты поиска Маркета.

Внимание. Подбор товаров по изображению не используется в рекомендательных виджетах.

Например: searchImageUrl: "shop-example.ru/images/iphone-x-64gb-serebristyj.jpg".

По изображению в теге img на вашем сайте

Выберите атрибут src, содержащий URL изображения, и укажите его в searchImageSelector.

Внимание. Подбор товаров по изображению не используется в рекомендательных виджетах.
Примеры
Тег на сайтеПараметр виджета
<img id="ProductPhoto" src="https://shop-example.ru/images/iphone-x-64gb-serebristyj.jpg" alt="Смартфон Apple iPhone X фото">
searchImageSelector: "#ProductPhoto"
<div id="ProductPhoto">
  <a href="http://shop-example.ru/images/iphone-x-64gb-serebristyj.jpg">
    <img src="https://shop-example.ru/images/iphone-x-64gb-serebristyj.jpg" alt="Смартфон Apple iPhone X фото">
  </a>
</div>
searchImageSelector: "#ProductPhoto > a > img"