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

Рекомендательная система для сайта

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

01

Как работает рекомендательная система ДАРА?

Сайт отправляет данные и запрашивает выдачу по API, всё остальное делает ДАРА: анализирует содержание, считает профили пользователей и пары объектов «вместе».

  1. Каталог по API

    Объекты передаются запросом PUT /items/{id} или пакетами POST /items/batch по 500 операций. Повторная отправка безопасна: объект заменяется, а анализ перезапускается только для изменившегося.

  2. Анализ содержания

    ДАРА распознаёт речь с таймкодами, описывает кадры и текст на экране, строит сводку с темами и тегами и векторы смысла. Новый объект сразу получает быстрый вектор по заголовку и описанию и участвует в похожих ещё до конца анализа.

  3. События посетителей

    Показы, открытия, досмотры, лайки, корзина и заказы приходят методами POST /events и POST /orders. Пресет проекта — «Видеохостинг», «Магазин», «Медиа» или «Свой» — задаёт типы событий и их веса.

  4. Выдача

    Лента, похожие и переранжирование возвращают объекты с оценкой score. Первая страница ленты сохраняется снимком на 30 минут, поэтому следующие страницы идут без повторов и пропусков.

02

Что получает сайт

Три метода выдачи закрывают главную, блок под материалом и упорядочивание своих списков. Ответ — JSON, у каждого ответа есть recommendation_id.

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

POST /recommendations/feed — для главной и бесконечной прокрутки. Новые посетители получают тренды и свежее, постоянные — ленту по интересам. Когда новое заканчивается, лента продолжается давно досмотренными объектами.

Похожие

POST /recommendations/similar — блок под плеером, статьёй или карточкой товара: близкие по содержанию, объекты «вместе» с исходным и новое того же автора. Работает сразу после загрузки объекта.

Переранжирование

POST /recommendations/rerank расставляет ваш список — подборку редакции или результаты своего поиска — по интересу конкретного пользователя. В одном запросе — до 1000 id.

Причина у каждого объекта

Поле reason объясняет выбор: интересы пользователя, то, что он смотрит сейчас, «вместе», любимый автор, тренд, свежее, популярное или популярное у похожих пользователей. Причину можно показать посетителю.

Метрики выдачи

recommendation_id передаётся в событиях показа и открытия. По нему кабинет считает показы, открытия, CTR, цели на 100 показов и долю запасной выдачи — по поверхностям и дням.

Чего в выдаче не будет

Удалённых и недоступных объектов, скрытых пользователем, недавно досмотренного, объектов скрытых авторов, а при включённом фильтре по возрасту — объектов с отметкой старше возраста пользователя.

03

Как система узнаёт посетителя?

Пользователь передаётся объектом user — в событиях, заказах и запросах выдачи. Нужен хотя бы один идентификатор, иначе выдача неперсональная.

Посетитель без входа

anonymous_id — id браузера или устройства, который выдаёт ваш сайт, например случайный id в cookie. Его передают всегда, в том числе после входа: так ДАРА свяжет устройство с аккаунтом.

Вход и регистрация

В момент входа сайт вызывает POST /users/link, и история анонима переходит в аккаунт. На общем устройстве чужая история не подмешивается.

ДАРА Отпечаток — по желанию

Если anonymous_id сменился, а отпечаток браузера тот же, история сохраняется. При включённом узнавании без входа выдача строится по профилю пользователя, который входил на этом устройстве.

ДАРА Аналитика — по желанию

Новый пользователь без событий сразу получает персональную ленту по интересам и покупкам из сети. Данные сети хранятся отдельно, и значение от вашего сайта всегда важнее.

04

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

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

  1. Письмо

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

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

  2. Проект и ключ

    В кабинете создайте проект, выберите пресет и выпустите ключ API.

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

  3. Каталог и события

    Передайте объекты и начните отправлять события; каталог можно загрузить и файлом.

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

  4. Выдача и метрики

    Запросите ленту и похожие, передавайте recommendation_id в событиях показа.

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

05

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

Нужна ли история, чтобы лента стала персональной?

Нет. Новые посетители сразу получают тренды и свежее, а похожие работают по содержанию объекта с момента загрузки. По мере событий лента переходит на интересы пользователя. Если подключена ДАРА Аналитика, новый посетитель получает персональную ленту сразу — по интересам из сети.

Что будет, если ДАРА не успеет ответить?

Если подбор не укладывается во время ответа, ДАРА отвечает запасной выдачей: код 200 и mode: fallback с трендовым списком проекта. На стороне сайта ставьте таймаут около 700 мс и держите свою запасную ленту на случай ошибки.

Можно ли ограничить выдачу по цене, наличию или региону?

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

Какие лимиты запросов?

Выдача и поиск вместе — 100 запросов в секунду на ключ, объекты, события, заказы и профили — 20 в секунду. Лимиты защищают от ошибок интеграции и тарифом не служат: если живая интеграция упирается в лимит, порог поднимают.

06

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

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