ДАРА Рекомендации

Рекомендации товаров для интернет-магазина

Рекомендации товаров для интернет-магазина — это блоки «Вам может понравиться», «Похожие товары» и «Дополните заказ», которые подбираются под конкретного покупателя. ДАРА Рекомендации строит их по API из вашего каталога, просмотров, корзины и заказов и не предлагает то, что покупатель только что купил.

01

Как ДАРА подбирает товары?

Проект магазина начинается с пресета «Магазин». Выдача учитывает содержание карточек, действия покупателей и товары, которые покупают вместе.

  1. Каталог

    Товар — объект с названием, описанием, фото по ссылкам https и свойствами: цена, бренд, наличие. ДАРА анализирует фото и тексты и строит векторы смысла, поэтому похожие находятся по содержанию карточки, а не только по категории.

  2. Пресет «Магазин»

    Типы событий: показ, просмотр товара, избранное, корзина, покупка и «не интересно». Веса и типы событий потом можно менять в кабинете.

  3. Заказы

    POST /orders передаёт заказ одним запросом: строки раскладываются на события покупки, одинаковые товары складываются, повтор того же order_id заменяет состав.

  4. Пары «вместе»

    Пары строятся из неотменённых заказов за 365 дней и из сессий за 30 дней и учитываются, когда их набрали несколько разных покупателей. Они работают в ленте, похожих и «дополните заказ».

02

Какие блоки рекомендаций получает магазин?

Все блоки — два метода выдачи. У каждого ответа есть recommendation_id для метрик и причина reason у каждого товара.

Персональная лента

Главная и «для вас»: товары по интересам покупателя, «вместе» с тем, что ему понравилось, и популярное у похожих покупателей — с той же страной, городом, полом и возрастом.

Похожие товары

POST /recommendations/similar с полем item — блок на карточке товара. Новый товар участвует в похожих сразу после загрузки — по быстрому вектору из названия и описания.

«Дополните заказ»

Тот же метод с полем items — корзина до 20 товаров. Для нескольких товаров важнее то, что покупают вместе, чем замены, поэтому блок подбирает дополнения к корзине.

Фильтры по цене и наличию

Свойства, отмеченные фильтруемыми, работают в ленте и похожих: наличие, бренд, диапазон цены. Если подходящих товаров мало, выдача добирается популярными, которые проходят фильтр.

Купленное не предлагается

У покупки в пресете «Магазин» срок приглушения 30 дней: купленный товар и почти одинаковые с ним — копии карточки, другой цвет той же модели — не показываются покупателю в ленте и похожих.

«Не интересно» и скрытые бренды

Событие «не интересно» скрывает товар для этого покупателя. Бренд передаётся полем author, и товары брендов, скрытых в профиле покупателя, в выдачу не попадают.

03

Как загрузить каталог и историю заказов?

Первую загрузку удобно сделать файлами в кабинете, а ежедневные изменения — новый товар, цену, покупку — передавать методами API. Повторная загрузка того же файла данные не удваивает.

Файлы CSV и Excel

Проект → «Импорт»: шаблоны «Каталог», «Профили», «Заказы» и «События». Кодировка CSV (UTF-8 или Windows-1251) и разделитель определяются автоматически, у XLSX читается первый лист. Файл — до 100 МБ и до 1 000 000 строк.

Выгрузки 1С и Битрикса

Колонки сопоставляются по заголовкам: подписи полей и привычные названия выгрузок 1С и Битрикса распознаются сами. Дата 1С вида «14.09.2026 0:00:00» читается как есть, относительные ссылки на фото дополняются до абсолютных.

Проверка до записи

ДАРА показывает первые 20 строк файла и проверяет первые 1000: ошибки по строкам и колонкам, кодировку и разделитель. Итог импорта — счётчики и отчёт об ошибках в CSV.

История заказов по API

POST /orders/batch принимает до 500 заказов и не больше 5000 строк за запрос, даты заказов — до 730 дней назад. Заказы обрабатываются независимо.

04

Как подключить

Четыре шага от письма до выдачи на сайте. Подробности каждого шага — в документации.

  1. Письмо

    Напишите на info@daratech.ru о магазине и размере каталога. Стоимость обсуждается при подключении.

    Как подключить

  2. Проект «Магазин»

    В кабинете создайте проект с пресетом «Магазин» и выпустите ключ API.

    Быстрый старт

  3. Каталог и история

    Загрузите каталог и заказы файлом или передайте их по API.

    Импорт файлов · Объекты

  4. Заказы, события и блоки

    Передавайте заказы и события, запрашивайте ленту, похожие и «дополните заказ».

    События и заказы · Рекомендации

05

Частые вопросы

Что если товара из заказа нет в каталоге?

Если в строке заказа есть название (title), ДАРА заводит недоступный объект: он учитывается в профиле покупателя, но в выдачу не попадает. Позже запрос PUT этого товара сделает его обычным. Без названия строка отклоняется с кодом unknown_item.

Как учитываются отмены заказов?

Заказ со статусом cancelled снимает свой вклад: события покупки помечаются отменёнными, сигналы и пары «вместе» пересчитываются. Повтор заказа с тем же order_id заменяет состав, поэтому заказ передают целиком при каждом изменении.

Подходит ли это для товаров повседневного спроса?

Да. Срок приглушения купленного задаётся в кабинете: для товаров повседневного спроса ставят 0, и купленное снова может появляться в ленте и похожих.

Можно ли начать без интеграции с API?

Каталог, профили и историю заказов можно загрузить файлами в кабинете. Сами блоки сайт запрашивает по API: ленту возвращает POST /recommendations/feed, похожие и «дополните заказ» — POST /recommendations/similar.

06

Подключить ДАРА Рекомендации

Доступ открываем по запросу: напишите на info@daratech.ru. Стоимость обсуждается при подключении и зависит от объёма контента и выбранных моделей. Онлайн-оплаты нет.