API-режим Sales Ninja для мест, где нельзя поставить скрипт: мобильные приложения, бэкенд, CRM, личные кабинеты. Один POST приносит одно решение: без куки, без хранения состояния и без вынесения данных за контур.
На сайте Sales Ninja подключается JS‑скриптом и дальше сам решает, кому какой вариант показать. Но есть мир, где скрипт поставить нельзя: мобильное приложение, бэкенд, CRM, личный кабинет, телефония, рассылка. Там нужен другой формат интеграции.
API‑режим работает без установки скрипта. Вы собираете состояние пользователя у себя и отправляете POST‑запрос с нужными полями, в ответ приходит решение: какую персонализацию или вариант A/B применить. Без скриптов на клиенте, без куки, без вынесения данных за контур.
Скрипт следит за поведением, сам выбирает вариант и сам применяет изменения через DOM.
Отлично работает на сайте. Не работает в нативном приложении, бэкенде или CRM.
Следит за поведением
Выбирает вариант
Применяет изменения в DOM
Использует куки и хранит состояниеБэкенд или мобильное приложение собирает идентификатор пользователя и контекст, шлёт POST, получает решение и применяет его на своей стороне.
Stateless‑запрос: что передали, то и участвует в решении. Ничего лишнего.
Ваш backend или приложение отправляет POST
Получает решениеПрименяет у себя UI, логику, контент
Без куки, без хранения состоянияBackend
iOS / Android
CRM
Личные кабинеты
E‑mail / push / SMSSales Ninja по API работает как удалённый движок решений: один запрос приносит одно решение, тот же вход даст тот же вариант. Никаких куки и сессий на стороне Sales Ninja, которые надо синхронизировать с вашим бэкендом.
// что вы отправляете { "customerId": "934f17b6-ffba-…", "projectId": "4e0b71c2-…", "context": { "page": "/checkout", "sessionNumber": 3, "pagesOpened": 7, "utmSource": "yandex", "device": "mobile", "params": { "plan": "pro", "cartTotal": 12490 } } }
// что возвращается [ { "personalizationId": "934f17b6-…", "optionId": "variant_b", "isControl": false, "version": 17, "validUntil": "2026-05-12T00:00:00Z", "params": { "discount": "10%", "copy": "Заберите со скидкой" } } ]
Никакого «состояния пользователя» на нашей стороне, которое надо синхронизировать. Что вы кладёте в запрос, то и учитывается.
Один и тот же customerId на одну версию персонализации получит один и тот же вариант. Sticky‑поведение из коробки.
Ответ обычно занимает от единиц до десятков миллисекунд и не добавляет заметной задержки в ваш сценарий.
В ответе приходит срок жизни решения. Можно безопасно кэшировать на своей стороне и экономить вызовы.
Стандартный блокер интеграции с внешним сервисом звучит как «нам нельзя отдавать персональные данные». В API‑режиме состав запроса контролируете вы: Sales Ninja не запрашивает PII, не ставит куки и не трекает поведение скрытым скриптом.
customerIdcontextparamsip?Обезличенный идентификатор, контекст визита и произвольные параметры. IP опционален и нужен только для гео‑логики.
customerId может быть любым устойчивым ID: SHA‑256 от почты, ID строки в БД, GUID мобильной сессии, anonId. Sales Ninja не знает, что это, и не пытается расшифровать.
Можно дать только UTM и тип устройства, а можно поделиться суммой корзины и тарифом через params. Чем больше сигнала, тем точнее персонализация, но это всегда ваш выбор.
Для гео‑логики передайте IP. Без него всё тоже работает: устойчивый customerId, контекст и params уже дают системе достаточно сигнала.
Проектный токен в заголовке X‑SN‑TOKEN. Никаких пользовательских ключей, ничего, что нужно генерить per‑user. Ротация в один клик в кабинете.
Через API доступны три ключевых сценария Sales Ninja: персонализация по ML‑модели, A/B‑тестирование с контрольной группой и учёт целей, на которых решения улучшаются сами.
/outer/v1.0/personalizationsОдин эндпоинт отдаёт персонализированные предложения, тексты, цены и бизнес‑логику. Модель сама учит, какой вариант лучше для кого, а вы применяете готовое решение в своём интерфейсе.
/public/v1.0/ab-tests/apply
Отдельный эндпоинт для классических экспериментов. Многорукий бандит, четыре статистических метода остановки, sticky‑разделение: всё то же, что и на сайте, только без скрипта.
/outer/v1.0/goal/reach
Когда у вас сработала покупка, заявка или оплата, отправьте достижение цели. Модель учится на этих сигналах. Цели бывают и офлайновые: дозвон, выкуп, окончание подписки.
UTM, устройство, страница, пройденные шаги, признаки CRM, любые ваши params. Условия таргетинга и сегменты настраиваются в кабинете, код менять не надо.
Пользователь, попавший в вариант, продолжит видеть его же при следующих запросах. Можно дополнительно прислать appliedPersonalizations, чтобы решение было консистентно между каналами.
Базово API нужен в четырёх случаях: в нативных мобильных приложениях, на вашем бэкенде, в CRM и автоматизациях и в личных кабинетах, куда нельзя положить произвольный JS‑скрипт. Выберите свой сценарий.
Запрос идёт либо напрямую с клиента, либо через ваш бэкенд. Ответ применяете в нативных экранах: подменяете предложение, показываете другой онбординг, включаете другую механику чек‑аута.
Ваш сервер собирает контекст и принимает решение перед рендерингом ответа. Подходит для SSR‑сайтов и систем, где UI собирается на сервере.
Перед отправкой коммуникации система спрашивает вариант. Разные сегменты получают разные предложения, темы и скидки, а офлайн‑конверсии возвращаются обратно как достижения целей.
Если сторонние скрипты запрещены корпоративной политикой, всё работает по серверному API. Ничего лишнего на клиенте, токен живёт только на вашем бэкенде.
Базовая интеграция собирается за день. Логика остаётся в кабинете Sales Ninja, на вашей стороне только два HTTP‑вызова.
Опишите варианты, условия таргетинга, цель оптимизации. Это делается в UI, маркетолог справится без разработчика. После публикации вы получаете ID и токен.
В нужной точке кода, перед рендером экрана или отправкой письма, делаете POST. В ответе приходит идентификатор варианта и его параметры. Применяете их.
Когда пользователь сделал то, ради чего всё затевалось, зафиксируйте цель: покупку, заявку, продление. Дальше модель сама подкручивает раздачу вариантов в сторону того, что работает.
# 1. Получить вариант curl -X POST 'https://api.sales-ninja.me/outer/v1.0/personalizations' \ -H 'X-SN-TOKEN: ********' \ -d '{"customerId":"u_8421","projectId":"…","context":{"page":"/checkout"}}' # 2. Зафиксировать достижение цели curl -X POST 'https://api.sales-ninja.me/outer/v1.0/goal/reach' \ -H 'X-SN-TOKEN: ********' \ -d '{"goalId":"checkout_paid","customerId":"u_8421"}'
Глубина данных / Sales Ninja
Аналитика показывает, что произошло. Мы добавляем подробное поведение, модельные оценки и данные ваших систем — чтобы понять, что может произойти дальше.
Пиксель Sales Ninja
Подробный слепок сессии помогает различать случайный просмотр и осмысленный интерес — даже когда покупка ещё не произошла.
Оценивать намерение по совокупности действий, а не по одному клику или времени на сайте.
Клики, скроллы, движения мыши, активность вкладок, корзина, просмотренные товары и цели прошлых сессий. UTM, устройство, город, погода и ваши собственные параметры.
Интересы, возрастная группа, платёжеспособность — с оценкой уверенности. Вероятность конверсии, ожидаемая выручка, цена клика и оценка ботности по поведению.
amoCRM, Битрикс24, RetailCRM; Calltouch, UIS / CoMagic, Phonix; Rick.ai, Smartis, Roistat; Яндекс Метрика, AppMetrica. Если готовой интеграции нет — своя выгрузка конверсий.
