API-режим Sales Ninja для мест, где нельзя поставить скрипт: мобильные приложения, бэкенд, CRM, личные кабинеты. Один POST — одно решение, без куки, без хранения состояния и без вынесения данных за контур.
На сайте Sales Ninja подключается JS‑скриптом и дальше сам решает, кому какой вариант показать. Но есть мир, где скрипт поставить нельзя — мобильное приложение, бэкенд, CRM, личный кабинет, телефония, рассылка. Там нужен другой формат интеграции.
Персонализация и A/B‑тесты по API — это режим Sales Ninja без установки скрипта. Вы собираете состояние пользователя у себя, отправляете POST‑запрос с нужными полями — в ответ получаете решение: какую персонализацию или вариант A/B применить. Без скриптов на клиенте, без куки, без вынесения данных за контур.
JS‑скрипт на сайте — следит за поведением, сам выбирает вариант, сам применяет изменения через DOM.
Отлично работает на сайте. Не работает в нативном приложении, бэкенде или CRM.
Следит за поведением
Выбирает вариант
Применяет изменения в DOM
Использует куки и хранит состояниеБэкенд / мобильное приложение собирает идентификатор пользователя и контекст, шлёт POST — получает решение и применяет его на своей стороне.
Stateless‑запрос: что передали — то и участвует в решении. Ничего лишнего, никакой «магии со стороны».
Ваш backend или приложение отправляет POST
Получает решение
Применяет у себя UI, логику, контентБез куки, без хранения состоянияBackend
iOS / AndroidCRMЛичные кабинеты
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, не ставим куки, не трекаем поведение скрытым скриптом.
customerId — это любой устойчивый ID, который вы считаете нужным. SHA‑256 от почты, ID строки в БД, GUID мобильной сессии, anonId. Sales Ninja не знает, что это, и не пытается обратно расшифровать.
customerId: 76f21ce7-365a-45f6-b416-49b5cd238a8bХотите дать только UTM и тип устройства — дайте только их. Готовы поделиться суммой корзины и тарифом — добавьте в params. Чем больше сигнала — тем точнее персонализация, но это всегда ваш выбор, не наш.
Если хотите гео‑логику — передайте IP. Не хотите — не передавайте, всё работает и без него: persistent customerId, контекст и params уже дают системе достаточно сигнала.
Проектный токен в заголовке X‑SN‑TOKEN. Никаких пользовательских ключей, ничего, что нужно генерить per‑user. Ротация — в один клик в кабинете.
Через API доступны три ключевых сценария Sales Ninja: персонализация по ML‑модели, A/B‑тестирование с контрольной группой и учёт целей — чтобы решения улучшались сами.
Один и тот же эндпоинт отдаёт персонализированные предложения, тексты, цены и бизнес‑логику. Модель сама учит, какой вариант лучше для кого. Через API возвращается готовое решение — вы применяете его в своём интерфейсе.
Отдельный endpoint для классических экспериментов. Многорукий бандит, четыре статистических метода остановки, sticky‑разделение — всё то же, что и на сайте, только без скрипта.
Когда у вас на стороне сработала покупка, заявка, оплата — стукните POST /goal/reach. Модель учится на этих сигналах. Цели бывают офлайн — дозвон, выкуп, окончание подписки.
UTM, устройство, страница, пройденные шаги, признаки CRM, любые ваши params. Условия таргетинга и сегменты настраиваются в кабинете — код менять не надо.
Если пользователь уже попал в вариант, он продолжит видеть его же при следующих запросах. Можно дополнительно прислать appliedPersonalizations — чтобы решение было консистентно даже между разными каналами.
Базово API нужен в четырёх случаях: на нативных мобильных приложениях, на вашем бэкенде, в CRM / автоматизациях и в личных кабинетах, где нельзя положить произвольный JS‑скрипт.
iOS и Android. Запрос идёт либо напрямую с клиента, либо через ваш бэкенд. Ответ применяете в нативных экранах: подменяете предложение, показываете другой онбординг, включаете другую механику чек‑аута.
Ваш сервер собирает контекст и принимает решение перед рендерингом ответа. Подходит для SSR‑сайтов, лендингов с heavy‑BI, систем где UI собирается на сервере.
Перед отправкой письма, пуша, SMS — запрос за вариантом. У разных сегментов получаются разные предложения, темы, скидки. Цели по офлайн‑конверсиям возвращаются обратно через /goal/reach.
Когда сторонние скрипты на сайт ставить нельзя по корпоративной политике — всё работает по серверному API. Ничего лишнего на клиенте, токен живёт только на вашем бэкенде.
Базовая интеграция собирается за день. Логика остаётся в кабинете Sales Ninja, на вашей стороне — только два HTTP‑вызова.
Опишите варианты, условия таргетинга, цель оптимизации. Это всё делается в UI — маркетолог справится без разработчика. Опубликуйте — получаете ID и токен.
В нужной точке кода — перед рендером экрана, перед отправкой письма, при открытии чек‑аута — делаете POST. В ответе — идентификатор варианта и его параметры. Применяете их.
Когда пользователь сделал то, ради чего всё затевалось — покупка, заявка, продление — стукните /goal/reach. Дальше модель сама подкручивает раздачу вариантов в сторону того, что работает.
# 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"}'
