Персональная лента
POST /recommendations/feed — для главной и бесконечной прокрутки. Новые посетители получают тренды и свежее, постоянные — ленту по интересам. Когда новое заканчивается, лента продолжается давно досмотренными объектами.
Рекомендательная система для сайта — это сервис, который подбирает каждому посетителю объекты каталога: ролики, статьи, треки или товары. ДАРА Рекомендации делает это по API: сайт передаёт контент и действия посетителей, а получает персональную ленту, похожие и свой список в порядке интереса — с причиной у каждого объекта.
01
Сайт отправляет данные и запрашивает выдачу по API, всё остальное делает ДАРА: анализирует содержание, считает профили пользователей и пары объектов «вместе».
Объекты передаются запросом PUT /items/{id} или пакетами POST /items/batch по 500 операций. Повторная отправка безопасна: объект заменяется, а анализ перезапускается только для изменившегося.
ДАРА распознаёт речь с таймкодами, описывает кадры и текст на экране, строит сводку с темами и тегами и векторы смысла. Новый объект сразу получает быстрый вектор по заголовку и описанию и участвует в похожих ещё до конца анализа.
Показы, открытия, досмотры, лайки, корзина и заказы приходят методами POST /events и POST /orders. Пресет проекта — «Видеохостинг», «Магазин», «Медиа» или «Свой» — задаёт типы событий и их веса.
Лента, похожие и переранжирование возвращают объекты с оценкой 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
Четыре шага от письма до выдачи на сайте. Подробности каждого шага — в документации.
Напишите на info@daratech.ru о сайте, контенте и размере каталога. Стоимость обсуждается при подключении.
В кабинете создайте проект, выберите пресет и выпустите ключ API.
Передайте объекты и начните отправлять события; каталог можно загрузить и файлом.
Запросите ленту и похожие, передавайте recommendation_id в событиях показа.
05
Нет. Новые посетители сразу получают тренды и свежее, а похожие работают по содержанию объекта с момента загрузки. По мере событий лента переходит на интересы пользователя. Если подключена ДАРА Аналитика, новый посетитель получает персональную ленту сразу — по интересам из сети.
Если подбор не укладывается во время ответа, ДАРА отвечает запасной выдачей: код 200 и mode: fallback с трендовым списком проекта. На стороне сайта ставьте таймаут около 700 мс и держите свою запасную ленту на случай ошибки.
Да. Свойства объектов, отмеченные в кабинете фильтруемыми, работают в фильтрах ленты и похожих: равенство, списки значений и диапазоны чисел, до 10 свойств в запросе. Если подходящих объектов мало, выдача добирается популярными, которые проходят фильтр.
Выдача и поиск вместе — 100 запросов в секунду на ключ, объекты, события, заказы и профили — 20 в секунду. Лимиты защищают от ошибок интеграции и тарифом не служат: если живая интеграция упирается в лимит, порог поднимают.
06
Доступ открываем по запросу: напишите на info@daratech.ru. Стоимость обсуждается при подключении и зависит от объёма контента и выбранных моделей. Онлайн-оплаты нет.